Blame man/man3/PAPI_flips.3
Branch: 552d6d1af62cc0295a89fc10924aca25b9f08f2e
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\&.