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

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 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.

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 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.

STATI DUSCITA
       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.

VARIABILI DAMBIENTE
       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  alternativa e
              conforme con FHS.

       /usr/share/man/.../whatis
              Una tradizionale base di dati whatis.

VEDERE ANCHE

       apropos(1), man(1).

AUTORE

       Wilf. (G.Wilford@ee.surrey.ac.uk).
       Fabrizio Polacco (fpolacco@debian.org).
       Traduzione di Giovanni Bortolozzo (borto@pluto.linux.it)