Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

papi_start_counters(3) [centos man page]

PAPI_start_counters(3)						       PAPI						    PAPI_start_counters(3)

NAME
PAPI_start_counters - Start counting hardware events. SYNOPSIS
Detailed Description @par C Interface: int PAPI_start_counters( int *events, int array_len ); Parameters: *events an array of codes for events such as PAPI_INT_INS or a native event code array_len the number of items in the *events array Return values: PAPI_EINVAL One or more of the arguments is invalid. PAPI_EISRUN Counters have already been started, you must call PAPI_stop_counters() before you call this function again. PAPI_ESYS A system or C library call failed inside PAPI, see the errno variable. PAPI_ENOMEM Insufficient memory to complete the operation. PAPI_ECNFLCT The underlying counter hardware cannot count this event and other events in the EventSet simultaneously. PAPI_ENOEVNT The PAPI preset is not available on the underlying hardware. PAPI_start_counters() starts counting the events named in the *events array. This function cannot be called if the counters have already been started. The user must call PAPI_stop_counters() to stop the events explicitly if he/she wants to call this function again. It is the user's responsibility to choose events that can be counted simultaneously by reading the vendor's documentation. The length of the *events array should be no longer than the value returned by PAPI_num_counters(). if( PAPI_start_counters( Events, num_hwcntrs ) != PAPI_OK ) handle_error(1); * See Also: PAPI_stop_counters() PAPI_add_event() PAPI_create_eventset() Author Generated automatically by Doxygen for PAPI from the source code. Version 5.2.0.0 Tue Jun 17 2014 PAPI_start_counters(3)

Check Out this Related Man Page

PAPI_read_counters(3)						       PAPI						     PAPI_read_counters(3)

NAME
PAPI_read_counters - Read and reset counters. SYNOPSIS
Detailed Description @par C Interface: int PAPI_read_counters( long long *values, int array_len ); Parameters: *values an array to hold the counter values of the counting events arry_len the number of items in the *events array Precondition: These calls assume an initialized PAPI library and a properly added event set. Postcondition: The counters are reset and left running after the call. Return values: PAPI_EINVAL One or more of the arguments is invalid. PAPI_ESYS A system or C library call failed inside PAPI, see the errno variable. PAPI_read_counters() copies the event counters into the array *values. do_100events(); if ( PAPI_read_counters( values, num_hwcntrs ) != PAPI_OK ) handlw_error(1); // values[0] now equals 100 do_100events(); if ( PAPI_accum_counters( values, num_hwcntrs ) != PAPI_OK ) handle_error(1); // values[0] now equals 200 values[0] = -100; do_100events(); if ( PAPI_accum_counters(values, num_hwcntrs ) != PAPI_OK ) handle_error(); // values[0] now equals 0 * See Also: PAPI_set_opt() PAPI_start_counters() Fortran Interface: #include 'fpapi.h' PAPIF_read_counters( C_LONG_LONG(*) values, C_INT array_len, C_INT check ) See Also: PAPI_read_counters Author Generated automatically by Doxygen for PAPI from the source code. Version 5.2.0.0 Tue Jun 17 2014 PAPI_read_counters(3)
Man Page