Linux commando: man

Elk Linux-systeem wordt geleverd met een compleet naslagwerk, geïnstalleerd op schijf, beschikbaar zonder internetverbinding, en geschreven door dezelfde mensen die de software schreven. De meeste gebruikers lopen eraan voorbij. Ze zoeken op het web naar een optie die drie regels verderop staat in een pagina die ze al op hun eigen machine hebben. Het commando dat dat naslagwerk opent is man.

2. Waar komt de naam vandaan?

De naam man is kort voor manual, handleiding. Niets slimmers dan dat.

man       =  MANual
whatis    =  "what is this command?"
apropos   =  an English word borrowed from French, "with regard to"
mandb     =  MANual DataBase

De volledige naam van het oorspronkelijke document was de Unix Programmer's Manual, en een "man-pagina" is letterlijk een pagina daaruit. Het naslagwerk was genummerd in delen, en die nummering leeft vandaag voort als de secties die je in hoofdstuk 5 van dit artikel tegenkomt.

Je ziet documentatie voortdurend geschreven in de vorm ls(1), passwd(5), signal(7). Dat is geen versiering. Het is een precieze verwijzing: de pagina met de naam ls, in sectie 1 van het naslagwerk. Als een man-pagina zegt "see chmod(2)", vertelt hij je dat de interessante pagina de systeemaanroep in sectie 2 is, en niet het commando in sectie 1. Leer die notatie lezen en de helft van de verwarring rond man verdwijnt.

4. Eenvoudige toepassingen

4.1 Een pagina openen en erin navigeren

De eenvoudigst mogelijke toepassing is de commandonaam op zichzelf:

$ man cp

Je zit nu in less, dezelfde pager die je krijgt van less eenbestand.txt. Onderaan het scherm zet man een regel die je precies vertelt op welke pagina je terechtkwam:

Manual page cp(1) line 1

Die regel is het lezen waard voordat je iets anders doet. Hij bevestigt zowel de naam als de sectie, zodat je weet of je de pagina kreeg die je bedoelde. Dit zijn de toetsen die je nodig hebt:

Alles wat je al over less weet geldt hier, want het is less. Als de toetsen zich op jouw systeem anders gedragen, is je pager een ander programma; paragraaf 6.3 legt uit hoe je dat verandert.

4.2 De onderdelen van een man-pagina

Man-pagina's zijn geen vrije vorm. De koppen liggen vast, ze verschijnen in een vaste volgorde, en die afspraak is zelf gedocumenteerd in man 7 man-pages. Dit zijn de koppen die je tegenkomt:

Omdat de koppen tegen de linkerkantlijn staan, kun je er direct naartoe springen met een zoekopdracht in de pager die aan het regelbegin verankerd is:

$ man rsync
/^EXAMPLES        # then press Enter, and n for the next hit
/^EXIT STATUS
/^ENVIRONMENT

Dit is de gewoonte die man-pagina's verandert van een muur tekst in een naslagwerk dat je echt kunt gebruiken. Niet scrollen. Springen.

4.3 Hoe je een SYNOPSIS leest

De SYNOPSIS is een samengeperste grammatica van het commando. Hij gebruikt een notatie die niemand ooit uitlegt, en daarom slaan veel mensen hem over. Dit is de hele notatie:

Lees er nu een echte. Dit is de complete SYNOPSIS van ls:

$ man ls
SYNOPSIS
       ls [OPTION]... [FILE]...

Beide delen zijn optioneel en beide mogen herhaald worden. Dus ls, ls -l, ls -l -a /etc /var zijn allemaal geldig, en ls /etc /var zonder opties ook. Die ene regel vertelde je de volledige aanroepconventie.

Nu een met echte structuur:

$ man cp
SYNOPSIS
       cp [OPTION]... [-T] SOURCE DEST
       cp [OPTION]... SOURCE... DIRECTORY
       cp [OPTION]... -t DIRECTORY SOURCE...

Drie regels betekent drie werkwijzen. De eerste regel kopieert een enkel ding naar een enkele bestemming. De tweede regel kopieert een of meer bronnen in een map, en merk op dat SOURCE... herhaald mag worden en DIRECTORY niet, dus het laatste argument is het doel. De derde regel doet hetzelfde met het doel vooraan benoemd door -t, wat je gebruikt als de lijst met bronnen uit een pipe komt. Het hele gedrag van cp waar mensen over struikelen staat in die drie regels.

