Blame man/man3/PAPI_get_virt_usec.3
|
Packit |
577717 |
.TH "PAPI_get_virt_usec" 3 "Mon Dec 18 2017" "Version 5.6.0.0" "PAPI" \" -*- nroff -*-
|
|
Packit |
577717 |
.ad l
|
|
Packit |
577717 |
.nh
|
|
Packit |
577717 |
.SH NAME
|
|
Packit |
577717 |
PAPI_get_virt_usec \-
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
get virtual time counter values in microseconds
|
|
Packit |
577717 |
|
|
Packit |
577717 |
.SH SYNOPSIS
|
|
Packit |
577717 |
.br
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
.SH "Detailed Description"
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
.nf
|
|
Packit |
577717 |
@retval PAPI_ECNFLCT
|
|
Packit |
577717 |
If there is no master event set.
|
|
Packit |
577717 |
This will happen if the library has not been initialized, or for threaded
|
|
Packit |
577717 |
applications, if there has been no thread id function defined by the
|
|
Packit |
577717 |
PAPI_thread_init function.
|
|
Packit |
577717 |
@retval PAPI_ENOMEM
|
|
Packit |
577717 |
For threaded applications, if there has not yet been any thread
|
|
Packit |
577717 |
specific master event created for the current thread, and if the
|
|
Packit |
577717 |
allocation of such an event set fails, the call will return PAPI_ENOMEM or PAPI_ESYS .
|
|
Packit |
577717 |
|
|
Packit |
577717 |
This function returns the total number of virtual units from some
|
|
Packit |
577717 |
arbitrary starting point.
|
|
Packit |
577717 |
Virtual units accrue every time the process is running in user-mode on
|
|
Packit |
577717 |
behalf of the process.
|
|
Packit |
577717 |
Like the real time counters, this count is guaranteed to exist on every
|
|
Packit |
577717 |
platform PAPI supports. However on some platforms, the resolution can be
|
|
Packit |
577717 |
as bad as 1/Hz as defined by the operating system.
|
|
Packit |
577717 |
@par Examples:
|
|
Packit |
577717 |
|
|
Packit |
577717 |
.fi
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
.nf
|
|
Packit |
577717 |
s = PAPI_get_virt_cyc();
|
|
Packit |
577717 |
your_slow_code();
|
|
Packit |
577717 |
e = PAPI_get_virt_cyc();
|
|
Packit |
577717 |
printf("Process has run for cycles: %lld\en",e-s);
|
|
Packit |
577717 |
*
|
|
Packit |
577717 |
|
|
Packit |
577717 |
.fi
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
\fBSee Also:\fP
|
|
Packit |
577717 |
.RS 4
|
|
Packit |
577717 |
PAPIF
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
PAPI
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
PAPI
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
\fBPAPI_get_real_cyc\fP
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
\fBPAPI_get_virt_cyc\fP
|
|
Packit |
577717 |
.RE
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
|
|
Packit |
577717 |
|
|
Packit |
577717 |
.SH "Author"
|
|
Packit |
577717 |
.PP
|
|
Packit |
577717 |
Generated automatically by Doxygen for PAPI from the source code\&.
|