1.4.2 (revision 8839)
Score-P Tools

scorep

A call to scorep has the following syntax:


This is the Score-P instrumentation tool. The usage is:
scorep <options> <original command>

Common options are:
  --help, -h      Show help output. Does not execute any other command.
  --config=<file> Specifies file for the instrumentation configuration.
  -v, --verbose[=<value>] Specifies the verbosity level. The following
                  levels are available:
                  0 = No output
                  1 = Executed commands are displayed (default if no
                      value is specified)
                  2 = Detailed information is displayed
  --dry-run       Only displays the executed commands. It does not
                  execute any command.
  --keep-files    Do not delete temporarily created files after successfull
                  instrumentation. By default, temporary files are deleted
                  if no error occures during instrumentation.
  --instrument-filter=<file>
                  Specifies the filter file for filtering functions during
                  compile-time. Not supported by all instrumentation methods.
                  It applies the same syntax, as the one used by Score-P during
                  run-time.
  --version       Prints the Score-P version and exits.
  --static        Enforce static linking of the Score-P libraries.
  --dynamic       Enforce dynamic linking of the Score-P libraries.
  --no-as-needed  Adds a GNU ld linker flag to fix undefined references
                  when using shared Score-P libraries. This happens on
                  systems using --as-needed as linker default. It will
                  be handled transparently in future releases of Score-P.
  --thread=<paradigm>[:<variant>]
                  Possible paradigms and variants are:
              none
                  No thread support.
              omp:pomp_tpd
                  OpenMP support using OPARI2 thread tracking
                  It requires and, thus, automatically enables opari instrumentation.
              omp:ancestry
                  OpenMP support using thread tracking with ancestry functions in OpenMP 3.0 and later
                  It requires and, thus, automatically enables opari instrumentation.
              pthread
                  Pthread support using thread tracking via library wrapping
                  It conflicts and, thus, automatically disables opari instrumentation.
  --mpp=<paradigm>[:<variant>]
                  Possible paradigms and variants are:
              none
                  No multi-process support.
              mpi
                  MPI support using library wrapping
              shmem
                  SHMEM support using library wrapping
  --mutex=<paradigm>[:<variant>]
                  Possible paradigms and variants are:
              none
                  serial case, no locking
              pthread
                  Pthread mutex locks
              pthread:spinlock
                  Pthread spinlocks
              omp
                  OpenMP locks
  --compiler      Enables compiler instrumentation.
                  By default, it disables pdt instrumentation.
  --nocompiler    Disables compiler instrumentation.
  --cuda          Enables cuda instrumentation.
  --nocuda        Disables cuda instrumentation.
  --online-access Enables online-access support. It is disabled by default
  --noonline-access online-access Disables online-access support.
  --pomp[=<parameter-list>]
                  Enables pomp user instrumentation.
                  You may add additional parameters that are passed to OPARI2.
                  By default, it enables also preprocessing
  --nopomp        Disables pomp user instrumentation.
  --opari[=<parameter-list>]
                  Enables OPARI2 instrumentation of OpenMP regions.
                  You may add additional parameters that are passed to OPARI2
                  By default, it enables also preprocessing and
                  pomp user instrumentation.
  --pdt[=<parameter-list>]
                  Enables pdt instrumentation.
                  You may add additional parameters that are passed to pdt.
                  It requires and, thus, automatically enables user instrumentation.
                  It conflicts and, thus, automatically disables preprocess instrumentation.
                  By default, it disables compiler instrumentation.
  --nopdt         Disables pdt instrumentation.
  --preprocess    Enables preprocess instrumentation.
                  It requires and, thus, automatically enables opari instrumentation.
                  It conflicts and, thus, automatically disables pdt instrumentation.
  --nopreprocess  Disables preprocess instrumentation.
  --user          Enables user instrumentation.
  --nouser        Disables user instrumentation.
  --opencl        Enables OpenCL instrumentation.
  --noopencl      Disables OpenCL instrumentation.

scorep-config

A call to scorep-config has the following syntax:


