Blame man/man3/PAPI_flips.3

Packit Service a1973e
.TH "PAPI_flips" 3 "Mon Dec 18 2017" "Version 5.6.0.0" "PAPI" \" -*- nroff -*-
Packit Service a1973e
.ad l
Packit Service a1973e
.nh
Packit Service a1973e
.SH NAME
Packit Service a1973e
PAPI_flips \- 
Packit Service a1973e
.PP
Packit Service a1973e
Simplified call to get Mflips/s (floating point instruction rate), real and processor time\&.  
Packit Service a1973e
Packit Service a1973e
.SH SYNOPSIS
Packit Service a1973e
.br
Packit Service a1973e
.PP
Packit Service a1973e
.SH "Detailed Description"
Packit Service a1973e
.PP 
Packit Service a1973e
Packit Service a1973e
.PP
Packit Service a1973e
\fBC Interface: \fP
Packit Service a1973e
.RS 4
Packit Service a1973e
#include <\fBpapi\&.h\fP> 
Packit Service a1973e
.br
Packit Service a1973e
int \fBPAPI_flips( float *rtime, float *ptime, long long *flpins, float *mflips )\fP;
Packit Service a1973e
.RE
Packit Service a1973e
.PP
Packit Service a1973e
\fBParameters:\fP
Packit Service a1973e
.RS 4
Packit Service a1973e
\fI*rtime\fP total realtime since the first call 
Packit Service a1973e
.br
Packit Service a1973e
\fI*ptime\fP total process time since the first call 
Packit Service a1973e
.br
Packit Service a1973e
\fI*flpins\fP total floating point instructions since the first call 
Packit Service a1973e
.br
Packit Service a1973e
\fI*mflips\fP incremental (Mega) floating point instructions per seconds since the last call
Packit Service a1973e
.RE
Packit Service a1973e
.PP
Packit Service a1973e
\fBReturn values:\fP
Packit Service a1973e
.RS 4
Packit Service a1973e
\fIPAPI_EINVAL\fP The counters were already started by something other than \fBPAPI_flips()\fP\&. 
Packit Service a1973e
.br
Packit Service a1973e
\fIPAPI_ENOEVNT\fP The floating point instructions event does not exist\&. 
Packit Service a1973e
.br
Packit Service a1973e
\fIPAPI_ENOMEM\fP Insufficient memory to complete the operation\&.
Packit Service a1973e
.RE
Packit Service a1973e
.PP
Packit Service a1973e
The first call to \fBPAPI_flips()\fP will initialize the PAPI High Level interface, set up the counters to monitor the PAPI_FP_INS event and start the counters\&.
Packit Service a1973e
.PP
Packit Service a1973e
Subsequent calls will read the counters and return total real time, total process time, total floating point instructions since the start of the measurement and the Mflip/s rate since latest call to \fBPAPI_flips()\fP\&. A call to \fBPAPI_stop_counters()\fP will stop the counters from running and then calls such as \fBPAPI_start_counters()\fP or other rate calls can safely be used\&.
Packit Service a1973e
.PP
Packit Service a1973e
\fBPAPI_flips\fP returns information related to floating point instructions using the PAPI_FP_INS event\&. This is intended to measure instruction rate through the floating point pipe with no massaging\&.
Packit Service a1973e
.PP
Packit Service a1973e
\fBSee Also:\fP
Packit Service a1973e
.RS 4
Packit Service a1973e
\fBPAPI_flops()\fP 
Packit Service a1973e
.PP
Packit Service a1973e
\fBPAPI_ipc()\fP 
Packit Service a1973e
.PP
Packit Service a1973e
\fBPAPI_epc()\fP 
Packit Service a1973e
.PP
Packit Service a1973e
\fBPAPI_stop_counters()\fP 
Packit Service a1973e
.RE
Packit Service a1973e
.PP
Packit Service a1973e
Packit Service a1973e
Packit Service a1973e
.SH "Author"
Packit Service a1973e
.PP 
Packit Service a1973e
Generated automatically by Doxygen for PAPI from the source code\&.