Man: Unterschied zwischen den Versionen
Keine Bearbeitungszusammenfassung |
|||
| Zeile 6: | Zeile 6: | ||
Wenn ihr über einen Befehl stolpert und nicht wisst, was er tut. Gebt einfach man ein, gefolgt von dem Befehl. Dann seht ihr eine Anleitung (Manual), wie dieser funktioniert. Mit den Pfeiltasten könnt ihr durch die Anleitung im Terminal scrollen. Mit der Taste Q beendet ihr die Anleitung. | Wenn ihr über einen Befehl stolpert und nicht wisst, was er tut. Gebt einfach man ein, gefolgt von dem Befehl. | ||
Dann seht ihr eine Anleitung (Manual), wie dieser funktioniert. Mit den Pfeiltasten könnt ihr durch die Anleitung | |||
im Terminal scrollen. Mit der Taste Q beendet ihr die Anleitung. | |||
== Beispiel== | == Beispiel== | ||
so schreibt man das Kommando | so schreibt man das Kommando | ||
| | | | ||
man BEFEHL | man BEFEHL | ||
MAN(1) Dienstprogramme für Handbuchseiten MAN(1) | MAN(1) Dienstprogramme für Handbuchseiten MAN(1) | ||
BEZEICHNUNG | BEZEICHNUNG | ||
man - eine Oberfläche für die System-Referenzhandbücher | man - eine Oberfläche für die System-Referenzhandbücher | ||
ÜBERSICHT | ÜBERSICHT | ||
man [man Optionen] [[Abschnitt] Seite ...] ... | man [man Optionen] [[Abschnitt] Seite ...] ... | ||
man -k [apropos Optionen] Regulärer_Ausdruck ... | man -k [apropos Optionen] Regulärer_Ausdruck ... | ||
| Zeile 28: | Zeile 30: | ||
man -w|-W [man Optionen] Seite ... | man -w|-W [man Optionen] Seite ... | ||
BESCHREIBUNG | BESCHREIBUNG | ||
man ist das System-Anzeigeprogramm für die Handbuchseiten. Je‐ | man ist das System-Anzeigeprogramm für die Handbuchseiten. Je‐ | ||
des an man übergebene Argument Seite ist normalerweise der | des an man übergebene Argument Seite ist normalerweise der | ||
| Zeile 40: | Zeile 42: | ||
mehreren Abschnitten vorkommt. | mehreren Abschnitten vorkommt. | ||
= Mehr Beispiele= | = Mehr Beispiele= | ||
*man ls | *man ls | ||
*man cat | *man cat | ||
*man cp und soweiter und sofort. | *man cp und soweiter und sofort. | ||
==Funktionsweise== | ==Funktionsweise== | ||
* Immer, wenn Sie eine man Page aufrufen, konsultiert das Programm ''man'' die in der Variablen ''$MANPATH'' enthaltenen Verzeichnisse. Hier können mehrere Verzeichnisse auf einmal hinterlegt sein. | * Immer, wenn Sie eine man Page aufrufen, konsultiert das Programm ''man'' die in der Variablen ''$MANPATH'' | ||
* In nach Sektionen unterteilten Unterverzeichnissen befinden sich die Dateien der man Pages im komprimierten Zustand | enthaltenen Verzeichnisse. Hier können mehrere Verzeichnisse auf einmal hinterlegt sein. | ||
* Das man System dekomprimiert die angeforderte Datei und übergibt sie anschließend an einen Pager. Dieser zeigt daraufhin die gewünschte man Page an. | * In nach Sektionen unterteilten Unterverzeichnissen befinden sich die Dateien der man Pages im komprimierten | ||
Zustand | |||
* Das man System dekomprimiert die angeforderte Datei und übergibt sie anschließend an einen Pager. Dieser zeigt | |||
daraufhin die gewünschte man Page an. | |||
=Sektionen= | =Sektionen= | ||
Das man System ist in mehrere Sektionen unterteilt. Diese Sektionen sind folgendermaßen gegliedert: | Das man System ist in mehrere Sektionen unterteilt. Diese Sektionen sind folgendermaßen gegliedert: | ||
* ausführbare Programme für Benutzer | * ausführbare Programme für Benutzer | ||
* Systemaufrufe (Funktionen, die durch den Kernel unterstützt werden) | * Systemaufrufe (Funktionen, die durch den Kernel unterstützt werden) | ||
* Bibliothek aufrufe (Libraries) | * Bibliothek aufrufe (Libraries) | ||
* besondere Dateien (normalerweise in ''/dev'') | * besondere Dateien (normalerweise in ''/dev'') | ||
* Dateiformate und Konventionen | * Dateiformate und Konventionen | ||
* Spiele | * Spiele | ||
* Sonstiges (Makro-Pakete und Konventionen) | * Sonstiges (Makro-Pakete und Konventionen) | ||
* administrative Programme (nur für den User root) | * administrative Programme (nur für den User root) | ||
* Kernel-Routinen (nicht standardisiert) | * Kernel-Routinen (nicht standardisiert) | ||
== Aufbau == | == Aufbau == | ||
Der Aufbau einer Manpage ist festgelegt und sollte immer die folgenden Elemente enthalten: | Der Aufbau einer Manpage ist festgelegt und sollte immer die folgenden Elemente enthalten: | ||
*''Name'' – die Bezeichnung des Elements mit einer kurzen Beschreibung | *''Name'' – die Bezeichnung des Elements mit einer kurzen Beschreibung | ||
*''Synopsis'' – eine vollständige Kurzbeschreibung der Syntax | *''Synopsis'' – eine vollständige Kurzbeschreibung der Syntax | ||
*''Description'' – eine ausführliche Beschreibung des Elements | *''Description'' – eine ausführliche Beschreibung des Elements | ||
*''Defaults'' – voreingestellte Parameter | *''Defaults'' – voreingestellte Parameter | ||
*''Overview'' – ein Überblick über die komplexeren Zusammenhänge | *''Overview'' – ein Überblick über die komplexeren Zusammenhänge | ||
*''Options'' – Optionen und deren Beschreibung | *''Options'' – Optionen und deren Beschreibung | ||
*''Return Values'' – Informationen über eventuelle Rückgabewerte, teilweise auch als Exit-Status bezeichnet | *''Return Values'' – Informationen über eventuelle Rückgabewerte, teilweise auch als Exit-Status bezeichnet | ||
*''See also'' – Verweise auf artverwandte Themen | *''See also'' – Verweise auf artverwandte Themen | ||
*''Bugs'' – bekannte Fehler | *''Bugs'' – bekannte Fehler | ||
*''Files'' – Konfigurationsdateien u. Ä. | *''Files'' – Konfigurationsdateien u. Ä. | ||
Version vom 10. November 2020, 14:17 Uhr
Funktion
Mit dem Befehl "man" kann man in einer Konsole eine Manual (Anleitung) für auf dem PC installierte Software oder andere Konsolenbefehle aufrufen.
man – Anleitung zum Befehl anzeigen
Wenn ihr über einen Befehl stolpert und nicht wisst, was er tut. Gebt einfach man ein, gefolgt von dem Befehl. Dann seht ihr eine Anleitung (Manual), wie dieser funktioniert. Mit den Pfeiltasten könnt ihr durch die Anleitung im Terminal scrollen. Mit der Taste Q beendet ihr die Anleitung.
Beispiel
so schreibt man das Kommando
|
man BEFEHL
MAN(1) Dienstprogramme für Handbuchseiten MAN(1)
BEZEICHNUNG
man - eine Oberfläche für die System-Referenzhandbücher
ÜBERSICHT
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 ...
BESCHREIBUNG
man ist das System-Anzeigeprogramm für die Handbuchseiten. Je‐
des an man übergebene Argument Seite ist normalerweise der
Name eines Programms oder einer Funktion. Gefunden und ange‐
zeigt 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 An‐
gabe 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.
= Mehr Beispiele= *man ls
*man cat
*man cp und soweiter und sofort.
==Funktionsweise== * Immer, wenn Sie eine man Page aufrufen, konsultiert das Programm man die in der Variablen $MANPATH enthaltenen Verzeichnisse. Hier können mehrere Verzeichnisse auf einmal hinterlegt sein. * In nach Sektionen unterteilten Unterverzeichnissen befinden sich die Dateien der man Pages im komprimierten Zustand * Das man System dekomprimiert die angeforderte Datei und übergibt sie anschließend an einen Pager. Dieser zeigt daraufhin die gewünschte man Page an.
=Sektionen= Das man System ist in mehrere Sektionen unterteilt. Diese Sektionen sind folgendermaßen gegliedert: * ausführbare Programme für Benutzer * Systemaufrufe (Funktionen, die durch den Kernel unterstützt werden) * Bibliothek aufrufe (Libraries) * besondere Dateien (normalerweise in /dev) * Dateiformate und Konventionen * Spiele * Sonstiges (Makro-Pakete und Konventionen) * administrative Programme (nur für den User root) * Kernel-Routinen (nicht standardisiert)
== Aufbau == Der Aufbau einer Manpage ist festgelegt und sollte immer die folgenden Elemente enthalten: *Name – die Bezeichnung des Elements mit einer kurzen Beschreibung *Synopsis – eine vollständige Kurzbeschreibung der Syntax *Description – eine ausführliche Beschreibung des Elements *Defaults – voreingestellte Parameter *Overview – ein Überblick über die komplexeren Zusammenhänge *Options – Optionen und deren Beschreibung *Return Values – Informationen über eventuelle Rückgabewerte, teilweise auch als Exit-Status bezeichnet *See also – Verweise auf artverwandte Themen *Bugs – bekannte Fehler *Files – Konfigurationsdateien u. Ä.