Pagina's in sectie 2 en 3 zien er anders uit, omdat ze C-functies documenteren in plaats van commando's:

$ man 3 printf
SYNOPSIS
       #include <stdio.h>

       int printf(const char *restrict format, ...);
       int fprintf(FILE *restrict stream,
                   const char *restrict format, ...);

Hier geeft de SYNOPSIS je het header-bestand dat je moet includeren en de exacte prototypes. Zelfde idee, ander publiek: het blijft "hoe roep ik dit ding aan".

4.4 De pagina die je wilt is vaak niet die je typte

Een commandonaam kan meerdere man-pagina's hebben. man kiest er zelf een uit, en zegt er niet bij welke. Probeer dit:

$ whatis passwd
passwd (1)           - change user password
passwd (1ssl)        - OpenSSL application commands
passwd (5)           - the password file

Drie verschillende pagina's, allemaal passwd geheten. Kaal man passwd geeft je het commando in sectie 1. Als je eigenlijk de opbouw van /etc/passwd zocht, moet je expliciet om de sectie vragen. Dat is het hele antwoord op de vraag "waarom bestaat man 5 passwd", en hoofdstuk 5 gaat daar precies over.

6. Gevorderde toepassingen

6.1 Zelf de sectie kiezen: -S en MANSECT

Je weet al dat een kaal sectienummer voor de naam een sectie kiest:

$ man 5 passwd

De langere vorm neemt een lijst, in de volgorde waarin je ze geprobeerd wilt hebben:

$ man -S 5,1 passwd       # try section 5 first, fall back to 1
$ man --sections=8,1 mount

Als je altijd een andere voorkeur wilt, zet dan MANSECT in plaats van het elke keer te typen. Een beheerder die in configuratiebestanden leeft, wil misschien sectie 5 en 8 voor sectie 1 hebben:

$ export MANSECT=8:5:1:7:2:3

6.2 Hoe man bepaalt waar hij zoekt

Man-pagina's staan in een manual path, een lijst mappen gescheiden door dubbele punten, net als PATH. Vraag de jouwe op:

$ manpath
/usr/share/man:/home/peter/.local/share/man:/usr/local/man:/usr/local/share/man

$ man --path            # the same thing, from man itself

Die lijst staat niet vast in het programma. Hij wordt opgebouwd uit /etc/manpath.config, dat twee interessante soorten regels bevat:

MANDATORY_MANPATH       /usr/share/man
MANDATORY_MANPATH       /usr/local/share/man
MANPATH_MAP  /usr/bin        /usr/share/man
MANPATH_MAP  /usr/local/bin  /usr/local/share/man
MANPATH_MAP  /opt/bin        /opt/man

De MANPATH_MAP-regels zijn het slimme deel. Ze zeggen: "voeg voor elke map in het PATH van de gebruiker de bijbehorende map met man-pagina's toe". Dus als je een programma in /opt/bin installeert en dat in je PATH zet, worden zijn man-pagina's in /opt/man automatisch vindbaar. Het manual path volgt het uitvoerbare pad.

Je kunt het geheel overschrijven met de omgevingsvariabele MANPATH, maar er zit een valkuil aan: instellen vervangt de berekende lijst in plaats van eraan toe te voegen. Daarom doet een dubbele punt aan het begin of het einde ertoe, want een lege positie betekent "voeg hier de standaardlijst in":

$ MANPATH=/opt/mytool/man man --path
/opt/mytool/man                                  # ONLY this. Everything else is gone.

$ MANPATH=/opt/mytool/man: man --path
/opt/mytool/man:/usr/share/man:/home/peter/.local/share/man:/usr/local/share/man

Geef voor een enkel commando de voorkeur aan -M boven iets exporteren:

$ man -M /opt/mytool/man mytool

6.3 man prettig maken

man leest een handvol omgevingsvariabelen. Deze vier zijn het kennen waard:

Twee ervan lossen echte ergernissen op. Op een heel breed scherm wordt een man-pagina slecht leesbaar omdat de regels eindeloos doorlopen; MANWIDTH zet hem vast op een prettige maat:

$ export MANWIDTH=80

En met MANOPT maak je een voorkeur blijvend zonder alias. Deze zet afbreken en uitvullen uit voor elke pagina die je ooit opent, om de reden die in paragraaf 7.1 staat:

$ export MANOPT="--no-hyphenation --no-justification"

