NAME

PAPI_ipc - PAPI High level: Simplified call to get instructions per cycle, real and processor time

CONTENTS

Synopsis
Description
Arguments
Return Values
Errors
Examples
Authors
Bugs
See Also

SYNOPSIS

C Interface

#include <papi.h> 

int PAPI_ipc (float *rtime, float *ptime, long_long *ins, float *ipc); 

Fortran Interface

#include fpapi.h 

PAPIF_ipc(C_FLOAT real_time, C_FLOAT proc_time, C_LONG_LONG ins, C_FLOAT ipc, C_INT check) 

DESCRIPTION

The first call to PAPI_ipc() will initialize the PAPI High Level interface, set up the counters to monitor PAPI_TOT_INS and PAPI_TOT_CYC events and start the counters. Subsequent calls will read the counters and return total real time, total process time, total instructions since the start of the measurement and the instructions per cycle rate since latest call to PAPI_ipc().

ARGUMENTS

*rtime -- total realtime since the first PAPI_ipc() call

*ptime -- total process time since the first PAPI_ipc() call

*ins -- total instructions since the first call

*ipc -- instructions per cycle achieved since the previous call

RETURN VALUES

On success, this function returns PAPI_OK.
On error, a non-zero error code is returned.

ERRORS

EXAMPLES

AUTHORS

The PAPI Team. See them at the PAPI Web Site: http://icl.cs.utk.edu/projects/papi

BUGS

This function has no known bugs.

SEE ALSO

PAPI_accum (3) , PAPI_flips (3) , PAPI_flops (3)


PAPI Programmer’s Reference PAPI_ipc (3) November, 2003

  Innovative Computing Laboratory
2001 R&D Winner  
Contact PAPI: papi@cs.utk.edu Computer Science Department
  University of Tennessee