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.
lexgrog(1),
man(1),
manpath(5),
catman(8)
Avsnittet
WHATIS-TOLKNING som tidigare fanns på denna manualsida
finns nu i
lexgrog(1).
Wilf. ([email protected]).
Fabrizio Polacco ([email protected]).
Colin Watson ([email protected]).
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db