mandb - Zwischenspeicher für Handbuchseiten-Indizes
erzeugen oder aktualisieren
ÜBERSICHT
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
Wilf. (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Colin Watson (cjwatson@debian.org).
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db