MANPATH(5) /etc/man_db.conf MANPATH(5) BEZEICHNUNG manpath - das Format der Datei /etc/man_db.conf BESCHREIBUNG Diese Konfigurationsdatei wird von den Handbuchseiten-Hilfsprogrammen dazu benutzt, den Benutzer-Handbuchpfad zur Laufzeit zu bestimmen, Handbuch-Hierarchien (Manpaths) als systemweit zu erkennen und Verzeichnisse fur die Speicherung von Cat-Dateien zuzuordnen. Wenn die Umgebungsvariable $MANPATH schon gesetzt ist, wird die Information in /etc/man_db.conf die Variable nicht ausser Kraft setzen. SUCHPFAD Standardmassig wertet man-db die Umgebungsvariable $PATH des Benutzers aus. Fur jeden gefundenen Pfad-Bestandteil wird ein Hierarchie-Bestandteil zum suchpfad hinzugefugt. Falls es in der Konfigurationsdatei fur einen gegebenen Pfad-Bestandteil keine MANPATH_MAP-Zeile gibt, dann wird alles der Formen Pfad-Bestandteil/../man, Pfad-Bestandteil/man und Pfad-Bestandteil/share/man, was als Verzeichnis existiert, zum Suchpfad hinzugefugt. Dann werden alle MANDATORY_MANPATH-Eintrage aus der Konfigurationsdatei zum Suchpfad hinzugefugt. Zum Schluss, sofern die Option --systems verwendet wird oder die Umgebungsvariable $SYSTEM gesetzt ist, sollte es aus einer Folge von Betriebssystemnamen bestehen, die durch Kommata getrennt sind. Dies fungiert als Vorlage, wobei der Suchpfad erweitert wird, um auf die Handbuchseiten anderer Betriebssysteme zugreifen zu konnen: Fur jeden Systemnamen sucht man-db nach diesem Namen als Unterverzeichnis jedes der Eintrage im Suchpfad und fugt, sofern er existiert, ihn zum finalen Suchpfad hinzu. Wenn der Suchpfad beispielsweise /usr/share/man:/usr/local/man ware und $SYSTEM auf newOS:man gesetzt ist, ware der finale Suchpfad /usr/share/man/newOS:/usr/share/man:/usr/local/man/newOS:/usr/local/man. Die Umgebungsvariable $MANPATH setzt die standardmassigen Handbuchseiten-Suchpfade von man-db ausser Kraft. Fur die meisten Benutzer sollte es nicht notwendig sein, diese zu setzen. Deren Syntax ist ahnlich der Umgebungsvariable $PATH: Sie besteht aus einer Folge von Verzeichnisnamen, die durch Kommata getrennt sind. Sie setzt den vorstehend beschriebenen standardmassigen Suchpfad ausser Kraft. Wenn der Wert von $MANPATH mit einem Doppelpunkt beginnt, wird der standardmassige Suchpfad am Anfang eingefugt. Endet der Wert mit einem Doppelpunkt, wird der standardmassige Suchpfad am Ende angehangt. Enthalt der wert von $MANPATH einen doppelten Doppelpunkt (::), dann wird der standardmassige Suchpfad in der Mitte des Wertes zwischen den beiden Doppelpunkten eingefugt. FORMAT Derzeit werden die folgenden Feldtypen erkannt: # Kommentar Leerzeilen und Zeilen, die mit einem # beginnen, werden als Kommentare behandelt und ignoriert. MANDATORY_MANPATH geforderter Hierarchie-Bestandteil Zeilen dieser Form zeigen die Hierarchien an, die jede automatisch erzeugte $MANPATH-Variable beinhalten sollte. Normalerweise gehort dazu /usr/man. MANPATH_MAP Pfad-Bestandteil Hierarchie-Bestandteil Zeilen dieser Form wandeln $PATH in die entsprechende $MANPATH-Syntax um. Fur jeden Pfad-Bestandteil im personlichen $PATH wird ein Hierarchie-Bestandteil zu $MANPATH hinzugefugt. MANDB_MAP Hierarchie-Bestandteil [ Cat-Hierarchie-Bestandteil ] Zeilen dieser Form geben die systemweiten Hierarchien und optional den Speicherort ihrer Cat-Dateien an. Dieser Feldtyp ist besonders wichtig, wenn man ein Setuid-Programm ist und die System-Konfigurationsdatei /etc/man_db.conf die personliche Konfigurationsdatei .manpath uberlagert. Das Feld gibt an, auf welche Hierarchien als Setuid-Benutzer und auf welche als der aufrufende Benutzer zugegriffen wird. Die systemweiten Handbuch-Hierarchien sind ublicherweise die unter /usr gespeicherten wie /usr/man, /usr/local/man und /usr/X11R6/man. Wenn Cat-Seiten fur einen Hierarchie-Bestandteil nicht oder am traditionellen Speicherort gespeichert werden sollen, kann der Cat-Hierarchie-Bestandteil weggelassen werden. Die traditionelle Platzierung der Cat-Dateien ware fur nicht schreibbar eingebundene Handbuch-Hierarchien unmoglich. Aus diesem Grund ist es moglich, beliebige gultige Verzeichnis-Hierarchien als Speicherorte anzugeben. Zur Wahrung des Linux FSSTND kann das Schlusselwort FSSTND anstelle eines vorhandenen Verzeichnisses verwendet werden. Leider mussen alle System-Handbuchpfade angegeben werden, einschliesslich derer von alternativen Betriebssystemen wie /usr/man/sun und aller Pfade fur NLS Locales wie beispielsweise /usr/man/de_DE.88591. Da die Informationen Zeile fur Zeile in der Schreibreihenfolge analysiert werden, mussen alle einer anderen untergeordneten Handbuch-Hierarchien zuerst aufgefuhrt werden, damit falsche Zuordnungen ausgeschlossen werden. Beispielsweise muss /usr/man/de_DE.88591 vor /usr/man aufgefuhrt werden. DEFINE Schlussel Wert Zeilen dieser Form definieren verschiedene Konfigurationsvariablen. In der Standard-Konfigurationsdatei werden die von den Handbuch-Programmen verwendeten Variablen festgelegt. Dazu gehoren Standard-Pfade zu verschiedenen Programmen (wie grep und tbl) und Satze von Standard-Argumenten fur diese Programme. SECTION Abschnitt ... Zeilen dieser Form bestimmen die Reihenfolge, in der Handbuch-Abschnitte durchsucht werden sollen. Enthalt die Konfigurationsdatei keinen SECTION-Eintrag, ist der Standardwert: SECTION 1 n l 8 3 0 2 3type 5 4 9 6 7 Sind mehrere SECTION-Eintrage vorhanden, werden deren Listen aneinander gehangt. Wenn eine bestimmte Erweiterung (z.B. 1mh) nicht in dieser Liste eingetragen ist, werden die entsprechenden Seiten mit dem Rest des zugehorigen Abschnitts angezeigt. Der Effekt davon ist: Nur, wenn Sie eine bestimmte Reihenfolge erzwingen wollen, mussen Sie explizit eine Liste von Erweiterungen angeben. Abschnitte mit Erweiterungen sollten in der Regel den Hauptabschnitten benachbart sein (z.B. >>1 1mh 8 ... <<). Als alternativer Name fur diese Direktive wird SECTIONS akzeptiert. MINCATWIDTH Breite Wenn die Terminalbreite kleiner als Breite ist, werden fehlende Cat-Seiten nicht erzeugt und vorhandene nicht angezeigt. Der Standardwert ist 80. MAXCATWIDTH Breite Wenn die Terminalbreite grosser als Breite ist, werden fehlende Cat-Seiten nicht erzeugt und vorhandene nicht angezeigt. Der Standardwert ist 80. CATWIDTH Breite Wenn Breite von Null verschieden ist, werden die Cat-Seiten fur ein Terminal der vorgegebenen Breite formatiert, ungeachtet der Breite des aktuell verwendeten Terminals. Dies setzt MINCATWIDTH und MAXCATWIDTH ausser Kraft. NOCACHE Dieses Option halt man von der automatischen Erzeugung von Cat-Seiten ab. FEHLER Wenn die oben angefuhrten Regeln nicht genau befolgt werden, werden sich die Handbuch-Dienstprogramme nicht wie gewunscht verhalten. Die Regeln sind zu kompliziert. https://gitlab.com/man-db/man-db/-/issues https://savannah.nongnu.org/bugs/?group=man-db 2.12.1 2024-04-05 MANPATH(5)