Een pagina als platte tekst wegschrijven is makkelijk, omdat man merkt dat zijn uitvoer geen terminal is en dan automatisch alle opmaak weglaat:

$ man ls > ls.txt              # plain text, no control characters
$ man -P cat ls                # same, forcing the pager to cat
$ MANPAGER=cat man ls          # same, through the environment

Daarmee is een man-pagina gewoon een tekststroom, dus de rest van het Unix-gereedschap werkt erop:

$ man cp | grep -A2 -- '-l, --link'
       -l, --link
              hard link files instead of copying

$ man ls | wc -l               # how long is this page really?

6.4 Zoeken in de volledige tekst: man -K

apropos kijkt alleen naar de NAME-regel. De optie -K (kort voor global apropos) doorzoekt de inhoud van elke man-pagina op het systeem. Het is traag, want het pakt duizenden bestanden uit en scant ze, maar het vindt dingen die niets anders vindt:

$ man -wK -S 5 'MANPATH_MAP'
/usr/share/man/man5/manpath.5.gz

Twee gewoontes maken het bruikbaar. Beperk de secties met -S, en voeg -w toe zodat je een lijst paden krijgt in plaats van dat je een voor een in elke passende pagina belandt.

Er is een subtiliteit waar de eigen man-pagina eerlijk over is: -K doorzoekt de roff-bron van elke pagina, niet de opgemaakte tekst, omdat alles opmaken veel trager zou zijn. Het kan dus valse treffers geven door commentaar in de bron, en treffers missen als de bron iets anders schrijft dan er op het scherm verschijnt. Een minteken dat in de bron als \- geschreven staat is het klassieke voorbeeld, en daarom vindt zoeken naar een optie met -K soms niets.

Toch is dit het gereedschap voor de vraag "in welk configuratiebestand zit deze obscure instelling?". Let op: -K is een uitbreiding van man-db en niet overal beschikbaar.

6.5 Andere manieren om een pagina weer te geven

Omdat het opmaken een aparte stap in de pijplijn is, kun je die omleiden. Een man-pagina die je gedownload hebt, of die je aan het schrijven bent, open je met -l (kort voor local file, lokaal bestand):

$ man -l ./mytool.1
$ man -l /tmp/downloaded.8.gz

Zonder -l zou man dat pad als paginanaam behandelen en falen.

De zeterfenis leeft nog. -t (kort voor troff) maakt de pagina op voor druk in plaats van voor een terminal:

$ man -t ls | head -2
%!PS-Adobe-3.0
%%Creator: groff version 1.23.0

$ man -t ls > ls.ps            # PostScript
$ man -t ls | ps2pdf - ls.pdf  # a printable PDF of the manual page

Er is ook -H, dat een pagina naar HTML omzet en in een browser opent. Let op dat op Debian en Ubuntu standaard alleen groff-base geïnstalleerd is, dat wel PostScript kan maken maar geen HTML; daar faalt man -H tot je het volledige pakket groff installeert.

6.6 Sectie 2 en 3: het naslagwerk voor programmeurs

Sectie 2 en 3 zijn een ander naslagwerk voor een andere lezer, en ze zijn het deel van het systeem dat vrijwel niemand per ongeluk ontdekt. Sectie 2 documenteert de systeemaanroepen, de scheidslijn tussen jouw programma en de kernel. Sectie 3 documenteert bibliotheekfuncties, die in je eigen proces draaien en er meestal systeemaanroepen onder gebruiken.

$ man 2 open          # the kernel system call
$ man 3 fopen         # the C library function built on top of it
$ man 2 read          $ man 3 malloc
$ man 2 fork          $ man 3 pthread_create

Dat paarsgewijze verband is het hele punt van de splitsing. open() is een verzoek aan de kernel; fopen() is een omhulsel eromheen dat buffering en administratie in user space toevoegt. Het sectienummer vertelt je aan welke kant van die grens je staat.

Deze pagina's gebruiken hun eigen koppen. Een commando heeft EXIT STATUS; een functie heeft RETURN VALUE en ERRORS:

$ man 2 open
RETURN VALUE
       On success, open(), openat(), and creat() return  the  new  file  de-
       scriptor (a nonnegative integer).  On error, -1 is returned and errno
       is set to indicate the error.

ERRORS
       EACCES The  requested  access  to  the file is not allowed ...

