newhelp(1)

Från Wiki.linux.se -Linux wikipedia på Svenska.
Hoppa till navigering Hoppa till sök


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

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.

Hämtad från "https://wiki.linux.se/index.php?title=newhelp(1)&oldid=9756"