.TH "PAPI_disable_component_by_name" 3 "Mon Dec 18 2017" "Version 5.6.0.0" "PAPI" \" -*- nroff -*-

.ad l

.nh

.SH NAME

PAPI_disable_component_by_name \- 

.PP

disables the named component  

.SH SYNOPSIS

.br

.PP

.SH "Detailed Description"

.PP 

.PP

.nf

\retval ENOCMP

    component does not exist

\retval ENOINIT

    unable to disable the component, the library has already been initialized

\param component_name

    name of the component to disable.

\par Example:

.fi

.PP

.PP

.nf

   int result;

   result = PAPI_disable_component_by_name("example");

   if (result==PAPI_OK)

    printf("component \"example\" has been disabled\n");

   //\&.\&.\&.

   PAPI_library_init(PAPI_VER_CURRENT);

*   

.fi

.PP

 \fBPAPI_disable_component_by_name()\fP allows the user to disable a component before \fBPAPI_library_init()\fP time\&. This is useful if the user knows they do not with to use events from that component and want to reduce the PAPI library overhead\&.

.PP

\fBPAPI_disable_component_by_name()\fP must be called before \fBPAPI_library_init()\fP\&.

.PP

\fBSee Also:\fP

.RS 4

\fBPAPI_library_init\fP 

.PP

\fBPAPI_disable_component\fP 

.RE

.PP

.SH "Author"

.PP 

Generated automatically by Doxygen for PAPI from the source code\&.