X-Git-Url: http://wien.tomnetworks.com/gitweb/?a=blobdiff_plain;ds=sidebyside;f=man%2Fmprof-report.1;h=56663251bf8e0066c83fd9f700eb835d724a2ff2;hb=098f6e8aa8ead1a80b751fa34e5e049439c2f0c3;hp=b96001d2c63c4369b6f45462e70bbb1846d197dd;hpb=f1c948536d6f4b9025b8593dc3f285f3ccf84db6;p=mono.git diff --git a/man/mprof-report.1 b/man/mprof-report.1 index b96001d2c63..56663251bf8 100644 --- a/man/mprof-report.1 +++ b/man/mprof-report.1 @@ -139,30 +139,15 @@ garbage collections to the control port .RE .IP \[bu] 2 -\f[I]sample[=TYPE[/FREQ]]\f[]: collect statistical samples of the +\f[I]sample[=FREQ]\f[]: collect statistical samples of the program behaviour. The default is to collect a 100 times per second (100 Hz) the instruction pointer. -This is equivalent to the value \[lq]cycles/100\[rq]. +This is equivalent to the value \[lq]100\[rq]. A value of zero for \f[I]FREQ\f[] effectively disables sampling. -On some systems, like with recent Linux kernels, it is possible to -cause the sampling to happen for other events provided by the -performance counters of the cpu. -In this case, \f[I]TYPE\f[] can be one of: -.RS 2 -.IP \[bu] 2 -\f[I]cycles\f[]: processor cycles -.IP \[bu] 2 -\f[I]instr\f[]: executed instructions -.IP \[bu] 2 -\f[I]cacherefs\f[]: cache references .IP \[bu] 2 -\f[I]cachemiss\f[]: cache misses -.IP \[bu] 2 -\f[I]branches\f[]: executed branches -.IP \[bu] 2 -\f[I]branchmiss\f[]: mispredicted branches -.RE +\f[I]heapshot-on-shutdown\f[]: collect heap shot data when the runtime +shuts down. .IP \[bu] 2 \f[I]maxframes=NUM\f[]: when a stack trace needs to be performed, collect \f[I]NUM\f[] frames at the most. @@ -198,16 +183,15 @@ with the current process id and \f[I]%t\f[] with the current date and time, then do according to \f[I]OUTSPEC\f[]: .RS 2 .IP \[bu] 2 -if \f[I]OUTSPEC\f[] begins with a \f[I]|\f[] character, execute the -rest as a program and feed the data to its standard input +If \f[I]OUTSPEC\f[] begins with a \f[I]|\f[] character, execute the +rest as a program and feed the data to its standard input. .IP \[bu] 2 -if \f[I]OUTSPEC\f[] begins with a \f[I]-\f[] character, use the -rest of OUTSPEC as the filename, but force overwrite any existing -file by that name +If \f[I]OUTSPEC\f[] begins with a \f[I]#\f[] character, parse the +rest as a file descriptor number, and feed the data to this file +descriptor. .IP \[bu] 2 otherwise write the data the the named file: note that is a file by -that name already exists, a warning is issued and profiling is -disabled. +that name already exists, it is truncated. .RE .IP \[bu] 2 \f[I]report\f[]: the profiling data is sent to mprof-report, which @@ -227,20 +211,11 @@ The following commands are available: \f[I]heapshot\f[]: perform a heapshot as soon as possible .RE .IP \[bu] 2 -\f[I]counters\f[]: sample counters values every 1 second. This allow -a really lightweight way to have insight in some of the runtime key -metrics. Counters displayed in non verbose mode are : Methods from AOT, -Methods JITted using mono JIT, Methods JITted using LLVM, Total time -spent JITting (sec), User Time, System Time, Total Time, Working Set, -Private Bytes, Virtual Bytes, Page Faults and CPU Load Average (1min, -5min and 15min). +\f[I]nocounters\f[]: disables sampling of runtime and performance +counters, which is normally done every 1 second. .IP \[bu] 2 \f[I]coverage\f[]: collect code coverage data. This implies enabling the \f[I]calls\f[] option. -.IP \[bu] 2 -\f[I]onlycoverage\f[]: can only be used with \f[I]coverage\f[]. This -disables most other events so that the profiler mostly only collects -coverage data. .RE .SS Analyzing the profile data .PP