'\" t
.\" Man page for mandb
.\"
.\" Copyright (C), 1994, 1995, Graeme W. Wilford. (Wilf.)
.\"
.\" Traduzione in Italiano di Bortolozzo Giovanni <borto@pluto.linux.it>
.\" Febbraio 1997
.\" 1° Revisione Marzo 1997
.\" 2° Revisione Agosto 1999
.\" 3^ Revisione e aggionamento Settembre 1999
.\"
.\" You may distribute under the terms of the GNU General Public
.\" License as specified in the file docs/COPYING.GPLv2 that comes with the
.\" man-db distribution.
.\"
.\" Tue Apr 26 12:56:44 BST 1994  Wilf. (G.Wilford@ee.surrey.ac.uk)
.\"
.\"" for hilit19
.TH %thmandb% 8 "%date%" "%version%" "Utility per le Pagine di Manuale"
.SH NOME
%mandb% \- crea o aggiorna le cache index delle pagine di manuale
.SH SINTASSI
.B %mandb%
.RB [\| \-dqsuc \||\| \-h \||\| \-V\c
.RI "\|] [\|" percorso \|]
.SH DESCRIZIONE
.B %mandb%
è usato per inizializzare o aggiornare manualmente le cache delle basi
di dati
.B index
solitamente mantenute da
.BR %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
.BR index ,
.B %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
.BR whatis .

Fornendo a
.B %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.
.SH "CACHE DELLE BASI DI DATI"
.B %mandb%
può essere compilato con il supporto per qualsiasi fra seguenti tipi
di basi di dati.

.TS
tab (@);
l l l l.
Nome@Tipo@Asinc@NomeFile
_
Berkeley db@Binary tree@Sì@\fIindex.bt\fR
GNU gdbm@Hashed@Sì@\fIindex.db\fR
UNIX ndbm@Hashed@No@\fIindex.(dir|pag)\fR
.TE

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
.B %mandb%
con l'opzione
.B \-c
per ricreare le nuove basi di dati.
.SH OPZIONI
.TP
.B \-d, \-\-debug
Produce informazioni utili al debug.
.TP
.B \-q, \-\-quiet
Non produce nessun avviso.
.TP
.B \-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
.I "stray cat"
page.)
.TP
.B \-c, \-\-create
Di default,
.B %mandb%
proverà ad aggiornare le basi di dati precedentemente create. Se una
base di dati non esiste, la creerà. Questa opzione forza
.B %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.
.TP
.B \-u, \-\-user-db
Crea solo le basi di dati dell'utente, anche se ha i permessi per
creare le basi di dati globali.
.TP
.B \-h, \-\-help
Mostra un messaggio d'aiuto, poi esce.
.TP
.B \-V, \-\-version
Mostra la versione, poi esce.
.SH DIAGNOSTICI
Durante la costruzione delle basi di dati possono essere emessi i
seguenti messaggi di avviso:
.TP
.B <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.
.TP
.B <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.
.TP
.B <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.
.TP
.B <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.
.TP
.B <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.
.SH FILE
.TP
.I %manpath_config_file%
File di configurazione di man-db.
.TP
.I /usr/man/index.(bt|db|dir|pag)
Una cache della base di dati globale
.I index
tradizionale.
.TP
.I /var/catman/index.(bt|db|dir|pag)
Una cache della base di dati globale
.I index
alternativa e conforme con FSSTND.
.SH "VEDERE ANCHE"
.BR %man% (1),
.BR manpath (5),
.BR %catman% (8).
.SH AUTORE
Wilf. (G.Wilford@ee.surrey.ac.uk).
.br
Fabrizio Polacco (fpolacco@debian.org).
.br
Traduzione di Bortolozzo Giovanni (borto@pluto.linux.it)
