.TH "PAPI_disable_component_by_name" 3 "Fri Feb 22 2019" "Version 5.7.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\&.