278 lines
8.8 KiB
HTML
278 lines
8.8 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of MANDB</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>MANDB</H1>
|
|
Section: Dienstprogramme für Handbuchseiten (8)<BR>Updated: 2020-02-25<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>BEZEICHNUNG</H2>
|
|
|
|
mandb - Zwischenspeicher für Handbuchseiten-Indizes erzeugen oder
|
|
aktualisieren
|
|
<A NAME="lbAC"> </A>
|
|
<H2>ÜBERSICHT</H2>
|
|
|
|
<B>mandb</B> [<B>-dqsucpt?V</B>] [<B>-C</B> <I>Datei</I>] [<I>Pfad</I>]
|
|
<BR>
|
|
|
|
<B>mandb</B> [<B>-dqsut</B>] [<B>-C</B> <I>Datei</I>] <B>-f</B> <I>Dateiname</I> ...
|
|
<A NAME="lbAD"> </A>
|
|
<H2>BESCHREIBUNG</H2>
|
|
|
|
<B>mandb</B> wird für die Initialisierung und die manuelle Aktualisierung der
|
|
<B>Index</B>-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.
|
|
<P>
|
|
Beim Erzeugen oder Aktualisieren eines <B>Index</B> wird <B>mandb</B> vor
|
|
schlechten ROFF-.so-Anfragen, merkwürdigen Dateinamen für Handbuchseiten
|
|
oder Handbuchseiten, bei denen <B>whatis</B> nicht ausgewertet werden kann,
|
|
warnen.
|
|
<P>
|
|
Wenn <B>mandb</B> 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.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>DATENBANK-ZWISCHENSPEICHER</H2>
|
|
|
|
<B>mandb</B> kann mit Unterstützung für jeden der folgenden Datenbanktypen
|
|
kompiliert werden.
|
|
<P>
|
|
<TABLE>
|
|
<TR VALIGN=top><TD>Name</TD><TD>Typ</TD><TD>asynch</TD><TD>Dateiname<BR></TD></TR>
|
|
<TR VALIGN=top><TD COLSPAN=4><HR></TD></TR>
|
|
<TR VALIGN=top><TD>Berkeley-Datenbank</TD><TD>
|
|
Binärbaum
|
|
</TD><TD>Ja</TD><TD><I>index.bt</I><BR></TD></TR>
|
|
<TR VALIGN=top><TD>GNU gdbm</TD><TD>
|
|
Hash-Tabelle
|
|
</TD><TD>Ja</TD><TD><I>index.db</I><BR></TD></TR>
|
|
<TR VALIGN=top><TD>UNIX ndbm</TD><TD>
|
|
Hash-Tabelle
|
|
</TD><TD>Nein</TD><TD><I>index.(dir|pag)</I><BR></TD></TR>
|
|
</TABLE>
|
|
|
|
<P>
|
|
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,
|
|
<B>mandb</B> mit der Option <B>-c</B> zu starten, um die Datenbanken von Grund auf
|
|
neu zu erstellen.
|
|
<A NAME="lbAF"> </A>
|
|
<H2>OPTIONEN</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-d</B>, <B>--debug</B>
|
|
|
|
|
|
<DD>
|
|
Ausgabe von Debug-Informationen
|
|
<DT id="2"><B>-q</B>, <B>--quiet</B>
|
|
|
|
|
|
<DD>
|
|
keine Warnmeldungen erzeugen
|
|
<DT id="3"><B>-s</B>, <B>--no-straycats</B>
|
|
|
|
|
|
<DD>
|
|
Nicht Informationen über Stray Cats (Cat-Seiten ohne Quelltext) suchen oder
|
|
in die Datenbank aufnehmen.
|
|
<DT id="4"><B>-p</B>, <B>--no-purge</B>
|
|
|
|
|
|
<DD>
|
|
Nicht nach gelöschten Handbuchseiten suchen und diese vollständig aus der
|
|
Datenbank löschen.
|
|
<DT id="5"><B>-c</B>, <B>--create</B>
|
|
|
|
|
|
<DD>
|
|
Standardmäßig versucht <B>mandb</B> zunächst, eine bestehende Datenbank zu
|
|
aktualisieren. Ist keine Datenbank vorhanden, wird sie erstellt. Diese
|
|
Option zwingt <B>mandb</B> dazu, die Datenbank von Grund auf neu zu erstellen
|
|
und impliziert <B>--no-purge</B>. Dieses kann notwendig sein, wenn eine
|
|
Datenbank beschädigt oder das Datenbank-Schema geändert wird.
|
|
<DT id="6"><B>-u</B>, <B>--user-db</B>
|
|
|
|
|
|
<DD>
|
|
Erzeugt nur benutzereigene Datenbanken, selbst wenn Schreibrechte auf
|
|
systemweite Handbuchhierarchien bestehen.
|
|
<DT id="7"><B>-t</B>, <B>--test</B>
|
|
|
|
|
|
<DD>
|
|
Überprüft Handbuchseiten im Hierarchie-Suchpfad auf Fehlerfreiheit. Mit
|
|
dieser Option wird <B>mandb</B> keine existierenden Datenbanken ändern.
|
|
<DT id="8"><B>-f</B>, <B>--filename</B>
|
|
|
|
|
|
<DD>
|
|
Aktualisiert nur die Einträge für den angegebenen Dateinamen. Diese Option
|
|
ist nicht für den Allgemeingebrauch, sondern wird intern von <B>man</B>
|
|
verwendet, wenn es mit der Option <B>MAN_DB_UPDATES</B> kompiliert wurde und die
|
|
Seite als veraltet betrachtet. Diese Option impliziert <B>-p</B> und schaltet
|
|
<B>-c</B> und <B>-s</B> ab.
|
|
<DT id="9"><B>-C </B><I>Datei</I>, <B>--config-file=</B><I>Datei</I><DD>
|
|
Verwendung dieser benutzerspezifischen Konfigurationsdatei an Stelle der
|
|
Vorgabe <I>~/.manpath</I>
|
|
<DT id="10"><B>-?</B>, <B>--help</B>
|
|
|
|
|
|
<DD>
|
|
Gebrauchsanweisung anzeigen und beenden.
|
|
<DT id="11"><B>--usage</B>
|
|
|
|
|
|
<DD>
|
|
zeigt eine kurze Anwendungszusammenfassung an und beendet das Programm.
|
|
<DT id="12"><B>-V</B>, <B>--version</B>
|
|
|
|
|
|
<DD>
|
|
Programmversion anzeigen und beenden.
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>EXIT-STATUS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="13"><B>0</B>
|
|
|
|
|
|
<DD>
|
|
erfolgreiche Programmausführung
|
|
<DT id="14"><B>1</B>
|
|
|
|
|
|
<DD>
|
|
Verwendungs-, Syntax- oder Konfigurationsdateien-Fehler.
|
|
<DT id="15"><B>2</B>
|
|
|
|
|
|
<DD>
|
|
betriebsbedingter Fehler
|
|
<DT id="16"><B>3</B>
|
|
|
|
|
|
<DD>
|
|
Ein Kindprozess ist fehlgeschlagen.
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>DIAGNOSE</H2>
|
|
|
|
Die folgenden Warnmeldungen können bei der Erstellung der Datenbank
|
|
auftreten.
|
|
<DL COMPACT>
|
|
<DT id="17"><B><Dateiname>: Whatis-Auswertung für Seite(Abschnitt) fehlgeschlagen</B><DD>
|
|
Ein Versuch, die <A HREF="/cgi-bin/man/man2html?n+Whatis-Zeile">Whatis-Zeile</A>(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 <B>WAS
|
|
BEDEUTET PARSEN</B> in <B><A HREF="/cgi-bin/man/man2html?1+lexgrog">lexgrog</A></B>(1).
|
|
<DT id="18"><B><Dateiname>: Ist ein toter symbolischer Link</B><DD>
|
|
<Dateiname> existiert nicht, aber ein symbolischen Link weist
|
|
dorthin.Die folgenden Diagnosemeldungen dienen der Identifizierung des
|
|
<Dateinamens> des betreffenden Links.
|
|
<DT id="19"><B><Dateiname>: Schlechter symbolischer Link oder schlechte ROFF».so«-Anfrage</B><DD>
|
|
<Dateiname> ist entweder ein symbolischer Link oder enthält eine
|
|
ROFF-haltige Anfrage zu einer nicht existierenden Datei.
|
|
<DT id="20"><B><Dateiname>: Schein-Dateiname ignoriert</B><DD>
|
|
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.
|
|
<DT id="21"><B><filename_mask>: Konkurrierende Erweiterungen</B><DD>
|
|
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.
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>DATEIEN</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="22"><I>/etc/manpath.config</I>
|
|
|
|
|
|
<DD>
|
|
Konfigurationsdatei für Man-db
|
|
<DT id="23"><I>/var/cache/man/index.(bt|db|dir|pag)</I>
|
|
|
|
|
|
<DD>
|
|
ein FHS-konformer, globaler Zwischenspeicher für die <I>Index</I>-Datenbank
|
|
</DL>
|
|
<P>
|
|
|
|
Frühere Speicherorte für den Datenbankzwischenspeicher waren unter anderen:
|
|
<DL COMPACT>
|
|
<DT id="24"><I>/usr/man/index.(bt|db|dir|pag)</I>
|
|
|
|
|
|
<DD>
|
|
ein traditioneller, globaler Zwischenspeicher für die <I>Index</I>-Datenbank
|
|
<DT id="25"><I>/var/catman/index.(bt|db|dir|pag)</I>
|
|
|
|
|
|
<DD>
|
|
ein alternativer oder FSSTND-konformer, globaler
|
|
<I>Index</I>-Datenbankzwischenspeicher
|
|
</DL>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>SIEHE AUCH</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+lexgrog">lexgrog</A></B>(1),
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+man">man</A></B>(1),
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+manpath">manpath</A></B>(5),
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+catman">catman</A></B>(8)
|
|
|
|
|
|
<P>
|
|
|
|
Der frühere Abschnitt <B>WAS BEDEUTET PARSEN</B> ist jetzt Teil von
|
|
<B><A HREF="/cgi-bin/man/man2html?1+lexgrog">lexgrog</A></B>(1).
|
|
<A NAME="lbAK"> </A>
|
|
<H2>AUTOR</H2>
|
|
|
|
<PRE>
|
|
Wilf. (<A HREF="mailto:G.Wilford@ee.surrey.ac.uk">G.Wilford@ee.surrey.ac.uk</A>).Fabrizio Polacco (<A HREF="mailto:fpolacco@debian.org">fpolacco@debian.org</A>).Colin Watson (<A HREF="mailto:cjwatson@debian.org">cjwatson@debian.org</A>).</PRE>
|
|
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="26"><A HREF="#lbAB">BEZEICHNUNG</A><DD>
|
|
<DT id="27"><A HREF="#lbAC">ÜBERSICHT</A><DD>
|
|
<DT id="28"><A HREF="#lbAD">BESCHREIBUNG</A><DD>
|
|
<DT id="29"><A HREF="#lbAE">DATENBANK-ZWISCHENSPEICHER</A><DD>
|
|
<DT id="30"><A HREF="#lbAF">OPTIONEN</A><DD>
|
|
<DT id="31"><A HREF="#lbAG">EXIT-STATUS</A><DD>
|
|
<DT id="32"><A HREF="#lbAH">DIAGNOSE</A><DD>
|
|
<DT id="33"><A HREF="#lbAI">DATEIEN</A><DD>
|
|
<DT id="34"><A HREF="#lbAJ">SIEHE AUCH</A><DD>
|
|
<DT id="35"><A HREF="#lbAK">AUTOR</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:04:58 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|