man(1)

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

NAMN

man – ett gränssnitt till systemets referensmanualer

SYNOPSIS

man [man-alternativ] [[sektion] sida ...] ...
man -k [apropos-alternativ] reguljärt_uttryck ...
man -K [man-alternativ] [sektion] term ...
man -f [whatis-alternativ] sida ...
man -l [man-alternativ] fil ...
man -w|-W [man-alternativ] sida ...

BESKRIVNING

man är systemets manualsidor. Varje argument till man är normalt namnet på ett program, verktyg eller funktion. Manualsidan för varje argument hittas och visas. Om en sektion anges, begränsas sökningen till just den sektionen. Som standard genomsöks alla tillgängliga sektioner i en fördefinierad ordning (se DEFAULTS) och endast den första träffen visas, även om sidan finns i flera sektioner.

Tabellen nedan visar sektionernas nummer och vilka typer av sidor de innehåller:

1   Körbara program eller skalkommandon
2   Systemanrop (funktioner som tillhandahålls av kärnan)
3   Biblioteksanrop (funktioner i programbibliotek)
4   Specialfiler (ofta i /dev)
5   Filformat och konventioner, t.ex. /etc/passwd
6   Spel
7   Diverse (inklusive makropaket och konventioner), t.ex. man(7), groff(7), man-pages(7)
8   Administrationskommandon (ofta endast för root)
9   Kärnrutiner [Ej standard]

En manualsida består av flera sektioner.

Konventionella sektionsnamn inkluderar NAMN, SYNOPSIS, KONFIGURATION, BESKRIVNING, FLAGGOR, UTGÅNGSSTATUS, RETURVÄRDE, FEL, MILJÖ, FILER, VERSIONER, STANDARDER, NOTER, BUGGAR, EXEMPEL, FÖRFATTARE och SE ÄVEN.

EXEMPEL

man ls
    Visa manualsidan för kommandot ls.

man man.7
    Visa manualsidan för makropaketet man i sektion 7.

man 'man(7)'
    Alternativ form av "man 7 man". Parentesserna bör citeras för att skydda dem från skalet.

man -a intro
    Visa alla tillgängliga "intro"-sidor i turordning.

man -t bash | lpr -Pps
    Formatera sidan för bash och skriv ut till skrivaren "ps".

man -l -Tdvi ./foo.1x.gz > ./foo.1x.dvi
    Formatera komprimerad sida som DVI-fil, som kan visas med t.ex. xdvi.

man -k printf
    Sök i kortbeskrivningar efter nyckelordet "printf". Motsvarar ''apropos printf''.

man -f smail
    Visa kortbeskrivning för ''smail''. Motsvarar ''whatis smail''.

ÖVERSIKT

Många alternativ finns tillgängliga för man för att ge användaren maximal flexibilitet. Det går att ändra sökvägar, sektionsordning, formatterare och andra beteenden som beskrivs nedan.

Miljövariabeln $MANOPT kan sättas till en sträng i kommandoradsformat, där mellanslag i argument måste föregås av bakstreck. man tolkar $MANOPT före sina egna argument. Flaggor som kräver argument kan åsidosättas via kommandoraden. Alternativet -D som först argument gör att man ignorerar $MANOPT.

Manualsidor lagras normalt i nroff(1)-format under /usr/share/man. Förformaterade cat-sidor kan också förekomma. Se manpath(5).

Stöd finns för manualsidor på flera språk enligt din lokal. Om det inte ställts in automatiskt, sätt $LC_MESSAGES, $LANG eller liknande till ett POSIX-format:

språk[_territorium[.teckenuppsättning[,version]]]

Om en sida finns på det angivna språket visas den istället för den engelska.

Sidorna skrivs och underhålls normalt av respektive programs utvecklare. Rapportera saknade eller felaktiga sidor till dem.

STANDARDINSTÄLLNINGAR

Sektionernas sökordning kan ändras med $MANSECT eller SECTION i /usr/local/etc/man_db.conf. Standardordningen är:

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

Utdata visas med en "pager", som t.ex. less. Detta kan ändras med flaggan -P eller miljövariabler.

Preprocessorer identifieras via flaggan -p, $MANROFFSEQ eller första raden i manfilen. Exempel:

'" t

En formatteringskedja byggs upp från filter och nroff/groff. Alternativt körs program som mandb_nfmt.

FLAGGOR

Flaggorna är grupperade nedan. I MediaWiki-översättningar visas de med samma stil:

-C, --config-file fil  
 Använd konfigurationsfilen fil istället för ~/.manpath.
-d, --debug  
 Visa felsökningsinformation.
-D, --default  
 Återställ beteende till standard och ignorera $MANOPT.
--warnings[=varningar]  
 Aktivera varningar från groff, t.ex. --warnings=mac,!break.
-f, --whatis  
 Som whatis(1), visa kort beskrivning av sidan.
-k, --apropos  
 Som apropos(1), sök i kortbeskrivningar.
-K, --global-apropos  
 Sök i hela man-källtexten (kan vara långsamt).
-l, --local-file  
 Visa lokal manfil, t.ex. om filnamn innehåller snedstreck.
-w, --where, --path, --location  
 Visa sökvägen till källfilen istället för dess innehåll.
-W, --where-cat, --location-cat  
 Visa sökvägen till förformaterad cat-fil.

... (förkortad: resten av flagglistan följer samma mönster)

UTGÅNGSSTATUS

0   Lyckad körning
1   Syntax- eller konfigurationsfel
2   Operativt fel
3   Underprocess returnerade fel
16  Sidan/filen/nyckelordet hittades inte

MILJÖVARIABLER

MANPATH           sökväg för manualsidor
MANROFFOPT        flaggor till formatterare
MANROFFSEQ        preprocessorer
MANSECT           sökordning för sektioner
MANPAGER, PAGER   pager-program
MANLESS           prompt-sträng för less
BROWSER           webbläsare för --html
SYSTEM            motsvarar flaggan -m
MANOPT            globala alternativ
MANWIDTH          radlängd
MAN_KEEP_FORMATTING  behåll formatteringskommandon
MAN_KEEP_STDERR   visa felutdata från formattering
MAN_DISABLE_SECCOMP  stäng av seccomp-sandlåda
PIPELINE_DEBUG    skriv ut subprocessinfo
LANG, LC_MESSAGES språk för meddelanden

FILER

/usr/local/etc/man_db.conf    konfigurationsfil för man-db
/usr/share/man                global hierarki 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: John W. Eaton
  • 1992: Rik Faith, Willem Kasdorp
  • 1994–2000: G. Wilford
  • 1996–2001: Fabrizio Polacco för Debian
  • 2001–: Colin Watson (Debian, man-db)

FEL

COLOPHON

Denna sida är en del av man-db-projektet. Mer info: http://www.nongnu.org/man-db/ Rapportera förbättringar: man-db-devel@nongnu.org Källkod: https://gitlab.com/cjwatson/man-db HTML-rendering: Michael Kerrisk (TLPI)


Sidslut

Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/man.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 hemma som har sponsrat Linux.se med webbhotell.