Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

papi_set_granularity(3) [centos man page]

PAPI_set_granularity(3) 					       PAPI						   PAPI_set_granularity(3)

NAME

       PAPI_set_granularity -

       Set the default counting granularity for eventsets bound to the cpu component.

SYNOPSIS

Detailed Description
       @par C Prototype:
	       int PAPI_set_granularity( int granularity );

       @param -- granularity one of the following constants as defined in the papi.h header file
       @arg PAPI_GRN_THR   -- Count each individual thread
       @arg PAPI_GRN_PROC  -- Count each individual process
       @arg PAPI_GRN_PROCG -- Count each individual process group
       @arg PAPI_GRN_SYS   -- Count the current CPU
       @arg PAPI_GRN_SYS_CPU   -- Count all CPUs individually
       @arg PAPI_GRN_MIN   -- The finest available granularity
       @arg PAPI_GRN_MAX   -- The coarsest available granularity

       Return values:
	   PAPI_OK
	   PAPI_EINVAL One or more of the arguments is invalid.

       PAPI_set_granularity sets the default counting granularity for all new event sets created by PAPI_create_eventset. This call implicitly
       sets the granularity for the cpu component (component 0) and is included to preserve backward compatibility.

       Example:

	   int ret;

	   // Initialize the library
	   ret = PAPI_library_init(PAPI_VER_CURRENT);
	   if (ret > 0 && ret != PAPI_VER_CURRENT) {
	     fprintf(stderr,"PAPI library version mismatch!0);
	     exit(1);
	   }
	   if (ret < 0) handle_error(ret);

	   // Set the default granularity for the cpu component
	   ret = PAPI_set_granularity(PAPI_GRN_PROC);
	   if (ret != PAPI_OK) handle_error(ret);
	   ret = PAPI_create_eventset(&EventSet);
	   if (ret != PAPI_OK) handle_error(ret);
	    *

       See Also:
	   PAPI_set_cmp_granularity PAPI_set_domain PAPI_set_opt PAPI_get_opt

Author
       Generated automatically by Doxygen for PAPI from the source code.

Version 5.2.0.0 						  Tue Jun 17 2014					   PAPI_set_granularity(3)

Check Out this Related Man Page

PAPI_reset(3)							       PAPI							     PAPI_reset(3)

NAME

       PAPI_reset -

       Reset the hardware event counts in an event set.

SYNOPSIS

Detailed Description
       @par C Prototype:
	       int PAPI_reset( int EventSet );

       @param EventSet
	   an integer handle for a PAPI event set as created by PAPI_create_eventset

       @retval PAPI_OK
       @retval PAPI_ESYS
	   A system or C library call failed inside PAPI, see the errno variable.
       @retval PAPI_ENOEVST
	   The EventSet specified does not exist.

       PAPI_reset() zeroes the values of the counters contained in EventSet.
       This call assumes an initialized PAPI library and a properly added event set

       @par Example:

       int EventSet = PAPI_NULL;
       int Events[] = {PAPI_TOT_INS, PAPI_FP_OPS};
       int ret;

       // Create an empty EventSet
       ret = PAPI_create_eventset(&EventSet);
       if (ret != PAPI_OK) handle_error(ret);

       // Add two events to our EventSet
       ret = PAPI_add_events(EventSet, Events, 2);
       if (ret != PAPI_OK) handle_error(ret);

       // Start counting
       ret = PAPI_start(EventSet);
       if (ret != PAPI_OK) handle_error(ret);

       // Stop counting, ignore values
       ret = PAPI_stop(EventSet, NULL);
       if (ret != PAPI_OK) handle_error(ret);

       // reset the counters in this EventSet
       ret = PAPI_reset(EventSet);
       if (ret != PAPI_OK) handle_error(ret);
	*

       See Also:
	   PAPI_create_eventset

Author
       Generated automatically by Doxygen for PAPI from the source code.

Version 5.2.0.0 						  Tue Jun 17 2014						     PAPI_reset(3)
Man Page