genpmda(1)

NAMN

genpmda — PMDA-generator för Performance Co-Pilot

SYNOPSIS

genpmda [-dv] [-D domän] [-n pmns] [-o katalog] [-s stdpmid] [-t toppkatalog] -c konfig -i IAM

BESKRIVNING

genpmda är ett verktyg för snabb programutveckling som används för att skapa nya Performance Metrics Domain Agents, se PMDA(3). Det ger ett mycket enkelt och effektivt sätt att utöka Performance Co-Pilot (PCP) med nya prestandamått utan att behöva förstå de lågnivådetaljer som krävs för att bygga PMDA:er.

genpmda läser en konfigurationsfil som innehåller ett utökat Performance Metrics Name Space, se PMNS(5), och genererar automatiskt nästan all källkod som behövs för att implementera en fullt fungerande PMDA. Detta inkluderar Makefile, namnrymd, stödskript för att konfigurera den nya PMDA:n samt hjälptext för mätvärdena.

Ganska enkla PMDA:er kan genereras automatiskt från konfigurationsfilen utan att någon ytterligare kod behöver skrivas. Mer komplicerade PMDA:er, till exempel sådana som innehåller flera instansdomäner, kräver endast att uppdateringsmetoderna för instansdomänerna skrivs manuellt.

Ett exempel på det konfigurationsfilformat som accepteras av genpmda visas nedan.

FLAGGOR

Obligatoriska flaggor:

-c konfig

Indatafilen konfig. Se exemplet nedan.

-i IAM

PMDA-namnet IAM. Detta ska finnas i stdpmid, eller så måste flaggan -D användas för att ange en domän.

Övriga flaggor:

-d

Generera ett Install-skript för en daemon-PMDA. Standard är DSO.

-D domän

Använd domännumret i den genererade pmns och domain.h, om -s inte anges.

-n pmns

Använd pmns som rot för namnrymden. Standardvärdet matchar flaggan -i.

-o katalog

Använd katalog för genererad källkod. Standard är:

./generated

-s stdpmid

Sökväg till stdpmid. Standard är:

../../pmns/stdpmid

-t toppkatalog

Använd toppkatalog i den genererade GNUmakefile. Standard är:

../../..

-v

Skriv ut utförliga meddelanden om vad genpmda gör.

EXEMPEL

Generera en PMDA med namnet “example” med domän 99:

genpmda -D 99 -v -i EXAMPLE -c example.conf

Här är konfigurationsfilen example.conf, som används med den obligatoriska flaggan -c:

example {
    metric
}

example.metric {
    ##  metric            string
    ##  pmid              EXAMPLE:CLUSTER:0
    ##  indom             PM_INDOM_NULL
    ##  type              PM_TYPE_STRING
    ##  units             PMDA_PMUNITS(0,0,0,0,0,0)
    ##  semantics         PM_SEM_DISCRETE
    ##  briefhelptext     one line help text for example.metric.string
    ##  helptext          long help text for example.metric.string
    ##  helptext          This is the second line of the long help text
    ##  helptext          and this is the third line.
    ##  fetch             function example_string_fetch_callback
    ##  code              atom->cp = "hello world";
    ##  code              return 1;
    ##  endmetric
}

PCP-MILJÖ

Miljövariabler med prefixet PCP_ används för att parametrisera de fil- och katalognamn som används av PCP. På varje installation innehåller filen:

/etc/pcp.conf

de lokala värdena för dessa variabler.

Variabeln $PCP_CONF kan användas för att ange en alternativ konfigurationsfil, enligt beskrivningen i pcp.conf(5).

SE ÄVEN

pmcd(1), PMDA(3), pcp.conf(5), pcp.env(5) och PMNS(5)

COLOPHON

Denna sida är en del av projektet PCP (Performance Co-Pilot).

Information om projektet finns på:

http://www.pcp.io/

Om du har en felrapport för denna manualsida, skicka den till:

pcp@groups.io

Denna sida hämtades från projektets uppströms Git-arkiv:

https://github.com/performancecopilot/pcp.git

Sidan hämtades den 16 januari 2026. Vid den tidpunkten var datumet för den senaste commit som hittades i arkivet den 16 januari 2026.

Om du hittar renderingsproblem i denna HTML-version av sidan, eller om du anser att det finns en bättre eller mer uppdaterad källa för sidan, eller om du har rättelser eller förbättringar av informationen i detta COLOPHON-avsnitt, som inte är en del av den ursprungliga manualsidan, skicka e-post till:

man-pages@man7.org

Performance Co-Pilot PCP GENPMDA(1)