User Guide

  • 2022.2
  • 08/08/2022
  • Public Content
Contents

VT_registerthread

int VT_registerthread(int thindex)

Description

Registers a new thread with Intel® Trace Analyzer and 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 Analyzer and 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 Analyzer and 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.