whatis - mostra le descrizioni delle pagine di manuale
whatis [-dhV] [-r|-w] [-m
sistema[,...]] [-M percorso] nome ...
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 caratteri speciali
per evitare che la shell provi a interpretarla(i).
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.
- -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 corrispondere 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 manuale 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 variabile d'ambiente $MANPATH finché questa non
è vuota o non impostata, nel qual caso determinerà un
percorso man appropriato basandosi sulla variabile d'ambiente $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.
- 0
- L'esecuzione del programma ha avuto successo.
- 1
- Errore d'uso, di sintassi o nel file di configurazione.
- 2
- Errore operativo.
- 16
- Non è stata trovata alcuna pagina di manuale che corrisponde al
criterio specificato.
- 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.
- /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 alternativa e conforme
con FHS.
- /usr/share/man/.../whatis
- Una tradizionale base di dati whatis.
Wilf. (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Traduzione di Giovanni Bortolozzo (borto@pluto.linux.it)