Intel® Trace Analyzer and Collector User and Reference Guide
ID
767272
Date
10/31/2024
Public
Tracing Conventional MPI Applications
Tracing Failing MPI Applications
Tracing OpenSHMEM* Applications
Tracing MPI File IO
Handling of Communicator Names
Tracing MPI Load Imbalance
Tracing User Defined Events
Configuring the Collector
Filtering Trace Data
Recording OpenMP* Regions Information
Tracing System Calls (Linux* OS)
Collecting Lightweight Statistics
Recording Source Location Information
Recording Hardware Performance Information (Linux* OS)
Recording Operating System Counters
Tracing Library Calls
Correctness Checking
Tracing Distributed Non-MPI Applications
ACTIVITY
ALTSTACK
AUTOFLUSH
CHECK
CHECK-LEAK-REPORT-SIZE
CHECK-MAX-DATATYPES
CHECK-MAX-ERRORS
CHECK-MAX-PENDING
CHECK-MAX-REPORTS
CHECK-MAX-REQUESTS
CHECK-SUPPRESSION-LIMIT
CHECK-TIMEOUT
CHECK-TRACING
CLUSTER
COMPRESS-RAW-DATA
COUNTER
CURRENT-DIR
DEADLOCK-TIMEOUT
DEADLOCK-WARNING
DEMANGLE
DETAILED-STATES
ENTER-USERCODE
ENVIRONMENT
EXTENDED-VTF
FLUSH-PID
FLUSH-PREFIX
GROUP
HANDLE-SIGNALS
INTERNAL-MPI
KEEP-RAW-EVENTS
LOGFILE-FORMAT
LOGFILE-NAME
LOGFILE-PREFIX
LOGFILE-RANK
MEM-BLOCKSIZE
MEM-FLUSHBLOCKS
MEM-INFO
MEM-MAXBLOCKS
MEM-MINBLOCKS
MEM-OVERWRITE
NMCMD
OS-COUNTER-DELAY
PCTRACE
PCTRACE-CACHE
PCTRACE-FAST
PLUGIN
PROCESS
PROGNAME
PROTOFILE-NAME
STATISTICS
STATE
STF-PROCS-PER-FILE
STF-USE-HW-STRUCTURE
STOPFILE-NAME
SYMBOL
SYNC-MAX-DURATION
SYNC-MAX-MESSAGES
SYNC-PERIOD
SYNCED-CLUSTER
SYNCED-HOST
TIME-WINDOWS (Experimental)
TIMER
TIMER-SKIP
UNIFY-COUNTERS
UNIFY-GROUPS
UNIFY-SCLS
UNIFY-SYMBOLS
VERBOSE
VT_START_PAUSED
VT_COMPRESS_TRACE
Parameter Checking
Premature Exit
Overlapping Memory
Detecting Illegal Buffer Modifications
Buffer Given to MPI Cannot Be Read or Written
Distributed Memory Checking
Illegal Memory Access
Request Handling
Datatype Handling
Buffered Sends
Deadlocks
Checking Message Transmission
Datatype Mismatches
Data Modified during Transmission
Checking Collective Operations
Freeing Communicators
Process Aggregation
Function Aggregation
Function Group Color Editor
Filtering Dialog Box
Tagging Dialog Box
Idealization Dialog Box
Imbalance Diagram Dialog Box
Trace Merge Dialog Box
Details Dialog Box
Source View Dialog
Time Interval Selection
Configuration Dialogs
Find Dialog Box
Command line for Intel® VTune™ Profiler and Intel® Advisor Dialog Box
OTF2 to STF Conversion Dialog Box
Configuration Assistant
Old Interface
To define a new symbol, first determine which value has to be used for the symbol handle, and then call the VT_symdef() function, passing the symbol and activity names, plus the handle value. It is not necessary to define the activity itself. Make sure to not use the same handle value for different symbols.
VT_symdef
int VT_symdef (int statehandle, const char * symname, const char * activity)
Description
Defines the numeric statehandle as shortcut for a state.
This function will become obsolete and should not be used for new code. Both symname and activity may consist of more than one component, separated by a colon :.
Leading and trailing colons are ignored. Several colons in a row are treated as just one separator.
Fortran
VTSYMDEF(code, symname, activity, ierr)
Parameters
statehandle | numeric value chosen by the application |
symname | name of the symbol |
activity | name of activity this symbol belongs to |
Return values
Returns error code
Parent topic: Defining and Recording Functions or Regions