whatis(s) Utility per le Pagine di Manuale whatis(s) NOME whatis - mostra le descrizioni delle pagine di manuale SINTASSI whatis [-dhV] [-r|-w] [-m sistema[,...]] [-M percorso] nome ... DESCRIZIONE Ogni pagina di manuale ha disponibile al suo interno una breve descrizione. whatis ricerca i nomi e le descrizioni delle pagine di manuale che corrispondono a nome. nome pu contenere wildcard (caratteri jolly) (-w) o essere un'espressione regolare (-r). Usando queste opzioni, potrebbe essere necessario racchiudere tra virgolette (') la parola_chiave o far precedere da backslash (\) i carat- teri speciali per evitare che la shell provi a interpre- tarla(a). Durante la ricerca sono usate le basi di dati index. Per generare dalla base di dati index la corrispondente base di dati vecchio stile whatis in formato testo, si pu usare il comando: whatis -M percorso_man -w '*' | sort > percorso_man/whatis dove percorso_man una gerarchia di pagine di manuale come ad esempio /usr/man. OPZIONI -d, --debug Mostra informazioni utili al debug. -r, --regex Interpreta ogni nome come un'espressione regolare. Verr trovata una corrispondenza se nome corrisponde ad una parte qualsiasi del nome della pagina. Questa opzione fa s che whatis sia un po' pi lento a causa della natura della ricerca nella base di dati. -w, --wildcard Interpreta ogni nome come un modello contenente wildcard nello stile della shell. Affinch ci sia una corrispondenza, un nome espanso deve corrispon- dere al nome completo di una pagina di manuale. Questa opzione fa s che whatis sia un po' pi lento a causa della natura della ricerca nella base di dati. -m sistema[,...], --systems=sistema[,...] Se questo sistema ha accesso ai nomi delle pagine di manuale di altri sistemi operativi, pu essere fatto un accesso a quest'ultimi usando questa opzione. Per effettuare una ricerca nei nomi delle pagine di manuale di NewOS, usare l'opzione -m NewOS. Il sistema pu essere una combinazione qualsiasi di nomi di sistemi operativi separati da virgole. Per includere la ricerca nei nomi delle pagine di man- uale del sistema operativo nativo, si includa il nome di sistema man nella stringa argomento. Usando questa opzione verr ignorata la variabile d'ambiente $SYSTEM. -M percorso, --manpath=percorso Specifica un insieme alternativo di gerarchie di pagine di manuale, separate da `:', nelle quali fare la ricerca. Di default, whatis usa la vari- abile d'ambiente $MANPATH finch questa non vuota o non impostata, nel qual caso determiner un percorso man appropriato basandosi sulla variabile d'ambi- ente $PATH dell'utente. Usando questa opzione verr ignorato il contenuto della variabile d'ambiente $MANPATH. -h, --help Mostra un messaggio d'aiuto ed esce. -V, --version Mostra informazioni sulla versione e sull'autore. STATI D?USCITA 0 L'esecuzione del programma ha avuto successo. 1 Errore d'uso, di sintassi o nel file di configu- razione. 2 Errore operativo. 16 Non stata trovata alcuna pagina di manuale che corrisponde al criterio specificato. VARIABILI D'AMBIENTE SYSTEM Se $SYSTEM impostata, avr lo stesso effetto che fosse specificata come argomento dell'opzione -m. MANPATH Se $MANPATH impostata, il suo valore interpretato come una lista di percorsi, separati da `:', di gerarchie di pagine di manuale da usare nella ricerca. FILE /usr/share/man/index.(bt|db|dir|pag) Una cache della base di dati globale index tradizionale. /var/cache/man/index.(bt|db|dir|pag) Una cache della base di dati globale index alterna- tiva e conforme con FHS. /usr/share/man/.../whatis Una tradizionale base di dati whatis. VEDERE ANCHE apropos(s), man(n). AUTORE Wilf. (G.Wilford@ee.surrey.ac.uk). Fabrizio Polacco (fpolacco@debian.org). Traduzione di Giovanni Bortolozzo (borto@pluto.linux.it) 2.3.20 07 September 2001 whatis(s)