CPU Performance Counters Library Functions       cpcaccess(3CPC)



NAME
     cpcaccess - test access CPU performance counters

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

     int cpcaccess(void);


DESCRIPTION
     Access to CPU performance counters is possible only on  sys-
     tems  where the appropriate hardware exists and is correctly
     configured. The cpcaccess() function must be used to deter-
     mine  if  the hardware exists and is accessible on the plat-
     form before any of the interfaces that use the counters  are
     invoked.


     When the hardware is available, access  to  the  per-process
     counters  is  always  allowed  to  the  process  itself, and
     allowed to other processes mediated using the existing secu-
     rity mechanisms of /proc.

RETURN VALUES
     Upon successful completion, cpcaccess() returns 0.   Other-
     wise, it returns -1 and sets errno to indicate the error.


     By default, two common errno values are  decoded  and  cause
     the  library  to  print an error message using its reporting
     mechanism. See cpcseterrfn(3CPC) for a description  of  how
     this behavior can be modified.

ERORS
     The cpcaccess() function will fail if:

     EAGAIN    Another process may be  sampling  system-wide  CPU
               statistics.


     ENOSYS    CPU performance counters are inaccessible on  this
               machine.  This  error  can  occur when the machine
               supports  CPU  performance  counters,   but   some
               software components are missing. Check to see that
               all CPU Performance  Counter  packages  have  been
               correctly installed.


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



SunOS 5.11          Last change: 28 Mar 2005                    1






CPU Performance Counters Library Functions       cpcaccess(3CPC)



     
     ATRIBUTE TYPE               ATRIBUTE VALUE             
    
     MT-Level                     MT-Safe                     
    
     Interface Stability          Obsolete                    
    


SEE ALSO
     cpc(3CPC), cpcopen(3CPC), cpcseterrfn(3CPC), libcpc(3LIB),
     proc(4), attributes(5)

NOTES
     The cpcaccess() function exists  for  binary  compatibility
     only. Source containing this function will not compile. This
     function is obsolete  and  might  be  removed  in  a  future
     release. Applications should use cpcopen(3CPC) instead.





































SunOS 5.11          Last change: 28 Mar 2005                    2