1PMLOGWRITEMARK(3)          Library Functions Manual          PMLOGWRITEMARK(3)
2
3
4

NAME

6       __pmLogWriteMark - append a <mark> record to a PCP archive
7

C SYNOPSIS

9       #include <pcp/pmapi.h>
10       #include <pcp/libpcp.h>
11
12       int __pmLogWriteMark(__pmArchCtl *acp, const __pmTimestamp *last_stamp,
13       const __pmTimestamp *inc)
14
15       cc ... -lpcp
16

CAVEAT

18       This documentation is intended for internal Performance Co-Pilot  (PCP)
19       developer use.
20
21       These  interfaces  are  not part of the PCP APIs that are guaranteed to
22       remain fixed across releases, and at some point in the future they  may
23       not work or may provide different semantics.
24

DESCRIPTION

26       __pmLogWriteMark  appends a <mark> record to the current data file of a
27       PCP archive.  A <mark> record indicates a dicontinuity in the time  se‐
28       ries  of  logged data in the archive, see PCPIntro(1) for more informa‐
29       tion.
30
31       The timestamp of the <mark> record is given  by  last_stamp  optionally
32       incremented  by  inc  unless inc is NULL (in which case no increment is
33       done).
34
35       The current data volume's I/O stream and the  archive  version  (deter‐
36       mines the format of the <mark> record) are determined from acp.
37

DIAGNOSTICS AND RETURN VALUES

39       The  return  value  is 0 if all is well, else some error code less than
40       zero that can be turned into an error message by calling pmErrStr(3).
41

SEE ALSO

43       PCPIntro(1), PMAPI(3) and __pmLogWrite(3).
44
45
46
47Performance Co-Pilot                  PCP                    PMLOGWRITEMARK(3)
Impressum