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)