Man: Unterschied zwischen den Versionen

Aktuelle Version vom 11. Mai 2025, 20:59 Uhr

Beschreibung

Jedes an man übergebene Argument Seite ist normalerweise der Name eines Programms oder einer Funktion
Gefunden und angezeigt wird die Handbuchseite, die auf jedes der Argumente passt
Wenn ein Abschnitt angegeben wird, sucht man nur in diesem Abschnitt der Handbuchseiten
Ohne eine explizite Angabe werden alle verfügbaren Abschnitte in einer festgelegten Reihenfolge durchsucht (siehe VOREINSTELLUNGEN) und nur die jeweils zuerst gefundene Seite angezeigt, wenn die Seite in mehreren Abschnitten vorkommt

Installation

sudo apt install man

Aufruf

man [man Optionen] [[Abschnitt] Seite ...] ..
man -k [apropos Optionen] Regulärer_Ausdruck ..
man -K [man Optionen] [Abschnitt] Begriff ..
man -f [whatis Optionen] Seite ..
man -l [man Optionen] Datei ..
man -w|-W [man Optionen] Seite ..

Anwendung

Suche in Manual-Pages

Die Einzeldokumentationen enthalten am Beginn einen Abschnitt (Name), der den Zweck des Programms kurz beschreibt (Apropos)
In diesem Abschnitt kann nach bestimmten Stichworten gesucht werden
Für jeden Manualeintrag, der im Abschnitt "Name" dieses Stichwort enthält, wird ein entsprechender Hinweis ausgegeben

$ apropos <stichwort>

Alternative

$ man -k <stichwort>

Beispiel

Sie suchen die Beschreibung des Aufbaus der Passwortdatenbank /etc/passwd

$ man -k passwd
passwd (5) - password file
passwd, npasswd (1) - change login password
rpc.yppasswdd (8) - NIS password update server
yppasswd, ypchfn, ypchsh (1) - NIS password update clients

Die Angaben in Klammern (zum Beispiel passwd (5)) geben an, in welcher Sektion des Manuals sich dieser Eintrag befindet

Die gewünschte Information kann aufgerufen werden

$ man -S 5 passwd

oder kurz mit

$ man 5 passwd

Manpage exportieren

man loginctl > loginctl.txt

Beispiele

Handbuchseite für ls anzeigen

man ls

Handbuchseite für das Makropaket man aus Abschnitt 7 anzeigen

Dies sind alternative Schreibweisen für man 7 man

man 'man(7)'
man man.7

Zeigt die Handbuchseite für das Makropaket man aus Abschnitt 7 an

Dies ist eine weitere alternative Schreibweise für "man 7 man"
Dies könnte beim Kopieren und Einfügen von Querverweisen in Handbuchseiten bequemer sein
Beachten Sie, dass die Klammern normalerweise in Anführungszeichen gesetzt werden müssen, um zu verhindern, dass sie von der Shell interpretiert werden

Zeigt nacheinander alle vorhandenen intro-Handbuchseiten an

Sie können zwischen den aufeinander folgendenden Ausgaben der Seiten abbrechen oder beliebige Seiten überspringen

man -a intro

Formatiert die Handbuchseite für bash in das Standardformat von Troff oder Groff und schickt sie zum Drucker ps

Für Groff ist das Standardausgabeformat gewöhnlich PostScript
Mit man --help können Sie herausfinden, welcher Prozessor mit der Option -t verbunden ist

Dieser Befehl dekomprimiert und formatiert den Nroff-Quelltext der Handbuchseite ./foo.1x.gz in eine geräteunabhängige (device-independent)

dvi-Datei

Die Umleitung der Ausgabe ist notwendig, da die Option -T ohne Anzeigeprogramm die Ausgabe zur Standardausgabe schickt
Die Ausgabe kann mit einem Programm wie xdvi betrachtet oder mit einem Programm wie dvips zu PostScript weiterverarbeitet werden

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

Sucht in den Beschreibungen und Namen der Handbuchseiten nach dem als regulären Ausdruck angesehenen Schlüsselwort printf und gibt alle Fundstellen aus

Diese Option entspricht apropos printf

man -k printf

Sucht die durch smail angegebenen Handbuchseiten und gibt alle Beschreibungen der gefundenen Seiten aus

Diese Option entspricht apropos smail

