newhelp(1)
NAMN
newhelp – skapa en hjälpdatabas för prestandamätvärden
SYNOPSIS
$PCP_BINADM_DIR/newhelp [-vV?] [-D felsökning]
[-n pmnsfil] [-o utdatafil]
[fil ...]
BESKRIVNING
newhelp skapar hjälptextfiler för Performance Co-Pilot, PCP. Dessa hjälptextfiler används av Performance Metric Domain Agents, PMDA:er.
Normalt arbetar newhelp mot standardnamnrymden Performance Metrics Name Space, PMNS.
Om optionen -n anges läses i stället en alternativ namnrymd från filen pmnsfil.
När det bara finns en indatafil härleds basnamnet för den nya databasen från namnet på indatafilen.
Om flera indatafiler används måste optionen -o anges för att uttryckligen namnge databasen.
Om inga indatafiler anges läser newhelp från standardindata. I detta fall måste optionen -o anges.
Om utdatafilens namn bestäms till foo skapar newhelp följande filer:
foo.dir foo.pag
Flaggan -V gör att utförliga meddelanden skrivs medan newhelp tolkar sin indata.
FORMAT FÖR HJÄLPKÄLLA
Den första raden i varje post i en hjälpkällfil består av tecknet @ i början av raden, följt av ett mellanslag, mätvärdets namn och en enradig beskrivning av mätvärdet.
Efterföljande rader, fram till nästa rad som börjar med @ eller fram till filslut, kan innehålla en utförlig hjälpbeskrivning.
Exempel:
# # Detta är ett exempel på newhelps indatasyntax # @ kernel.all.cpu.idle CPU idle time A cumulative count of the number of milliseconds of CPU idle time, summed over all processors.
Tredelade numeriska mätvärdesidentifierare, PMIDs, kan användas i stället för mätvärdesnamn.
Exempel:
60.0.23
kan användas i stället för:
kernel.all.cpu.idle
Användning av denna syntax rekommenderas inte, utom för dynamiska mätvärden där mätvärdets existens är känd för en PMDA men inte synlig i PMNS och därför saknar ett namn som newhelp kan känna till.
Rader som börjar med # ignoreras.
Tomma rader före den första raden som börjar med @ ignoreras också.
Den utförliga hjälptexten är valfri.
Som specialfall tolkas ett “mätvärdesnamn” på formen:
NNN.MM
där NNN och MM är numeriska, som en instansdomänidentifierare. Texten beskriver då instansdomänen.
OPTIONER
Tillgängliga kommandoradsoptioner är:
-o utdata, --output= utdata
- Ange basnamn för utdatafilerna.
- Om basnamnet är foo skapas:
foo.dir foo.pag
-n pmnsfil, --namespace= pmnsfil
- Läs in en alternativ Performance Metrics Name Space, PMNS, från filen pmnsfil.
- Se PMNS(5).
-v version, --version= version
- Ange utdataversion.
- Denna option är föråldrad.
- Det enda värde som stöds är:
2
-V, --verbose
- Skriv utförlig utmatning.
-?, --help
- Visa användningsmeddelande och avsluta.
FILER
$PCP_VAR_DIR/pmns/*
- Lokala standardfiler för PMNS-specifikationer.
PCP-MILJÖ
Miljövariabler med prefixet PCP_ används för att ange 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.
Miljövariabeln $PCP_CONF kan användas för att ange en alternativ konfigurationsfil. Se pcp.conf(5).
För miljövariabler som påverkar PCP-verktyg, se pmGetOptions(3).
FELSÖKNINGSOPTIONER
Optionen -D eller --debug aktiverar ytterligare diagnostik på standardfel, stderr.
Informationen är ibland kryptisk och är främst avsedd att ge vägledning till utvecklare snarare än slutanvändare.
Argumentet felsökning är en kommaseparerad lista över felsökningsoptioner.
Använd pmdbg(1) med optionen -l för att få en lista över tillgängliga felsökningsoptioner och deras betydelse.
SE ÄVEN
- chkhelp(1)
- PMAPI(3)
- pmLookupInDomText(3)
- pmLookupText(3)
- pcp.conf(5)
- pcp.env(5)
- PMNS(5)
- pmdbg(1)
- pmGetOptions(3)
KOLOFON
Denna sida är en del av projektet PCP, Performance Co-Pilot.
Information om projektet finns på:
http://www.pcp.io/
Felrapporter för denna manualsida skickas till:
pcp@groups.io
Sidan hämtades från projektets uppströms Git-förråd:
https://github.com/performancecopilot/pcp.git
Den hämtades den 24 maj 2026. Vid den tidpunkten var datumet för den senaste hittade commiten i förrådet den 24 maj 2026.
Om du upptäcker renderingsproblem i HTML-versionen av sidan, eller anser att det finns en bättre eller mer uppdaterad källa för sidan, eller har rättelser eller förbättringar av informationen i kolofonen, kan du skicka e-post till:
man-pages@man7.org
HÄNVISAD FRÅN
KORT SAMMANFATTNING
newhelp används för att skapa PCP-hjälpdatabaser från textfiler.
Skapa hjälpdatabas från en fil:
newhelp min_hjalpfil
Skapa hjälpdatabas med uttryckligt basnamn:
newhelp -o helpdb min_hjalpfil
Läs från standardindata:
cat min_hjalpfil | newhelp -o helpdb
Använd alternativ PMNS:
newhelp -n pmnsfil -o helpdb min_hjalpfil
Skriv utförlig information under inläsning:
newhelp -V -o helpdb min_hjalpfil
Den skapade databasen består av två filer:
helpdb.dir helpdb.pag
Sidslut
Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/newhelp.1.html
Det här är en maskinöversättning av Linux man sidor till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på
https://www.linux.se/kontaka-linux-se/
Tack till Datorhjälp Stockholm som har sponsrat Linux.se med webbhotell.