man(1): Skillnad mellan sidversioner

Från Wiki.linux.se
Hoppa till navigering Hoppa till sök
 
(10 mellanliggande sidversioner av samma användare visas inte)
Rad 1: Rad 1:
== NAMN ==
== NAMN ==
man - ett gränssnitt till systemets referensmanualer
man ett gränssnitt till systemets referensmanualer


== SYNOPS ==
== SYNOPSIS ==
<pre>
<pre>
man [man-flaggor] [[sektion] sida ...] ...
man [man-alternativ] [[sektion] sida ...] ...
man -k [apropos-flaggor] regexp ...
man -k [apropos-alternativ] reguljärt_uttryck ...
man -K [man-flaggor] [sektion] term ...
man -K [man-alternativ] [sektion] term ...
man -f [whatis-flaggor] sida ...
man -f [whatis-alternativ] sida ...
man -l [man-flaggor] fil ...
man -l [man-alternativ] fil ...
man -w|-W [man-flaggor] sida ...
man -w|-W [man-alternativ] sida ...
</pre>
</pre>


== BESKRIVNING ==
== 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.


man är systemets manualvisare. Varje argument sida som ges till man är normalt namnet på ett program, verktyg eller en funktion.
Tabellen nedan visar sektionernas nummer och vilka typer av sidor de innehåller:
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:
<pre>
   Körbara program eller skal-kommandon
1   Körbara program eller skalkommandon
   Systemanrop (funktioner som kärnan tillhandahåller)
2   Systemanrop (funktioner som tillhandahålls av kärnan)
   Biblioteksanrop (funktioner i programbibliotek)
3   Biblioteksanrop (funktioner i programbibliotek)
   Specialfiler (oftast i /dev)
4   Specialfiler (ofta i /dev)
   Filformat och konventioner, t.ex. /etc/passwd
5   Filformat och konventioner, t.ex. /etc/passwd
   Spel
6   Spel
   Diverse (inkl. makropaket och konventioner), t.ex. [[man(7)]], [[groff(7)]], [[man-pages(7)]]
7   Diverse (inklusive makropaket och konventioner), t.ex. man(7), groff(7), man-pages(7)
   8  Systemadministrationskommandon (vanligen bara för root)
8   Administrationskommandon (ofta endast för root)
   Kärnrutiner [Icke-standard]
9   Kärnrutiner [Ej standard]
</pre>


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


Konventioner i SYNOPSIS:
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.
  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 ==
== EXEMPEL ==
<pre>
<pre>
man ls
man ls
  Visar manualsidan för programmet ls.
    Visa manualsidan för kommandot ls.


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


man 'man(7)'
man 'man(7)'
  Visar manualsidan för makropaketet "man" från sektion 7.
    Alternativ form av "man 7 man". Parentesserna bör citeras för att skydda dem från skalet.
  (Bekvämt vid inklistring av referenser. Parenteser måste citattecknas.)


man -a intro
man -a intro
  Visar samtliga intro-sidor i tur och ordning. Man kan avsluta eller hoppa mellan dem.
    Visa alla tillgängliga "intro"-sidor i turordning.


man -t bash | lpr -Pps
man -t bash | lpr -Pps
  Formaterar manualsidan för bash med groff och skickar till skrivare "ps".
    Formatera sidan för bash och skriv ut till skrivaren "ps".


man -l -T dvi ./foo.1x.gz > ./foo.1x.dvi
man -l -Tdvi ./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.
    Formatera komprimerad sida som DVI-fil, som kan visas med t.ex. xdvi.


man -k printf
man -k printf
  Söker efter printf i beskrivningar och sidnamn (motsvarar apropos printf)
    Sök i kortbeskrivningar efter nyckelordet "printf". Motsvarar ''apropos printf''.


man -f smail
man -f smail
  Visar kort beskrivning för smail (motsvarar whatis smail)
    Visa kortbeskrivning för ''smail''. Motsvarar ''whatis smail''.
</pre>
</pre>


== ÖVERSIKT ==
== Ö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:
<pre>
<pre>
man erbjuder stor flexibilitet. Användaren kan ändra sökvägar, sektionsordning, formatteringsverktyg m.m.
språk[_territorium[.teckenuppsättning[,version]]]
</pre>


Miljövariabler kan påverka beteendet – t.ex. MANOPT, LANG, LC_MESSAGES, MANPATH, MANSECT, m.fl.
Om en sida finns på det angivna språket visas den istället för den engelska.


man-sidor sparas ofta som nroff-filer i /usr/share/man. Preformatterade cat-filer kan förekomma för prestanda.
Sidorna skrivs och underhålls normalt av respektive programs utvecklare. Rapportera saknade eller felaktiga sidor till dem.


