mandb - creează sau actualizează memoriile tampon de
index ale paginilor de manual
mandb [-dqsucpt?V] [-C fișier]
[cale-manual]
mandb [-dqsut] [-C fișier] -f
nume-fișier ...
mandb este utilizat pentru a inițializa sau
actualiza manual memoriile tampon ale bazelor de date index.
Memoriile tampon conțin informații relevante pentru starea
curentă paginilor de manual ale sistemului, și
informațiile stocate în ele sunt utilizate de utilitarele
«man-db» pentru a le îmbunătăți
viteza și funcționalitatea.
Când se creează sau se actualizează un
index, mandb va avertiza cu privire la cererile .so ROFF
defectuoase, nume de fișiere ale paginilor de manual false, și
pagini de manual din care whatis nu poate fi analizat.
Furnizarea lui mandb cu o cale opțională
delimitată de două puncte va suprascrie calea de
căutare a ierarhiei paginilor de manual a sistemului internă,
determinată din informațiile găsite în
fișierul de configurare «man-db».
mandb poate fi compilat cu suport pentru oricare dintre
următoarele tipuri de baze de date.
| Nume |
Asincron |
Numele fișierului |
| Bază de date Berkeley |
Da |
index.bt |
| GNU gdbm |
Da |
index.db |
| UNIX ndbm |
Nu |
index.(dir|pag) |
Acele tipuri de baze de date care suportă
actualizări asincrone oferă o viteză sporită cu
prețul unei posibile coruperi în cazul de terminare
neobișnuită. Într-un caz neobișnuit în
care s-a întâmplat acest lucru, poate fi necesar să
rulați din nou mandb cu opțiunea -c pentru a
recrea bazele de date de la zero.
- -d, --debug
- Imprimă informațiile de depanare.
- -q, --quiet
- Nu produce avertismente.
- -s,
--no-straycats
- Nu pierdeți timp căutând sau adăugând
informații în bazele de date cu privire la fișierele
«cat» pierdute.
- -p,
--no-purge
- Nu pierdeți timp verificând pentru pagini de manual
șterse și curățarea lor de la bazele de
date.
- -c, --create
- În mod implicit, mandb va încerca să
actualizeze orice bază de date creată anterior. Dacă
o bază de date nu există, o va crea. Această
opțiune forțează mandb să
șteargă bazele de date anterioare și să le
recreeze de la zero și implică --no-purge. Acest
lucru poate fi necesar dacă o bază de date devine
coruptă, sau dacă o nouă schemă de stocare a
bazei de date este introdusă în viitor.
- -u, --user-db
- Creează doar bazele de date de utilizator, chiar și cu
permisiunile de scriere necesare pentru a crea baze de date de
sistem.
- -t, --test
- Efectuează verificările de corectare a paginilor de manual
din calea de căutare ierarhică. Cu această
opțiune, mandb nu va modifica bazele de date existente.
- -f,
--filename
- Actualizează doar intrările pentru numele de fișier
dat. Această opțiune nu este pentru uz general; este
utilizată intern de man când a fost compilat cu
opțiunea MAN_DB_UPDATES și găsește
că o pagină nu este actualizată. Implică
-p și dezactivează -c și
-s.
- -C fișier, --config-file=fișier
- Utilizează acest fișier de configurare al utilizatorului,
mai degrabă decât cel implicit din ~/.manpath.
- -?, --help
- Afișează mesajul de utilizare, apoi iese.
- --usage
- Imprimă un mesaj scurt de utilizare și iese.
- -V, --version
- Arată versiunea, apoi iese.
- 0
- Executarea programului s-a încheiat fără erori.
- 1
- Eroare de utilizare, de sintaxă sau de fișier de
configurare.
- 2
- Eroare operațională.
- 3
- Un proces copil a eșuat.
Următoarele mesaje de avertisment pot fi emise în
timpul construirii bazei de date.
- <nume-fișier>: analizarea whatis pentru
pagina(secțiunea) a eșuat
- O încercare de a extrage linia/liniile «whatis» din
<nume(le)-fișier(ului)> specificat, a eșuat. Acest
lucru se datorează de obicei, unei pagini de manual scrise
greșit, dar dacă sunt emise multe astfel de mesaje, este
posibil ca sistemul să conțină pagini de manual
non-standard, care sunt incompatibile cu analizatorul
«whatis» al «man-db». Consultați
secțiunea WHATIS PARSING din lexgrog(1) pentru mai
multe informații.
- <nume-fișier>: este o legătură
simbolică suspendată(ruptă)
- <nume-fișier> nu există, dar o legătură
simbolică face referire la el. Mai multe diagnosticări sunt
de obicei emise pentru a identifica <nume-fișier> al
legăturii defecte.
- <nume-fișier>: legătură simbolică sau
cerere „.so” ROFF greșită
- <nume-fișier> este ori o legătură
simbolică la un fișier care nu există, ori
conține o cerere de includere ROFF la un fișier care nu
există.
- <nume-fișier>: se ignoră numele de fișier
fals
- <nume-fișier> poate să fie sau poate să nu fie
o pagină de manual validă dar numele său nu este
valid. Acest lucru este de obicei din cauza unei pagini de manual cu
extensia secțională <x> care a fost plasată
în secțiunea paginii de manual <y>.
- <mască_nume-fișier>: extensii în
conflict
- Metacaracterul <mască_nume-fișier> nu este unic. Acest
lucru este cauzat de obicei de existența atât a unei
versiuni comprimate, cât și a unei versiuni necomprimate ale
aceleiași pagini de manual. Toate, în afară de cea
mai recentă, sunt ignorate.
- /etc/manpath.config
- fișier de configurare man-db.
- /var/cache/man/index.(bt|db|dir|pag)
- Memorie tampon a bazei de date index globală conform cu
FHS.
Locațiile mai vechi pentru memoria tampon a bazei de date
includ:
- /usr/man/index.(bt|db|dir|pag)
- Memorie tampon a bazei de date index globală
tradițională.
- /var/catman/index.(bt|db|dir|pag)
- O memorie tampon a bazei de date index global, compatibil sau
alternativ cu FSSTND. NT: FSSTND = Sistemul de fișiere
standard.
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