Scroll to navigation

PMAUNDELTAINDOM(3) Library Functions Manual PMAUNDELTAINDOM(3)

NAME

pmaUndeltaInDom - find ``full'' instance domain matching a ``delta'' instance domain

C SYNOPSIS

#include <pcp/pmapi.h>
#include <pcp/libpcp.h>
#include <pcp/archive.h>

__pmLogInDom *pmaUndeltaInDom(__pmLogCtl *lcp, __int32_t *buf);

cc ... -lpcp_archive -lpcp

CAVEAT

This documentation is intended for internal Performance Co-Pilot (PCP) developer use.

These interfaces are not part of the PCP APIs that are guaranteed to remain fixed across releases, and they may not work, or may provide different semantics at some point in the future.

DESCRIPTION

Find the loaded ``full'' instance domain that matches a ``delta'' instance domain.

The caller ensures the physical metadata record for the ``delta'' instance domain has been read into buf. The associated archive control structure is identified by lcp, which implies the input archive has also been opened with pmNewContext(3).

pmaUndeltaInDom starts by extracting the timestamp and the instance domain number for the ``delta'' instance domain from buf. With this information, __pmLogSearchInDom(3) is called to find the matching loaded instance domain, which will have been converted from a ``delta'' instance domain to a ``full'' instance domain in the process.

pmaUndeltaInDom is most useful for applications that read physical metadata records and need to operate on ``full'' instance domains, rather than the ``delta'' instance domains that occur in Version 3 archives.

DIAGNOSTICS AND RETURN VALUES

Lots of warning babble if the matching loaded instance domain cannot be found, and the return value is NULL in this case.

SEE ALSO

PMAPI(3),

PCP Performance Co-Pilot