LPI 1.108.1 Nutzung und Verwaltung lokaler Systemdokumentation

Wichtung: 4

Beschreibung: Die Kandidaten sollen in der Lage sein, man und das Material unter /usr/share/doc/ zu nutzen und zu administrieren.

Wichtigste Wissensgebiete:
Auffinden relevanter Man-Pages.
Durchsuchen der Man-Pages-Sektionen.
Auffinden von Befehlen und zugehöriger Man-Pages.
Konfiguration des Zugriffs auf die Man-Sourcen und das Man-System.
Vorbereiten von Man-Pages für den Ausdruck.
Nutzen der Systemdokumentation in /usr/share/doc/ und Festlegen, welche Dokumentation dort gehalten wird.

Liste wichtiger Dateien, Verzeichnisse und Anwendungen:
MANPATH man
apropos
whatis

Handbuchsystem - Manpages

Linux besitzt ein Handbuchsystem, welches es ermöglicht, zu nahe jedem Programm oder Datei eine ausführliche Beschreibung nachlesen zu können. Dabei gibt es so genannte Handbuch-Sektionen, in welche die Handbücher eingeteilt werden:

1 - Ausführbare Programme und Shell-Befehle
2 - Systemaufrufe (System Calls)
3 - C-Bibliotheksfunktionen (Subroutines)
4 - Gerätedateien (Devices)
5 - Dateiformate und Konventionen (File Formats) Bsp. /etc/passwd
6 - Spiele (Games)
7 - Makropakete und Konventionen
8 - Kommandos für die Systemverwaltung (Sys. Administration)
9 - Kernelroutinen (Kernel)

Die Handbuch-Seiten werden nicht im ASCII-, sondern einem speziellen GROFF-Format formatiert, welche mit dem Programm man angezeigt werden können. man macht im Prinzip nichts anderes, als die Manpages in ein allgemeines Textformat zu konvertieren, damit diese nahezu überall dargestellt werden können. Die Syntax von man lautet:

man [Optionen] [Sektion] Name

Folgendes Beispiel zeigt den Aufruf der Manpage des Programms passwd:

man passwd

Was aber, wenn man sich die Manpage zur gleichnamigen Datei /etc/passwd anzeigen lassen möchte? Hier kommen die oben erwähnten Handbuch-Sektionen zum Einsatz. Da standardmäßig der erste Suchtreffer in einer Sektion genommen wird, wurde im Fall von passwd das Programm gemeint. Um nun die Manpage der Datei /etc/passwd anzeigen zu lassen, muss man die fünfte Handbuch-Sektion ansprechen:

man 5 passwd

apropos / whatis - Manpagebeschreibung

Der Fall passwd zeigt, dass es mehrere Manpages zu einem Begriff gibt. Nämlich die Datei /etc/passwd und das Programm passwd. Um herauszufinden, welche Manpage wie geladen werden kann, gibt es die Programme apropos und whatis.

whatis
Das Programm whatis tut eigentlich nix anderes, als Kurzbeschreibungen der Programme und Daten zu durchsuchen. Die Syntax ist total simpel:

# whatis passwd

passwd (1) - ändert das Paßwort zum System
passwd (5) - Paßwort-Datei

Auf der linken Seite sehen wir nun die möglichen Programme und Dateien, auf der rechten Seite die jeweiligen Beschreibungen. whatis durchsucht nur die linke Seite.

apropos
anders als whatis durchsucht apropos die ganze Zeile dieser Kurzbeschreibung:

# apropos passwort

passwd (1) - ändert das Paßwort zum System
fgetpwent (3) - arbeite mit Paßworteintrag
endpwent (3) - arbeite mit Paßworteintrag
chsh (1) - ändert den Loginshell Eintrag in der Paßwortdatei
getpwnam (3) - arbeite mit Paßworteintrag
setpwent (3) - arbeite mit Paßworteintrag
passwd (5) - Paßwort-Datei

Handbuch-Verzeichnisse

Laut dem offiziellen Linux-Standard sollen Handbuch-Seiten im Verzeichnis /usr/share/man. Die genauen Verzeichnisse kann man sich mit folgendem Befehl anzeigen lassen:

# echo $MANPATH