papi_set_domain(3) [centos man page]

PAPI_set_domain(3)						       PAPI							PAPI_set_domain(3)

NAME

       PAPI_set_domain -

       Set the default counting domain for new event sets bound to the cpu component.

SYNOPSIS

Detailed Description
       @par C Prototype:
	       int PAPI_set_domain( int domain );

       @param domain one of the following constants as defined in the papi.h header file
       @arg PAPI_DOM_USER User context counted
       @arg PAPI_DOM_KERNEL  Kernel/OS context counted
       @arg PAPI_DOM_OTHER Exception/transient mode counted
       @arg PAPI_DOM_SUPERVISOR Supervisor/hypervisor context counted
       @arg PAPI_DOM_ALL All above contexts counted
       @arg PAPI_DOM_MIN The smallest available context
       @arg PAPI_DOM_MAX The largest available context

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

       PAPI_set_domain sets the default counting domain for all new event sets created by PAPI_create_eventset in all threads. This call
       implicitly sets the domain 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 domain for the cpu component
	   ret = PAPI_set_domain(PAPI_DOM_KERNEL);
	   if (ret != PAPI_OK) handle_error(ret);
	   ret = PAPI_create_eventset(&EventSet);
	   if (ret != PAPI_OK) handle_error(ret);
	    *

       See Also:
	   PAPI_set_cmp_domain PAPI_set_granularity 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_domain(3)

PAPI_start(3)							       PAPI							     PAPI_start(3)

NAME

       PAPI_start -

       Start counting hardware events in an event set.

SYNOPSIS

Detailed Description
       C Interface:
	   #include <papi.h>
	    int PAPI_start( int  EventSet );

       Parameters:
	   EventSet -- an integer handle for a PAPI event set as created by PAPI_create_eventset

       Return values:
	   PAPI_OK
	   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_ENOEVST -- The EventSet specified does not exist.
	   PAPI_EISRUN -- The EventSet is currently counting events.
	   PAPI_ECNFLCT -- The underlying counter hardware can not count this event and other events in the EventSet simultaneously.
	   PAPI_ENOEVNT -- The PAPI preset is not available on the underlying hardware.

       PAPI_start starts counting all of the hardware events contained in the previously defined EventSet. All counters are implicitly set to zero
       before counting. Assumes an initialized PAPI library and a properly added event set.

       Example:

	   *  int EventSet = PAPI_NULL;
	   *  long long values[2];
	   *  int ret;
	   *
	   *  ret = PAPI_create_eventset(&EventSet);
	   *  if (ret != PAPI_OK) handle_error(ret);
	   *
	   *  // Add Total Instructions Executed to our EventSet
	   *  ret = PAPI_add_event(EventSet, PAPI_TOT_INS);
	   *  if (ret != PAPI_OK) handle_error(ret);
	   *
	   *  // Start counting
	   *  ret = PAPI_start(EventSet);
	   *  if (ret != PAPI_OK) handle_error(ret);
	   *  poorly_tuned_function();
	   *  ret = PAPI_stop(EventSet, values);
	   *  if (ret != PAPI_OK) handle_error(ret);
	   *  printf("%lld
",values[0]);
	   *

       See Also:
	   PAPI_create_eventset PAPI_add_event PAPI_stop

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

Version 5.2.0.0 						  Tue Jun 17 2014						     PAPI_start(3)