oparchive - produce archive of oprofile data for offline analysis
Contents
Description
The oparchive utility is commonly used for collecting profile data on a "target" system for future
offline analysis on a different ("host") machine. oparchive creates a directory populated with
executables, libraries, debuginfo files, and oprofile sample files. This directory can be tar'ed up and
moved to another machine to be analyzed without further use of the target machine. Using opreport and
other post-profiling tools against archived data requires the use of the archive:<archived-dir>
specification. See oprofile(1) for how to write profile specifications. A complete description of
offline analysis can be found in the chapter titled Analyzingprofiledataonanothersystem(oparchive)
of the OProfile user manual. (See the user manual URL in the "SEE ALSO" section below.)
Environment
No special environment variables are recognized by oparchive.
Files
<session_dir>/samples
The location of the generated sample files.
Name
oparchive - produce archive of oprofile data for offline analysis
Options
--help/-?/--usage
Show help message.
--version/-v
Show version.
--verbose/-V[options]
Give verbose debugging output.
--session-dir=dir_path
Use sample database from the specified directory dir_path instead of the default location. If
--session-dir is not specified, then oparchive will search for samples in
<current_dir>/oprofile_data first. If that directory does not exist, the standard session-dir of
/var/lib/oprofile is used.
--image-path/-p[paths]
Comma-separated list of additional paths to search for binaries. This is needed to find modules
in kernels 2.6 and upwards.
--root/-R[path]
A path to a filesystem to search for additional binaries.
--output-directory/-o[directory]
Output to the given directory. There is no default. This must be specified.
--exclude-dependent/-x
Do not include application-specific images for libraries, kernel modules and the kernel. This
option only makes sense if the profile session used --separate.
--list-files/-l
Only list the files that would be archived, don't copy them.
See Also
file:///usr/share/doc/oprofile/oprofile.html#oparchiveopimport(1)oprofile(1) 4th Berkeley Distribution Mon 22 April 2024 OPARCHIVE(1)
Synopsis
oparchive [ options ] [profile specification] -o [directory]
Version
This man page is current for oprofile-1.4.0.
