WHATIS(1)              Utility per le Pagine di Manuale              WHATIS(1)

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 puo 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 puo usare il comando:

       whatis -M percorso_man -w '*' | sort > percorso_man/whatis

       dove percorso_man e 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.  Verra
              trovata una corrispondenza se nome corrisponde ad una parte
              qualsiasi del nome della pagina.  Questa opzione fa si che
              whatis sia un po' piu 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.  Affinche ci sia una corrispondenza, un nome
              espanso deve corrispondere al nome completo di una pagina di
              manuale.  Questa opzione fa si che whatis sia un po' piu 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, puo 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 puo 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 verra 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 finche
              questa non e vuota o non impostata, nel qual caso determinera un
              percorso man appropriato basandosi sulla variabile d'ambiente
              $PATH dell'utente. Usando questa opzione verra 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 configurazione.

       2      Errore operativo.

       16     Non e stata trovata alcuna pagina di manuale che corrisponde al
              criterio specificato.

VARIABILI D'AMBIENTE
       SYSTEM Se $SYSTEM e impostata, avra lo stesso effetto che fosse
              specificata come argomento dell'opzione -m.

       MANPATH
              Se $MANPATH e impostata, il suo valore e 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)

2.12.1                            2024-04-05                         WHATIS(1)