Manual Pages for UNIX Operating System command usage for man cpc_event_accum

CPU Performance Counters Library Functions   cpc_event_diff(3CPC)



NAME
     cpc_event_diff,  cpc_event_accum  -  simple  difference  and
     accumulate operations

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

     void cpc_event_accum(cpc_event_t *accum, cpc_event_t *event);


     void cpc_event_diff(cpc_event_t *diff, cpc_event_t *after,
          cpc_event_t *before);


DESCRIPTION
     The cpc_event_accum() and cpc_event_diff()  functions   per-
     form   common   accumulate   and  difference  operations  on
     cpc_event(3CPC) data  structures.  Use  of  these  functions
     increases  program  portability, since structure members are
     not referenced directly .

  cpc_event_accum()
     The cpc_event_accum() function adds  the  ce_pic  fields  of
     event  into  the  corresponding  fields of accum. The ce_hrt
     field of accum is set to the later of the times in event and
     accum.

  SPARC:
     The function adds the contents of the ce_tick field of event
     into the corresponding field of accum.

  x86:
     The function adds the contents of the ce_tsc field of  event
     into the corresponding field of accum.

  cpc_event_diff()
     The cpc_event_diff() function places the difference  between
     the ce_pic fields of after and before and places them in the
     corresponding field of diff. The ce_hrt field of diff is set
     to the ce_hrt field of after.

  SPARC:
     Additionally, the function computes the  difference  between
     the ce_tick fields of after and before, and places it in the
     corresponding field of diff.

  x86:
     Additionally, the function computes the  difference  between
     the  ce_tsc fields of after and before, and places it in the
     corresponding field of diff.




SunOS 5.11          Last change: 28 Mar 2005                    1






CPU Performance Counters Library Functions   cpc_event_diff(3CPC)



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



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


SEE ALSO
     cpc(3CPC),       cpc_buf_add(3CPC),       cpc_buf_sub(3CPC),
     cpc_event(3CPC), libcpc(3LIB), attributes(5)

NOTES
     The cpc_event_accum() and cpc_event_diff()  functions  exist
     for binary compatibility only. Source containing these func-
     tions will not compile. These  functions  are  obsolete  and
     might  be  removed  in a future release. Applications should
     use cpc_buf_add(3CPC) and cpc_buf_sub(3CPC) instead.






























SunOS 5.11          Last change: 28 Mar 2005                    2