mandb - skapa eller uppdatera indexcachar för
manualsidor
mandb [-dqsucpt?V] [-C fil]
[man-sökväg]
mandb [-dqsut] [-C fil] -f
filnamn ...
mandb används för att initiera eller manuellt
uppdatera index-databascachar. Cacharna innehåller information
relevant för det aktuella tillståndet för systemet av
manualsidor och informationen som lagras i dem används av
man-db-verktygen för att förbättra deras hastighet och
funktionalitet.
När ett index skapas eller uppdateras kommer
mandb att varna vid felaktiga ROFF .so-begäran, felaktiga
filnamn för manualsidor och manualsidor för vilka
whatis inte kan tolkas.
Om mandb förses med en valfri kolonavgränsad
sökväg så kommer detta att åsidosätta den
interna sökvägen för hierarkier av manualsidor i
systemet, fastställd från information hittad i
konfigurationsfilen för man-db.
mandb kan kompileras med stöd för
någon av följande databastyper.
| Namn |
Asynk |
Filnamn |
| Berkeley-db |
Ja |
index.bt |
| GNU gdbm |
Ja |
index.db |
| UNIX ndbm |
Nej |
index.(dir|pag) |
De databastyper som har stöd för asynkrona
uppdateringar tillhandahåller förbättrad hastighet
på bekostnad av potentiell korrumpering vid oväntat avslut. I
det ovanliga fall då detta inträffat kan det vara
nödvändigt att köra om mandb med flaggan
-c för att återskapa databaserna från
grunden.
- -d, --debug
- Skriver ut felsökningsinformation.
- -q, --quiet
- Producera inte några varningar.
- -s,
--no-straycats
- Spendera inte tid på att söka efter eller lägga till
information till databaserna om lösa cat-sidor.
- -p,
--no-purge
- Spendera inte tid på att leta efter borttagna manualsidor och rensa
bort dem från databaserna.
- -c, --create
- Som standard kommer mandb att försöka uppdatera
tidigare skapade databaser. Om en databas inte existerar kommer den att
skapas. Denna flagga tvingar mandb att ta bort tidigare databaser
och återskapa dem från grunden och implicerar
--no-purge. Detta kan vara nödvändigt om databasen
blir korrumperad eller om ett nytt databaslagringssystem introduceras i
framtiden.
- -u, --user-db
- Skapa endast användardatabaser, även med
skrivbehörigheter som behövs för att skapa
systemdatabaser.
- -t, --test
- Utför konsistenskontroller på manualsidor i
hierarkisökvägen. Med denna flagga kommer mandb inte
att förändra några existerande databaser.
- -f,
--filename
- Uppdatera bara posterna för det angivna filnamnet. Denna flagga
är inte avsedd för allmänt bruk; den används
internt av man när det har kompilerats med flaggan
MAN_DB_UPDATES och hittar sidor som är
föråldrade. Den implicerar -p och inaktiverar
-c och -s.
- -C fil, --config-file=fil
- Använd denna användarkonfigurationsfil snarare än
standard ~/.manpath.
- -?, --help
- Visa hjälptexten, avsluta sedan.
- --usage
- Skriv ut ett kort användningsmeddelande och avsluta.
- -V, --version
- Visa versionen, avsluta sedan.
- 0
- Framgångsrik programexekvering.
- 1
- Användnings-, syntax- eller konfigurationsfilsfel.
- 2
- Funktionsfel.
- 3
- En barnprocess misslyckades.
Följande varningsmeddelanden kan matas ut under
databasuppbyggnaden.
- <filnamn>: whatis-tolkning för sida(sekt)
misslyckades
- Ett försök att extrahera whatis-rader från det
angivna filnamnet <filnamn> misslyckades. Detta sker vanligtvis
på grund av en dåligt skriven manualsida, men om
många sådana meddelanden matas ut är det troligt att
systemet innehåller icke-standardiserade manualsidor som är
inkompatibla med man-db:s whatis-tolk. Se avsnittet WHATIS-TOLKNING
i lexgrog(1) för vidare information.
- <filnamn>: är en lös symbolisk länk
- <filnamn> existerar inte men refereras till med en symbolisk
länk. Vidare diagnostikmeddelanden matas vanligtvis ut för
att identifiera namnet <filnamn> på den länk som
är problematisk.
- <filnamn>: felaktig symbolisk länk eller ROFF
”.so”-begäran
- <filnamn> är antingen en symbolisk länk till, eller
innehåller en ROFF-inklusionsbegäran till, en icke
existerande fil.
- <filnamn>: ignorerar felaktigt filnamn
- Filnamnet <filnamn> kan vara en giltig manualsida men dess namn
är ogiltigt. Detta sker vanligtvis för att en manualsida med
avsnittsändelsen <x> lagts till i avsnitt <y> i en
manualsida.
- <filnamn_mask>: filändelser i konflikt
- Jokerteckensträngen <filnamn_mask> är inte unik. Detta
sker vanligtvis för att det finns både komprimerade och
okomprimerade versioner av samma manualsida. Alla, förutom de
senaste, kommer att ignoreras.
- /etc/manpath.config
- man-db-konfigurationsfil.
- /var/cache/man/index.(bt|db|dir|pag)
- En FHS-kompatibel global index-databascache.
Äldre platser för databascachen inkluderar:
- /usr/man/index.(bt|db|dir|pag)
- En traditionell global index-databascache.
- /var/catman/index.(bt|db|dir|pag)
- En alternativ eller FSSTND-kompatibel global
index-databascache.
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