oparchive(1) - Linux manual page

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT | FILES | VERSION | SEE ALSO | COLOPHON

OPARCHIVE(1)               General Commands Manual              OPARCHIVE(1)

NAME         top

       oparchive - produce archive of oprofile data for offline analysis

SYNOPSIS         top

       oparchive [ options ] [profile specification] -o [directory]

DESCRIPTION         top

       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 Analyzing profile data on
       another system (oparchive) of the OProfile user manual. (See the user
       manual URL in the "SEE ALSO" section below.)

OPTIONS         top

       --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.

ENVIRONMENT         top

       No special environment variables are recognized by oparchive.

FILES         top

       <session_dir>/samples
              The location of the generated sample files.

VERSION         top

       This man page is current for oprofile-1.3.0git.

SEE ALSO         top

       file:///usr/local/share/doc/oprofile/oprofile.html#oparchive
       opimport(1)
       oprofile(1)

COLOPHON         top

       This page is part of the oprofile (a system-wide profiler for Linux)
       project.  Information about the project can be found at 
       ⟨http://oprofile.sourceforge.net/news/⟩.  If you have a bug report for
       this manual page, see ⟨http://oprofile.sourceforge.net/bugs/⟩.  This
       page was obtained from the project's upstream Git repository ⟨git
       clone git://git.code.sf.net/p/oprofile/oprofile⟩ on 2018-02-02.  (At
       that time, the date of the most recent commit that was found in the
       repository was 2018-01-18.)  If you discover any rendering problems
       in this HTML version of the page, or you believe there is a better or
       more up-to-date source for the page, or you have corrections or
       improvements to the information in this COLOPHON (which is not part
       of the original manual page), send a mail to man-pages@man7.org

4th Berkeley Distribution   Fri 02 February 2018                OPARCHIVE(1)

Pages that refer to this page: oprofile(1)