De sectie ERRORS is de reden om deze pagina's te openen. Hij somt elke errno-waarde op die de aanroep kan opleveren en wat elke waarde betekent, en dat vat geen enkele zoekopdracht op het web correct samen.

Een valkuil heeft zijn eigen antwoord in de SYNOPSIS staan. Sommige functies worden pas gedeclareerd als je eerst een feature-test macro definieert, en de pagina vertelt je welke:

$ man 3 asprintf
SYNOPSIS
       #define _GNU_SOURCE         /* See feature_test_macros(7) */
       #include <stdio.h>

       int asprintf(char **restrict strp, const char *restrict fmt, ...);

Sla je die eerste regel over, dan meldt de compiler dat asprintf niet gedeclareerd is, terwijl de man-pagina hem duidelijk documenteert. De pagina wijst zelfs het overzicht aan: man 7 feature_test_macros legt _GNU_SOURCE, _POSIX_C_SOURCE en de rest uit. Dit is een geval waarin de SYNOPSIS letterlijk lezen, inclusief het commentaar, je een middag bespaart.

Pagina's in sectie 2 en 3 hebben ook een STANDARDS-sectie, die je vertelt of een interface POSIX is, een erfenis van BSD, of alleen Linux. Dat is het verschil tussen code die overdraagbaar is en code die dat niet is. Als deze pagina's op jouw machine ontbreken, zie paragraaf 7.7.

6.7 Man-pagina's in je eigen taal

Man-pagina's kunnen vertaald worden, en de mappenstructuur heeft naast de genummerde mappen een submap per taal:

$ ls /usr/share/man/ | grep -v '^man[1-9]$' | tr '\n' ' '
ca ca@valencia cs da de de.UTF-8 es fi fr fr.ISO8859-1 fr.UTF-8 hr hu id it
ja ja.UTF-8 ko nl pl pt pt_BR ro ru sk sl sr sv tr uk zh zh_CN zh_TW

Je instellingen voor LANG en LC_MESSAGES bepalen welke man verkiest. Je kunt ook rechtstreeks om een taal vragen met -L:

$ man -L nl apropos
APROPOS(1)               Hulpprogramma's paginaopmaker              APROPOS(1)

NAAM
       apropos - namen en beschrijvingen van de man-pagina's doorzoeken

SAMENVATTING

Twee opmerkingen uit de praktijk. Ten eerste is de dekking dun. Deze machine heeft 105 Nederlandse pagina's tegenover 9761 Engelse, en ze komen bijna allemaal van apt, dpkg en man-db zelf. Voor al het andere krijg je Engels, wat je taalinstelling ook is.

Ten tweede kan een vertaling achterlopen op het origineel, omdat de Engelse pagina met de software meekomt en de vertaling met een taalpakket. Als je Engelse documentatie volgt, met een collega vergelijkt, of een probleem meldt, forceer dan het origineel:

$ man -L C apropos     # the untranslated page
$ man -L C -w apropos
/usr/share/man/man1/apropos.1.gz

Dat is ook de snelste manier om te controleren of een kop die je niet kunt vinden ontbreekt of alleen maar vertaald is.

6.8 De rare sectienamen: 1ssl, 3perl, 3avr

Kijk nog eens naar de uitvoer van whatis en je ziet secties die geen kaal getal zijn:

$ whatis passwd
passwd (1)           - change user password
passwd (1ssl)        - OpenSSL application commands
passwd (5)           - the password file

De letters achter het getal zijn een sub-extensie. Daarmee claimt een project zijn eigen ruimte binnen een sectie, zodat de passwd van OpenSSL niet botst met de passwd van het systeem. Je komt 1ssl, 3perl, 3pm, 3posix en andere tegen. Vraag er een op met -e:

$ man -e ssl passwd            # the OpenSSL page
$ man 1ssl passwd              # the same, written the short way

6.9 Een man-pagina schrijven voor je eigen script

Als je scripts schrijft die anderen (of jij over een jaar) op een server draaien, kost een man-pagina erbij ongeveer tien minuten en laat het ze geïnstalleerd lijken in plaats van geimproviseerd. Het formaat is gewoon roff. Dit is een complete, werkende pagina:

.TH DEPLOY 1 "August 2026" "1.0" "Site tools"
.SH NAME
deploy \- push the website to production
.SH SYNOPSIS
.B deploy
[\fB\-n\fR] \fISITE\fR
.SH DESCRIPTION
Pushes the checked-out site to the production server.

