This is the list of configure variables to control a Score-P measurement.
SCOREP_ENABLE_PROFILING
- Enable profiling
- Type:
- Boolean
- Default:
- true
SCOREP_ENABLE_TRACING
- Enable tracing
- Type:
- Boolean
- Default:
- false
SCOREP_VERBOSE
- Be verbose
- Type:
- Boolean
- Default:
- false
SCOREP_TOTAL_MEMORY
- Total memory in bytes for the measurement system
- Type:
- Number with size suffixes
- Default:
- 16000k
SCOREP_PAGE_SIZE
- Memory page size in bytes
- Type:
- Number with size suffixes
- Default:
- 8k
TOTAL_MEMORY will be split up into pages of size PAGE_SIZE.
SCOREP_EXPERIMENT_DIRECTORY
- Name of the experiment directory
- Type:
- String
- Default:
When no experiment name is given (the default)Score-P names the
experiment directory `scorep-measurement-tmp' and renames this
after a successful measurement to a generated name based on the
current time.
SCOREP_OVERWRITE_EXPERIMENT_DIRECTORY
- Overwrite an existing experiment directory
- Type:
- Boolean
- Default:
- true
If you specified a specific experiment directory name, but this name
is already given, you can force overwriting it with this flag.
The previous experiment directory will be renamed.
SCOREP_MACHINE_NAME
- The machine name used in profile and trace output.
- Type:
- String
- Default:
- Linux
We suggest using a unique name, e.g., the fully qualified domain name.
The default machine name was set at configure time (see the INSTALL
file for customization options).
SCOREP_EXECUTABLE
- Executable of the application
- Type:
- String
- Default:
File name, preferrrably with full path, of the application's executable.
It is used for evaluating the symbol table of the application, which is
required by some compiler adapters.
SCOREP_PROFILING_TASK_TABLE_SIZE
- Size of the task tracing table
- Type:
- Number
- Default:
- 64
Size of the task tracing table. Best performance is obtained, if the
table size matches the number of tasks that are active at once. If
your program does not use tasks, you may set this value to zero, to
save some memory.
SCOREP_PROFILING_MAX_CALLPATH_DEPTH
- Maximum depth of the calltree
- Type:
- Number
- Default:
- 30
SCOREP_PROFILING_BASE_NAME
- Base for construction of the profile filename
- Type:
- String
- Default:
- profile
String which is used as based to create the filenames for the profile files.
SCOREP_PROFILING_FORMAT
- Profile output format
- Type:
- Set
- Default:
- default
Sets the output format for the profile.
The following formats are supported:
none: No profile output. This does not disable profile recording.
tau_snapshot: Tau snapshot format
cube4: Stores the sum for every metric per callpath in Cube4 format.
cube_tuple: Stores an extended set of statistics in Cube4 format.
default: Default format. If Cube4 is supported, Cube4 is the default
else the Tau snapshot format is default
SCOREP_PROFILING_ENABLE_CLUSTERING
- Enable clustering
- Type:
- Boolean
- Default:
- true
SCOREP_PROFILING_CLUSTER_COUNT
- maximum cluster count for iteration clustering.
- Type:
- Number with size suffixes
- Default:
- 64
maximum cluster count for iteration clustering.
SCOREP_PROFILING_CLUSTERING_MODE
- Specifies the level of strictness when comparing call trees for equivalence.
- Type:
- Number with size suffixes
- Default:
- 1
Specifies the level of strictness when comparing call trees for equivalence.
SCOREP_PROFILING_CLUSTERED_REGION
- Name of the clustered region
- Type:
- String
- Default:
The clustering can only cluster one dynamic region. If more than one dynamic region are defined by the user, the region is clustered which is exited first. If another region should be clustered instead you can specify the region name in this variable. If the variable is unset or empty, the first exited dynamic region is clustered.
SCOREP_PROFILING_ENABLE_CORE_FILES
- Write .core files if an error occured.
- Type:
- Boolean
- Default:
- false
If an error occures inside the profiling system, the profiling is disabled. For dubugging reasons, it might be feasable to get the state of the local local at these points. It is not recommended to enable this feature for large scale measurements.
SCOREP_TRACING_USE_SION
- Whether or not to use libsion as OTF2 substrate
- Type:
- Boolean
- Default:
- false
SCOREP_TRACING_MAX_PROCS_PER_SION_FILE
- Maximum number of processes that share one sion file (must be > 0)
- Type:
- Number
- Default:
- 1024
All processes are than evenly distributed over the number of needed files to fulfill this constraint. E.g., having 4 processes and setting the maximum to 3 would result in 2 files each holding 2 processes.
SCOREP_TRACING_COMPRESS
- Whether or not to compress traces with libz
- Type:
- Boolean
- Default:
- false
SCOREP_ONLINEACCESS_ENABLE
- Enable online access interface
- Type:
- Boolean
- Default:
- false
SCOREP_ONLINEACCESS_REG_PORT
- Online access registry service port
- Type:
- Number
- Default:
- 50100
SCOREP_ONLINEACCESS_REG_HOST
- Online access registry service hostname
- Type:
- String
- Default:
- localhost
SCOREP_ONLINEACCESS_BASE_PORT
- Base port for online access server
- Type:
- Number
- Default:
- 50010
SCOREP_ONLINEACCESS_APPL_NAME
- Application name to be registered
- Type:
- String
- Default:
- appl
SCOREP_FILTERING_FILE
- A file name which contain the filter rules
- Type:
- String
- Default:
SCOREP_METRIC_PAPI
- PAPI metric names to measure
- Type:
- String
- Default:
List of requested metric names that will be collected during program run.
SCOREP_METRIC_PAPI_PER_PROCESS
- PAPI metric names to measure per-process
- Type:
- String
- Default:
List of requested metric names that will be recorded only by first thread of a process.
SCOREP_METRIC_PAPI_SEP
- Separator of metric names
- Type:
- String
- Default:
- ,
Character that separates metric names in SCOREP_METRIC_PAPI and SCOREP_METRIC_PAPI_PER_PROCESS.
SCOREP_METRIC_RUSAGE
- Resource usage metric names to measure
- Type:
- String
- Default:
List of requested resource usage metric names that will be collected during program run.
SCOREP_METRIC_RUSAGE_PER_PROCESS
- Resource usage metric names to measure per-process
- Type:
- String
- Default:
List of requested resource usage metric names that will be recorded only by first thread of a process.
SCOREP_METRIC_RUSAGE_SEP
- Separator of resource usage metric names.
- Type:
- String
- Default:
- ,
Character that separates metric names in SCOREP_METRIC_RUSAGE and SCOREP_METRIC_RUSAGE_PER_PROCESS.
SCOREP_METRIC_PLUGINS
- Specify list of used plugins
- Type:
- String
- Default:
List of requested metric plugin names that will be used during program run.
SCOREP_METRIC_PLUGINS_SEP
- Separator of plugin names
- Type:
- String
- Default:
- ,
Character that separates plugin names in SCOREP_METRIC_PLUGINS.
SCOREP_SELECTIVE_CONFIG_FILE
- A file name which configures selective recording
- Type:
- String
- Default:
SCOREP_MPI_MAX_COMMUNICATORS
- Determines the number of concurrently used communicators per process
- Type:
- Number
- Default:
- 50
SCOREP_MPI_MAX_WINDOWS
- Determines the number of concurrently used windows for MPI one-sided communication per process
- Type:
- Number
- Default:
- 50
SCOREP_MPI_MAX_ACCESS_EPOCHS
- Maximum amount of concurrently active access or exposure epochs per process
- Type:
- Number
- Default:
- 50
SCOREP_MPI_MAX_GROUPS
- Maximum number of concurrently used MPI groups per process
- Type:
- Number
- Default:
- 50
SCOREP_MPI_ENABLE_GROUPS
- The names of the function groups which are measured
- Type:
- Set
- Default:
- default
Other functions are not measured.
Possible groups are:
all: All MPI functions
cg: Communicator and group management
coll: Collective functions
default: Default configuration
env: Environmental management
err: MPI Error handling
ext: External interface functions
io: MPI file I/O
misc: Miscellaneous
perf: PControl
p2p: Peer-to-peer communication
rma: One sided communication
spawn: Process management
topo: Topology
type: MPI datatype functions
xnonblock: Extended non-blocking events
xreqtest: Test events for uncompleted requests
SCOREP_MPI_ONLINE_ANALYSIS
- Enable online mpi wait states analysis
- Type:
- Boolean
- Default:
- false
SCOREP_CUDA_ENABLE
- CUDA measurement features
- Type:
- Set
- Default:
- no
Sets the CUDA measurement mode to capture:
runtime: CUDA runtime API
driver: CUDA driver API
kernel: CUDA kernels
kernel_serial: Serialized kernel recording.
kernel_counter: Fixed CUDA kernel metrics.
idle: GPU compute idle time
pure_idle: GPU idle time (memory copies are not idle)
memcpy: CUDA memory copies
sync: Record implicit and explicit CUDA synchronization
gpumemusage: Record CUDA memory (de)allocations as a counter
references: Record references between CUDA activities
stream_reuse: Reuse destroyed/closed CUDA streams
device_reuse: Reuse destroyed/closed CUDA devices
flushatexit: Flush CUDA activity buffer at program exit
default/yes/1: CUDA runtime API and GPU activities
no: Disable CUDA measurement
SCOREP_CUDA_BUFFER
- Total memory in bytes for the CUDA record buffer
- Type:
- Number with size suffixes
- Default:
- 1M
SCOREP_CUDA_BUFFER_CHUNK
- Chunk size in bytes for the CUDA record buffer (ignored for CUDA 5.5 and earlier)
- Type:
- Number with size suffixes
- Default:
- 8k