oparchive(1)

1OPARCHIVE(1)                General Commands Manual               OPARCHIVE(1)
2
3
4

NAME

6       oparchive - produce archive of oprofile data for offline analysis
7

SYNOPSIS

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

DESCRIPTION

12       The oparchive utility is commonly used for collecting profile data on a
13       "target" system for future offline analysis  on  a  different  ("host")
14       machine.   oparchive  creates  a  directory populated with executables,
15       libraries, debuginfo files, and oprofile sample files.  This  directory
16       can  be  tar'ed  up and moved to another machine to be analyzed without
17       further use of the target machine. Using opreport and  other  post-pro‐
18       filing  tools  against  archived  data  requires  the  use  of  the ar‐
19       chive:<archived-dir> specification. See oprofile(1) for  how  to  write
20       profile specifications.  A complete description of offline analysis can
21       be found in the chapter titled Analyzing profile data on another system
22       (oparchive)  of  the  OProfile user manual. (See the user manual URL in
23       the "SEE ALSO" section below.)
24

OPTIONS

26       --help / -? / --usage
27              Show help message.
28
29       --version / -v
30              Show version.
31
32       --verbose / -V [options]
33              Give verbose debugging output.
34
35       --session-dir=dir_path
36              Use  sample  database  from  the  specified  directory  dir_path
37              instead  of the default location. If --session-dir is not speci‐
38              fied,  then  oparchive  will  search  for   samples   in   <cur‐
39              rent_dir>/oprofile_data first. If that directory does not exist,
40              the standard session-dir of /var/lib/oprofile is used.
41
42       --image-path / -p [paths]
43              Comma-separated list of additional paths to search for binaries.
44              This is needed to find modules in kernels 2.6 and upwards.
45
46       --root / -R [path]
47              A path to a filesystem to search for additional binaries.
48
49       --output-directory / -o [directory]
50              Output to the given directory. There is no default. This must be
51              specified.
52
53       --exclude-dependent / -x
54              Do not include application-specific images for libraries, kernel
55              modules and the kernel. This option only makes sense if the pro‐
56              file session used --separate.
57
58       --list-files / -l
59              Only list the files that would be archived, don't copy them.
60
61

ENVIRONMENT

63       No special environment variables are recognized by oparchive.
64
65

FILES

67       <session_dir>/samples
68              The location of the generated sample files.
69
70

VERSION

72       This man page is current for oprofile-1.3.0.
73
74