De regel .TH neemt vijf velden: de naam in hoofdletters, de sectie, de datum, de versie, en de titel van het naslagwerk die in de kop verschijnt. .SH begint een sectiekop, .B maakt de volgende regel vet, en \fB ... \fR en \fI ... \fR schakelen binnen een regel over naar vet en cursief.

Installeer hem in de lokale structuur en bouw de index opnieuw op:

$ sudo cp deploy.1 /usr/local/share/man/man1/
$ sudo mandb
1 man subdirectory contained newer manual pages.
1 manual page was added.

$ man deploy
DEPLOY(1)                         Site tools                        DEPLOY(1)

NAME
       deploy - push the website to production

SYNOPSIS
       deploy [-n] SITE

Bekijk hem voor het installeren rechtstreeks vanuit je werkmap met man -l deploy.1. Let op het ontsnapte koppelteken in deploy \- push: in roff is een kaal - een typografisch koppelteken, en \- het letterlijke minteken. Dat verkeerd doen is de reden dat sommige man-pagina's je een teken geven dat je niet terug in een shell kunt plakken.

8. Best practices

• Lees de regel onderaan het scherm. Manual page cp(1) line 1 vertelt je de naam en de sectie waar je werkelijk terechtkwam. De helft van alle "de handleiding klopt niet"-momenten is in werkelijkheid "ik lees een andere pagina dan ik denk".
• Spring, scroll niet. Zoek in de pager naar een kop, verankerd aan het regelbegin: /^EXAMPLES, /^EXIT STATUS, /^ENVIRONMENT. Gebruik n om langs de treffers te lopen.
• Leer een SYNOPSIS lezen. Rechte haken betekenen optioneel, drie punten betekenen herhaalbaar, cursief betekent "hier jouw waarde", en meerdere regels betekenen meerdere werkwijzen. Twee minuten daar wint het van twintig minuten proberen.
• Controleer welke pagina's bestaan voordat je er een leest. whatis naam kost een seconde en voorkomt dat je de C-functie leest terwijl je het commando wilde.
• Onthoud sectie 5 voor configuratiebestanden. Als je een bestand bewerkt in plaats van een commando draait, is de pagina die je zoekt bijna altijd man 5 iets.
• Blader sectie 7 een keer bewust door. man 7 hier, man 7 signal en man 7 glob leren je elk een stuk Linux dat de meeste mensen langzaam en verkeerd oppikken.
• Zet afbreken permanent uit. Zet export MANOPT="--no-hyphenation --no-justification" in je shell-profiel zodat wat je kopieert is wat je typte.
• Installeer de documentatiepakketten op een werkmachine. Op Debian en Ubuntu brengen manpages en manpages-dev de systeemaanroepen, de bibliotheekfuncties en de meeste overzichten uit sectie 7. Standaard staan ze niet op een server.
• Forceer het origineel als het ertoe doet. Een vertaalde pagina kan achterlopen op de software. Gebruik man -L C naam als je Engelse documentatie volgt of een pagina met iemand anders bespreekt.
• Bouw de index opnieuw op na met de hand installeren. Als apropos niets vindt maar man werkt, draai dan sudo mandb.
• Geef je eigen scripts een man-pagina. Alles wat in /usr/local/bin staat op een server die je voor iemand anders beheert, verdient acht regels roff in /usr/local/share/man/man1.
• Gebruik de hele documentatieverzameling, niet alleen man. De man-pagina is het naslagwerk, --help is de geheugensteun die altijd bij het geïnstalleerde programma hoort, help is de enige bron voor shell-builtins, info is de GNU-cursus, en /usr/share/doc bevat wat geen van alle bevat.

$ man man                        # the manual for the manual
$ man 7 man-pages                # how manual pages are structured
$ man 1 intro                    # what section 1 is for (also 2 to 8)
$ man --help                     # the flag summary
$ info info                      # how to drive the info reader

10. Samenvatting

Het naslagwerk is de meest complete Linux-documentatie die je ooit zult hebben, het staat er al op, en het werkt zonder internetverbinding om drie uur 's nachts.

