| Mike Dodd | 8cfa702 | 2010-11-17 11:12:26 -0800 | [diff] [blame] | 1 | .TH OPARCHIVE 1 "@DATE@" "oprofile @VERSION@" |
| 2 | .UC 4 |
| 3 | .SH NAME |
| 4 | oparchive \- produce archive of oprofile data for offline analysis |
| 5 | .SH SYNOPSIS |
| 6 | .br |
| 7 | .B oparchive |
| 8 | [ |
| 9 | .I options |
| 10 | ] |
| 11 | [profile specification] |
| 12 | .B -o |
| 13 | [directory] |
| 14 | .SH DESCRIPTION |
| 15 | |
| 16 | .B oparchive |
| 17 | generates a directory populated with executable, debug, and oprofile sample |
| 18 | files. This directory can be move to another machine via tar and analyzed |
| 19 | without further use of the data collection machine. See oprofile(1) for how |
| 20 | to write profile specifications. |
| 21 | |
| 22 | .SH OPTIONS |
| 23 | .TP |
| 24 | .BI "--help / -? / --usage" |
| 25 | Show help message. |
| 26 | .br |
| 27 | .TP |
| 28 | .BI "--version / -v" |
| 29 | Show version. |
| 30 | .br |
| 31 | .TP |
| 32 | .BI "--verbose / -V [options]" |
| 33 | Give verbose debugging output. |
| 34 | .br |
| 35 | .TP |
| 36 | .BI "--session-dir="dir_path |
| 37 | Use sample database out of directory dir_path instead of the default location (/var/lib/oprofile). |
| 38 | .br |
| 39 | .TP |
| 40 | .BI "--image-path / -p [paths]" |
| 41 | Comma-separated list of additional paths to search for binaries. |
| 42 | This is needed to find modules in kernels 2.6 and upwards. |
| 43 | .br |
| 44 | .TP |
| 45 | .BI "--root / -R [path]" |
| 46 | A path to a filesystem to search for additional binaries. |
| 47 | .br |
| 48 | .TP |
| 49 | .BI "--output-directory / -o [directory]" |
| 50 | Output to the given directory. There is no default. This must be specified. |
| 51 | .br |
| 52 | .TP |
| 53 | .BI "--exclude-dependent / -x" |
| 54 | Do not include application-specific images for libraries, kernel modules |
| 55 | and the kernel. This option only makes sense if the profile session |
| 56 | used --separate. |
| 57 | .br |
| 58 | .TP |
| 59 | .BI "--list-files / -l" |
| 60 | Only list the files that would be archived, don't copy them. |
| 61 | |
| 62 | .SH ENVIRONMENT |
| 63 | No special environment variables are recognised by oparchive. |
| 64 | |
| 65 | .SH FILES |
| 66 | .TP |
| 67 | .I /var/lib/oprofile/samples/ |
| 68 | The location of the generated sample files. |
| 69 | |
| 70 | .SH VERSION |
| 71 | .TP |
| 72 | This man page is current for @PACKAGE@-@VERSION@. |
| 73 | |
| 74 | .SH SEE ALSO |
| 75 | .BR @OP_DOCDIR@, |
| 76 | .BR oprofile(1) |