User and Reference Guide

Contents

VT_registerthread

int VT_registerthread(int thindex)
Description
Registers a new thread with Intel® Trace Collector under the given number.
Threads are numbered starting from 0, which is always the thread that has called
VT_initialize()
or
MPI_Init()
. The call to
VT_registerthread()
is optional, as the thread that uses Intel® Trace Collector without having called
VT_registerthread()
is automatically assigned the lowest free index. If a thread terminates, then its index becomes available again and might be reused for another thread.
Calling
VT_registerthread()
when the thread has been assigned an index already is an error, unless the argument of
VT_registerthread()
is equal to this index. The thread is not (re-)registered in case of an error.
Fortran
VTREGISTERTHREAD(thindex, ierr)
Parameters
thindex
thread number, only used if >= 0
Return values
Returns error codes:
  • VT_ERR_BADINDEX
    - thread index is currently assigned to another thread
  • VT_ERR_BADARG
    - thread has been assigned a different index already
  • VT_ERR_NOTINITIALIZED
    - Intel® Trace Collector has not been initialized yet

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.