Provided by: man-db_2.6.1-2_i386 bug

BEZEICHNUNG

       mandb - Caches fur Handbuchseiten-Indizes erzeugen oder aktualisieren

"UBERSICHT

       mandb [-dqsucpt|-h|-V] [-C Datei] [Pfad]
       mandb [-dqsut] [-C Datei] -f Dateiname ...

BESCHREIBUNG

       mandb  wird fur die Initialisierung und die manuelle Aktualisierung der
       normalerweise von man gepflegten Index-Datenbank-Caches verwendet.  Die
       Caches  enthalten  wichtige  Informationen  zum  aktuellen  Zustand des
       Handbuchseiten-Systems. Die dort gespeicherten Informationen  verwenden
       die  Man-db-Programme,  um  ihre  Geschwindigkeit und Funktionalitat zu
       erhohen.

       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-CACHES

       mandb  kann  mit  Unterstutzung  fur jeden der folgenden Datenbanktypen
       kompiliert werden.

       Name                 Typ            asynch   Dateiname
       -------------------------------------------------------------
       Berkeley-Datenbank   Binarbaum      Ja       index.bt
       GNU gdbm v >= 1.6    Hash-Tabelle   Ja       index.db
       GNU gdbm v <  1.6    Hash-Tabelle   Nein     index.db
       UNIX ndbm            Hash-Tabelle   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
              StandardmaBig 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

       -h, --help
              Gebrauchsanweisung anzeigen und beenden.

       -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.

       <Dateiname>: Whatis-Auswertung f"ur 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 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).

       <Dateiname>: Ist ein toter symbolischer Link
              <Dateiname> existiert nicht, aber ein  symbolischen  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 enthalt eine
              ROFF-haltige Anfrage zu einer nicht existierenden Datei.

       <Dateiname>: Schein-Dateiname ignoriert
              Der <Dateiname> konnte eine gultige Handbuchseite sein, aber ihr
              Name  ist  nicht  gultig.  Das  liegt  in  der  Regel  an  einer
              Handbuchseite mit abschnittsweiser Erweiterung <x>, die  in  den
              Handbuchseitenabschnitt <y> eingefugt 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 auBer der jungsten werden ignoriert.

DATEIEN

       /etc/manpath.config
              Konfigurationsdatei fur Man-db

       /var/cache/man/index.(bt|db|dir|pag)
              ein FHS-konformer, globaler Cache fur die Index-Datenbank

       Fruhere Speicherorte fur den Datenbank-Cache waren unter anderen:

       /usr/man/index.(bt|db|dir|pag)
              ein traditioneller, globaler Cache fur die Index-Datenbank

       /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   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).