MAN(1)               Utilitare ale paginatorului de manual              MAN(1)

NUME
       man - o interfa<?>a a manualelor de referin<?>a ale sistemului

REZUMAT
       man [op<?>iuni man] [[sec<?>iune] pagina ...] ...
       man -k [op<?>iuni apropos] expreg ...
       man -K [op<?>iuni man] [sec<?>iune] termen-expresie ...
       man -f [whatis op<?>iuni] pagina ...
       man -l [op<?>iuni man] fi<?>ier ...
       man -w|-W [op<?>iuni man] pagina ...

DESCRIERE
       man este paginatorul de manual al sistemului.  Fiecare argument pagina
       dat lui man este in mod normal numele unui program, utilitar sau
       func<?>ie.  Pagina de manual asociata cu fiecare dintre aceste
       argumente este apoi gasita <?>i afi<?>ata.  O sec<?>iune, daca este
       furnizata, va direc<?>iona man sa se uite doar la acea sec<?>iune din
       manual.  Ac<?>iunea implicita este de a cauta in toate sec<?>iunile
       disponibile urmand o ordine predefinita (consulta<?>i IMPLICITE), <?>i
       sa arate doar prima pagina gasita, chiar daca pagina exista in mai
       multe sec<?>iuni.

       Tabelul de mai jos prezinta numerele de sec<?>iune ale manualului,
       urmate de tipurile de pagini pe care le con<?>in.


       1   Programe executabile sau comenzi shell
       2   Apeluri de sistem (func<?>ii furnizate de catre kernel)
       3   Apeluri de biblioteca (func<?>ii care se afla in biblioteca
           aplica<?>iei)
       4   Fi<?>iere speciale (gasite de obicei in /dev)
       5   Formate de fi<?>ier <?>i conven<?>ii, de ex. /etc/passwd
       6   Jocuri
       7   Diverse (inclusiv pachetele de macrocomenzi <?>i conven<?>iile)
           e.g. man(7), groff(7), pagini-man(7)
       8   Comenzi de administrare a sistemului (de obicei doar pentru root)
       9   Rutine de kernel [Nestandard]

       O pagina de manual consista in mai multe sec<?>iuni.

       Numele conven<?>ionale includ NUME, REZUMAT, CONFIGURARE, DESCRIERE,
       OP<?>IUNI, STARE IE<?>IRE, VALOARE REVENIRE, ERORI, MEDIU DE LUCRU,
       FI<?>IERE, VERSIUNI, STANDARDE, NOTE, DEFECTE, EXEMPLE, AUTORI, <?>i
       CONSULTA<?>I DEASEMENEA.

       Urmatoarele conven<?>ii se aplica la sec<?>iunea REZUMAT <?>i pot fi
       utilizate ca un ghid in alte sec<?>iuni.


       text aldin       tasta<?>i exact a<?>a cum este prezentat.
       text cursiv      inlocuie<?>te cu argumentul adecvat.
       [-abc]           orice argument sau toate argumentele dintre [ ] sunt
                        op<?>ionale.
       -a|-b            op<?>iunile delimitate de | nu pot fi utilizate
                        impreuna.
       argument ...     argument(ul) este repetabil.
       [expresie] ...   intreaga expresie dintre [ ] este repetabila.

       Redarea exacta poate varia in func<?>ie de dispozitivul de ie<?>ire. De
       exemplu, de obicei, <<man>> nu va putea reda cursivele atunci cand
       ruleaza intr-un terminal <?>i, de obicei, va folosi text subliniat sau
       colorat.

       Explicarea ilustrata a comenzii sau a func<?>iei este un model care ar
       trebui sa se potriveasca cu toate invocarile posibile.  In unele
       cazuri, este recomandabil sa se ilustreze(explice) mai multe invocari
       exclusive, a<?>a cum este aratat in sec<?>iunea REZUMAT a acestei
       pagini de manual.

