Other Features

Inclusion/Exclusion prefix list

Many POSIX calls intercepted are made by system libraries, job schedulers, etc. Their I/O accesses are less interesting as they operates on file locations such as /dev, /sys, /usr/lib, etc. To ignore those calls, you can specifiy a file that contains prefixes that you want to exclude:

export RECORDER_EXCLUSION_FILE=/path/to/your/exclusion_prefix_file

# This file contains one prefix each line.
# An example exclusion prefix file is included with Recorder:

Recorder$ cat ./exclusion_prefix.txt
/dev
/proc
/sys
/etc
/usr/tce/packages
pipe:[
anon_inode:
socket:[

Similarly, you can set RECORDER_INCLUSION_FILE to specify the inclusion prefixes, so only the POSIX calls that match those prefixes will be recorded.

Note that this feature only applies to POSIX calls. MPI and HDF5 calls are always recorded when enabled.

Storing pointers

Recorder by default does not log the pointers (memory addresses) as they provide little information yet cost a lot of space to store. However, you can change this behaviour by setting the enviroment variable RECORDER_LOG_POINTER to 1.

Storing thread ids

Use RECORDER_LOG_TID(0 or 1) to control whether to store thread id. Default is 0.

Storing call levels

Use RECORDER_LOG_LEVEL (0 or 1) to control whether to store call levels. Default is 1.

Traces location

By default Recorder will output the traces to the current working directory. You can use the enviroment variable RECORDER_TRACES_DIR to specifiy the path where you want the traces stored. Make sure that every process has the persmission to write to that directory.

Timestamp buffer size

Timestamps are buffered internally to avoid frequent disk I/O. Use RECORDER_BUFFER_SIZE (in MB) to set the size of this buffer. The default value is 1MB.