man -f smail

Parameter

Exit-Status

Anhang

Siehe auch

Dokumentation

Man-Pages

Info-Pages

Links

Weblinks

@@ Zeile 9: / Zeile 9: @@
 == Installation ==
-<syntaxhighlight lang="bash" highlight="1" line>
+<syntaxhighlight lang="bash" highlight="1" line copy>
 sudo apt install man
 </syntaxhighlight>
 == Aufruf ==
-<syntaxhighlight lang="bash" highlight="1-6" line>
+<syntaxhighlight lang="bash" highlight="1-6" line copy>
 man [man Optionen] [[Abschnitt] Seite ...] ..
 man -k [apropos Optionen] Regulärer_Ausdruck ..
@@ Zeile 46: / Zeile 46: @@
 Die gewünschte Information kann aufgerufen werden
-  $ '''man –S 5 passwd'''
+  $ '''man -S 5 passwd'''
 oder kurz mit
@@ Zeile 56: / Zeile 56: @@
 === Beispiele ===
 ; Handbuchseite für ''ls'' anzeigen
-<syntaxhighlight lang="bash" highlight="1" line>
+<syntaxhighlight lang="bash" highlight="1" line copy>
 man ls
 </syntaxhighlight>
 ; Handbuchseite für das Makropaket man aus Abschnitt 7 anzeigen
-* Dies sind alternative Schreibweisen für »man 7 man«
+* Dies sind alternative Schreibweisen für ''man 7 man''
-<syntaxhighlight lang="bash" highlight="1" line>
+<syntaxhighlight lang="bash" highlight="1" line copy>
 man 'man(7)'
 man man.7
@@ Zeile 72: / Zeile 72: @@
 * Beachten Sie, dass die Klammern normalerweise in Anführungszeichen gesetzt werden müssen, um zu verhindern, dass sie von der Shell interpretiert werden
-; Zeigt nacheinander alle vorhandenen »intro«-Handbuchseiten an
+; Zeigt nacheinander alle vorhandenen ''intro''-Handbuchseiten an
 * Sie können zwischen den aufeinander folgendenden Ausgaben der Seiten abbrechen oder beliebige Seiten überspringen
-<syntaxhighlight lang="bash" highlight="1" line>
+<syntaxhighlight lang="bash" highlight="1" line copy>
 man -a intro
 </syntaxhighlight>
@@ Zeile 86: / Zeile 86: @@
 * Die Umleitung der Ausgabe ist notwendig, da die Option -T ohne Anzeigeprogramm die Ausgabe zur Standardausgabe schickt
 * Die Ausgabe kann mit einem Programm wie xdvi betrachtet oder mit einem Programm wie dvips zu PostScript weiterverarbeitet werden
-<syntaxhighlight lang="bash" highlight="1" line>
+<syntaxhighlight lang="bash" highlight="1" line copy>
-man -l -Tdvi ./foo.1x.gz > ./foo.1x.dvi
+man -l -T dvi ./foo.1x.gz > ./foo.1x.dvi
 </syntaxhighlight>
 ; Sucht in den Beschreibungen und Namen der Handbuchseiten nach dem als regulären Ausdruck angesehenen Schlüsselwort printf und gibt alle Fundstellen aus
 * Diese Option entspricht apropos printf
-<syntaxhighlight lang="bash" highlight="1" line>
+<syntaxhighlight lang="bash" highlight="1" line copy>
 man -k printf
 </syntaxhighlight>
@@ Zeile 98: / Zeile 98: @@
 ; Sucht die durch smail angegebenen Handbuchseiten und gibt alle Beschreibungen der gefundenen Seiten aus
 * Diese Option entspricht apropos smail
-<syntaxhighlight lang="bash" highlight="1" line>
+<syntaxhighlight lang="bash" highlight="1" line copy>
 man -f smail
 </syntaxhighlight>
@@ Zeile 105: / Zeile 105: @@
 === Exit-Status ===
