man(1): Skillnad mellan sidversioner

Från Wiki.linux.se
Hoppa till navigering Hoppa till sök
Rad 44: Rad 44:


== EXEMPEL ==
== EXEMPEL ==
<pre>
 
man ls
man ls
   Visar manualsidan för programmet ls.
   Visar manualsidan för programmet ls.
Rad 70: Rad 70:
man -f smail
man -f smail
   Visar kort beskrivning för smail (motsvarar whatis smail)
   Visar kort beskrivning för smail (motsvarar whatis smail)
</pre>


== ÖVERSIKT ==
== ÖVERSIKT ==

Versionen från 8 juni 2025 kl. 09.45

NAMN

man - ett gränssnitt till systemets referensmanualer

SYNOPS

man [man-flaggor] [[sektion] sida ...] ...
man -k [apropos-flaggor] regexp ...
man -K [man-flaggor] [sektion] term ...
man -f [whatis-flaggor] sida ...
man -l [man-flaggor] fil ...
man -w|-W [man-flaggor] sida ...

BESKRIVNING

man är systemets manualvisare. Varje argument sida som ges till man är normalt namnet på ett program, verktyg eller en funktion. Manualsidan som hör till varje av dessa argument hittas och visas. En sektion, om angiven, gör att man bara letar i den sektionen. Standardbeteendet är att söka i alla tillgängliga sektioner i fördefinierad ordning (se DEFAULTS), och bara visa den första matchade sidan, även om den finns i flera sektioner.

Sektionernas nummer och innehåll:

 1  Körbara program eller skal-kommandon
 2  Systemanrop (funktioner som kärnan tillhandahåller)
 3  Biblioteksanrop (funktioner i programbibliotek)
 4  Specialfiler (oftast i /dev)
 5  Filformat och konventioner, t.ex. /etc/passwd
 6  Spel
 7  Diverse (inkl. makropaket och konventioner), t.ex. man(7), groff(7), man-pages(7)
 8  Systemadministrationskommandon (vanligen bara för root)
 9  Kärnrutiner [Icke-standard]

Manualsidor består av flera sektioner. Vanliga sektionsrubriker inkluderar NAME, SYNOPSIS, CONFIGURATION, DESCRIPTION, OPTIONS, EXIT STATUS, RETURN VALUE, ERRORS, ENVIRONMENT, FILES, VERSIONS, STANDARDS, NOTES, BUGS, EXAMPLES, AUTHORS och SEE ALSO.

Konventioner i SYNOPSIS:

 fet text        skriv exakt som visas.
 kursiv text     ersätt med lämpligt argument.
 [-abc]          valfritt - alla eller några av flaggorna.
 -a|-b           uteslutande alternativ.
 argument ...    argumentet kan upprepas.
 [uttryck] ...   hela uttrycket inom hakparenteser är upprepningsbart.

Man kan inte alltid återge kursiv stil i terminalen – man använder ofta understrykning eller färg istället.

EXEMPEL

man ls

 Visar manualsidan för programmet ls.

man man.7

 Visar manualsidan för makropaketet "man" från sektion 7.
 (Alternativ skrivning till "man 7 man")

man 'man(7)'

 Visar manualsidan för makropaketet "man" från sektion 7.
 (Bekvämt vid inklistring av referenser. Parenteser måste citattecknas.)

man -a intro

 Visar samtliga intro-sidor i tur och ordning. Man kan avsluta eller hoppa mellan dem.

man -t bash | lpr -Pps

 Formaterar manualsidan för bash med groff och skickar till skrivare "ps".

man -l -T dvi ./foo.1x.gz > ./foo.1x.dvi

 Avkodar och formaterar foo.1x.gz till DVI-fil. Kan ses med t.ex. xdvi eller konverteras till PostScript med dvips.

man -k printf

 Söker efter printf i beskrivningar och sidnamn (motsvarar apropos printf)

man -f smail

 Visar kort beskrivning för smail (motsvarar whatis smail)

ÖVERSIKT

man erbjuder stor flexibilitet. Användaren kan ändra sökvägar, sektionsordning, formatteringsverktyg m.m.

Miljövariabler kan påverka beteendet – t.ex. MANOPT, LANG, LC_MESSAGES, MANPATH, MANSECT, m.fl.

man-sidor sparas ofta som nroff-filer i /usr/share/man. Preformatterade cat-filer kan förekomma för prestanda.

Språkstöd styrs via lokalinställningar (t.ex. LANG eller LC_MESSAGES). Om översättning finns, visas den.

Saknas en manualsida kan du rapportera detta till underhållaren av programmet.

Fler funktioner finns beskrivna i dokumentationen till man-paketet.

STANDARDVÄRDEN

Standardsökningsordning kan påverkas av miljövariabeln MANSECT eller konfigurationsfilen /usr/local/etc/man_db.conf.

Standardordning:
  1 n l 8 3 0 2 3type 5 4 9 6 7

man använder ett pager-program (t.ex. less). Kan ändras med -P eller MANPAGER.

Filter styrs via flaggan -p, MANROFFSEQ eller första raden i nroff-filen (ex: '"ept').

Formatteringsrörledning skapas baserat på filter och formatterare (nroff, groff).

Om ett program mandb_nfmt eller mandb_tfmt finns, används det istället.

FLAGGOR

Se man-flaggor för komplett lista över alla alternativ.

EXITSTATUS

0    Programmet kördes framgångsrikt.
1    Fel i användning, syntax eller konfigurationsfil.
2    Operativt fel.
3    Barnprocess returnerade ett felvärde.
16   Minst en sida/fil/nyckel saknades eller matchades inte.

MILJÖVARIABLER

Se man-miljövariabler för förklaringar av MANPATH, MANROFFOPT, MANSECT, MANPAGER, MANOPT, LANG m.fl.

FILER

/usr/local/etc/man_db.conf    Konfigurationsfil för man-db
/usr/share/man                Global katalog för manualsidor

STANDARDER

POSIX.1-2001, POSIX.1-2008, POSIX.1-2017

SE ÄVEN

apropos(1), groff(1), less(1), manpath(1), nroff(1), troff(1), whatis(1), zsoelim(1), manpath(5), man(7), catman(8), mandb(8)

HISTORIK

1990–1991: Ursprungligen skriven av John W. Eaton
1992-12-23: Buggfixar av Willem Kasdorp tillämpades av Rik Faith
1994–2000: Underhåll av G. Wilford
1996–2001: Underhåll och förbättringar av Fabrizio Polacco (Debian)
2001–:     Colin Watson (Debian) underhåller och utvecklar man-db

FEL

https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db

COLOPHON

Denna sida är en del av projektet man-db.
Projektets hemsida: http://www.nongnu.org/man-db/
Källkod: https://gitlab.com/cjwatson/man-db

Buggrapporter för denna manualsida skickas till: man-db-devel@nongnu.org
HTML-versionen genererades 2025-02-02.