NAME

PAPI_multiplex_init - initialize multiplex support in the PAPI library

CONTENTS

Synopsis
Description
Return Values
Errors
Examples
Authors
Bugs
See Also

SYNOPSIS

C Interface

#include <papi.h> 

int PAPI_multiplex_init (void); 

Fortran Interface

#include fpapi.h 

PAPIF_multiplex_init(C_INT check) 

DESCRIPTION

PAPI_multiplex_init enables and initializes multiplex support in the PAPI library. This allows a user to count more events than total physical counters by time sharing the existing counters at some loss in precision. Applications that make no use of multiplexing do not need to call this routine.

RETURN VALUES

On success, this function returns PAPI_OK.
On error, a non-zero error code is returned.

ERRORS

PAPI_EINVAL
  One or more of the arguments is invalid.

EXAMPLES


  /* Initialize the library */

retval = PAPI_library_init(PAPI_VER_CURRENT); if (retval != PAPI_VER_CURRENT) handle_error("PAPI_library_init",__LINE__,retval);

/* Enable multiplexing support */

retval = PAPI_multiplex_init(); if (retval != PAPI_OK) handle_error("PAPI_multiplex_init",__LINE__,retval); /* Turn on thread support in PAPI */

if (PAPI_thread_init((unsigned long (*)(void))(pthread_self), 0) != PAPI_OK) handle_error("PAPI_thread_init",__LINE__,retval);

AUTHORS

The PAPI Team. See them at the PAPI Web Site: http://icl.cs.utk.edu/projects/papi

BUGS

This function causes the application to exit if it is called more than once.

SEE ALSO

PAPI_set_multiplex (3)


PAPI Programmer’s Reference PAPI_multiplex_init (3) November, 2003

  Innovative Computing Laboratory
2001 R&D Winner  
Contact PAPI: papi@cs.utk.edu Computer Science Department
  University of Tennessee