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)