dwww Home | Manual pages | Find package

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

NOME
       man - un'interfaccia ai manuali di riferimento in linea

SINTASSI
       man   [-c|-w|-tZ]  [-H[browser]]  [-Tdispositivo]  [-X[dpi]]  [-adhu7V]
       [-i|-I] [-m sistema[,...]] [-L  locale]  [-p  stringa]  [-C  file]  [-M
       percorso]  [-P  paginatore]  [-r  prompt]  [-S  lista]  [-e estensione]
       [[sezione] pagina ...] ...
       man -l [-7] [-tZT] [-H[browser]] [-Tdispositivo] [-X[dpi]] [-p stringa]
       [-P paginatore] [-r prompt] file ...
       man -k [apropos opzioni] espr_reg ...
       man -f [whatis opzioni] pagina ...

DESCRIZIONE
       man  è  il  paginatore  dei manuali del sistema. Di solito ognuno degli
       argomenti pagina dati a man è il nome di un programma, di un'utility  o
       di  una  funzione.  La pagina di manuale associata con ognuno di questi
       argomenti  è  poi  trovata  e  mostrata.  Una  sezione,   se   fornita,
       indirizzerà  man  a  guardare  solo  in  quella  sezione  del  manuale.
       L'azione predefinita è di ricercare in  tutte  le  sezioni  disponibili
       seguendo  un  ordine  prestabilito  e  di mostrare solo la prima pagina
       trovata, anche se pagina esiste in diverse sezioni.

       La seguente tabella mostra i numeri delle sezioni del  manuale  seguiti
       dai tipi di pagine che contengono

       1   Programmi eseguibili e comandi della shell
       2   Chiamate al sistema (funzioni fornite dal kernel)
       3   Chiamate  alle  librerie  (funzioni  all'interno  delle librerie di
           sistema)
       4   File speciali (di solito trovabili in /dev)
       5   Formati dei file e convenzioni p.es. /etc/passwd
       6   Giochi
       7   Pacchetti di macro e convenzioni p.es. man(7), groff(7).
       8   Comandi per l'amministrazione del  sistema  (solitamente  solo  per
           root)
       9   Routine del kernel [Non standard]

       Una pagina di manuale consta di diverse parti.

       Queste  possono  essere  etichettate  NOME (NAME), SINTASSI (SYNOPSIS),
       DESCRIZIONE (DESCRIPTION),  OPZIONI  (OPTIONS),  FILE  (FILES),  VEDERE
       ANCHE (SEE ALSO), PROBLEMI (BUGS) e AUTORE (AUTHOR).

       Le  seguenti  convenzioni  si applicano alla sezione SINTASSI e possono
       essere usate come una guida per le altre sezioni.

       testo in grassetto   scrivere esattamente come mostrato.
       testo in corsivo     rimpiazzare con un argomento appropriato.
       [-abc]               ognuno o tutti gli argomenti all'interno  di  [  ]
                            sono opzionali.
       -a|-b                opzioni  separate  da  |  non possono essere usate
                            assieme.
       argomento ...        argomento è ripetibile.
       [espressione] ...    l'intera  espressione all'interno   di   [   ]   è
                            ripetibile.

       L'illustrazione  del  comando  o  funzione  è  un  modello che dovrebbe
       corrispondere a tutte  le  possibili  invocazioni.  In  alcuni  casi  è
       preferibile illustrare diverse invocazioni che si escludono a vicenda
        come mostrato nella sezione SINTASSI di questa pagina di manuale.

