mandb(b) Utility per le Pagine di Manuale mandb(b) 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 fun- zionalit. 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 per- corsi 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. tab (@); l l l l. 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 asin- croni privilegiando la velocit a spese di eventuali cor- ruzioni 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 infor- mazioni ai database riguardanti le pagine di man- uale 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(a) 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 sca- dente, ma se sono emessi molti di questi messaggi allora probabilmente il sistema contiene delle pagine di manuale non standard che sono incompati- bili con l'analizzatore whatis di man_db. <nomefile>: un link simbolico penzolante <nomefile> non esiste ma riferito con un link sim- bolico. Ulteriori messaggi diagnotici sono solita- mente 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 alterna- tiva e conforme con FSSTND. VEDERE ANCHE man(n), manpath(h), catman(n). AUTORE Wilf. (G.Wilford@ee.surrey.ac.uk). Fabrizio Polacco (fpolacco@debian.org). Traduzione di Bortolozzo Giovanni (borto@pluto.linux.it) 2.3.20 07 September 2001 mandb(b)