Språkstöd styrs via lokalinställningar (t.ex. LANG eller LC_MESSAGES). Om översättning finns, visas den.
== STANDARDINSTÄLLNINGAR ==
Sektionernas sökordning kan ändras med '''$MANSECT''' eller '''SECTION''' i ''/usr/local/etc/man_db.conf''. Standardordningen är:


Saknas en manualsida kan du rapportera detta till underhållaren av programmet.
<pre>
1 n l 8 3 0 2 3type 5 4 9 6 7
</pre>


Fler funktioner finns beskrivna i dokumentationen till man-paketet.
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:
 
<pre>
'" t
</pre>
</pre>


== STANDARDVÄRDEN ==
En formatteringskedja byggs upp från filter och nroff/groff. Alternativt körs program som ''mandb_nfmt''.
<pre>
 
Standardsökningsordning kan påverkas av miljövariabeln MANSECT eller konfigurationsfilen /usr/local/etc/man_db.conf.
== 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.


Standardordning:
'''-k''', '''--apropos''' 
   1 n l 8 3 0 2 3type 5 4 9 6 7
   Som [[apropos(1)]], sök i kortbeskrivningar.


man använder ett pager-program (t.ex. less). Kan ändras med -P eller MANPAGER.
'''-K''', '''--global-apropos''' 
  Sök i hela man-källtexten (kan vara långsamt).


Filter styrs via flaggan -p, MANROFFSEQ eller första raden i nroff-filen (ex: '"ept').
'''-l''', '''--local-file'''
  Visa lokal manfil, t.ex. om filnamn innehåller snedstreck.


Formatteringsrörledning skapas baserat på filter och formatterare (nroff, groff).
'''-w''', '''--where''', '''--path''', '''--location''' 
  Visa sökvägen till källfilen istället för dess innehåll.


Om ett program mandb_nfmt eller mandb_tfmt finns, används det istället.
'''-W''', '''--where-cat''', '''--location-cat''' 
</pre>
  Visa sökvägen till förformaterad cat-fil.


== FLAGGOR ==
... (förkortad: resten av flagglistan följer samma mönster)
Se [[man-flaggor]] för komplett lista över alla alternativ.


== EXITSTATUS ==
== UTGÅNGSSTATUS ==
<pre>
<pre>
0   Programmet kördes framgångsrikt.
0   Lyckad körning
1   Fel i användning, syntax eller konfigurationsfil.
1   Syntax- eller konfigurationsfel
2   Operativt fel.
2   Operativt fel
3   Barnprocess returnerade ett felvärde.
3   Underprocess returnerade fel
16   Minst en sida/fil/nyckel saknades eller matchades inte.
16 Sidan/filen/nyckelordet hittades inte
</pre>
</pre>


== MILJÖVARIABLER ==
== MILJÖVARIABLER ==
Se [[man-miljövariabler]] för förklaringar av MANPATH, MANROFFOPT, MANSECT, MANPAGER, MANOPT, LANG m.fl.
<pre>
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
</pre>


== FILER ==
== FILER ==
<pre>
<pre>
/usr/local/etc/man_db.conf    Konfigurationsfil för man-db
/usr/local/etc/man_db.conf    konfigurationsfil för man-db
/usr/share/man                Global katalog för manualsidor
/usr/share/man                global hierarki för manualsidor
</pre>
</pre>


== STANDARDER ==
== STANDARDER ==
<pre>
POSIX.1-2001, POSIX.1-2008, POSIX.1-2017
POSIX.1-2001, POSIX.1-2008, POSIX.1-2017
</pre>


== SE ÄVEN ==
== SE ÄVEN ==
Rad 133: Rad 170:


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


== FEL ==
== FEL ==
<pre>
* https://gitlab.com/man-db/man-db/-/issues
https://gitlab.com/man-db/man-db/-/issues
* https://savannah.nongnu.org/bugs/?group=man-db
https://savannah.nongnu.org/bugs/?group=man-db
</pre>


== COLOPHON ==
== COLOPHON ==
<pre>
Denna sida är en del av '''man-db'''-projektet.
Denna sida är en del av projektet man-db.
Mer info: http://www.nongnu.org/man-db/
Projektets hemsida: http://www.nongnu.org/man-db/
Rapportera förbättringar: man-db-devel@nongnu.org 
Källkod: https://gitlab.com/cjwatson/man-db
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/
<BR><BR>Tack till [https://datorhjalp.se/web/datorhjalp-hemma/ Datorhjälp hemma] som har  sponsrat [https://www.linux.se Linux.se] med webbhotell.


Buggrapporter för denna manualsida skickas till: man-db-devel@nongnu.org
[[Kategori:Linuxmanual grupp 1]]
HTML-versionen genererades 2025-02-02.
[[Kategori:Linuxmanual]]
</pre>

Nuvarande version från 8 juni 2025 kl. 09.58

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.