ESEMPI
       man ls
           Mostra la pagina di manuale per la voce (programma) ls.

       man -a intro
           Mostra,   in   successione,   tutte  le  pagine  di  manuale  intro
           disponibili nel manuale. È possibile uscire tra due visualizzazioni
           successive o saltarne una qualsiasi.

       man -t alias | lpr -Pps
           Formatta  la pagina di manuale indicata da `alias', solitamente una
           pagina di manuale della shell, nel formato predefinito di  troff  o
           groff  e  la redireziona, tramite pipe, alla stampante chiamata ps.
           L'output predefinito per groff è  di  solito  in  PostScript.   man
           --help  dovrebbe  mostrare  quale  preprocessore  è  collegato  con
           l'opzione -t.

       man -l -Tdvi ./foo.1x.gz > ./foo.1x.dvi
           Questo comando decomprime e formatta il sorgente nroff della pagina
           di  manuale  ./foo.1x.gz  in un file device independent (dvi) .  La
           redirezione è necessaria in quanto l'opzione -T fa sì che  l'output
           sia  diretto  verso lo stdout senza nessun paginatore. L'output può
           essere visto con un programma tipo xdvi o ulteriormente  convertito
           in PostScript usando un programma tipo dvips.

       man -k printf
           Cerca  la  parola  chiave printf nelle descrizioni brevi e nei nomi
           delle  pagine  considerandola  una  espressione  regolare.   Mostra
           qualsiasi corrispondenza.  Equivalente a apropos -r printf.

       man -f smail
           Cerca  le  pagine  di  manuale indicate da smail e mostra una breve
           descrizione   di   tutte    quelle    trovate.     Equivalente    a
           whatis -r smail.

PANORAMICA
       Molte sono le opzioni disponibili per man in modo da fornire all'utente
       la maggior flessibilità possibile. Possono essere fatti cambiamenti  al
       percorso  di  ricerca,  all'ordine  delle sezioni, al preprocessore per
       l'output, e ad altri comportamenti e operazioni elencati  in  dettaglio
       più avanti.

       Se   impostate,   alcune  variabili  d'ambiente  sono  interrogate  per
       determinare le funzionalità di man.  È possibile impostare la variabile
       "omni  comprensiva"  $MANOPT ad una stringa qualsiasi nel formato della
       riga di  comando,  con  l'eccezione  che  ogni  spazio  che  sia  parte
       integrante  dell'argomento  di  un'opzione  deve essere preceduto da un
       backslash (`\').  man analizzerà $MANOPT prima di analizzare la propria
       riga  di  comando.  Quelle opzioni che richiedono un argomento, saranno
       ridefinite se le stesse opzioni si trovano anche nella riga di comando.
       Per  annullare  tutte  le  opzioni  impostate  in  $MANOPT,  può essere
       specificato -D come  opzione  iniziale  della  riga  di  comando.   Ciò
       permette  a  man  di  "dimenticare"  le  opzioni specificate in $MANOPT
       sebbene debbano restare ancora valide.

       Le utility per le pagine di manuale raggruppate  nel  pacchetto  man-db
       fanno  un  uso  intenso  delle  cache  di index.  Tali cache contengono
       informazioni come la posizione di ogni pagina di manuale nel filesystem
       e  cosa  contiene il relativo whatis (breve descrizione della pagina di
       manuale), inoltre permettono a man  di  cercare  le  pagine  molto  più
       velocemente  rispetto  ad una ricerca su file system per ogni pagine da
       cercare.  Se richiesto tramite l'opzione -u man può verificare che tali
       cache  rimangano consistenti, in modo da non dover lanciare manualmente
       del software per aggiornare le tradizionali basi di dati di whatis.

       Se man non può trovare una base di dati index  inizializzato  da  mandb
       per  una  particolare gerarchia di pagine di manuale, cercherà comunque
       la pagina di manuale richiesta sebbene sarà necessario un globbing  dei
       file  per effettuare la ricerca all'interno di quella gerarchia (N.d.T:
       con globbing [jargon] si intende l'espansione  dei  caratteri  speciali
       all'interno  di  un  nome  costruito  con  wildcard - caratteri jolly).
       Invece se  whatis  o  apropos  non  trovano  la  base  di  dati  index,
       proveranno  comunque  a  estrarre  le  informazioni  dalla base di dati
       whatis tradizionale.

       Queste utility supportano i file sorgente nroff compressi, che abbiano,
       di  default,  una fra le seguenti estensioni .Z, .z e .gz.  È possibile
       trattare  con  qualsiasi  estensione  di  file  compresso,  ma   questa
       informazione  deve essere nota al momento della compilazione.  Inoltre,
       normalmente, qualsiasi pagina cat prodotta  è  compressa  usando  gzip.
       Ognuna   delle  gerarchie  `globali'  delle  pagine  di  manuale,  come
       /usr/share/man o /usr/X11R6/man, può avere una directory qualsiasi come
       gerarchia  delle  pagine  cat.   Tradizionalmente  le  pagine  cat sono
       salvate sotto la stessa gerarchia  delle  pagine  di  manuale,  ma  per
       ragioni   come  quelle  specificate  nel  Linux  File  System  Standard
       (FSSTND), è meglio salvarle da qualche altra parte. Per i  dettagli  su
       come ciò sia possibile, si legga manpath(5).  Per i dettagli sul perché
       fare ciò, si legga lo standard.

       Con questo pacchetto è disponibile il ``supporto  internazionale'':  le
       pagine  di manuale nella lingua nativa sono accessibili (se disponibili
       nel proprio sistema) usando le  funzioni  locale.   Per  attivare  tale
       supporto,  è  necessario impostare $LC_MESSAGES e $LANG o qualche altra
       variabile  d'ambiente  dipendente  dal  sistema,  alla  propria  lingua
       locale, solitamente specificata nel formato basato sul POSIX 1003.1:

       <lingua>[_<zona>[.<set-di-caratteri>[,<versione>]]]

       Se la pagina desiderata è disponibile nel proprio locale, sarà mostrata
       al posto della pagina standard (di solito in Inglese Americano).

       Il supporto internazionale per  i  cataloghi  di  messaggi  è  un'altra
       caratteristica  di  questo  pacchetto  e può essere attivato, sempre se
       disponibile, nello stesso modo. Se si trova che le pagine di manuale  e
       i  cataloghi  dei  messaggi  forniti  con  questo  pacchetto  non  sono
       disponibili per la propria lingua e si vuole fornirli, si  contatti  il
       manutentore il quale coordinerà tali attività.

       Per   informazioni  riguardanti  altre  caratteristiche  ed  estensioni
       disponibili con questo paginatore dei manuali, si leggano  i  documenti
       forniti con il pacchetto.

COMPORTAMENTO PREDEFINITO
       man  cercherà  la  pagina di manuale desiderata all'interno delle cache
       delle basi di  dati  index.   Se  l'opzione  -u  viene  specificata,  è
       eseguita una verifica della consistenza della cache per assicurarsi che
       le  basi  di  dati  riflettano  accuratamente  il  filesystem.  Non   è
       generalmente  necessario  eseguire  mandb  dopo che le cache sono state
       create inizialmente, finché una di  questa  non  sia  in  qualche  modo
       corrotta.   Il  controllo  della  cache  su sistemi con molte pagine di
       manuale può  essere  piuttosto  lungo;  per  questo  non  viene  svolto
       automaticamente,  ma  gli  amministratori  di sistema possono esseguire
       mandb settimanalmente per aggiornare la base  di  dati.   Per  superare
       eventuali   problemi   causati   da  cache  non  aggiornate  man  passa
       automaticamente al `file globbing' se una ricerca nella  cache  non  ha
       esito, allo stesso modo di quando la cache non è presente.

       Una volta che una pagina di manuale è stata localizzata, è eseguita una
       verifica per scoprire se il relativo file  `cat'  preformattato  esiste
       già  e  se  è  più  recente  del  file  nroff.  Se  è così, questo file
       preformattato è (di solito) decompresso e poi visualizzato  tramite  un
       paginatore. Il paginatore può essere specificato in diversi modi oppure
       viene usato quello predefinito (si veda l'opzione -P per  i  dettagli).
       Se non c'è la pagina cat o è più vecchia del file nroff, quest'ultimo è
       filtrato attraverso vari programmi ed è mostrato immediatamente.

       Se può essere prodotto un file cat (esiste la relativa directory cat  e
       ha  i  permessi  appropriati),  man comprimerà e salverà il file cat in
       background.

       Quanti e quali filtri usare viene determinato  in  svariati  modi.  Per
       prima  cosa  è  interrogata  l'opzione  della  riga  di comando -p o la
       variabile d'ambiente $MANROFFSEQ.  Se -p non è  usata  e  la  variabile
       d'ambiente  non è impostata, viene analizzata la riga iniziale del file
       troff per  cercare  una  "stringa  preprocessore".  Per  contenere  una
       stringa preprocessore valida, la prima riga deve assomigliare a

       '\" <stringa>

       dove  stringa  può  essere  una  combinazione  qualsiasi  delle lettere
       descritte più avanti dall'opzione -p.

       Se nessuno dei metodi suddetti fornisce informazioni sui filtri,  ne  è
       usato un insieme predefinito.

       Una  pipeline  di  formattazione  è  creata  dai filtri al formattatore
       primario (nroff o [tg]roff con -t) ed eseguita.   Alternativamente,  se
       esiste  un  programma eseguibile mandb_nfmt (o mandb_tfmt con -t) nella
       radice dell'albero dei manuali, questo è eseguito. Gli viene passato il
       file  sorgente  del manuale, la stringa preprocessore, ed eventualmente
       il dispositivo specificato come argomento di -T o -E.

OPZIONI
       Le opzioni che  non  richiedono  argomenti,  duplicate  nelle  riga  di
       comando,  in  $MANOPT,  o  in entrambe sono dannose. Per le opzioni che
       richiedono un argomento, ogni  duplicazione  annullerà  il  valore  del
       precendente argomento.

       -l, --local-file
              Attiva  il  modo `locale'. Formatta e visualizza file di manuale
              locali invece di effettuare  una  ricerca  nella  collezione  di
              manuali  del  sistema.  Ogni  argomento pagina sarà interpretato
              come un file sorgente nroff nel formato corretto.  Non è  creato
              il  file  cat. Se '-' è elencato fra gli argomenti, l'input sarà
              preso dallo stdin.  Quando non è usata questa opzione, e man non
              trova  la  pagina  richiesta,  prima  di  mostrare  un messaggio
              d'errore, prova a  comportarsi  come  se  fosse  fornita  questa
              opzione,  usando  il  nome  come  nome di un file e cercando una
              corrispondenza esatta.

       -L locale, --locale=locale
              man di solito determinerà il proprio locale attuale chiamando la
              funzione   C   setlocale(3)   che  interroga  diverse  variabili
              d'ambiente, tra le quali $LC_MESSAGES e $LANG.   Per  ridefinire
              temporaneamente  il  valore  così  determinato,  si  usi  questa
              opzione per fornire direttamente una stringa locale a  man.   Si
              noti  che  ciò  non avrà effetto finché non è iniziata realmente
              una ricerca. L'output, come ad  esempio  il  messaggio  d'aiuto,
              sarà sempre visualizzato nel locale determinato inizialmente.

       -D, --default
              Questa   opzione   è  solitamente  data  come  prima  opzione  e
              reinizializza il comportamento di man a  quello  predefinito.  È
              usata  per  reinizializzare  quelle  opzioni  che possono essere
              state impostate in $MANOPT.   Qualsiasi  opzione  successiva  -D
              avrà il solito effetto.

       -C file, --config-file=file
              Usa il file di configurazione speficiato al posto di ~/.manpath.

       -M percorso, --manpath=percorso
              Specifica  un  percorso  man alternativo. Normalmente man usa il
              codice derivato  da  manpath  per  determinare  il  percorso  di
              ricerca.  Questa  opzione ha priorità sulla variabile d'ambiente
              $MANPATH e fa sì che questa e l'opzione -m siano ignorate.

              Un percorso specificato come manpath deve essere  la  radice  di
              una  gerarchia  di pagine di manuali strutturate in sezioni come
              descritto nel manuale di man-db (nella sezione "The manual  page
              system").   Per  vedere  le  pagine  di manuali esterne a questa
              gerarchia, si usi l'opzione -l .

       -P paginatore, --pager=paginatore
              Specifica quale paginatore dell'output  usare.  Normalmente  man
              usa   pager.    Questa   opzione  ha  priorità  sulla  variabile
              d'ambiente $PAGER e non va usata assieme con -f o -k.

       -r prompt, --prompt=prompt
              Se una versione recente di less è  usata  come  paginatore,  man
              proverà  ad  impostare  il  suo prompt e alcune sue opzioni.  Il
              prompt predefinito assomiglierà a

               Pagina di Manuale nome(sez) riga x

              dove nome denota il nome della pagina di manuale, sez denota  la
              sezione in cui è stata trovata e x è il numero di riga corrente.
              Ciò è ottenuto usando la variabile d'ambiente $LESS.

              Fornendo l'opzione -r seguita da una stringa si  può  modificare
              il  prompt  predefinito.   La  stringa  può  contenere  il testo
              $MAN_PN il quale sarà espanso nel nome della pagina  di  manuale
              corrente e il nome della sua sezione racchiuso tra `(' e `)'. La
              stringa usata per produrre il default potrebbe  essere  espressa
              come

              \ Pagina\ di\ Manuale\ \$MAN_PN\ ?ltriga\ %lt?L/%L.:
              byte\ %bB?s/%s..?\ (FINE):?pB %pB\\%..

              È   stata   spezzata  in  due  righe  solo  per  migliorarne  la
              leggibilità. Per il suo significato si veda la pagina di manuale
              less(1).   La  stringa di prompt per prima cosa è valutata dalla
              shell. Perciò le doppie virgolette `"',  le  virgolette  rovesce
              ``' e i backslash `\' devono essere preceduti da `\'. La stringa
              di prompt potrebbe terminare con un `\$'  il  quale  può  essere
              seguito da ulteriori opzioni per less. Di default man imposta le
              opzioni -ix8.

              Se si vuole eliminare completamente la gestione  del  prompt  da
              parte  di  man si faccia uso della variabile d'ambiente $MANLESS
              descritta sotto.

       -7, --ascii
              Quando visualizza una pagina di manuale in ascii(7) puro  su  di
              un  terminale  a  7  bit  o su un emulatore di terminale, alcuni
              caratteri potrebbero non essere visualizzati correttamente se si
              usa  il  descrittore  di dispositivo latin1(7) con il GNU nroff.
              Questa opzione permette alle pagine di manuale in ascii puro  di
              essere  visualizzate  in  ascii  con il dispositivo latin1.  Non
              tradurrà alcun testo latin1.   La  seguente  tabella  mostra  le
              traduzioni  effettuate:  alcune  parti di essa potrebbero essere
              mostrate  in  maniera  corretta  solo  usando   il   dispositivo
              latin1(7) di GNU nroff.

              Descrizione                 Ottale   latin1   ascii
              ────────────────────────────────────────────────────
              trattino di continuazione    255       -        -
              bullet (middle dot)          267       •        o
              accento acuto                264       ´        '
              segno di moltiplicazione     327       ×        x

              Se  la  colonna  latin1 è visualizzata correttamente, il proprio
              terminale può essere configurato per i caratteri latin1 e questa
              opzione  non  è  necessaria.   Se le colonne latin1 e ascii sono
              identiche, si sta leggendo questa pagina usando  questa  opzione
              oppure   man  non  l'ha  formattata  usando  il  descrittore  di
              dispositivo latin1.  Se manca la colonna latin1  o  è  corrotta,
              può  essere  necessario visualizzare le pagine di manuale usando
              questa opzione.

              Questa opzione è ignorata quando si usano le opzioni -t, -H,  -T
              o -Z e può essere inutile per nroff diversi dalla versione GNU.

       -S lista, --sections=lista
              Lista  è  un  elenco  ordinato  di  sezioni  di  manuale  su cui
              effettuare la ricerca. Usando questa opzione viene  ignorata  la
              variabile d'ambiente $MANSECT.

       -a, --all
              Normalmente,  man  uscirà  dopo  aver  visualizzato la pagina di
              manuale più adatta che trova. Usando questa opzione si forza man
              a  visualizzare  tutte  le  pagine  di  manuale  con  i nomi che
              corrispondono al criterio di ricerca.

       -c, --catman
              Questa opzione non è di uso generale  e  dovrebbe  essere  usata
              solo dal programma catman.

       -d, --debug
              Non  mostra  alcuna  pagina  di  manuale,  ma mostra un sacco di
              informazioni per il debug.

       -e sotto-estensione, --extension=sotto-estensione
              Alcuni sistemi  incorporano  nella  gerarchia  principale  delle
              pagine  di  manuale  grossi pacchetti di pagine di manuale, come
              quelle che  accompagnano  il  pacchetto  Tcl.   Per  ovviare  ai
              problemi dovuti alla presenza di pagine di manuale con lo stesso
              nome come exit(3), le pagine di Tcl  sono  di  solito  assegnate
              alla sezione l.  Poiché questa non è una scelta fortunata, è ora
              possibile mettere le pagine nella sezione corretta, ed in questo
              caso  assegnare  l'estensione  specifica exit(3tcl).  Durante il
              funzionamento normale, man visualizzerà  exit(3)  piuttosto  che
              exit(3tcl).   Per  trattare  questa  situazione  ed  evitare  la
              necessità di sapere in quale  sezione  di  trova  la  pagina  di
              manuale  richiesta,  è  ora  possibile dare a man una stringa di
              sotto-estensione che indica a quale pacchetto  deve  appartenere
              la  pagina.  Usando  il  precedente  esempio, passando l'opzione
              -e tcl a man verrà ristretta la ricerca alle  pagine  che  hanno
              estensione *tcl.

       -f, --whatis
              Equivalente   a  whatis.   Mostra,  se  disponibile,  una  breve
              descrizione tratta della pagine di manuale.  Si  veda  whatis(1)
              per i dettagli.

       -h, --help
              Mostra un messaggio d'aiuto ed esce.

       -i, --ignore-case
              Non  fa distinzione tra maiuscole e minuscole durante la ricerca
              della pagine. Questo è il comportamento normale

       -I, --match-case
              Effettua la ricerca della pagina facendo distinzione tra lettere
              minuscole e maiuscole.

       -k, --apropos
              Equivalente  a  apropos.   Cerca  nelle  descrizioni brevi delle
              pagine di manuale le occorrenze delle parole chiave e visualizza
              qualsiasi corrispondenza. Si veda apropos(1) per i dettagli.

       -m sistema[,...], --systems=sistema[,...]
              Se  questo  sistema  ha  accesso alle pagine di manuale di altri
              sistemi operativi, si può accedere a quest'ultime usando  questa
              opzione.  Per  cercare  una  pagina  di manuale nella collezione
              delle pagine di manuale di NewOS, si usi l'opzione -m NewOS.

              Il sistema specificato può essere una combinazione  di  nomi  di
              sistemi operativi separati da virgole. Per includere una ricerca
              fra le 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.

       -p stringa, --preprocessor=stringa
              Specifica la sequenza di  preprocessori  da  lanciare  prima  di
              nroff   o  troff/groff.   Non  tutte  le  installazioni  avranno
              l'insieme completo di preprocessori. Alcuni dei preprocessori  e
              le  lettere  che  li designano sono: eqn (e), grap (g), pic (p),
              tbl (t), vgrind (v), refer (r).   Usando  questa  opzione  viene
              ignorata  la variabile d'ambiente $MANROFFSEQ.  zsoelim è sempre
              lanciato come primo preprocessore.

       -u, --update
              Questa opzione fa in  modo  che  man  effettui  un  controllo  a
              livello  di  `inode'  sulla propria base di dati per assicurarsi
              che sia una accurata rappresentazione del file system.   Il  suo
              effetto  è  positivo  solo se man è installato con il bit setuid
              impostato.

       -t, --troff
              Usa groff -mandoc per formattare  la  pagina  di  manuale  nello
              stdout. Questa opzione non è richiesta assieme a -H, -T o -Z.

       -T[dispositivo], --troff-device[=dispositivo]
              Questa  opzione  è  usata  per  cambiare l'output di groff (o se
              possibile quello di  troff)  per  adattarlo  ad  un  dispositivo
              diverso  da quello predefinito. Implica -t.  Esempi (forniti con
              Groff-1.17) comprendono dvi, latin1, ps, utf8, X75 e X100.

       -X[dpi], --gxditview[=dpi]
              Questa opzione mostra l'output di groff in una finestra  grafica
              usando  il  programma  gxditview.   dpi  (punti per pollice) può
              essere 75, 75-12, 100 o 100-12, con valore  predefinito  75;  le
              varianti  -12 usano un font da 12 punti.  Questa opzione implica
              -T con i dispositivi X75, X75-12, X100, X100-12 rispettivamente.

       -Z, --ditroff
              groff lancerà troff e poi userà un  appropriato  post-processore
              per  produrre  un  output  adatto  per il dispositivo scelto. Se
              groff -mandoc è groff, questa opzione è passata a groff e  verrà
              soppresso l'uso del post-processore. Implica -t.

       -H[browser], --html[=browser]
              Questa  opzione  indica  a  groff  di produrre un output HTML, e
              mostra tale output in un browser web. La scelta  del  browser  è
              opzionale  ed  è determinata dall'argomento opzionale browser se
              questo è fornito; altrimenti dalla variabile $BROWSER oppure dal
              valore  definito  durante  la  compilazione  (in  genere  lynx).
              Questa opzione implica -t, e funziona solo con la  versione  GNU
              di troff.

       -E dispositivo, --encoding=dispositivo
              Genera  un  output  usando una codifica di caratteri diversa dal
              valore predefinito. Per il modo nel quale nroff  è  strutturato,
              l'argomento  di  questa  opzione  deve  essere un dispositivo di
              nroff come ascii, latin1 o utf8.

       -w, --where, --location
              Non  mostra  veramente  le  pagine  di  manuale,  ma  stampa  le
              posizioni dei file che sarebbero stati formattati.

       -W, --where-cat, --location-cat
              Non  mostra  veramente  le  pagine  di  manuale,  ma  stampa  le
              posizioni dei file cat che  sarebbero  stati  visualizzati.   Se
              entrambi  -w e -W vengono specificati, li stampa separati da uno
              spazio.

       -V, --version
              Mostra informazioni sulla versione.

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.

       3      Un processo figlio ha restituito uno stato d'uscita  diverso  da
              zero.

       16     Almeno  una  delle  pagine/file/parole chiave non esisteva o non
              aveva corrispondenza.

