mandb - Zwischenspeicher für Handbuchseiten-Indizes erzeugen oder
aktualisieren
mandb [
-dqsucpt?V] [
-C Datei] [
Pfad]
mandb [
-dqsut] [
-C Datei]
-f
Dateiname ...
mandb wird für 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 erhöhen und
Funktionalität zu verbessern.
Beim Erzeugen oder Aktualisieren eines
Index wird
mandb vor
schlechten ROFF-.so-Anfragen, merkwürdigen Dateinamen für
Handbuchseiten oder Handbuchseiten, bei denen
whatis nicht ausgewertet
werden kann, warnen.
Wenn
mandb beim Aufruf ein optionaler, durch Doppelpunkte gegliederter
Pfad übergeben wird, so hebt dieser den internen, in der
Man-db-Konfigurationsdatei festgelegten systemweiten
Handbuchhierarchie-Suchpfad auf.
mandb kann mit Unterstützung für 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 unterstützen,
ermöglichen eine höhere Geschwindigkeit. Der höheren
Geschwindigkeit gegenüber steht das Risiko, dass die Datenbank bei
einer unüblichen Beendigung des Programms beschädigt wird. Dann
kann es erforderlich sein,
mandb mit der Option
-c zu starten,
um die Datenbanken von Grund auf neu zu erstellen.
-
-d, --debug
- Ausgabe von Debug-Informationen
-
-q, --quiet
- keine Warnmeldungen erzeugen
-
-s, --no-straycats
- Nicht Informationen über Stray Cats (Cat-Seiten ohne
Quelltext) suchen oder in die Datenbank aufnehmen.
-
-p, --no-purge
- Nicht nach gelöschten Handbuchseiten suchen und
diese vollständig aus der Datenbank löschen.
-
-c, --create
- Standardmäßig versucht mandb
zunächst, 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
beschädigt oder das Datenbank-Schema geändert wird.
-
-u, --user-db
- Erzeugt nur benutzereigene Datenbanken, selbst wenn
Schreibrechte auf systemweite Handbuchhierarchien bestehen.
-
-t, --test
- Überprüft Handbuchseiten im
Hierarchie-Suchpfad auf Fehlerfreiheit. Mit dieser Option wird
mandb keine existierenden Datenbanken ändern.
-
-f, --filename
- Aktualisiert nur die Einträge für den
angegebenen Dateinamen. Diese Option ist nicht für 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.
- 0
- erfolgreiche Programmausführung
- 1
- Verwendungs-, Syntax- oder
Konfigurationsdateien-Fehler.
- 2
- betriebsbedingter Fehler
- 3
- Ein Kindprozess ist fehlgeschlagen.
Die folgenden Warnmeldungen können bei der Erstellung der Datenbank
auftreten.
- <Dateiname>: Whatis-Auswertung für
Seite(Abschnitt) fehlgeschlagen
- Ein Versuch, die Whatis-Zeile(n) aus dem angegebenen
<Dateinamen> zu entnehmen, ist fehlgeschlagen. Das liegt in der
Regel an einer schlecht geschriebenen Handbuchseite, aber wenn die Meldung
öfters auftritt, kann es sein, dass das System nicht
standardkonforme Handbuchseiten enthält, 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).
- <Dateiname>: Ist ein toter symbolischer
Link
- <Dateiname> existiert nicht, aber ein symbolischer
Link weist dorthin. Die folgenden Diagnosemeldungen dienen der
Identifizierung des <Dateinamens> des betreffenden Links.
- <Dateiname>: Schlechter symbolischer Link oder
schlechte ROFF».so«-Anfrage
- <Dateiname> ist entweder ein symbolischer Link oder
enthält eine ROFF-haltige Anfrage zu einer nicht existierenden
Datei.
- <Dateiname>: Schein-Dateiname ignoriert
- Der <Dateiname> könnte eine gültige
Handbuchseite sein, aber ihr Name ist nicht gültig. Das liegt in
der Regel an einer Handbuchseite mit abschnittsweiser Erweiterung
<x>, die in den Handbuchseitenabschnitt <y> eingefügt
wurde.
- <filename_mask>: Konkurrierende
Erweiterungen
- Der Platzhalter <filename_mask> ist nicht
einzigartig. Das liegt normalerweise daran, dass eine komprimierte und
eine unkomprimierte Version der selben Handbuchseite nebeneinander
existieren. Alle außer der jüngsten werden ignoriert.
- /etc/manpath.config
- Konfigurationsdatei für Man-db
- /var/cache/man/index.(bt|db|dir|pag)
- ein FHS-konformer, globaler Zwischenspeicher für die
Index-Datenbank
Frühere Speicherorte für den Datenbankzwischenspeicher waren unter
anderem:
- /usr/man/index.(bt|db|dir|pag)
- ein traditioneller, globaler Zwischenspeicher für
die Index-Datenbank
- /var/catman/index.(bt|db|dir|pag)
- ein alternativer oder FSSTND-konformer, globaler
Index-Datenbankzwischenspeicher
lexgrog(1),
man(1),
manpath(5),
catman(8)
Der frühere Abschnitt
WAS BEDEUTET PARSEN ist jetzt Teil von
lexgrog(1).
Wilf. ([email protected]).
Fabrizio Polacco ([email protected]).
Colin Watson ([email protected]).
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db