Intel® Trace Analyzer and Collector

Additional API Calls in libVTcs

VT_abort

int VT_abort (void)

Description

Abort a VT_initialize() or VT_finalize() call running concurrently in a different thread.

This call will not block, but it might still take a while before the aborted calls actually return. They will return either successfully (if they have completed without aborting) or with an error code.

Checking Collective Operations

(GLOBAL:COLLECTIVE)

Checking correct usage of collective operations is easier than checking messages. At the beginning of each operation, Intel® Trace Collector broadcasts the same data from rank #0 of the communicator. This data includes:

  • Type of the operation

  • Root (zero if not applicable)

  • Reduction type (predefined types only)

VT_registernamed

int VT_registernamed (const char * threadname, int thindex)

Description

Registers a new thread with Intel® Trace Collector under the given number and name.

Threads with the same number cannot have different names. If you try doing that, the thread uses the number, but not the new name.

ALTSTACK

Syntax

ALTSTACK [on|off]

Variable

VT_ALTSTACK

Description

Handling segfaults due to a stack overflow requires that the signal handler runs on an alternative stack, otherwise it will just segfault again, causing the process to terminate.

Because installing an alternative signal handler affects application behavior, it is normally not done. If it is known to work, it is enabled only for MPI correctness checking.

LOGFILE-PREFIX

Syntax

LOGFILE-PREFIX <directory name>

Variable

VT_LOGFILE_PREFIX

Description

Specifies the directory of the trace or log file. It can be an absolute or relative pathname; in the latter case, it is interpreted relative to the current working directory of the process writing it.

Subscribe to Intel® Trace Analyzer and Collector