-== Konfiguration ==
-=== Dateien ===
-{| class="wikitable options"
-|-
-! Datei !! Beschreibung
-|-
-| [[/etc/manpath.config]] || Konfigurationsdatei für [[man-db]]
-|-
-| [[/usr/share/man]] || globale Handbuchhierarchie
-|}
-=== Umgebungsvariablen ===
-{| class="wikitable options"
-! Umgebungsvariable !! Beschreibung
-|-
-| MANPATH ||Wenn $MANPATH gesetzt ist, wird ihr Wert als Suchpfad für die Handbuchseiten benutzt
-* Siehe den Abschnitt SUCHPFAD in der Handbuchseite manpath(5) für das Standardverhalten und Details dazu, wie mit dieser Umgebungsvariable umgegangen wird
-|-
-| MANROFFOPT ||Jedes Mal, wenn man das Formatierungsprogramm aufruft (nroff, troff oder groff), wird der Inhalt von $MANROFFOPT zur Befehlszeile des Formatierungsprogramms hinzugefügt
-|-
-| MANROFFSEQ ||Wenn $MANROFFSEQ gesetzt ist, wird ihr Wert benutzt, um die Abfolge der Präprozessoren zu bestimmen, die jede Handbuchseite vor Nroff oder Troff durchläuft
-* Als Standard durchlaufen die Seiten den Präprozessor tbl (t)
-|-
-| MANSECT ||Wenn $MANSECT gesetzt ist, wird ihr Wert als eine durch Doppelpunkte gegliederte Liste von Abschnitten interpretiert und dazu benutzt, die zu durchsuchenden Abschnitte und deren Reihenfolge zu bestimmen
-* Die Vorgabe ist »1 n l 8 3 0 2 3posix 3pm 3perl 3am 5 4 9 6 7«, es sei denn, dies wird durch die SECTION-Anweisung in /etc/manpath.config außer Kraft gesetzt
-|-
-| MANPAGER</br>PAGER || Wenn $MANPAGER oder $PAGER gesetzt ist ($MANPAGER wird bevorzugt verwendet), legt dieser Wert das Anzeigeprogramm für die Handbuchseite fest
-Standardmäßig wird pager verwendet, wobei auf cat ausgewichen wird, falls pager nicht gefunden wurde oder nicht ausführbar ist
-Der Wert kann ein einfacher Befehlsname oder ein Befehl mit Argumenten sein
-* Er darf Shell-Maskierung (also linksseitige Schrägstriche sowie einfache und doppelte Anführungszeichen) enthalten
-* Er darf keine Pipelines verwenden, um mehrere Befehle zu verbinden
-* Wenn Sie das benötigen, verwenden Sie ein Skript, das die gewünschte Seite entweder als Argument erhält oder von der Standardeingabe liest
-|-
-| MANLESS ||Wenn $MANLESS gesetzt ist, wird deren Wert als Zeichenkette für die Festlegung einer Eingabeaufforderung für das Anzeigeprogramm less verwendet, so als ob dieser Wert mit der Option -r übergeben worden wäre (daher werden sonstige Vorkommen des Textes $MAN_PN in der gleichen Weise expandiert)
-* Wenn Sie beispielsweise die Eingabeaufforderung unbedingt auf »Meine Eingabeaufforderung« setzen wollen, setzen Sie
-$MANLESS auf ‘-PMeine Eingabeaufforderung’
-* Durch die Option -r wird diese Umgebungsvariable außer Kraft gesetzt
-|-
-| BROWSER ||Wenn $BROWSER gesetzt ist, ist Wert eine durch Doppelpunkte getrennte Liste von Befehlen
-* Mit allen diesen Befehlen wird versucht, einen Web-Browser für man --html zu starten
-* In jedem Befehl wird %s durch einen Dateinamen für die HTML-Ausgabe von Groff, %% durch ein einzelnes Prozentzeichen und %c durch einen Doppelpunkt (:) ersetzt
-|-
-| SYSTEM || Wenn $SYSTEM gesetzt ist, hat das die gleiche Wirkung wie die Verwendung als Argument für die Option -m
-|-
-| MANOPT || Wenn $MANOPT gesetzt ist, wird der Wert dieser Variablen vor der man-Befehlszeile ausgewertet
-* Es wird vorausgesetzt, dass der Wert im gleichen Format wie die Befehlszeile vorliegt
-* Da alle anderen für man spezifischen Umgebungsvariablen auch als Befehlszeilenoptionen ausgedrückt und in $MANOPT aufgenommen werden können, ist zu erwarten, dass Sie obsolet werden. Übrigens müssen alle Leerzeichen, die als Teil eines Arguments interpretiert werden sollen, geschützt werden
-|-
-| MANWIDTH ||Wenn $MANWIDTH gesetzt ist, wird ihr Wert als die Zeilenlänge für die Formatierung der Handbuchseiten verwendet
-* Wenn sie nicht gesetzt ist, werden die Handbuchseiten mit einer für das aktuelle Terminal angemessenen Zeilenlänge angezeigt, die (bei Verfügbarkeit) mit einem Aufruf von ioctl(2) oder dem Wert von $COLUMNS bestimmt wurde
-* Scheitert alles Andere, werden 80 Zeichen pro Zeile ausgegeben
-* Cat-Seiten werden nur dann gespeichert, wenn die Standard-Formatierung verwendet werden kann, also die Zeilenlänge zwischen zwischen 66 und 80 Zeichen liegt
-|-
-| MAN_KEEP_FORMATTING ||Wenn die Ausgabe nicht zu einem Terminal (zum Beispiel in eine Datei oder eine Pipeline) geschickt wird, werden Formatierungszeichen verworfen, um das Ergebnis ohne Spezialwerkzeuge lesen zu können
-* Ist aber $MAN_KEEP_FORMATTING auf einen nicht leeren Wert gesetzt, werden diese Formatierungszeichen beibehalten
-* Dies kann nützlich sein für Adapter, die man interpretieren und Formatierungszeichen verarbeiten können
-|-
-| MAN_KEEP_STDERR ||Normalerweise werden bei der Ausgabe auf einem Terminal (in der Regel mit einem Anzeigeprogramm) alle Fehlermeldungen der Formatierprogramme verworfen, um die Ausgabe des Anzeigeprogramms nicht zu stören
-* Programme wie Groff produzieren häufig relativ harmlose, hässliche Fehlermeldungen über typografische Probleme wie schlechte Ausrichtung
-* Die Anzeige dieser Meldungen ist in der Regel verwirrend, wenn sie zusammen mit der Handbuchseite erfolgt
-* Einige Benutzer wollen sie trotzdem sehen
-* Setzen Sie $MAN_KEEP_STDERR auf einen nicht leeren Wert, damit Fehlermeldungen wie gewohnt angezeigt werden
-|-
-| MAN_DISABLE_SECCOMP ||Unter Linux sperrt man normalerweise Unterprozesse, die nicht vertrauenswürdige Daten verarbeiten, in einer seccomp(2)-Sandbox ein
-* Dadurch wird es sicherer, komplexen Auswertungscode über beliebige Handbuchseiten hinweg auszuführen
-* Falls dies aus irgendeinem Grund fehlschlägt, der nicht auf den Inhalt der anzuzeigenden Handbuchseite zurückzuführen wäre, können Sie $MAN_DISABLE_SECCOMP auf einen beliebigen von Null verschiedenen Wert setzen, um die Sandbox zu deaktivieren
-|-
-| PIPELINE_DEBUG ||Falls die Umgebungsvariable $PIPELINE_DEBUG auf »1« gesetzt ist, dann schreibt man Debugging-Meldungen in die Standardfehlerausgabe, die jeden ausgeführten Unterprozess beschreiben
-|-
-| LANG</br>LC_MESSAGES ||Abhängig von System und Implementierung werden entweder $LANG oder $LC_MESSAGES oder beide nach Informationen zur aktuellen Locale durchsucht
-* man wird (wenn möglich) seine Nachrichten in dieser Locale anzeigen
-* Für genaue Details siehe setlocale(3)
-|}
 <noinclude>
@@ Zeile 184: / Zeile 110: @@
 == Anhang ==
 === Siehe auch ===
-{{Special:PrefixIndex/{{BASEPAGENAME}}}}
+{{Special:PrefixIndex/{{BASEPAGENAME}}/}}
-==== Dokumentation ====
+=== Dokumentation ===
+; Man-Pages
+; Info-Pages
-===== Man-Page =====
+=== Links ===
-===== Info-Pages =====
+==== Weblinks ====
-==== Links ====
-===== Projekt =====
-===== Weblinks =====
 {{DEFAULTSORT:man}}
@@ Zeile 197: / Zeile 123: @@
 [[Kategorie:Linux/Befehl]]
-[[Kategorie:Linux/Dokumentation]]
+[[Kategorie:Manpage]]
 </noinclude>