NOME¶
mandb - crea o aggiorna le cache index delle pagine di manuale
SINTASSI¶
mandb [
-dqsuc|
-h|
-V] [
percorso]
DESCRIZIONE¶
mandb è usato per inizializzare o aggiornare manualmente le cache
delle basi di dati
index solitamente mantenute da
man. Le cache
contengono importanti informazioni sullo stato corrente del sistema di pagine
di manuale e le informazioni immagazzinate al loro interno sono usate dalle
utility man-db per aumentare la loro velocità e funzionalità.
Quando crea o aggiorna un
index,
mandb genererà un avviso
nel caso di richieste ROFF .so errate, di nomi di pagine di manuale fasulli e
di pagine di manuale dalle quali non può essere estratto il
whatis.
Fornendo a
mandb una lista opzionale di percorsi separati da `:'
verrà ignorata la gerarchia globale interna dei percorsi di ricerca,
determinata dalle informazioni contenute nel file di configurazione di man-db.
CACHE DELLE BASI DI DATI¶
mandb può essere compilato con il supporto per qualsiasi fra
seguenti tipi di basi di dati.
Nome |
Tipo |
Asinc |
NomeFile |
|
Berkeley db |
Binary tree |
Sì |
index.bt |
GNU gdbm v >= 1.6 |
Hashed |
Sì |
index.db |
GNU gdbm v < 1.6 |
Hashed |
No |
index.db |
UNIX ndbm |
Hashed |
No |
index.(dir|pag) |
Questi tipi di basi di dati supportano aggiornamenti asincroni privilegiando la
velocità a spese di eventuali corruzioni nel caso di terminazioni
inusuali. Nel caso che ciò succeda, potrebbe essere necessario
rilanciare
mandb con l'opzione
-c per ricreare le nuove basi di
dati.
OPZIONI¶
- -d, --debug
- Produce informazioni utili al debug.
- -q, --quiet
- Non produce nessun avviso.
- -s, --no-straycats
- Non perde tempo a cercare o ad aggiungere informazioni ai database
riguardanti le pagine di manuale delle quali non esiste il file sorgente.
(N.d.T.: tali pagine di manuale sono dette in gergo stray cat
page.)
- -c, --create
- Di default, mandb proverà ad aggiornare le basi di dati
precedentemente create. Se una base di dati non esiste, la creerà.
Questa opzione forza mandb a cancellare le basi di dati precedenti
e ricrearle. Ciò potrebbe essere necessario se una base di dati
è rovinata o se un nuovo schema di immagazzinamento di dati
verrà introdotto in futuro.
- -u, --user-db
- Crea solo le basi di dati dell'utente, anche se ha i permessi per creare
le basi di dati globali.
- -h, --help
- Mostra un messaggio d'aiuto, poi esce.
- -V, --version
- Mostra la versione, poi esce.
DIAGNOSTICI¶
Durante la costruzione delle basi di dati possono essere emessi i seguenti
messaggi di avviso:
- <nomefile>: analisi whatis per pagina(sez) fallita
- Un tentativo di estrarre la riga o le righe whatis per il dato
<nomefile> è fallita. Ciò solitamente è dovuto
a una pagina di manuale scritta in modo scadente, ma se sono emessi molti
di questi messaggi allora probabilmente il sistema contiene delle pagine
di manuale non standard che sono incompatibili con l'analizzatore whatis
di man-db.
- <nomefile>: è un link simbolico penzolante
- <nomefile> non esiste ma è riferito con un link simbolico.
Ulteriori messaggi diagnotici sono solitamente prodotti per identificare
il <nomefile> del link violante.
- <nomefile>: link simbolico o richiesta ROFF `.so' errata
- <nomefile> è o un link simbolico a, oppure contiene una
richiesta di inclusione ROFF di un file non esistente.
- <nomefile>: nomefile fasullo ignorato
- Il <nomefile> potrebbe o meno essere un valido nome di pagina di
manuale ma il suo nome non è valido. Ciò solitamente
è dovuto a una pagina di manuale con estensione di sezione
<x> che è stata messa nella sezione <y> delle pagine di
manuale.
- <nomefile_mask>: estensioni in conflitto
- La wildcard <nomefile_mask> non è unica. Ciò è
causato solitamente dall'esistenza della versione compressa e non
compressa della stessa pagina di manuale. Sono ignorate tutte quante
tranne la più recente.
FILE¶
- /etc/manpath.config
- File di configurazione di man-db.
- /usr/man/index.(bt|db|dir|pag)
- Una cache della base di dati globale index tradizionale.
- /var/catman/index.(bt|db|dir|pag)
- Una cache della base di dati globale index alternativa e conforme
con FSSTND.
VEDERE ANCHE¶
man(1),
manpath(5),
catman(8).
AUTORE¶
Wilf. (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Traduzione di Bortolozzo Giovanni (borto@pluto.linux.it)