• 2019 Update 3
  • 03/07/2019
  • Public Content
  • Download as PDF
Contents

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

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804