• man is kort voor manual. Het bevat zelf geen documentatie: het zoekt een roff-bestand, maakt het op met groff, en stuurt het naar een pager.
• Man-pagina's stammen uit de Unix Programmer's Manual van 1971, en de koppen die je vandaag leest (NAME, SYNOPSIS, DESCRIPTION, BUGS, SEE ALSO) komen daar rechtstreeks vandaan.
• Het naslagwerk is opgedeeld in genummerde secties naar soort: 1 commando's, 2 systeemaanroepen, 3 bibliotheekfuncties, 4 apparaten, 5 bestandsformaten, 6 spelletjes, 7 overzichten, 8 beheer.
• Sectie 5 is degene die de meeste mensen nooit ontdekken. man 5 crontab en man 5 sshd_config documenteren de bestanden, niet de commando's.
• De notatie ls(1) is een verwijzing: paginanaam plus sectie. Lees hem, en schrijf hem.
• Leer de SYNOPSIS-notatie een keer goed: [ ] optioneel, ... herhaalbaar, cursief betekent je eigen waarde, meerdere regels betekenen meerdere werkwijzen.
• Spring in de pager met /^EXAMPLES in plaats van te scrollen.
• whatis toont welke pagina's bestaan, apropos doorzoekt hun samenvattingen van een regel, en man -K doorzoekt de volledige tekst.
• Sectie 2 en 3 vormen het naslagwerk voor programmeurs: systeemaanroepen tegenover bibliotheekfuncties, met ERRORS en RETURN VALUE in plaats van EXIT STATUS, en de feature-test macro die je compiler nodig heeft staat in de SYNOPSIS.
• Pagina's kunnen vertaald zijn. man -L nl naam vraagt om Nederlands, man -L C naam forceert het origineel, en buiten het Engels is de dekking dun.
• Een ontbrekende pagina betekent vaak een ontbrekend pakket, geen ontbrekende documentatie. Op Debian en Ubuntu zitten de meeste secties 2, 3 en 7 in manpages en manpages-dev.
• apropos leest een index-cache. Draai sudo mandb nadat je met de hand een pagina hebt geïnstalleerd.
• De zoekvolgorde van secties komt uit /etc/manpath.config en is niet 1, 2, 3. Dat verklaart man printf en man passwd.
• Zet afbreken uit met MANOPT, of de opties die je kopieert bevatten een teken dat je shell niet begrijpt.
• Een ontbrekende pagina sluit af met 16, niet met 1. Shell-builtins hebben helemaal geen pagina: gebruik help cd.
• Weet waar man ophoudt, en merk op dat de vier documentatiecommando's verschillen in bron: --help komt uit het programma, man uit een documentatiepakket, help uit de shell zelf, en info uit de eigen handleiding van het GNU-project.

Dit is het spiekbriefje dat je wilt bewaren:

man NAME                     open the manual page
man 5 NAME                   open it in a specific section
man -a NAME                  show every matching page in turn
man -f NAME                  which pages exist (same as whatis)
man -k WORD                  search the one-line summaries (same as apropos)
man -wK -S 5 WORD            full-text search, section 5, list the files
man -w NAME                  print the path of the page
man -l ./page.1              open a page file directly
man -L C NAME                the original page, not a translation
man -t NAME > page.ps        typeset for print instead of terminal
man -P cat NAME              no pager, straight to stdout
man NAME | grep -A2 -- -x    pipe it like any other text

apropos -s 1 'copy files'    find a command by what it does
whatis -w 'ls*'              wildcard search on page names
mandb                        rebuild the apropos/whatis index
manpath                      show where man looks for pages

/^EXAMPLES                   inside the pager: jump to a heading
n  N                         next / previous match
g  G  q                      top, bottom, quit

export MANWIDTH=80                                  readable width
export MANSECT=8:5:1:7:2:3                          your own section order
export MANOPT="--no-hyphenation --no-justification" copy-paste safe pages

apt install manpages manpages-dev    sections 2, 3 and most of 7 (Debian)
dpkg -S /usr/share/man/...   which package a page came from

help cd                      shell builtins, which have no manual page
help -s cd                   just the synopsis of a builtin
cmd --help                   the version you are actually running
info coreutils 'ls invocation'   the full GNU manual (n p u Enter q)

Goed leren lezen in het naslagwerk is een van die stille vaardigheden die iemand die naar een server gokt onderscheiden van iemand die weet wat die server doet. Als jouw Linux-server iemand nodig heeft die de documentatie leest voordat hij de configuratie aanpast, en die aantekeningen achterlaat waar de volgende persoon mee verder kan, dan is dat precies het soort werk waar ik graag bij help.