MAN(1) Utilitare ale paginatorului de manual MAN(1)
NUME
man - o interfa<?>a a manualelor de referin<?>a ale sistemului
SINOPSIS
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 nucleu)
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 nucleu [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 SINOPSIS <?>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 puse intre ghilimele 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
prompterului 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 continuare 255 - -
bulina (punct, pica<?>ea din mijloc) 267 o o
accent acut 264 ' '
semn de inmul<?>ire 327 x x
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 variabila $SYSTEM este definita, aceasta va avea acela<?>i
efect ca <?>i cum ar fi fost specificata 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.
ERORI
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db
2.13.1 2025-05-02 MAN(1)