CPC_EVENT_DIFF(3CPC) CPU Performance Counters Library Functions
NAME
cpc_event_diff, cpc_event_accum - simple difference and accumulate
operations
SYNOPSIS
cc [
flag... ]
file... -lcpc [
library... ]
#include <libcpc.h>
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 perform 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.
ATTRIBUTES
See
attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| 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(7)NOTES
The
cpc_event_accum() and
cpc_event_diff() functions exist for binary
compatibility only. Source containing these functions 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.
March 28, 2005 CPC_EVENT_DIFF(3CPC)