VARIABLI D'AMBIENTE
       MANPATH
              Se $MANPATH è impostata, il suo valore è usato come percorso per
              la ricerca delle pagine di manuale.

       MANROFFSEQ
              Se   $MANROFFSEQ   è  impostata,  il  suo  valore  è  usato  per
              determinare l'insieme dei preprocessori attraverso  i  quali  va
              passata  la  pagina  di  manuale.  La  lista  dei  preprocessori
              predefiniti dipende dal sistema.

       MANSECT
              Se $MANSECT è impostata, il suo valore è una lista  separata  da
              `:'  di  sezioni  ed è usata per determinare in quali sezioni di
              manuale cercare e in quale ordine.

       PAGER  Se $PAGER è impostata, il suo valore è usato come  il  nome  del
              programma  da  usare  per  visualizzare la pagina di manuale. Di
              default, è usato pager.

       MANLESS
              Se $MANLESS è impostata, man non  effettuerà  alcuna  operazione
              per  impostare una stringa di prompt per il pager less.  Invece,
              il valore di $MANLESS verrà passato senza modifiche  $LESS.   Ad
              esempio,  per  impostare  il  prompt  a “la mia stringa prompt”,
              impostare $MANLESS to ‘-Psla mia stringa prompt’.

       BROWSER
              Se $BROWSER è impostata, il suo valore deve essere una lista  di
              comandi  separati  da  virgole, ciascuno dei quali viene provato
              nell'ordine per cercare di  eseguire  un  browser  web  per  man
              --html.   In ogni comando %s viene sostituito da un nome di file
              contiene l'output HTML di  groff,  %%  viene  sostituito  da  un
              singolo  carattere  di  percento,  e  %c  viene  sostituito  dal
              carattere di due punti.

       SYSTEM Se $SYSTEM è impostata, avrà lo stesso effetto  dell'opzione  -m
              stringa dove stringa sarà preso come il contenuto di $SYSTEM.

       MANOPT Se  $MANOPT  è  impostata,  sarà  analizzata prima della riga di
              comando di man ed è supposta essere in  formato  simile.  Poiché
              tutte  le  altre  variabili d'ambiente specifiche di man possono
              essere specificate come opzioni della riga di  comando,  e  sono
              quindi  candidate  per  essere  incluse  in  $MANOPT  ci  si può
              aspettare che diventeranno obsolete.  N.B.: Tutti gli spazi  che
              dovrebbero  essere  interpretati come parte dell'argomento di un
              opzione devono essere preceduti da `\'.

       MANWIDTH
              Se $MANWIDTH è impostata, il suo  valore  sarà  utilizzato  come
              lunghezza  della riga per il quale le pagine di manuale verranno
              formattate. Se non viene impostata, le pagine saranno formattate
              usando  una  lunghezza  appropriata al terminale in uso (tramite
              ioctl(2) se disponibile, oppure il valore di $COLUMNS, o  ancora
              usando  il  valore  80  se  nessuno  dei  due  metodi precedenti
              funziona).  Le pagine cat verranno salvate solo le la  lunghezza
              della linea di terminale si trova tra 66 e 80 caratteri.

       LANG, LC_MESSAGES
              A  seconda del sistema e dell'implementazione, una o entrambe le
              variabili  $LANG  e   $LC_MESSAGES   saranno   interrogate   per
              determinare   il  locale  corrente.   man  visualizzerà  i  suoi
              messaggi  usando  quel  locale   (se   disponibile).   Si   veda
              setlocale(3) per i dettagli.

