DOKK / manpages / debian 12 / libpcp3-dev / pmiSetVersion.3.en
PMISETVERSION(3) Library Functions Manual PMISETVERSION(3)

pmiSetVersion - set the archive version for a LOGIMPORT archive

#include <pcp/pmapi.h>
#include <pcp/import.h>

int pmiSetVersion(int value);

cc ... -lpcp_import -lpcp

use PCP::LogImport;

pmiSetVersion($value);

from pcp import pmi

log = pmi.pmiLogImport(path).pmiSetVersion(value)

As part of the Performance Co-Pilot Log Import API (see LOGIMPORT(3)), pmiSetVersion sets the output archive version in the current context to be value.

In the absence of a call to pmiSetVersion the version currently defaults to the traditional v2 format. In a future major version of PCP it will default to v3 format.

pmiSetVersion returns zero on success else a negative value that can be turned into an error message by calling pmiErrStr(3).

LOGIMPORT(3), pmiErrStr(3), pmiSetHostname(3), pmiSetTimezone(3) and pmiStart(3).

Performance Co-Pilot