Provided by: man-db_2.5.7-2_i386 bug

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)