MANDB(8) Utility per le Pagine di Manuale MANDB(8)
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 Hashed Sì 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)
2.11.2 2023-01-08 MANDB(8)
Generated by dwww version 1.15 on Mon Jul 1 05:31:59 CEST 2024.