MANDB(8) Dienstprogramme fur Handbuchseiten MANDB(8) BEZEICHNUNG mandb - Zwischenspeicher fur Handbuchseiten-Indizes erzeugen oder aktualisieren UBERSICHT mandb [-dqsucpt?V] [-C Datei] [Pfad] mandb [-dqsut] [-C Datei] -f Dateiname ... BESCHREIBUNG mandb wird fur die Initialisierung und die manuelle Aktualisierung der Index-Datenbank-Zwischenspeicher verwendet. Die Zwischenspeicher enthalten wichtige Informationen zum aktuellen Zustand des Handbuchseitensystems. Die dort gespeicherten Informationen verwenden die Man-db-Programme, um ihre Geschwindigkeit zu erhohen und Funktionalitat zu verbessern. Beim Erzeugen oder Aktualisieren eines Index wird mandb vor schlechten ROFF-.so-Anfragen, merkwurdigen Dateinamen fur Handbuchseiten oder Handbuchseiten, bei denen whatis nicht ausgewertet werden kann, warnen. Wenn mandb beim Aufruf ein optionaler, durch Doppelpunkte gegliederter Pfad ubergeben wird, so hebt dieser den internen, in der Man-db-Konfigurationsdatei festgelegten systemweiten Handbuchhierarchie-Suchpfad auf. DATENBANK-ZWISCHENSPEICHER mandb kann mit Unterstutzung fur jeden der folgenden Datenbanktypen kompiliert werden. Name asynch Dateiname ---------------------------------------------- Berkeley-Datenbank Ja index.bt GNU gdbm Ja index.db UNIX ndbm Nein index.(dir|pag) Diejenigen Datenbanktypen, die asynchrone Aktualisierungen unterstutzen, ermoglichen eine hohere Geschwindigkeit. Der hoheren Geschwindigkeit gegenuber steht das Risiko, dass die Datenbank bei einer unublichen Beendigung des Programms beschadigt wird. Dann kann es erforderlich sein, mandb mit der Option -c zu starten, um die Datenbanken von Grund auf neu zu erstellen. OPTIONEN -d, --debug Ausgabe von Debug-Informationen -q, --quiet keine Warnmeldungen erzeugen -s, --no-straycats Nicht Informationen uber Stray Cats (Cat-Seiten ohne Quelltext) suchen oder in die Datenbank aufnehmen. -p, --no-purge Nicht nach geloschten Handbuchseiten suchen und diese vollstandig aus der Datenbank loschen. -c, --create Standardmassig versucht mandb zunachst, eine bestehende Datenbank zu aktualisieren. Ist keine Datenbank vorhanden, wird sie erstellt. Diese Option zwingt mandb dazu, die Datenbank von Grund auf neu zu erstellen und impliziert --no-purge. Dieses kann notwendig sein, wenn eine Datenbank beschadigt oder das Datenbank-Schema geandert wird. -u, --user-db Erzeugt nur benutzereigene Datenbanken, selbst wenn Schreibrechte auf systemweite Handbuchhierarchien bestehen. -t, --test Uberpruft Handbuchseiten im Hierarchie-Suchpfad auf Fehlerfreiheit. Mit dieser Option wird mandb keine existierenden Datenbanken andern. -f, --filename Aktualisiert nur die Eintrage fur den angegebenen Dateinamen. Diese Option ist nicht fur den Allgemeingebrauch, sondern wird intern von man verwendet, wenn es mit der Option MAN_DB_UPDATES kompiliert wurde und die Seite als veraltet betrachtet. Diese Option impliziert -p und schaltet -c und -s ab. -C Datei, --config-file=Datei Verwendung dieser benutzerspezifischen Konfigurationsdatei an Stelle der Vorgabe ~/.manpath -?, --help Gebrauchsanweisung anzeigen und beenden. --usage zeigt eine kurze Anwendungszusammenfassung an und beendet das Programm. -V, --version Programmversion anzeigen und beenden. EXIT-STATUS 0 erfolgreiche Programmausfuhrung 1 Verwendungs-, Syntax- oder Konfigurationsdateien-Fehler. 2 betriebsbedingter Fehler 3 Ein Kindprozess ist fehlgeschlagen. DIAGNOSE Die folgenden Warnmeldungen konnen bei der Erstellung der Datenbank auftreten. : Whatis-Auswertung fur Seite(Abschnitt) fehlgeschlagen Ein Versuch, die Whatis-Zeile(n) aus dem angegebenen zu entnehmen, ist fehlgeschlagen. Das liegt in der Regel an einer schlecht geschriebenen Handbuchseite, aber wenn die Meldung ofters auftritt, kann es sein, dass das System nicht standardkonforme Handbuchseiten enthalt, die nicht mit dem Parser (Auswerteprogramm) der Man-db-Implementierung von Whatis kompatibel sind. Weitere Informationen finden Sie im Abschnitt WAS BEDEUTET PARSEN in lexgrog(1). : Ist ein toter symbolischer Link existiert nicht, aber ein symbolischer Link weist dorthin. Die folgenden Diagnosemeldungen dienen der Identifizierung des des betreffenden Links. : Schlechter symbolischer Link oder schlechte ROFF>>.so<<-Anfrage ist entweder ein symbolischer Link oder enthalt eine ROFF-haltige Anfrage zu einer nicht existierenden Datei. : Schein-Dateiname ignoriert Der konnte eine gultige Handbuchseite sein, aber ihr Name ist nicht gultig. Das liegt in der Regel an einer Handbuchseite mit abschnittsweiser Erweiterung , die in den Handbuchseitenabschnitt eingefugt wurde. : Konkurrierende Erweiterungen Der Platzhalter ist nicht einzigartig. Das liegt normalerweise daran, dass eine komprimierte und eine unkomprimierte Version der selben Handbuchseite nebeneinander existieren. Alle ausser der jungsten werden ignoriert. DATEIEN /etc/man_db.conf Konfigurationsdatei fur Man-db /var/cache/man/index.(bt|db|dir|pag) ein FHS-konformer, globaler Zwischenspeicher fur die Index-Datenbank Fruhere Speicherorte fur den Datenbankzwischenspeicher waren unter anderem: /usr/man/index.(bt|db|dir|pag) ein traditioneller, globaler Zwischenspeicher fur die Index-Datenbank /var/catman/index.(bt|db|dir|pag) ein alternativer oder FSSTND-konformer, globaler Index-Datenbankzwischenspeicher SIEHE AUCH lexgrog(1), man(1), manpath(5), catman(8) Der fruhere Abschnitt WAS BEDEUTET PARSEN ist jetzt Teil von lexgrog(1). AUTOR Wilf. (G.Wilford@ee.surrey.ac.uk). Fabrizio Polacco (fpolacco@debian.org). Colin Watson (cjwatson@debian.org). FEHLER https://gitlab.com/man-db/man-db/-/issues https://savannah.nongnu.org/bugs/?group=man-db 2.12.1 2024-04-05 MANDB(8)