EXEMPLE
       man ls
           Afi<?>eaza pagina de manual pentru elementul (program)  ls.

       man man.7
           Afi<?>eaza pagina de manual pentru pachetul macrocomenzii man din
           sec<?>iunea 7.  (Aceasta este o ortografie alternativa a ,,man 7
           man".)

       man 'man(7)'
           Afi<?>eaza pagina de manual pentru pachetul de macrocomenzi man din
           sec<?>iunea 7.  (Aceasta este o alta ortografie alternativa pentru
           ,,man 7 man".  Poate fi mai convenabil cand copia<?>i <?>i lipi<?>i
           referin<?>e incruci<?>ate la paginile de manual.  Re<?>ine<?>i ca
           parantezele trebuie in mod normal citate pentru a le proteja de
           shell.)

       man -a introducere
           Afi<?>eaza, in succesiune, toate paginile de manual introducere
           disponibile care sunt con<?>inute in manual.  Este posibil sa
           ie<?>i<?>i intre afi<?>ari succesive sau sa omite<?>i pe oricare
           dintre ele.

       man -t bash | lpr -Pps
           Formateaza pagina de manual pentru bash in formatul implicit troff
           sau groff <?>i o trimite la imprimanta cu numele ps.  Ie<?>irea
           implicita pentru groff este de obicei PostScript.  man --help ar
           trebui sa indice ce procesor este legat de op<?>iunea -t.

       man -l -Tdvi ./foo.1x.gz > ./foo.1x.dvi
           Aceasta comanda va decomprima <?>i formata pagina de manual sursa
           nroff ./foo.1x.gz intr-un fi<?>ier independent de dispozitiv (dvi).
           Redirec<?>ionarea este necesara deoarece indicatorul -T face ca
           ie<?>irea sa fie direc<?>ionata catre stdout fara paginator.
           Ie<?>irea poate fi vizualizata cu un program precum xdvi sau
           procesata in continuare in PostScript utilizand un program precum
           dvips.

       man -k printf
           Cauta in descrierile scurte <?>i in numele de pagini de manual
           pentru cuvantul cheie printf ca expresie regulata.  Imprima orice
           potriviri.  Echivalenta cu apropos printf.

       man -f smail
           Cauta paginile de manual la care face referire smail <?>i imprima
           descrierile scurte ale celor gasite. Echivalenta cu whatis smail.

PREZENTARE GENERALA
       man dispune de mai multe op<?>iuni, pentru a oferi o flexibilitate cat
       mai mare utilizatorului. Se pot face modificari in ruta de cautare,
       ordinea sec<?>iunilor, procesorul de ie<?>ire <?>i alte comportamente
       <?>i opera<?>iuni detaliate mai jos.

       Exista mai multe variabile de mediu care, daca sunt
       stabilite(definite), sunt interogate pentru a determina modul de
       operare(func<?>ionare) al lui man.  Este posibil sa stabili<?>i
       variabila ,,globala" $MANOPT la orice <?>ir in format de linie de
       comanda, cu excep<?>ia faptului ca orice spa<?>iu folosit ca parte a
       argumentului unei op<?>iuni trebuie sa fie eludat (precedat de o bara
       oblica inversa).  man va analiza $MANOPT inainte de a-<?>i analiza
       propria linie de comanda.  Acele op<?>iuni care necesita un argument,
       vor fi suprascrise de acelea<?>i op<?>iuni gasite in linia de comanda.
       Pentru a restabili toate op<?>iunile stabilite in $MANOPT, -D poate fi
       specificata ca op<?>iune ini<?>iala a liniei de comanda.  Acest lucru
       va permite ca man sa ,,uite" de op<?>iunile specificate in $MANOPT,
       chiar daca acestea pot fi inca valide.

       Paginile de manual sunt de obicei stocate in format  nroff(1) intr-un
       director precum /usr/share/man.  In unele instalari, pot sa existe <?>i
       pagini cat preformatate pentru a imbunata<?>i eficien<?>a. Consulta<?>i
       manpath(5) pentru detalii despre locul unde sunt stocate aceste
       fi<?>iere.

       Acest pachet suporta pagini de manual in mai multe limbi, controlate de
       identificatorul_localizare.  Daca sistemul dvs. nu v-a configurat acest
       lucru automat, atunci poate fi necesar sa stabili<?>i $LC_MESSAGES,
       $LANG sau o alta variabila de mediu dependenta de sistem pentru a
       indica localizarea preferata, de obicei specificata in formatul POSIX :

       <limba>[_<teritoriu>[.<set_de_carractere>[,<versiune>]]]

       Daca pagina dorita este disponibila in romana(sau in localizarea aleasa
       de tine), ea va fi afi<?>ata in locul paginii standard (de obicei
       engleza americana).

       Daca descoperi<?>i ca traducerile furnizate cu acest pachet nu sunt
       disponibile in limba dumneavoastra materna <?>i dori<?>i sa le
       furniza<?>i, contacta<?>i responsabilul care va coordona aceasta
       activitate.

       Paginile individuale de manual sunt scrise <?>i intre<?>inute in mod
       normal de catre responsabilii programului, func<?>iei sau ai altor
       subiecte pe care le documenteaza <?>i nu sunt incluse in acest pachet.
       Daca gasi<?>i ca o pagina de manual lipse<?>te sau este inadecvata,
       raporta<?>i acest lucru responsabililor pachetului in cauza.

       Pentru informa<?>ii in legatura cu alte func<?>ionalita<?>i <?>i
       extensii disponibile cu acest paginator de manual, citi<?>i documentele
       furnizate cu acest pachet.

IMPLICITE
       Ordinea sec<?>iunilor de cautat poate fi suprascrisa de variabila de
       mediu $MANSECT sau de directiva SEC<?>IUNE din /etc/man_db.conf.
       Ordinea implicita, este urmatoarea:

              1 1p n l 8 3 3p 0 0p 2 3type 5 4 9 6 7

       Pagina de manual formatata este afi<?>ata utilizand un paginator.
       Acesta, poate fi specificat in mai multe moduri; sau, daca nu, va
       reveni la valoarea implicita (consulta<?>i op<?>iunea -P pentru
       informa<?>ii suplimentare).

       Filtrele sunt descifrate printr-o serie de mijloace.  In primul rand,
       este interogata op<?>iunea liniei de comanda -p sau variabila de mediu
       $MANROFFSEQ.  Daca -p nu a fost folosita <?>i variabila de mediu nu a
       fost definita, atunci prima linie a fi<?>ierului <<nroff>> este scanata
       pentru un <?>ir care indica preprocesorul de utilizat.  Pentru a
       con<?>ine un <?>ir de preprocesor valid, prima linie trebuie sa arate
       ca

       '\" <<?>ir>

       unde <?>ir poate fi orice combina<?>ie de litere descrisa, mai jos, de
       op<?>iunea -p.

       Daca niciuna dintre metodele de mai sus nu furnizeaza informa<?>ii
       despre filtre, se utilizeaza setul de filtrare implicit.

       O linie de execu<?>ie, de formatare, este formata din filtre <?>i
       formatorul primar (nroff sau [tg]roff cu -t) <?>i este executata.
       Alternativ, daca un program executabil mandb_nfmt (sau mandb_tfmt cu
       -t) exista in radacina arborelui <<man>>, se executa acesta in schimb.
       I se trece fi<?>ierul sursa de manual, <?>irul preprocesorului <?>i,
       op<?>ional, dispozitivul specificat cu -T sau -E ca argumente.

OP<?>IUNI
       Op<?>iunile fara argument care sunt duplicate fie pe linia de comanda,
       fie in $MANOPT, sau in ambele, nu sunt daunatoare.  Pentru op<?>iunile
       care necesita un argument, fiecare duplicare va suprascrie valoarea
       argumentului precedent.

   Op<?>iuni generale
       -C fi<?>ier, --config-file=fi<?>ier
              Utilizeaza acest fi<?>ier de configurare al utilizatorului, mai
              degraba decat cel implicit din ~/.manpath.

       -d, --debug
              Imprima informa<?>iile de depanare.

       -D, --default
              Aceasta op<?>iune este in general folosita ca prima op<?>iune,
              <?>i restaureaza comportamentul lui man cu configurarile
              implicite.  Utilizarea sa este de a reconfigura acele op<?>iuni
              care ar fi putut fi configurate in $MANOPT.  Orice op<?>iuni
              care urmeaza dupa -D, vor avea efectul obi<?>nuit.

       --warnings[=avertismente]
              Activeaza avertismentele de la groff.  Aceasta poate fi folosita
              pentru a efectua verificari de corectitudine asupra textului
              sursa al paginilor de manual. warnings este o lista de nume de
              avertismente separate prin virgula; daca niciunul nu este
              furnizat, se folose<?>te valoarea implicita ,,mac".  Pentru a
              dezactiva un avertisment groff, prefixa<?>i-l cu ,,!"; de
              exemplu: --warnings=mac,!break activeaza avertismentele din
              categoria ,,mac" <?>i dezactiveaza avertismentele din categoria
              ,,break".  Consulta<?>i nodul "Avertismente" din info groff)
              pentru o lista a numelor de avertismente disponibile.

   Principalele moduri de operare
       -f, --whatis
              Aproximativ echivalent cu whatis.  Daca pagina de manual este
              disponibila, este afi<?>ata o scurta descriere a paginii de
              manual dorite.  Consulta<?>i whatis(1), pentru a ob<?>ine mai
              multe detalii.

       -k, --apropos
              Aproximativ echivalent cu apropos.  Cauta in descrierile scurte
              ale paginilor de manual pentru cuvintele cheie date, <?>i
              afi<?>eaza orice potrivire.  Consulta<?>i apropos(1), pentru a
              ob<?>ine mai multe detalii.

       -K, --global-apropos
              Cauta textul in toate paginile de manual.  Aceasta este o
              cautare de for<?>a bruta, <?>i care poate sa dureze ceva timp;
              daca pute<?>i, ar trebui sa specifica<?>i o sec<?>iune pentru a
              reduce numarul de pagini care trebuie luate in considerare.
              Termenii de cautare pot fi <?>iruri simple (op<?>iunea
              implicita), sau expresii regulate daca este utilizata op<?>iunea
              --regex.

              Re<?>ine<?>i ca aceasta cauta in sursele paginilor de
              manual(neformatate), nu in textul ce este afi<?>at, a<?>a ca
              poate include falsuri pozitive din cauza comentariilor din
              fi<?>ierele sursa, sau falsuri negative din cauza unor lucruri
              precum cratimele care sunt scrise ca ,,\-" in fi<?>ierele sursa.
              Cautarea textului formatat ar fi mult mai lenta.

       -l, --local-file
              Activeaza modul ,,local".  Formateaza <?>i afi<?>eaza
              fi<?>ierele de manual locale in loc sa caute prin colec<?>ia de
              manuale a sistemului.  Fiecare argument de pagina de manual va
              fi interpretat ca un fi<?>ier sursa <<nroff>> in formatul
              corect.  Nu este produs niciun fi<?>ier <<cat>>.  Daca ,,-" este
              listat ca unul dintre argumente, intrarea va fi preluata de la
              intrarea standard.

              Daca aceasta op<?>iune nu este utilizata, atunci man va
              interpreta argumentele paginii de manual ca nume de fi<?>iere
              locale daca argumentul con<?>ine un caracter ,,/", deoarece
              acesta este un bun indiciu ca argumentul se refera la o ruta din
              sistemul de fi<?>iere.

       -w, --where, --path, --location
              Nu afi<?>eaza de fapt pagina de manual, dar imprima loca<?>ia
              fi<?>ierului <<nroff>> sursa care ar fi formatat.  Daca se
              folose<?>te <?>i op<?>iunea -a, atunci imprima loca<?>iile
              tuturor fi<?>ierelor sursa care corespund criteriilor de
              cautare.

       -W, --where-cat, --location-cat
              Nu afi<?>eaza de fapt pagina de manual, dar imprima loca<?>ia
              fi<?>ierului <<cat>> preformatat care ar fi afi<?>at.  Daca se
              folose<?>te <?>i op<?>iunea -a, atunci imprima loca<?>iile
              tuturor fi<?>ierelor <<cat>> preformatate care corespund
              criteriilor de cautare.

              Daca atat -w, cit <?>i -W sunt utilizate, atunci imprima atat
              fi<?>ierul sursa cat <?>i fi<?>ierul <<cat>> separate printr-un
              spa<?>iu.  Daca -w, -W <?>i -a sunt date impreuna, atunci acest
              lucru se face pentru fiecare potrivire posibila.

       -c, --catman
              Aceasta op<?>iune nu este pentru uz general <?>i ar trebui sa
              fie utilizata doar de programul catman.

       -R codificarea, --recode=codificarea
              In loc sa formateze pagina de manual in modul obi<?>nuit,
              produce sursa convertita la codificarea specificata.  Daca
              <?>ti<?>i deja codificarea fi<?>ierului sursa, pute<?>i utiliza
              <?>i manconv(1) direct.  Cu toate acestea, aceasta op<?>iune va
              permite sa converti<?>i mai multe pagini de manual intr-o
              singura codificare fara a fi nevoie sa declara<?>i in mod
              explicit codificarea pentru fiecare dintre ele, cu condi<?>ia ca
              acestea sa fi fost deja instalate intr-o structura similara cu o
              ierarhie a paginii de manual.

              Considera<?>i utilizarea lui man-recode(1)  in locul convertirii
              de pagini de manual multiple, de vreme ce are o interfa<?>a
              proiectata pentru conversia in vrac <?>i deci poate fi mult mai
              rapida.

   Gasirea paginilor de manual
       -L identificator_localizare, --locale=identificator_localizare
              man va determina in mod normal localizarea curenta printr-un
              apel la func<?>ia C setlocale(3)  care interogheaza diverse
              variabile de mediu, inclusiv $LC_MESSAGES <?>i $LANG.  Pentru a
              suprascrie temporar valoarea determinata, utiliza<?>i aceasta
              op<?>iune pentru a furniza un <?>ir identificator_localizare
              direct catre man. Re<?>ine<?>i ca aceasta nu va avea efect pana
              cand cautarea paginilor nu incepe efectiv.  Ie<?>irea precum
              mesajul de ajutor va fi intotdeauna afi<?>ata in localizarea
              determinata ini<?>ial.

       -m sistem[,...], --systems=sistem[,...]
              Daca acest sistem are acces la paginile de manual ale altor
              sisteme de operare, acestea pot fi cautate utilizand aceasta
              op<?>iune.  Pentru a cauta o pagina de manual din colec<?>ia de
              pagini de manual a <<Noului_SO>>, utiliza<?>i op<?>iunea -m
              <<Nou_SO>>.

              sistem(ul) specificat poate fi o combina<?>ie de nume de sisteme
              de operare delimitate prin virgule.  Pentru a include o cautare
              a paginilor de manual ale sistemului de operare nativ,
              include<?>i numele sistemului man in <?>irul argumentului.
              Aceasta op<?>iune va suprascrie variabila de mediu $SYSTEM.

       -M ruta, --manpath=ruta
              Specifica o ruta de manual alternativa de utilizat.  In mod
              implicit, man utilizeaza cod derivat manpath pentru a determina
              ruta de cautat.  Aceasta op<?>iune suprascrie variabila de mediu
              $MANPATH <?>i face ca op<?>iunea -m sa fie ignorata.

              O ruta specificata drept o ruta de manual trebuie sa fie
              radacina unei ierarhii a paginilor de manual, structurata in
              sec<?>iuni, a<?>a cum este descris in manualul man-db (sub
              ,,Sistemul paginilor de manual").  Pentru a vizualiza paginile
              de manual in afara acestor ierarhii, consulta<?>i op<?>iunea -l.

       -S lista, -s lista, --sections=lista
              lista data este o lista de sec<?>iuni separata prin virgula sau
              doua puncte, utilizata pentru a determina ce sec<?>iuni de
              manual sa se caute <?>i in ce ordine.  Aceasta op<?>iune
              suprascrie variabila de mediu $MANSECT.  (Ortografia -s este
              pentru compatibilitate cu System V.)

       -e sub-extensie, --extension=sub-extensie
              Unele sisteme incorporeaza pachete mari de pagini de manual,
              precum acelea care inso<?>esc pachetul Tcl, in ierarhia
              principala a paginilor de manual.  Pentru a evita problema de a
              avea doua pagini de manual cu acela<?>i nume, cum ar fi exit(3),
              paginile Tcl au fost de obicei toate atribuite sec<?>iunii l.
              Deoarece acest lucru este regretabil, acum este posibil sa
              pune<?>i paginile in sec<?>iunea corecta, <?>i sa le atribui<?>i
              o ,,extensie" specifica, in acest caz, exit(3tcl).  In
              condi<?>ii normale de func<?>ionare, man va afi<?>a exit(3)  in
              detrimentul a exit(3tcl).  Pentru a negocia aceasta situa<?>ie
              <?>i pentru a evita sa <?>ti<?>i in ce sec<?>iune se afla pagina
              de care ave<?>i nevoie, acum este posibil sa da<?>i lui man un
              <?>ir sub-extensie care indica pachetul caruia trebuie sa
              apar<?>ina pagina.  Utilizand exemplul de mai sus, furnizarea
              op<?>iunii -e tcl la man va restric<?>iona cautarea la paginile
              care au extensia *tcl.

       -i, --ignore-case
              Nu face distinc<?>ie intre majuscule <?>i minuscule atunci cand
              cauta paginile de manual.  Acesta este modul implicit de
              cautare.

       -I, --match-case
              Cauta paginile de manual facand .

       --regex
              Afi<?>eaza toate paginile cu orice parte a numelui sau
              descrierilor lor care se potrivesc cu fiecare argument pagina ca
              expresie regulata, ca <?>i in cazul apropos(1).  Deoarece de
              obicei nu exista o modalitate rezonabila de a alege pagina ,,cea
              mai buna" atunci cand se cauta pentru o expresie regulata,
              aceasta op<?>iune implica -a.

       --wildcard
              Afi<?>eaza toate paginile cu orice parte a numelui sau a
              descrierilor lor care se potrivesc cu fiecare argument pagina
              utilizand metacaractere in stil shell, ca <?>i in cazul
              apropos(1) --wildcard.  Argumentul pagina trebuie sa se
              potriveasca cu numele intreg sau cu intreaga descrierea sau sa
              se potriveasca in limitele cuvintelor din descriere.  Deoarece
              de obicei nu exista o modalitate rezonabila de a alege pagina
              ,,cea mai buna" atunci cand se cauta pentru un metacaracter,
              aceasta op<?>iune implica -a.

       --names-only
              Daca se utilizeaza op<?>iunea --regex sau --wildcard, aceasta
              cauta coinciden<?>e doar cu numele paginilor, nu cu descrierile
              paginilor, cum ar fi cu whatis(1).  Altfel, nu are niciun efect.

       -a, --all
              In mod implicit, man va ie<?>i dupa afi<?>area celei mai
              potrivite pagini de manual pe care o gase<?>te.  Folosirea
              acestei op<?>iuni for<?>eaza man sa afi<?>eze toate paginile de
              manual cu nume care corespund criteriilor de cautare.

       -u, --update
              Aceasta op<?>iune determina man sa-<?>i actualizeze memoria
              tampon a bazei de date a paginilor de manual instalate.  Acest
              lucru este necesar doar in situa<?>ii rare <?>i, in mod normal,
              este mai bine sa rula<?>i mandb(8).

       --no-subpages
              In mod implicit, man va incerca sa interpreteze perechile de
              nume de pagini manual date in linia de comanda, ca echivalent cu
              un singur nume de pagina de manual care con<?>ine o cratima sau
              un caracter de subliniere.  Aceasta suporta modelul comun al
              programelor care implementeaza o serie de subcomenzi,
              permi<?>andu-le sa furnizeze pagini de manual pentru fiecare
              dintre ele, <?>i care pot fi accesate folosind o sintaxa
              similara cu cea care ar fi folosita pentru a invoca subcomenzile
              in sine.  De exemplu:

                $ man -aw git diff
                /usr/share/man/man1/git-diff.1.gz

              Pentru a dezactiva acest comportament, utiliza<?>i op<?>iunea
              --no-subpages.

                $ man -aw --no-subpages git diff
                /usr/share/man/man1/git.1.gz
                /usr/share/man/man3/Git.3pm.gz
                /usr/share/man/man1/diff.1.gz

   Controlarea ie<?>irii formatate
       -P paginator, --pager=paginator
              Specifica ce paginator de ie<?>ire sa fie utilizat.  In mod
              implicit, man folose<?>te less, revenind la cat daca less nu
              este gasit sau nu este executabil.  Aceasta op<?>iune suprascrie
              variabila de mediu $MANPAGER, care la randul sau suprascrie
              variabila de mediu $PAGER.  Nu este utilizata impreuna cu -f sau
              -k.

              Valoarea poate fi un nume de comanda simpla sau o comanda cu
              argumente, <?>i poate utiliza ghilimele de tip shell (bara
              oblica inversa, ghilimele simple sau ghilimele duble).  Aceasta
              nu poate sa foloseasca linii de conectare pentru a conecta mai
              multe comenzi; daca ave<?>i nevoie de asta, utiliza<?>i un
              script care preia fi<?>ierul pentru a fi afi<?>at dintr-un
              argument sau de la intrarea standard.

       -r prompt, --prompt=prompt
              Daca o versiune recenta a less este utilizata ca paginator,, man
              va incerca sa -<?>i stabileasca prompterul <?>i unele op<?>iuni
              sensibile.  In mod implicit, prompterul arata ca

               Pagina de manual nume(sec<?>iune) linia x

              unde nume denota numele paginii de manual, sec<?>iune denota
              sec<?>iunea sub care a fost gasit <?>i x numarul de linie
              curent.  Acest lucru se realizeaza prin utilizarea variabilei de
              mediu $LESS.

              Furnizarea lui -r cu un <?>ir va suprascrie acest mod implicit.
              <?>irul poate con<?>ine textul $MAN_PN care va fi extins la
              numele paginii curente de manual <?>i numele sec<?>iunii
              acesteia inconjurat de ,,(" <?>i ,,)".  <?>irul utilizat pentru
              a produce modul implicit ar putea fi exprimat ca

              \ Pagina\ de\ manual\ \$MAN_PN\ ?ltlinia\ %lt?L/%L.:
              byte\ %bB?s/%s..?\ (FINAL):?pB\ %pB\\%..
              (apasa<?>i h pentru ajutor sau q pentru a ie<?>i)

              Aici este impar<?>it in trei randuri, doar pentru o mai buna
              claritate.  Pentru semnifica<?>ia <?>i explica<?>ia acestuia,
              consulta<?>i pagina de manual less(1).  <?>irul de prompter este
              mai intai evaluat de shell.  Toate ghilimele duble, ghilimele
              inverse <?>i barele oblice inverse din prompt trebuie sa fie
              eludate de o bara oblica inversa anterioara.  <?>irul
              prompter-ului se poate termina cu un ,,$" eludat, care poate fi
              urmat de alte op<?>iuni pentru <<less>>.  In mod implicit, man
              stabile<?>te op<?>iunile -ix8.

              Variabila de mediu $MANLESS descrisa mai jos poate fi utilizata
              pentru a stabili un <?>ir de prompter implicit, daca nu este
              furnizat niciunul in linia de comanda.

       -7, --ascii
              Cand se vizualizeaza o pagina de manual, pur ascii(7) pe un
              terminal de 7 bi<?>i sau un emulator de terminal, este posibil
              ca unele caractere sa nu se afi<?>eze corect cand se utilizeaza
              descrierea dispozitivului latin1(7) cu GNU nroff.  Aceasta
              op<?>iune permite ca paginile de manual, pur ascii sa fie
              afi<?>ate in ascii cu dispozitivul latin1.  Nu va traduce niciun
              text latin1.  Urmatorul tabel arata traducerile efectuate: unele
              par<?>i ale acestuia pot fi afi<?>ate corect numai cand se
              utilizeaza dispozitivul latin1(7) al lui GNU nroff.


              Descriere        Octal   latin1   ascii
              ----------------------------------------
              cratima de        255      -        -
              continuare
              bulina (punct,    267     o         o
              pica<?>ea din
              mijloc)
              accent acut       264      '        '
              semn de           327      x        x
              inmul<?>ire

              Daca coloana latin1 se afi<?>eaza corect, terminalul poate sa
              fie configurat pentru caractere latin1 <?>i aceasta op<?>iune nu
              este necesara.  Daca coloanele latin1 <?>i ascii sunt identice,
              citi<?>i aceasta pagina utilizand aceasta op<?>iune sau man nu a
              formatat aceasta pagina utilizand descrierea de dispozitiv
              latin1.  Daca coloana latin1 lipse<?>te sau este corupta, poate
              ca ave<?>i nevoie sa vizualiza<?>i paginile de manual cu aceasta
              op<?>iune.

              Aceasta op<?>iune este ignorata cand se utilizeaza op<?>iunile
              -t, -H, -T sau -Z <?>i poate fi inutila pentru nroff, altul
              decat GNU.

       -E codificarea, --encoding=codificarea
              Genereaza ie<?>irea pentru o codificare de caractere, alta decat
              cea implicita.  Pentru compatibilitate inversa, codificarea
              poate fi un dispozitiv nroff, cum ar fi ascii, latin1 sau utf8,
              precum <?>i o codificare de caractere adevarate, cum ar fi
              UTF-8.

       --no-hyphenation, --nh
              In mod normal, nroff imparte automat textul cu cratime la
              intreruperile de linie chiar <?>i in cuvintele care nu con<?>in
              cratime, daca este necesar sa face<?>i acest lucru pentru a
              a<?>eza cuvintele pe o linie fara spa<?>iere excesiva.  Aceasta
              op<?>iune dezactiveaza separarea automata in silabe, astfel
              incat cuvintele vor fi separate cu cratime numai daca con<?>in
              deja cratime.

              Daca scrie<?>i o pagina de manual <?>i dori<?>i pur <?>i simplu
              sa impiedica<?>i nroff sa imparta cu cratima un cuvant intr-un
              punct nepotrivit, nu utiliza<?>i aceasta op<?>iune, ci
              consulta<?>i documenta<?>ia nroff; de exemplu, pute<?>i pune
              ,,\%" in interiorul unui cuvant pentru a indica faptul ca acesta
              poate fi intrerupt in acel punct, sau pute<?>i pune ,,\%" la
              inceputul unui cuvant pentru a preveni impar<?>irea in silabe.

       --no-justification, --nj
              In mod normal, nroff va alinia automat textul la ambele margini.
              Aceasta op<?>iune dezactiveaza alinierea completa, lasand
              aliniata doar marginea din stanga, numita uneori text
              ,,zdren<?>uit la dreapta".

              Daca scrie<?>i o pagina de manual <?>i dori<?>i pur <?>i simplu
              sa impiedica<?>i ca nroff sa alinieze anumite paragrafe, nu
              utiliza<?>i aceasta op<?>iune, ci consulta<?>i documenta<?>ia
              nroff; de exemplu, pute<?>i folosi solicitarile ,,.na", ,,.nf",
              ,,.fi" <?>i ,,.ad" pentru a dezactiva temporar ajustarea <?>i
              completarea.

       -p <?>ir, --preprocessor=<?>ir
              Specifica<?>i secven<?>a de preprocesoare de rulat inainte de
              nroff sau troff/groff.  Nu toate instala<?>iile vor avea un set
              complet de preprocesoare.  Cateva dintre preprocesoare <?>i
              literele folosite pentru a le desemna sunt: eqn (e), grap (g),
              pic (p), tbl (t), vgrind (v), refer (r).  Aceasta op<?>iune
              suprascrie variabila de mediu $MANROFFSEQ. zsoelim este
              intotdeauna rulat ca primul preprocesor.

       -t, --troff
              Utilizeaza groff -mandoc pentru a formata pagina de manual la
              ie<?>irea standard(stdout).  Aceasta op<?>iune nu este necesara
              in conjunc<?>ie cu -H, -T, sau -Z.

       -T[dispozitiv], --troff-device[=dispozitiv]
              Aceasta op<?>iune este utilizata pentru a modifica ie<?>irea lui
              groff (sau eventual a lui troff)  ca sa fie mai potrivita pentru
              un dispozitiv, altul decat cel implicit. Acest lucru implica -t.
              Exemplele (incepand cu groff 1.23.0) includ dvi, latin1, pdf,
              ps, utf8, X75 <?>i X100.

       -H[navigator], --html[=navigator]
              Aceasta op<?>iune va determina ca groff sa produca o ie<?>ire
              HTML <?>i va afi<?>a acea ie<?>ire intr-un navigator web.
              Alegerea navigatorului este determinata de argumentul op<?>ional
              navigator, daca este furnizat unul, de variabila de mediu
              $BROWSER sau de o valoare implicita in timpul compilarii daca
              aceasta nu este configurata (de obicei lynx).  Aceasta op<?>iune
              implica -t <?>i va func<?>iona numai cu GNU troff.

       -X[ppi], --gxditview[=ppi]
              Aceasta op<?>iune afi<?>eaza ie<?>irea lui groff intr-o
              fereastra grafica utilizand programul gxditview.  ppi (puncte
              per inci) poate fi 75, 75-12, 100, sau 100-12, valoarea
              implicita fiind 75; variantele *-12 utilizeaza un font cu baza
              de 12-puncte.  Aceasta op<?>iune implica -T cu dispozitivul X75,
              X75-12, X100, sau X100-12 respectiv.

       -Z, --ditroff
              groff va rula troff <?>i mai apoi va utiliza un post-procesor
              adecvat pentru a produce o ie<?>ire corespunzatoare pentru
              dispozitivul ales.  Daca groff -mandoc este groff, aceasta
              op<?>iune este trecuta la groff <?>i va suprima utilizarea unui
              post-procesor.  Acest lucru implica -t.

   Ob<?>inere ajutor
       -?, --help
              Imprima un mesaj de ajutor <?>i iese.

       --usage
              Imprima un mesaj scurt de utilizare <?>i iese.

       -V, --version
              Afi<?>eaza informa<?>ii despre versiune.

STARE DE IE<?>IRE
       0      Executarea programului s-a incheiat fara erori.

       1      Eroare de utilizare, de sintaxa sau de fi<?>ier de configurare.

       2      Eroare opera<?>ionala.

       3      Un proces copil a returnat o stare de ie<?>ire diferita de zero.

       16     Cel pu<?>in una dintre pagini/fi<?>iere/cuvinte cheie nu exista
              sau nu s-a gasit.

MEDIU
       MANPATH
              Daca $MANPATH este stabilita, valoarea acesteia este utilizata
              drept ruta de cautare pentru paginile de manual.

              Consulta<?>i sec<?>iunea RUTA DE CAUTARE din manpath(5) pentru
              comportamentul implicit <?>i detalii despre modul in care este
              gestionata aceasta variabila de mediu.

       MANROFFOPT
              De fiecare data cand man invoca formatorul (nroff, troff, sau
              groff), acesta adauga con<?>inutul lui $MANROFFOPT la linia de
              comanda a formatorului.

              De exemplu, MANROFFOPT=-P-i ii spune formatorului sa utilizeze
              text italic (care este acceptat doar de unele terminale) in loc
              de text subliniat.

       MANROFFSEQ
              Daca $MANROFFSEQ este stabilita, valoarea acesteia este
              utilizata pentru a determina setul de preprocesoare prin care se
              trece fiecare pagina de manual.  Lista de preprocesoare
              implicita este dependenta de sistem.

       MANSECT
              Daca $MANSECT este stabilita, valoarea acesteia este o lista de
              sec<?>iuni delimitata de doua puncte <?>i este utilizata pentru
              a determina care sec<?>iuni din manual sa se caute <?>i in ce
              ordine.   Valoarea implicita este ,,1 1p n l 8 3 3p 0 0p 2 3type
              5 4 9 6 7", daca nu este suprascrisa de directiva SEC<?>IUNE din
              /etc/man_db.conf.

       MANPAGER, PAGER
              Daca $MANPAGER sau $PAGER este stabilita ($MANPAGER este
              utilizata in preferin<?>e), valoarea acesteia este utilizata ca
              numele programului utilizat pentru a afi<?>a pagina de manual.
              In mod implicit, este folosit less, revenind la cat daca less nu
              este gasit sau nu este executabil.

              Valoarea poate fi un nume de comanda simpla sau o comanda cu
              argumente, <?>i poate utiliza ghilimele de tip shell (bara
              oblica inversa, ghilimele simple sau ghilimele duble).  Aceasta
              nu poate sa foloseasca linii de conectare pentru a conecta mai
              multe comenzi; daca ave<?>i nevoie de asta, utiliza<?>i un
              script care preia fi<?>ierul pentru a fi afi<?>at dintr-un
              argument sau de la intrarea standard.

       MANLESS
              Daca $MANLESS este stabilita, valoarea acesteia va fi utilizata
              ca <?>irul de prompter implicit pentru paginatorul less, ca <?>i
              cum ar fi fost transmis folosind op<?>iunea -r (deci orice
              apari<?>ie a textului  $MAN_PN va fi extins in acela<?>i mod).
              De exemplu, daca dori<?>i sa stabili<?>i <?>irul prompter
              necondi<?>ionat la "<?>irul meu de prompter", stabili<?>i
              $MANLESS la `-Ps<?>irul meu de prompter'.  Utilizand op<?>iunea
              -r se suprascrie aceasta variabila de mediu.

       BROWSER
              Daca $BROWSER este stabilita, valoarea acesteia este o lista de
              comenzi delimitata de doua puncte, fiecare din acestea fiind la
              randul ei utilizata pentru a incerca sa porneasca un navigator
              web pentru man --html.  In fiecare comanda, %s este inlocuit cu
              un nume de fi<?>ier care con<?>ine ie<?>irea HTML de la groff,
              %% este inlocuit de un singur semn de procent (%) <?>i %c este
              inlocuit de doua puncte (:).

       SYSTEM Daca $SYSTEM este stabilit, acesta va avea acela<?>i efect ca
              <?>i cum ar fi fost specificat ca argument la op<?>iunea -m.

       MANOPT Daca $MANOPT este stabilita, aceasta va fi analizata inainte de
              linia de comanda a lui man <?>i se a<?>teapta sa fie intr-un
              format similar.  Deoarece toate celelalte variabile de mediu
              specifice man pot fi exprimate ca op<?>iuni de linie de comanda
              <?>i sunt astfel candidate pentru a fi incluse in $MANOPT, este
              de a<?>teptat ca acestea sa devina invechite.  N.B.  Toate
              spa<?>iile care ar trebui interpretate ca parte a argumentului
              unei op<?>iuni trebuie sa fie eludate.

       MANWIDTH
              Daca $MANWIDTH este stabilita, valoarea acesteia este utilizata
              ca lungimea de linie pentru care paginile de manual ar trebui sa
              fie formatate.  Daca nu este stabilita, paginile de manual vor
              fi formatate cu o lungime de linie potrivita cu terminalul
              curent (utilizand valoarea lui $COLUMNS, <?>i ioctl(2)  daca
              sunt disponibile, sau revenind la 80 de caractere daca niciuna
              dintre ele nu este disponibila).  Paginile <<cat>> vor fi
              salvate doar cand formatarea implicita poate fi utilizata, adica
              atunci cand lungimea liniei de terminal este intre 66 <?>i 80 de
              caractere.

       MAN_KEEP_FORMATTING
              In mod normal, cand ie<?>irea nu este direc<?>ionata catre un
              terminal (precum un fi<?>ier sau o conexiune), caracterele de
              formatare sunt eliminate  pentru a facilita citirea rezultatului
              fara instrumente speciale.  In orice caz, daca
              $MAN_KEEP_FORMATTING este stabilita la orice valoare care nu
              este goala, aceste caractere de formatare sunt pastrate.  Acest
              lucru poate fi util pentru ca programe ce utilizeaza man sa
              poata interpreta caracterele de formatare.

       MAN_KEEP_STDERR
              In mod normal, cand ie<?>irea este direc<?>ionata la un terminal
              (de obicei la un paginator), orice ie<?>ire de eroare de la
              comanda utilizata pentru a produce versiunile formatate ale
              paginilor de manual este eliminata pentru a evita interferen<?>a
              cu afi<?>ajul paginatorului.  Programe precum groff produc
              adesea mesaje de eroare relativ minore despre problemele
              tipografice precum aliniere gre<?>ita, care sunt inestetice <?>i
              in general produc confuzie cand sunt afi<?>ate impreuna cu
              pagina de manual.  Cu toate acestea, unii utilizatori vor sa le
              vada oricum, deci, daca $MAN_KEEP_STDERR este stabilita la o
              valoare care nu este goala, ie<?>irea de eroare va fi afi<?>ata
              ca de obicei.

       MAN_DISABLE_SECCOMP
              In Linux, man izoleaza in mod normal subprocesele care
              gestioneaza date nesigure folosind un mediu izolat seccomp(2).
              Acest lucru face mai sigura rularea unui cod complex de analiza
              pe pagini de manual arbitrare. Daca acest lucru nu reu<?>e<?>te
              din orice motiv ce nu are legatura cu con<?>inutul paginii
              afi<?>ate, pute<?>i stabili $MAN_DISABLE_SECCOMP la orice
              valoare care nu este goala pentru a dezactiva izolarea.

       PIPELINE_DEBUG
              Daca variabila de mediu $PIPELINE_DEBUG este stabilita la ,,1",
              atunci man va imprima mesajele de depanare la o eroare standard
              care descrie fiecare subproces pe care il ruleaza.

       LANG, LC_MESSAGES
              In func<?>ie de sistem <?>i de implementare, amandoua sau una
              dintre $LANG <?>i $LC_MESSAGES vor fi interogate pentru limba
              curenta a mesajelor.  man va afi<?>a mesajele sale in limba
              respectiva (daca este disponibila).  Consulta<?>i setlocale(3)
              pentru detalii precise.

FI<?>IERE
       /etc/man_db.conf
              fi<?>ier de configurare man-db.

       /usr/share/man
              O ierarhie globala a paginilor de manual.

STANDARDE
       POSIX.1-2001, POSIX.1-2008, POSIX.1-2017.

CONSULTA<?>I <?>I
       apropos(1), groff(1), less(1), manpath(1), nroff(1), troff(1),
       whatis(1), zsoelim(1), manpath(5), man(7), catman(8), mandb(8)

       Documenta<?>ia pentru unele pachete poate fi disponibila in alte
       formate, precum info(1)  sau HTML.

ISTORIC
       1990, 1991 - Scris original de John W. Eaton (jwe@che.utexas.edu).

       Dec 23 1992: Rik Faith (faith@cs.unc.edu) a aplicat corectarea
       defec<?>iunilor furnizata de Willem Kasdorp (wkasdo@nikhefk.nikef.nl).

       30th April 1994 - 23rd February 2000: Wilf. (G.Wilford@ee.surrey.ac.uk)
       a dezvoltat <?>i intre<?>inut acest pachet cu ajutorul catorva oameni
       dedica<?>i.

       30th October 1996 - 30th March 2001: Fabrizio Polacco
       <fpolacco@debian.org> a men<?>inut <?>i imbunata<?>it acest pachet
       pentru proiectul Debian, cu ajutorul intregii comunita<?>i.

       31st March 2001 - pana in ziua de azi: Colin Watson
       <cjwatson@debian.org> dezvolta <?>i intre<?>ine acum man-db.

DEFEC<?>IUNI
       https://gitlab.com/man-db/man-db/-/issues
       https://savannah.nongnu.org/bugs/?group=man-db

2.12.1                            2024-04-05                            MAN(1)