cpc_open(3CPC)					    CPU Performance Counters Library Functions					    cpc_open(3CPC)

NAME

       cpc_open, cpc_close - initialize the CPU Performance Counter library

SYNOPSIS

       cc [ flag... ] file... -lcpc [ library... ]
       #include <libcpc.h>

       cpc_t *cpc_open(int vers);

       int cpc_close(cpc_t *cpc);

DESCRIPTION

       The cpc_open() function initializes libcpc(3LIB) and returns an identifier 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  incom-
       patible	with the libcpc implementation present on the system. Usually, the argument has the value of CPC_VER_CURRENT bound to the applica-
       tion 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.

RETURN VALUES

       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 application, 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.

ERRORS

       These functions will fail if:

       EINVAL	       The version requested by the client is incompatible with the implementation.

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       libcpc(3LIB), attributes(5)

SunOS 5.10							    30 Jan 2004 						    cpc_open(3CPC)