papi_set_cmp_domain(3) [centos man page]

PAPI_set_cmp_domain(3)						       PAPI						    PAPI_set_cmp_domain(3)

NAME

       PAPI_set_cmp_domain -

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

SYNOPSIS

Detailed Description
       @par C Prototype:
	       int PAPI_set_cmp_domain( int domain, int  cidx );

       @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
       @arg PAPI_DOM_HWSPEC Something other than CPU like stuff. Individual components can decode
       low order bits for more meaning

       @param cidx
	   An integer identifier for a component.
	   By convention, component 0 is always the cpu component.

       Return values:
	   PAPI_OK
	   PAPI_EINVAL One or more of the arguments is invalid.
	   PAPI_ENOCMP The argument cidx is not a valid component.

       PAPI_set_cmp_domain sets the default counting domain for all new event sets in all threads, and requires an explicit component argument.
       Event sets that are already in existence are not affected. To change the domain of an existing event set, please see PAPI_set_opt. The
       reader should note that the domain of an event set affects only the mode in which the counter continues to run. Counts are still aggregated
       for the current process, and not for any other processes in the system. Thus when requesting PAPI_DOM_KERNEL , the user is asking for
       events that occur on behalf of the process, inside the kernel.

       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_cmp_domain(PAPI_DOM_KERNEL,0);
	   if (ret != PAPI_OK) handle_error(ret);
	   ret = PAPI_create_eventset(&EventSet);
	   if (ret != PAPI_OK) handle_error(ret);
	    *

       See Also:
	   PAPI_set_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_cmp_domain(3)

Check Out this Related Man Page

PAPI_get_multiplex(3)						       PAPI						     PAPI_get_multiplex(3)

NAME

       PAPI_get_multiplex -

       Get the multiplexing status of specified event set.

SYNOPSIS

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

       Fortran Interface:
	   #include fpapi.h
	    PAPIF_get_multiplex( C_INT	EventSet,  C_INT  check )

       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, or the EventSet is already multiplexed.
	   PAPI_ENOEVST The EventSet specified does not exist.
	   PAPI_EISRUN The EventSet is currently counting events.
	   PAPI_ENOMEM Insufficient memory to complete the operation.

       PAPI_get_multiplex tests the state of the PAPI_MULTIPLEXING flag in the specified event set, returning TRUE if a PAPI event set is
       multiplexed, or FALSE if not.

       Example:

	   *   int EventSet = PAPI_NULL;
	   *   int ret;
	   *
	   *   // Create an empty EventSet
	   *   ret = PAPI_create_eventset(&EventSet);
	   *   if (ret != PAPI_OK) handle_error(ret);
	   *
	   *   // Bind it to the CPU component
	   *   ret = PAPI_assign_eventset_component(EventSet, 0);
	   *   if (ret != PAPI_OK) handle_error(ret);
	   *
	   *   // Check  current multiplex status
	   *   ret = PAPI_get_multiplex(EventSet);
	   *   if (ret == TRUE) printf("This event set is ready for multiplexing.")
	   *   if (ret == FALSE) printf("This event set is not enabled for multiplexing.")
	   *   if (ret < 0) handle_error(ret);
	   *
	   *   // Turn on multiplexing
	   *   ret = PAPI_set_multiplex(EventSet);
	   *   if ((ret == PAPI_EINVAL) && (PAPI_get_multiplex(EventSet) == TRUE))
	   *	 printf("This event set already has multiplexing enabled0);
	   *   else if (ret != PAPI_OK) handle_error(ret);
	   *

       See Also:
	   PAPI_multiplex_init

	   PAPI_set_opt

	   PAPI_create_eventset

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

Version 5.2.0.0 						  Tue Jun 17 2014					     PAPI_get_multiplex(3)

Linux and UNIX Man Pages

papi_set_cmp_domain(3) [centos man page]

Check Out this Related Man Page