xref: /illumos-gate/usr/src/man/man3lib/libcpc.3lib (revision 6140ef003e4253c1c1f0b9c100687487e4f1954b)
te
Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved.
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
libcpc 3LIB "8 Oct 2008" "SunOS 5.11" "Interface Libraries"
NAME
libcpc - CPU performance counter library
SYNOPSIS

cc [ flag... ] file... -lcpc [ library... ] 
DESCRIPTION

Functions in this library provide access to CPU performance counters on platforms that contain the appropriate hardware.

INTERFACES

The shared object libcpc.so.1 provides the public interfaces defined below. See Intro(3) for additional information on shared object interfaces.

cpc_accesscpc_bind_cpu
cpc_bind_curlwpcpc_bind_event
cpc_bind_pctxcpc_buf_add
cpc_buf_copycpc_buf_create
cpc_buf_destroycpc_buf_get
cpc_buf_hrtimecpc_buf_set
cpc_buf_subcpc_buf_tick
cpc_buf_zerocpc_caps
cpc_ccinamecpc_close
cpc_cpurefcpc_count_sys_events
cpc_count_usr_eventscpc_disable
cpc_enablecpc_event_accum
cpc_event_diffcpc_eventtostr
cpc_getccinamecpc_getcpuref
cpc_getcpuvercpc_getnpic
cpc_getusagecpc_npic
cpc_opencpc_pctx_bind_event
cpc_pctx_invalidatecpc_pctx_rele
cpc_pctx_take_samplecpc_rele
cpc_request_presetcpc_set_add_request
cpc_set_createcpc_set_destroy
cpc_set_restartcpc_set_sample
cpc_seterrfncpc_seterrhndlr
cpc_shared_bind_eventcpc_shared_close
cpc_shared_opencpc_shared_rele
cpc_shared_take_samplecpc_strtoevent
cpc_take_samplecpc_unbind
cpc_versioncpc_walk_attrs
cpc_walk_events_allcpc_walk_events_pic
cpc_walk_generic_events_allcpc_walk_generic_events_pic
cpc_walk_namescpc_walk_requests
FILES

/usr/lib/libcpc.so.1

shared object

/usr/lib/64/libcpc.so.1

64-bit shared object

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
MT-LevelSafe
SEE ALSO

cputrack(1), cpustat(1M), Intro(3), cpc(3CPC), attributes(5), xVM(5)

NOTES

There is no support for access to performance counters in the xVM(5) environment. The -h operations for cputrack(1) are not enabled.