Manual Pages for UNIX Operating System command usage for man cpc_close

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 

     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 sub-
     sequent libcpc function calls. The cpc_open() function takes
     an interface version as an argument and returns NULL if that
     version of the interface is  incompatible  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.

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  recom-
     piled  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  incompati-
               ble with the implementation.


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



SunOS 5.11          Last change: 30 Jan 2004                    1






CPU Performance Counters Library Functions         cpc_open(3CPC)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | Safe                        |
    |_____________________________|_____________________________|


SEE ALSO
     libcpc(3LIB), attributes(5)












































SunOS 5.11          Last change: 30 Jan 2004                    2