chkhelp(1)

NAMN

chkhelp – kontrollera hjälptextfiler för prestandamätvärden

SYNOPSIS

$PCP_BINADM_DIR/chkhelp [-eHiOp?] [-D felsökning]
                        [-n pmnsfil] hjälpfil [mätvärdesnamn ...]

BESKRIVNING

chkhelp kontrollerar konsekvensen hos hjälptextfiler för Performance Co-Pilot, PCP.

Dessa hjälptextfiler skapas av newhelp(1) och används av Performance Metric Domain Agents, PMDA:er.

Kontrollen innebär att filerna genomsöks och att valda poster eventuellt visas.

Filerna:

hjälpfil.dir
hjälpfil.pag

skapas av newhelp(1) och förutsätts redan finnas.

Utan optioner och utan argumentet mätvärdesnamn verifierar chkhelp tyst hjälpfilernas strukturella integritet.

Om ett eller flera argument av typen mätvärdesnamn anges behandlas endast hjälptexterna för motsvarande mätvärden.

Om inga mätvärdesnamn anges måste minst en av optionerna -i eller -p anges.

Optionen -i gör att poster för alla instansdomäner behandlas. Poster för prestandamätvärden ignoreras då.

Optionen -p gör att poster för alla mätvärden visas. Poster för instansdomäner ignoreras då.

När mätvärdesposter ska behandlas, antingen via argumentet mätvärdesnamn, optionen -p eller optionen -i, används optionerna -O och -H för att begära visning av hjälptext.

-O visar enradshjälp.

-H visar utförlig hjälptext.

Standard är -O.

Normalt arbetar chkhelp mot standardnamnrymden Performance Metrics Name Space, PMNS.

Om optionen -n anges läses i stället en alternativ namnrymd från filen pmnsfil.

Optionen -e gör en existenskontroll där alla angivna mätvärden från PMNS genomsöks. Observera att detta gäller mätvärden från PMNS, inte från hjälpfil.

Endast namnen på de mätvärden som saknar hjälptext rapporteras.

Optionen -e kan inte användas tillsammans med -i och/eller -p.

OPTIONER

Tillgängliga kommandoradsoptioner är:

-e

Rapportera mätvärden som saknar hjälptext.

-H

Visa utförlig hjälptext och avsluta.

-i

Behandla alla instansdomäner.

-n pmnsfil

Läs in en alternativ Performance Metrics Name Space, PMNS, från filen pmnsfil.

Se PMNS(5).

-O

Visa enradssammanfattningen av hjälptexten.

-p

Behandla alla mätvärden, alltså PMIDs.

-?

Visa användningsmeddelande och avsluta.

DIAGNOSTIK

Det finns många tänkbara orsaker till att en hjälpdatabas kan vara inkonsekvent.

Den vanligaste orsaken är att ett prestandamätvärde i databasen inte är definierat i den inlästa PMNS:en.

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

• newhelp(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

• newhelp(1)
• pmlookupindomtext(3)
• pmlookuptext(3)

KORT SAMMANFATTNING

chkhelp används för att kontrollera PCP-hjälptextfiler som skapats med newhelp(1).

Kontrollera hjälpfilernas struktur tyst:

chkhelp hjälpfil

Visa enradshjälp för alla mätvärden:

chkhelp -p hjälpfil

Visa utförlig hjälptext för alla mätvärden:

chkhelp -p -H hjälpfil

Visa hjälptext för ett visst mätvärde:

chkhelp hjälpfil kernel.all.cpu.user

Kontrollera vilka mätvärden som saknar hjälptext:

chkhelp -e hjälpfil

Använd en alternativ PMNS-fil:

chkhelp -n pmnsfil hjälpfil

Sidslut

Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/chkhelp.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.