Manpages
Manpages - Systemhandbücher
Beschreibung
- Manpages
Sammlung von Hilfe- und Dokumentationsseiten unter Unix und verwandten Betriebssystemen
- Index
Zur schnellen Durchmusterung wird ein eigener Index, die Whatis-Datenbank, angelegt
- Erstellung
Manpages werden mit dem Macro-Pakets man mit dem Unix-Systemwerkzeug troff erzeugt
Sektionen
- Gliederung, Sections
| Sektion | Beschreibung |
|---|---|
| 1 | User Commands and Daemons („Anwender-Kommandos und Hintergrunddienste“) |
| 2 | System Calls and Kernel Services („Systemaufrufe und -dienste“) |
| 3 | Subroutines („Unterprogramme“) |
| 4 | Special Files, Device Drivers and Hardware („Geräte“) |
| 5 | Configuration Files („Konfigurationsdateien“) |
| 6 | Games („Spiele“) |
| 7 | Miscellaneous Commands („Verschiedenes“) |
| 8 | Administrative Commands and Daemons („Verwaltung“) |
So verweist die Notation jail(8) auf die Handbuchseite des FreeBSD Systemverwaltungs-Kommando jail, wohingegen die Notation jail(2) auf die Handbuchseite des FreeBSD Systemaufrufs jail hindeutet.
Die Nummer in Klammern hinter dem Namen des Kommandos folgt der Einteilung in zehn FreeBSD Manpage-Sections ("Bereiche"), diese sind: (1) Generelle Kommandos, (2) Systemaufrufe, (3) Subroutinen, (4) Spezialdateien, (5) Dateiformate, (6) Spiele, (7) Makros und Konventionen, (8) Wartungskommandos, (9) Kernelschnittstelle, (n) Neue Kommandos.
Aufbau einer Manpage
- Bereiche
| Bereich | Beschreibung |
|---|---|
| NAME | Name des Programms gefolgt von einer einzeiligen Beschreibung |
| SYNOPSIS | Für Programme wird hier eine vollständige Liste der Parameter und Optionen beschrieben |
| DESCRIPTION | Eine Textbeschreibung der Funktionsweise des Befehls oder der Funktion. (Üblicherweise jedoch nicht der Benutzung, siehe unten.) |
| OPTIONS / FLAGS | Eine üblicherweise alphabetisch sortierte Liste der Optionen und ihrer zulässigen Argumente |
| (USAGE) | Eine Anleitung für den Einsatz des Programms |
| EXIT STATUS | Beschreibung möglicher Rückgabewerte und deren Bedeutung |
| (EXAMPLES) | Einige Beispiele für die Benutzung |
| (FILES) | Falls bestimmte Dateien (etwa Konfigurationsdateien) an der Funktion des Programms beteiligt sind oder durch die Ausführung desselben betroffen sind, so werden sie hier aufgeführt und ihre Funktion beschrieben |
| SEE ALSO | Eine Liste ähnlicher oder verwandter Befehle oder Funktionen, bei betroffenen Dateien wird hier auf die entsprechenden Einträge in Section 5 verwiesen |
Siehe auch
Dokumentation
- Man-Page
- Info-Pages