cpc_open, cpc_close - initialize the CPU Performance Counter library
cc [ flag... ] file... -lcpc [ library... ]
cpc_t *cpc_open(int vers);
int cpc_close(cpc_t *cpc);
The cpc_open() function initializes libcpc(3LIB) and returns an identi‐
fier that must be used as the cpc argument in subsequent libcpc func‐
tion calls. The cpc_open() function takes an interface version as an
argument and returns NULL if that version of the interface is incompat‐
ible with the libcpc implementation present on the system. Usually,
the argument has the value of CPC_VER_CURRENT bound to the application
when it was compiled.
The cpc_close() function releases all resources associated with the cpc
argument. Any bound counters utilized by the process are unbound. All
entities of type cpc_set_t and cpc_buf_t are invalidated and destroyed.
If the version requested is supported by the implementation, cpc_open()
returns a cpc_t handle for use in all subsequent libcpc operations. If
the implementation cannot support the version needed by the applica‐
tion, cpc_open() returns NULL, indicating that the application at least
needs to be recompiled to operate correctly on the new platform and
might require further changes.
The cpc_close() function always returns 0.
These functions will fail if:
The version requested by the client is incompatible with the
See attributes(5) for descriptions of the following attributes:
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
│Interface Stability │ Evolving │
│MT-Level │ Safe │
SEE ALSOlibcpc(3LIB), attributes(5)
Jan 30, 2004 CPC_OPEN(3CPC)