FILE
       /etc/manpath.config
              File di configurazione di man-db.

       /usr/share/man
              Una gerarchia di pagine di manuale globale.

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

VEDERE ANCHE
       mandb(8), manpath(1),  manpath(5),  apropos(1),  whatis(1),  catman(8),
       less(1),   nroff(1),   troff(1),  groff(1),  zsoelim(1),  setlocale(3),
       man(7), ascii(7), latin1(7), la pagina del pacchetto man-db, FSSTND.

CRONOLOGIA
       1990,   1991   -   Originalmente   scritta    da    John    W.    Eaton
       (jwe@che.utexas.edu).

       23  Dicembre 1992: Rik Faith (faith@cs.unc.edu) applica le soluzioni ai
       problemi fornite da Willem Kasdorp (wkasdo@nikhefk.nikef.nl).

       30 Aprile 1994 - 23 Febbraio 2000:  Wilf.   (G.Wilford@ee.surrey.ac.uk)
       ha  iniziato  lo  sviluppo  e  il  mantenimento di questo pacchetto con
       l'aiuto di un po' di gente.

       30 Ottobre 1996 - 30 Marzo 2001: Fabrizio Polacco <fpolacco@debian.org>
       mantiene  e  migliora  questo  pacchetto  per  il  progetto Debian, con
       l'aiuto di tutta la comunità.

       31 Marzo 2001 - presente: Colin Watson <cjwatson@debian.org>

       Traduzione di Bortolozzo Giovanni (borto@pluto.linux.it)  Aggiornamento
       di Giuseppe Sacco <eppesuig@debian.org>

2.11.2                            2023-01-08                            MAN(1)

Generated by dwww version 1.15 on Mon Jul 1 05:47:47 CEST 2024.