Usage:
scorep-config <command> [<options>]
  Commands:
   --cflags    prints additional compiler flags for a C compiler. They already
               contain the include flags.
   --cxxflags  prints additional compiler flags for a C++ compiler. They already
               contain the include flags.
   --fflags    prints additional compiler flags for a Fortran compiler. They already
               contain the include flags.
   --cppflags  prints the include flags. They are already contained in the
               output of the --cflags, --cxxflags, and --fflags commands
   --ldflags   prints the library path flags for the linker
   --libs      prints the required linker flags
   --cc        prints the C compiler name
   --cxx       prints the C++ compiler name
   --fc        prints the Fortran compiler name
   --mpicc     prints the MPI C compiler name
   --mpicxx    prints the MPI C++ compiler name
   --mpifc     prints the MPI Fortran compiler name
   --help      prints this usage information
   --version   prints the version number of the Score-P package
   --scorep-revision prints the revision number of the Score-P package
   --common-revision prints the revision number of the common package
   --remap-specfile  prints the path to the remapper specification file
  Options:
   --nvcc      Convert flags to be suitable for the nvcc compiler.
   --static    Use only static Score-P libraries if possible.
   --dynamic   Use only dynamic Score-P libraries if possible.
   --online-access|--noonline-access
            Specifies whether online access (needed by Periscope) is enabled.
            On default it is enabled.
   --compiler|--nocompiler
            Specifies whether compiler instrumentation is used.
            On default compiler instrumentation is enabled.
   --user|--nouser
            Specifies whether user instrumentation is used.
            On default user instrumentation is disabled.
   --pomp|--nopomp
            Specifies whether pomp instrumentation is used.
            On default pomp instrumentation is disabled.
   --cuda|--nocuda
            Specifies whether cuda instrumentation is used.
            On default cuda instrumentation is enabled.
   --opencl|--noopencl
            Specifies whether OpenCL instrumentation is used.
            On default OpenCL instrumentation is enabled.
   --preprocess|--nopreprocess
            Specifies whether preprocess instrumentation is used.
            On default preprocess instrumentation is disabled.
   --thread=<threading system>[:<variant>]
            Available threading systems are:
         none	This is the default.
         omp:pomp_tpd
         omp:ancestry
         pthread
            If no variant is specified the first matching
            threading system is used.
   --mutex=<locking system>[:<variant>]
            Available locking systems are:
         none
         omp
         pthread
         pthread:spinlock
         pthread:wrap
            If no variant is specified the default for the respective
            threading system is used.
   --mpp=<multi-process paradigm>
            Available multi-process paradigms are:
         mpi	This is the default.
         shmem
         none

scorep-info

A call to scorep-info has the following syntax:

Usage: scorep-info <info command> <command options>
       scorep-info --help
This is the Score-P info tool.

Available info commands:

  config-vars:
    Shows the list of all measurement config variables with a short description.

    Info command options:
      --full        Displays a detailed description for each config variable.
      --values      Displays the current values for each config variable.
                    Warning: These values may be wrong, please consult the
                             manual of the batch system how to pass the values
                             to the measurement job.

  config-summary:
    Shows the configure summary of the Score-P package.

scorep-score

A call to scorep-score has the following syntax:

Usage: scorep-score <profile> [options]

Options:
  -r          Show all regions.
  -h          Show this help and exit.
  -f <filter> Shows the result with the filter applied.
  -c <num>    Specifes the number of hardware counters that shall be measured.
              By default, this value is 0, which means that only a timestamp
              is measured on each event. If you plan to record hardware counters
              specify the number of hardware counters. Otherwise, scorep-score
              may underestimate the required space.
  -m          Prints mangled region names if available.

scorep-backend-info

Note:
This tool is intended to run as a batch job. Please consult the manual of the batch system how to submit jobs.

A call to scorep-backend-info has the following syntax:

Usage: scorep-backend-info <info command> <command options>
       scorep-backend-info --help
This is the Score-P backend info tool.

Available info commands:

  system-tree:
    Shows the available system tree levels, starting with the root.

  config-vars:
    Shows the current values of all measurement config variables.