Mike Dodd | 8cfa702 | 2010-11-17 11:12:26 -0800 | [diff] [blame] | 1 | .TH OPGPROF 1 "@DATE@" "oprofile @VERSION@" |
| 2 | .UC 4 |
| 3 | .SH NAME |
| 4 | opgprof \- produce gprof-format profile data |
| 5 | .SH SYNOPSIS |
| 6 | .br |
| 7 | .B opgprof |
| 8 | [ |
| 9 | .I options |
| 10 | ] |
| 11 | [profile specification] |
| 12 | .SH DESCRIPTION |
| 13 | |
| 14 | .B opgprof |
| 15 | outputs gprof-format profile data for a given binary image, |
| 16 | from an OProfile session. See oprofile(1) for how to write profile specifications. |
| 17 | |
| 18 | .SH OPTIONS |
| 19 | .TP |
| 20 | .BI "--help / -? / --usage" |
| 21 | Show help message. |
| 22 | .br |
| 23 | .TP |
| 24 | .BI "--version / -v" |
| 25 | Show version. |
| 26 | .br |
| 27 | .TP |
| 28 | .BI "--verbose / -V [options]" |
| 29 | Give verbose debugging output. |
| 30 | .br |
| 31 | .TP |
| 32 | .BI "--session-dir="dir_path |
| 33 | Use sample database out of directory dir_path instead of the default location (/var/lib/oprofile). |
| 34 | .br |
| 35 | .TP |
| 36 | .BI "--image-path / -p [paths]" |
| 37 | Comma-separated list of additional paths to search for binaries. |
| 38 | This is needed to find modules in kernels 2.6 and upwards. |
| 39 | .br |
| 40 | .TP |
| 41 | .BI "--root / -R [path]" |
| 42 | A path to a filesystem to search for additional binaries. |
| 43 | .br |
| 44 | .TP |
| 45 | .BI "--threshold / -t [percentage]" |
| 46 | Only output data for symbols that have more than the given percentage |
| 47 | of total samples. |
| 48 | .br |
| 49 | .TP |
| 50 | .BI "--output-filename / -o [file]" |
| 51 | Output to the given file instead of the default, gmon.out |
| 52 | |
| 53 | .SH ENVIRONMENT |
| 54 | No special environment variables are recognised by opgprof. |
| 55 | |
| 56 | .SH FILES |
| 57 | .TP |
| 58 | .I /var/lib/oprofile/samples/ |
| 59 | The location of the generated sample files. |
| 60 | |
| 61 | .SH VERSION |
| 62 | .TP |
| 63 | This man page is current for @PACKAGE@-@VERSION@. |
| 64 | |
| 65 | .SH SEE ALSO |
| 66 | .BR @OP_DOCDIR@, |
| 67 | .BR oprofile(1) |