User and Reference Guide for the Intel® C++ Compiler 14.0

tcollect, Qtcollect

Inserts instrumentation probes calling the Intel® Trace Collector API.

Architecture Restrictions

Not available on Intel® 64 architecture targeting Intel® MIC Architecture, or on IA-32 architecture targeting Intel® Graphics Technology

Syntax

Linux OS:

-tcollect[lib]

OS X:

None

Windows OS:

/Qtcollect[:lib]

Arguments

lib

Is one of the Intel® Trace Collector libraries; for example, VT, VTcs, VTmc, or VTfs. If you do not specify lib, the default library is VT.

Default

OFF

Instrumentation probes are not inserted into compiled applications.

Description

This option inserts instrumentation probes calling the Intel® Trace Collector API.

This trace analyzing/collecting feature requires installation of another product. For more information, see Feature Requirements.

This option provides a flexible and convenient way of instrumenting functions of a compiled application. For every function, the entry and exit points are instrumented at compile time to let the Intel® Trace Collector record functions beyond the default MPI calls. For non-MPI applications (for example, threaded or serial), you must ensure that the Intel® Trace Collector is properly initialized (VT_initialize/VT_init).

Caution

Be careful with full instrumentation because this feature can produce very large trace files.

IDE Equivalent

None

Alternate Options

None

See Also


Submit feedback on this help topic