Die wichtigste Fähigkeit eines Administrators besteht darin, jede bekannte oder unbekannte Situation meistern zu können. Dieses Kapitel zeigt eine Reihe von Methoden auf, die es Ihnen - hoffentlich - ermöglichen, die Ursache jeden Problems, das Ihnen begegnet, einzugrenzen, sodass Sie es lösen können.
7.1. Dokumentationsquellen
Bevor Sie verstehen können, was tatsächlich vor sich geht, wenn Ihnen ein Problem begegnet, müssen Sie die theoretische Rolle kennen, die jedes an dem Problem beteiligte Programm spielt. Hierbei besteht die beste Reaktion darin, zunächst in ihrer Dokumentation nachzuschlagen; da diese Dokumentation jedoch umfangreich und weit verstreut ist, sollten Sie wissen, wo sie zu finden ist.
Manual pages, while relatively terse in style, contain a great deal of essential information. We will quickly go over the command for viewing them, provided by the
man-db package. Simply type
man manual-page — the manual page usually goes by the same name as the command whose documentation is sought. For example, to learn about the possible options for the
cp command, you would type the
man cp command at the shell prompt (see sidebar
ZURÜCK ZU DEN GRUNDLAGEN Die Shell, ein Befehlszeileninterpreter).
Man pages not only document commands and programs accessible from the command line, but also configuration files, system calls, library functions, and so forth. Sometimes names can collide. For example, the shell's read command has the same name as the read system call. This is why manual pages are organized in numbered sections:
- 1
Befehle, die von der Befehlszeile aus ausgeführt werden können;
- 2
Systemaufrufe (vom Kernel bereitgestellte Funktionen);
- 3
Bibliotheksfunktionen (von Systembibliotheken bereitgestellt);
- 4
Geräte (bei Unix-ähnlichen Systemen sind dies besondere Dateien, die sich normalerweise im Verzeichnis /dev/ befinden);
- 5
Konfigurationsdateien (Formate und Konventionen);
- 6
Spiele;
- 7
Zusammenstellungen von Makros und Standards;
- 8
Systemverwaltungsbefehle;
- 9
Kernelroutinen.
Man kann den Abschnitt der Handbuchseite, nach dem man sucht, angeben: um die Dokumentation des Systemaufrufs read nachzuschlagen, geben Sie man 2 read ein. Wenn kein Abschnitt ausdrücklich angegeben wird, wird der erste Abschnitt, der eine Handbuchseite mit dem gesuchten Namen hat, angezeigt. So liefert man shadow die Ausgabe shadow(5), da es in den Abschnitten 1 bis 4 keine Handbuchseiten für shadow gibt.
Falls Sie die Namen der Befehle nicht kennen, ist das Handbuch für Sie natürlich nicht sehr nützlich. Hierfür gibt es den Befehl apropos, der Ihnen hilft, die Handbuchseiten, oder genauer gesagt, ihre Kurzbeschreibungen zu durchsuchen. Jede Handbuchseite beginnt grundsätzlich mit einer einzeiligen Zusammenfassung. Der Befehl apropos zeigt eine Liste derjenigen Handbuchseiten an, in deren Zusammenfassung die gesuchten Stichwörter enthalten sind. Wenn Sie sie gut auswählen, werden Sie den Namen des benötigten Befehls finden.
Beispiel 7.1. Den Befehl cp mit apropos finden
$ apropos "copy file"
cp (1) - copy files and directories
cpio (1) - copy files to and from archives
hpcopy (1) - copy files from an HFS+ volume
install (1) - copy files and set attributes
ntfscp (8) - copy file to an NTFS volume.
The
man command is not the only means of consulting the manual pages, since
khelpcenter and
konqueror (by KDE) and
yelp (under GNOME) programs also offer this possibility. There is also a web interface, provided by the
man2html package, which allows you to view manual pages in a web browser. On a computer where this package is installed, use this URL after following the instructions in
/usr/share/doc/man2html/README.Debian:
Dieses Hilfsprogramm benötigt einen Webserver. Deshalb sollten Sie dieses Paket auf einem Ihrer Server installieren: Alle Nutzer des lokalen Netzwerks können so von diesem Dienst profitieren (auch Nicht-Linux-Rechner), und Sie ersparen es sich, auf jedem Arbeitsplatzrechner einen HTTP-Server einzurichten. Wenn Ihr Server auch von anderen Netzwerken aus erreichbar ist, sollten Sie den Zugriff auf diesen Dienst besser auf die Nutzer des lokalen Netzwerks beschränken.
Last but not least, you can view all manual pages available in Debian (even those that are not installed on your machine) on the
manpages.debian.org service. It offers each manual page in multiple versions, one for each Debian release.
Das GNU-Projekt hat für die meisten seiner Programme Handbücher im info-Format geschrieben. Deshalb beziehen sich viele Handbuchseiten auf die entsprechende info-Dokumentation. Dieses Format bietet einige Vorteile, jedoch ist das Standardprogramm zur Betrachtung dieser Dokumente (es heißt info) etwas komplizierter. Sie sollten stattdessen pinfo verwenden (aus dem Paket pinfo).
Die Dokumentation info hat eine hierarchische Struktur, und wenn Sie pinfo ohne Parameter aufrufen, wird eine Liste der auf der ersten Ebene verfügbaren Knoten angezeigt. Normalerweise tragen Knoten den Namen der entsprechenden Befehle.
With
pinfo navigating between these nodes is easy to achieve with the arrow keys. Alternatively, you could also use a graphical browser, which is a lot more user-friendly. Again,
konqueror and
yelp work; the
info2www package also provides a web interface.
Beachten Sie, dass das info-System nicht für die Übersetzung geeignet ist, im Gegensatz zum manpage-System. info-Dokumente sind daher fast immer in Englisch. Wenn Sie jedoch das Programm pinfo beauftragen, eine nicht existierende info Seite anzuzeigen, wird es (falls vorhanden) auf die man-Seite mit dem gleichen Namen zurückgreifen, die übersetzt sein könnte.
7.1.3. Konkrete Dokumentation
Jedes Paket verfügt über seine eigene Dokumentation. Sogar die am geringsten dokumentierten Programme haben wenigstens eine README-Datei, die einige interessante und wichtige Informationen enthält. Diese Dokumentation ist im Verzeichnis /usr/share/doc/paket/ installiert (wobei paket dem Namen des Pakets entspricht). Falls die Dokumentation außergewöhnlich groß ist, muss sie nicht unbedingt im Hauptpaket eines Programms enthalten sein, sondern kann in ein speziell hierfür vorgesehenes Paket ausgelagert sein, das dann üblicherweise paket-doc heißt. Das Hauptprogramm empfiehlt im Allgemeinen die Installation des Dokumentationspakets, so dass Sie es leicht finden können.
The
/usr/share/doc/package/ directory also contains some files provided by Debian which complete the documentation by specifying the package's particularities or improvements compared to a traditional installation of the software. The
README.Debian file also indicates all of the adaptations that were made to comply with the Debian Policy. The
changelog.Debian.gz file allows the user to follow the modifications made to the package over time: it is very useful to try to understand what has changed between two installed versions that do not have the same behavior. Finally, there is sometimes a
NEWS.Debian.gz file which documents the major changes in the program that may directly concern the administrator (see
Abschnitt 6.7.2, „Problembehandlung nach einer Aktualisierung“).
In den meisten Fällen gibt es zu freien Software-Programmen Webseiten, die zu ihrer Veröffentlichung dienen und dazu, die Gemeinschaft ihrer Entwickler und Anwender zusammenzubringen. Diese Seiten sind häufig voll einschlägiger Informationen in verschiedener Form: offizieller Dokumentation, FAQ (häufig gestellte Fragen), Mailinglisten-Archiven usw. Probleme, die Sie haben könnten, sind häufig schon Gegenstand zahlreicher Fragen gewesen; die FAQ oder die Mailinglisten-Archive können dafür eine Lösung parat halten. Die gute Beherrschung von Suchmaschinen ist für das schnelle Auffinden relevanter Seiten äußerst nützlich (durch Einschränkung der Suche auf die Internet-Domain oder Sub-Domain, die dem Programm gewidmet ist). Falls die Suche zu viele Seiten ergibt, oder falls die Ergebnisse nicht dem entsprechen, was Sie suchen, können Sie das Stichwort debian hinzufügen, um so die Ergebnisse einzuschränken und genauer auf relevante Informationen abzuzielen.
If you do not know the address for the software's website, there are various means of getting it. First, check if there is a
Homepage field in the package's meta-information (
apt show package). Alternately, the package description may contain a link to the program's official website. If no URL is indicated, look at
/usr/share/doc/package/copyright. The Debian maintainer generally indicates in this file where they got the program's source code, and this is likely to be the website that you need to find. If at this stage your search is still unfruitful, consult a free software directory, such as FSF's Free Software Directory, or search directly with a search engine, such as Google, DuckDuckGo, Yahoo, etc.
You might also want to check the Debian wiki, a collaborative website where anybody, even simple visitors, can make suggestions directly from their browsers. It is used equally by developers who design and specify their projects, and by users who share their knowledge by writing documents collaboratively.
7.1.5. Anleitungen (HOWTO)
A HOWTO is a document that describes, in concrete terms and step by step, “how to” reach a predefined goal. The covered goals are relatively varied, but often technical in nature: for example, setting up IP Masquerading, configuring software RAID, installing a Samba server, etc. These documents often attempt to cover all of the potential problems likely to occur during the implementation of a given technology.
Many such tutorials are managed by the Linux Documentation Project (LDP), whose website hosts all of these documents:
Debian also provides tutorials for its users:
All these documents should be taken with a grain of salt. They are often several years old; the information they contain is sometimes obsolete. This phenomenon is even more frequent for their translations, since updates are neither systematic nor instant after the publication of a new version of the original documents. Further many tutorials nowadays are provided by bloggers, sharing their individual solution with the interested reader. They often lack important information, i.e. the reason why some configuration has been chosen over another, or why some option has been enabled or disabled. Because blogging and creating own websites made it so easy to share, many of these often short tutorials exist, but only a few are actively maintained and well-kept. This can make it hard, to find the "right" one for you. This is all part of the joys of working in a volunteer environment and without constraints…
