Download Intel(R) Trace Collector Reference Guide

Transcript
Intel(R) Trace Collector Reference Guide
VT_COUNT_ABSVAL counter shall be displayed with absolute values.
VT_COUNT_RATE first derivative of counter values shall be displayed.
VT_COUNT_DISPLAY mask to extract the display type.
•
the semantic associated with a sample value
enum VT_CountScope
Enumeration values:
VT_COUNT_VALID_BEFORE the value is valid until and at the current time.
VT_COUNT_VALID_POINT the value is valid exactly at the current time, and no value is available
before or after it.
VT_COUNT_VALID_AFTER the value is valid at and after the current time.
VT_COUNT_VALID_SAMPLE the value is valid at the current time and samples a curve, so for
example, linear interpolation between sample values is possible
VT_COUNT_SCOPE mask to extract the scope.
•
the counter's target, that is the process or group of processes it belongs to
(VT_GROUP_THREAD for a thread-local counter, VT_GROUP_PROCESS for a process-local
counter, or an arbitrary previously defined group handle)
•
the lower and upper bounds
•
the counter's unit (an arbitrary string like FLOP, Mbytes)
int VT_countdef (const char * name, int classhandle, int genre, int target,
const void * bounds, const char * unit, int * counterhandle)
Define a counter and get handle for it.
Counters are identified by their name (string) alone.
Fortran:
VTCOUNTDEF(name, classhandle, genre, target, bounds[], unit, counterhandle,
ierr)
Parameters:
name string identifying the counter
classhandle class to group counters, handle must have been retrieved by VT_classdef
genre bitwise or of one value from VT_CountScope, VT_CountDisplay and VT_CountData
target target which the counter refers to (VT_ME, VT_GROUP_THREAD, VT_GROUP_PROCESS,
VT_GROUP_CLUSTER or thread/process-id or user-defined group handle).
bounds array of lower and upper bounds (2x 64 bit float, 2x2 32 bit integer, 2x 64 bit integer >16 byte)
unit string identifying the unit for the counter (like Volt, pints etc.)
118