mandb - Erstellen oder Aktualisieren der manuellen Seitenindex-Caches
SYNOPSIS
mandb [-dqsucpt?V] [-C Datei] [Manpfad]
mandb [-dqsut] [-C Datei] -f Dateiname ...
BESCHREIBUNG
mandb wird verwendet, um Index-Datenbank-Caches zu initialisieren oder manuell zu aktualisieren. Die Caches enthalten Informationen, die für den aktuellen Zustand des Manual-Page-Systems relevant sind, und die darin gespeicherten Informationen werden von den Man-db-Dienstprogrammen verwendet, um deren Geschwindigkeit und Funktionalität zu verbessern.
Beim Erstellen oder Aktualisieren eines Index warnt mandb vor fehlerhaften ROFF .so-Anforderungen, fehlerhaften Dateinamen von Manual Pages und Manual Pages, aus denen das "whatis" nicht extrahiert werden kann.
Durch die Übergabe eines optionalen, durch Doppelpunkte getrennten Pfads an mandb wird der interne System-Manual-Page-Hierarchie-Suchpfad überschrieben, der aus den Informationen in der Konfigurationsdatei von Man-db ermittelt wird.
DATENBANK-CACHES
mandb kann mit Unterstützung für einen der folgenden Datenbanktypen kompiliert werden.
Name Async Dateiname
Berkeley db Ja index.bt
GNU gdbm Ja index.db
UNIX ndbm Nein index.(dir|pag)
Diejenigen Datenbanktypen, die asynchrone Aktualisierungen unterstützen, bieten eine höhere Geschwindigkeit, gehen aber das Risiko einer Beschädigung im Falle einer ungewöhnlichen Beendigung ein. In einem ungewöhnlichen Fall, in dem dies aufgetreten ist, ist es möglicherweise erforderlich, mandb mit der Option -c auszuführen, um die Datenbanken von Grund auf neu zu erstellen.
OPTIONEN
-d, --debug
Debug-Informationen ausgeben.
-q, --quiet
Keine Warnungen ausgeben.
-s, --no-straycats
Keine Zeit damit verbringen, nach Informationen über "herrenlose Katzen" zu suchen oder diese den Datenbanken hinzuzufügen.
-p, --no-purge
Keine Zeit damit verbringen, nach gelöschten Manual Pages zu suchen und diese aus den Datenbanken zu entfernen.
-c, --create
Standardmäßig versucht mandb, vorhandene Datenbanken zu aktualisieren. Wenn eine Datenbank nicht vorhanden ist, wird sie erstellt. Diese Option zwingt mandb, vorherige Datenbanken zu löschen und sie von Grund auf neu zu erstellen, und impliziert --no-purge. Dies kann erforderlich sein, wenn eine Datenbank beschädigt wird oder wenn in Zukunft ein neues Datenbank-Speicherschema eingeführt wird.
-u, --user-db
Nur Benutzerdatenbanken erstellen, auch wenn Schreibberechtigungen zum Erstellen von Systemdatenbanken erforderlich sind.
-t, --test
Korrektheitsprüfungen auf Manual Pages im Hierarchie-Suchpfad durchführen. Mit dieser Option ändert mandb keine vorhandenen Datenbanken.
-f, --filename
Nur die Einträge für die angegebene Datei aktualisieren. Diese Option ist nicht für den allgemeinen Gebrauch bestimmt; sie wird intern von man verwendet, wenn es mit der Option MAN_DB_UPDATES kompiliert wurde und feststellt, dass eine Seite veraltet ist. Sie impliziert -p und deaktiviert -c und -s.
-C Datei, --config-file=Datei
Diese Benutzerkonfigurationsdatei anstelle der Standarddatei ~/.manpath verwenden.
-?, --help
Die Hilfemeldung anzeigen und dann beenden.
--usage
Eine kurze Nutzungsmeldung ausgeben und beenden.
-V, --version
Die Version anzeigen und dann beenden.
RÜCKGABESTATUS
0 Erfolgreiche Programmausführung.
1 Fehler bei der Verwendung, Syntax oder Konfigurationsdatei.
2 Betriebsfehler.
3 Ein Kindprozess ist fehlgeschlagen.
DIAGNOSTIK
Während des Erstellens der Datenbank können die folgenden Warnmeldungen ausgegeben werden.
<Dateiname>: whatis-Analyse für Seite(Abschnitt) fehlgeschlagen
Ein Versuch, die "whatis"-Zeile(n) aus der angegebenen <Dateiname> zu extrahieren, ist fehlgeschlagen. Dies liegt normalerweise an einer schlecht geschriebenen Manual Page, aber wenn viele solcher Meldungen ausgegeben werden, ist es wahrscheinlich, dass das System nicht standardmäßige Manual Pages enthält, die mit dem "whatis"-Parser von Man-db inkompatibel sind. Weitere Informationen finden Sie im Abschnitt "WHATIS PARSING" in lexgrog(1).
<Dateiname>: ist ein herabhängender symbolischer Link
<Dateiname> existiert nicht, wird aber von einem symbolischen Link referenziert. Es werden in der Regel weitere Diagnosen ausgegeben, um die <Dateiname> des fehlerhaften Links zu ermitteln.
<Dateiname>: fehlerhafter symbolischer Link oder ROFF `.so`-Anforderung
<Dateiname> ist entweder ein symbolischer Link zu einer nicht existierenden Datei oder enthält eine ROFF-Include-Anforderung für eine nicht existierende Datei.
<Dateiname>: ignoriere ungültigen Dateinamen
Die <Dateiname> ist möglicherweise eine gültige Manual Page, aber ihr Name ist ungültig. Dies liegt normalerweise daran, dass eine Manual Page mit einem Abschnitts-Suffix <x> in den Abschnitt <y> der Manual Page gesetzt wurde.
<Dateinamenmaske>: konkurrierende Erweiterungen
Die Wildcard <Dateinamenmaske> ist nicht eindeutig. Dies wird normalerweise durch die Existenz einer komprimierten und einer unkomprimierten Version derselben Manual Page verursacht. Alle außer der neuesten werden ignoriert.
DATEIEN
/etc/manpath.config
Konfigurationsdatei von Man-db.
/var/cache/man/index.(bt|db|dir|pag)
Ein FHS-konformer globaler Index-Datenbank-Cache.
Ältere Speicherorte für den Datenbank-Cache waren:
/usr/man/index.(bt|db|dir|pag)
Ein traditioneller globaler Index-Datenbank-Cache.
/var/catman/index.(bt|db|dir|pag)
Ein alternativer oder FSSTND-konformer globaler Index-Datenbank-Cache.
SIEHE AUCH
lexgrog(1), man(1), manpath(5), catman(8)
Der Abschnitt "WHATIS PARSING", der früher in dieser Manual Page enthalten war, ist jetzt Teil von lexgrog(1).
AUTOR
Wilf. (_)
Fabrizio Polacco (_).
Colin Watson (_).
FEHLER
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db