Blame man/man3/PAPI_disable_component.3
Branch: 7c646474b00c26d88b9457b24a580936e614b216
Packit
577717
.TH "PAPI_disable_component" 3 "Mon Dec 18 2017" "Version 5.6.0.0" "PAPI" \" -*- nroff -*-
Packit
577717
.ad l
Packit
577717
.nh
Packit
577717
.SH NAME
Packit
577717
PAPI_disable_component \-
Packit
577717
.PP
Packit
577717
disables the specified component
Packit
577717
Packit
577717
.SH SYNOPSIS
Packit
577717
.br
Packit
577717
.PP
Packit
577717
.SH "Detailed Description"
Packit
577717
.PP
Packit
577717
Packit
577717
.PP
Packit
577717
.nf
Packit
577717
@retval ENOCMP
Packit
577717
component does not exist
Packit
577717
@retval ENOINIT
Packit
577717
cannot disable as PAPI has already been initialized
Packit
577717
Packit
577717
@param cidx
Packit
577717
component index of component to be disabled
Packit
577717
@par Examples:
Packit
577717
Packit
577717
.fi
Packit
577717
.PP
Packit
577717
Packit
577717
.PP
Packit
577717
.nf
Packit
577717
int cidx, result;
Packit
577717
Packit
577717
cidx = PAPI_get_component_index("example");
Packit
577717
Packit
577717
if (cidx>=0) {
Packit
577717
result = PAPI_disable_component(cidx);
Packit
577717
if (result==PAPI_OK)
Packit
577717
printf("The example component is disabled\n");
Packit
577717
}
Packit
577717
// \&.\&.\&.
Packit
577717
PAPI_library_init();
Packit
577717
*
Packit
577717
Packit
577717
.fi
Packit
577717
.PP
Packit
577717
\fBPAPI_disable_component()\fP allows the user to disable components before \fBPAPI_library_init()\fP time\&. This is useful if the user knows they do not wish to use events from that component and want to reduce the PAPI library overhead\&.
Packit
577717
.PP
Packit
577717
\fBPAPI_disable_component()\fP must be called before \fBPAPI_library_init()\fP\&.
Packit
577717
.PP
Packit
577717
\fBSee Also:\fP
Packit
577717
.RS 4
Packit
577717
\fBPAPI_get_event_component\fP
Packit
577717
.PP
Packit
577717
\fBPAPI_library_init\fP
Packit
577717
.RE
Packit
577717
.PP
Packit
577717
Packit
577717
Packit
577717
.SH "Author"
Packit
577717
.PP
Packit
577717
Generated automatically by Doxygen for PAPI from the source code\&.