papi_set_multiplex(3) [centos man page]

PAPI_set_multiplex(3)						       PAPI						     PAPI_set_multiplex(3)

NAME

       PAPI_set_multiplex -

       Convert a standard event set to a multiplexed event set.

SYNOPSIS

Detailed Description
       C Interface:
	   #include <papi.h>
	    int PAPI_set_multiplex( 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, or the EventSet is already multiplexed.
	   PAPI_ENOCMP -- The EventSet specified is not yet bound to a component.
	   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_set_multiplex converts a standard PAPI event set created by a call to PAPI_create_eventset into an event set capable of handling
       multiplexed events. This must be done after calling PAPI_multiplex_init, and either PAPI_add_event or PAPI_assign_eventset_component, but
       prior to calling PAPI_start().

       Events can be added to an event set either before or after converting it into a multiplexed set, but the conversion must be done prior to
       using it as a multiplexed set.

       Note:
	   Multiplexing can't be enabled until PAPI knows which component is targeted. Due to the late binding nature of PAPI event sets, this
	   only happens after adding an event to an event set or explicitly binding the component with a call to PAPI_assign_eventset_component.

       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_get_multiplex

	   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_set_multiplex(3)

Check Out this Related Man Page

PAPI_detach(3)							       PAPI							    PAPI_detach(3)

NAME

       PAPI_detach -

       Detach PAPI event set from previously specified thread id and restore to executing thread.

SYNOPSIS

Detailed Description
       @par C Interface:
       int PAPI_detach( int  EventSet, unsigned long  tid );

       PAPI_detach is a wrapper function that calls PAPI_set_opt to allow PAPI to
       monitor performance counts on a thread other than the one currently executing.
       This is sometimes referred to as third party monitoring.
       PAPI_attach connects the specified EventSet to the specifed thread;
       PAPI_detach breaks that connection and restores the EventSet to the
       original executing thread.

       @param EventSet
	   An integer handle for a PAPI EventSet as created by PAPI_create_eventset.
       @param tid
	   A thread id as obtained from, for example, PAPI_list_threads or PAPI_thread_id.

       @retval PAPI_ECMP
	   This feature is unsupported on this component.
       @retval PAPI_EINVAL
	   One or more of the arguments is invalid.
       @retval PAPI_ENOEVST
	   The event set specified does not exist.
       @retval PAPI_EISRUN
	   The event set is currently counting events.

       @par Examples:

       *   int EventSet = PAPI_NULL;
       *   unsigned long pid;
       *   pid = fork( );
       *   if ( pid <= 0 )
       *   exit( 1 );
       *   if ( PAPI_create_eventset( &EventSet ) != PAPI_OK )
       *   exit( 1 );
       *   // Add Total Instructions Executed to our EventSet
       *   if ( PAPI_add_event( EventSet, PAPI_TOT_INS ) != PAPI_OK )
       *   exit( 1 );
       *   // Attach this EventSet to the forked process
       *   if ( PAPI_attach( EventSet, pid ) != PAPI_OK )
       *   exit( 1 );
       *

       See Also:
	   PAPI_set_opt
	    PAPI_list_threads
	    PAPI_thread_id
	    PAPI_thread_init

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

Version 5.2.0.0 						  Tue Jun 17 2014						    PAPI_detach(3)

Linux and UNIX Man Pages

papi_set_multiplex(3) [centos man page]

Check Out this Related Man Page