PAPI_get_virt_usec

NAME

PAPI_get_virt_usec -

get virtual time counter values in microseconds

SYNOPSIS

Detailed Description

Return values:

PAPI_ECNFLCT If there is no master event set. This will happen if the library has not been initialized, or for threaded applications, if there has been no thread id function defined by the PAPI_thread_init function.
PAPI_ENOMEM For threaded applications, if there has not yet been any thread specific master event created for the current thread, and if the allocation of such an event set fails, the call will return PAPI_ENOMEM or PAPI_ESYS .

This function returns the total number of virtual units from some arbitrary starting point. Virtual units accrue every time the process is running in user-mode on behalf of the process. Like the real time counters, this count is guaranteed to exist on every platform PAPI supports. However on some platforms, the resolution can be as bad as 1/Hz as defined by the operating system.

Examples:

s = PAPI_get_virt_cyc();
your_slow_code();
e = PAPI_get_virt_cyc();
printf("Process has run for cycles: %lld\n",e-s);

See Also:

PAPIF

PAPI

PAPI

PAPI_get_real_cyc

PAPI_get_virt_cyc

Author

Generated automatically by Doxygen for PAPI from the source code.