NAME

       gp-archive - archive gprofng experiment data

SYNOPSIS

       gprofng archive [OPTION(S)] EXPERIMENT

DESCRIPTION

       Archive  the  associated  application binaries and source files in a gprofng experiment to
       make it self contained and portable.

OPTIONS

       --version
              print the version number and exit.

       --help print usage information and exit.

       --verbose {on|off}
              enable (on) or disable (off) verbose mode; the default is "off".

       -a {off|on|ldobjects|src|usedldobjects|usedsrc}
              specify archiving of binaries and other files; in addition to disable this  feature
              (off),  or enable archiving off all loadobjects and sources (on), the other options
              support a more refined selection. All of these options enable  archiving,  but  the
              keyword controls what exactly is selected: all load objects (ldobjects), all source
              files (src), the loadobjects asscoiated with a program counter (usedldobjects),  or
              the  source  files  associated with a program counter (usedsrc); the default is "-a
              ldobjects".

       -n     archive the named experiment only, not any of its descendants.

       -q     do not write any warnings to stderr; messages are archived  and  can  be  retrieved
              later.

       -F     force writing or rewriting of the archive; ignored with the -n or -m options, or if
              this is a subexperiment.

       -d <path>
              specifies the location of a common archive;  this  is  a  directory  that  contains
              archived files.

       -m <regex>
              archive  only  those  source,  object,  and  debug  info files whose full path name
              matches the given POSIX compliant regular expression.

LIMITATIONS

       Default archiving does not occur in case the application profiled terminates  prematurely,
       or if archiving is disabled when collecting the performance data. In such cases, this tool
       can be used to afterwards archive the information, but it has to run on  the  same  system
       where the profiling data was recorded.

DOCUMENTATION

       A  getting  started  guide  for gprofng is maintained as a Texinfo manual. If the info and
       gprofng programs are properly installed at your site, the command  "info  gprofng"  should
       give you access to this document.

SEE ALSO

       gprofng(1), gp-collect-app(1), gp-display-html(1), gp-display-src(1), gp-display-text(1)

COPYRIGHT

       Copyright  ©  2023  Free  Software  Foundation, Inc.  License GPLv3+: GNU GPL version 3 or
       later <https://gnu.org/licenses/gpl.html>.
       This is free software: you are free to change and redistribute it.  There is NO  WARRANTY,
       to the extent permitted by law.