Manual Pages for UNIX Operating System command usage for man cpc_getcciname

CPU Performance Counters Library Functions    cpc_getcpuver(3CPC)



NAME
     cpc_getcpuver, cpc_getcciname, cpc_getcpuref,  cpc_getusage,
     cpc_getnpic,  cpc_walk_names  -  determine  CPU  performance
     counter configuration

SYNOPSIS
     cc [ flag... ] file... -lcpc [ library... ]
     #include 

     int cpc_getcpuver(void);


     const char *cpc_getcciname(int cpuver);


     const char *cpc_getcpuref(int cpuver);


     const char *cpc_getusage(int cpuver);


     uint_t cpc_getnpic(int cpuver);


     void cpc_walk_names(int cpuver, int regno, void *arg,
          void (*action)(void *arg, int regno,  const char *name,
          uint8_t bits));


DESCRIPTION
     The cpc_getcpuver() function  returns  an  abstract  integer
     that  corresponds to the distinguished version of the under-
     lying processor.  The library distinguishes between  proces-
     sors  solely  on  the basis of their support for performance
     counters, so the version returned should not be  interpreted
     in  any other way. The set of values returned by the library
     is unique across all processor implementations.


     The cpc_getcpuver() function returns -1 if the library  can-
     not  support  CPU performance counters on the current archi-
     tecture.  This may be because  the  processor  has  no  such
     counter hardware, or because the library is unable to recog-
     nize it. Either way, such a return value indicates that  the
     configuration functions described on this manual page cannot
     be used.


     The cpc_getcciname() function returns a  printable  descrip-
     tion  of  the  processor  performance counter interfaces-for
     example, the string UltraSPARC I&II.  Note  that  this  name
     should  not  be  assumed  to  be  the  same  as the name the



SunOS 5.11          Last change: 28 Mar 2005                    1






CPU Performance Counters Library Functions    cpc_getcpuver(3CPC)



     manufacturer might otherwise ascribe to the  processor.   It
     simply  names  the  performance counter interfaces as under-
     stood by the library, and thus names the set of  performance
     counter  events  that can be described by that interface. If
     the cpuver argument is unrecognized,  the  function  returns
     NULL.


     The cpc_getcpuref() function returns a string that describes
     a  reference work that should be consulted to (allow a human
     to) understand the  semantics  of  the  performance  counter
     events that are known to the library. If the cpuver argument
     is unrecognized,  the  function  returns  NULL.  The  string
     returned  might  be substantially longer than 80 characters.
     Callers printing to a terminal might  want  to  insert  line
     breaks as appropriate.


     The cpc_getusage() function returns a compact description of
     the   getsubopt()-oriented   syntax   that  is  consumed  by
     cpc_strtoevent(3CPC). It is returned  as  a  space-separated
     set  of  tokens  to  allow  the caller to wrap lines at con-
     venient boundaries. If the cpuver argument is  unrecognized,
     the function returns NULL.


     The cpc_getnpic()  function  returns  the  number  of  valid
     fields  in  the  ce_pic[] array of a cpc_event_t data struc-
     ture.


     The library maintains a list of events that it believes  the
     processor  capable of measuring, along with the bit patterns
     that must be set in the corresponding control register,  and
     which    counter   the   result   will   appear   in.    The
     cpc_walk_names() function calls  the  action()  function  on
     each  element  of  the list so that an application can print
     appropriate help on the set of events known to the  library.
     The arg parameter is passed uninterpreted from the caller on
     each invocation of the action() function.


     If the parameters specify  an  invalid  or  unknown  CPU  or
     register  number,  the  function  silently  returns  without
     invoking the action function.

USAGE
     Prior to calling any of these functions, applications should
     call  cpc_access(3CPC)  to  determine  if  the  counters are
     accessible on the system.





SunOS 5.11          Last change: 28 Mar 2005                    2






CPU Performance Counters Library Functions    cpc_getcpuver(3CPC)



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



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


SEE ALSO
     cpc(3CPC),       cpc_access(3CPC),        cpc_cciname(3CPC),
     cpc_cpuref(3CPC),                            cpc_npic(3CPC),
     cpc_walk_events_all(3CPC)libcpc(3LIB), attributes(5)

NOTES
     The  cpc_getcpuver(),   cpc_getcciname(),   cpc_getcpuref(),
     cpc_getusage(),  cpc_getnpic(),  and  cpc_walk_names() func-
     tions exist for binary compatibility only. Source containing
     these  functions  will  not  compile.  These  functions  are
     obsolete and might be removed in a future release.  Applica-
     tions   should   use   cpc_cciname(3CPC),  cpc_cpuref(3CPC),
     cpc_npic(3CPC), and cpc_npic(3CPC) instead.


     Only SPARC processors are described by the SPARC version  of
     the  library,  and  only x86 processors are described by the
     x86 version of the library.






















SunOS 5.11          Last change: 28 Mar 2005                    3