man

formateazã ºi afiºeazã paginile de manual

man.1.man

1. man.1.man

Manpage of man

man

Section: User Commands (1)
Updated: 2 Septembrie 1995
Index Return to Main Contents

NUME

man - formateazã ºi afiºeazã paginile de manual
manpath - determinã calea de cãutare a utilizatorului pentru paginile de manual

SUMAR

man [-acdfFhkKtwW] [--path] [-m sistem] [-p ºir] [-C fiºier_configurare] [-M listã_cãi] [-P paginator] [-S listã_secþiuni] [secþiune] nume ...

DESCRIERE

man formateazã ºi afiºeazã paginile de manual. Dacã specificaþi secþiune, man cautã doar în acea secþiune a manualului. nume este în mod normal numele paginii de manual, care este de obicei numele unei comenzi, funcþii, sau fiºier. Totuºi, dacã nume conþine un slash (/) atunci man îl interpreteazã ca o specificare de fiºier, astfel încât puteþi executa man ./foo.5 sau chiar man /cd/foo/bar.1.gz.

Vedeþi mai jos pentru o descriere a locurilor unde cautã man fiºierele cu paginile de manual.

OPÞIUNI

-C fiiºier_configurare: Specificã fiºierul de configurare care se va folosi; inplicit este /etc/man.conf. (Vezi man.conf(5).)
-M cale: Specificã lista de directoare unde se cautã paginile man. Separaþi directoarele cu douã puncte (:). O listã goalã este echivalent cu a nu specifica -M de loc. Vezi ºi CALEA DE CÃUTARE A PAGINILOR MAN.
-P paginator: Specificã ce paginator de va folosi. Aceastã opþiune ignorã variabila de mediu MANPAGER , care în schimb ignorã variabila PAGER. Implicit, man foloseºte /usr/bin/less-isR.
-S listã_secþiuni: Lista este un ºir de secþiuni de manual care vor fi cãutate, despãrþite prin douã puncte (:). Aceastã opþiune ignorã variabila de mediu MANSECT.
-a: Implicit, executia man se va termina dupã afiºarea primei pagini de manual pe care o gãseºte. Folosirea acestei opþiuni forþeazã man sã afiºeze toate paginila de manual care verificã nume, nu doar prima.
-c: Reformateazã pagina man sursã, chiar dacã existã o paginã cat actualizatã. Acest lucru poate fi important dacã pagina cat a fost formatatã pentru un ecran cu un numãr diferit de coloane, sau dacã pagina preformatatã este alteratã.
-d: Nu afiºeazã efectiv paginile man, ci tipãreºte multe informaþii de depanare.
-D: Afiºeazã atât paginile man, cât ºi informaþii de depanare.
-f: Echivalent cu whatis.
-F sau --preformat: Doar formateazã - nu afiºeazã.
-h: Tipãreºte un mesaj de ajutor ºi terminã execuþia.
-k: Echivalent cu apropos.
-K: Cautã ºirul de caractere specificat în *toate* paginile man. Avertisment: aceasta este probabil o operaþie foarte lentã! Ajutã specificarea unei secþiuni. (Pentru a da o idee generalã, pe maºina mea aceasta dureazã aproape un minut pentru 500 pagini man.)
-m sistem: Specificã un set alternativ de pagini man de cãutat, bazat pe numele de sistem dat.
-p ºir: Specificã secvenþa de preprocesoare ce vor fi rulate înainte de nroff sau troff. Nu toate instalãrile vor avea un set complet de preprocesoare. Unele din preprocesoare ºi literele folosite pentru a le desemna sunt: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r). Aceastã opþiune duce la ignorarea variabilei de mediu MANROFFSEQ.
-t: Foloseºte /usr/bin/groff -Tps -mandoc pentru a formata pegina man, trimiþând rezultatul la ieºirea standard (stdout). Rezultatul comenzii /usr/bin/groff -Tps -mandoc ar putea necesita sã fie trecut printr-un filtru înante de a fi tipãrit.
-w sau --path: Nu afiºeazã efectiv paginile man, ci tipãreºte locaþia(ile) fiºierelor care ar fi formatate sau afiºate. Dacã nici un argument nu este dat: afiºeazã (la ieºirea standard (stdout)) lista directoarelor în care sunt cãutate de man paginile man. Dacã manpath este o legãturã la man, atunci "manpath" este echivalent cu "man --path".
-W: Ca -w, dar afiºeazã numele de fiºiere unul pe linie, fãrã informaþii adiþionale. Aceastã opþiune este utilã în comenzi shell ca man -aW man | xargs ls -l

PAGINILE CAT

Man va încerca sã salveze paginile man formatate, pentru a reduce timpul de formatare data viitoare când aceste pagini sunt necesare. Tradiþional, versiunile formatate ale paginilor din DIR/manX sunt salvate în DIR/catX, dar alte mapãri de la directorul man la directorul cat pot fi specificate în /etc/man.conf. Nici o paginã cat nu este salvatã dacã directorul cat necesar nu existã.

Este posibil sã faceþi man suid la un utilizator man. Atunci, dacã un director cat are proprietar man ºi modul 0755 (scriere doar de cãtre man), ºi fiºierele cat au proprietarul man ºi modul 0644 sau 0444 (scriere doar de cãtre man, sau nici o permisiune de scriere), nici un utilizator normal nu poate modifica paginile cat sau sã punã alte fiºiere în directorul cat. Dacã man nu este fãcut suid, atunci un director cat ar trebui sã aibã modul 0777 dacã toþi utilizatorii trebuie sã poatã lãsa pagini cat acolo.

Opþiunea -c forþeazã reformatarea unei pagini, chiar dacã existã o paginã cat recentã.

CALEA DE CÃUTARE A PAGINILOR MAN

man foloseºte o metodã sofisticatã pentru a gãsi paginile de manual, bazatã pe opþiuni de apelare ºi variabile de mediu, fiºierul de configurare /etc/man.conf ºi anumite convenþii ºi euristici.

Înainte de toate, când argumentul nume al man conþine un slash (/), man considerã cã este un specificator de fiºier ºi nu se efectueazã nici o cãutare.

Dar în cazul normal în care nume nu conþine un slash, man cautã în o mulþime de directoare un fiºier care a putea fi o paginã de manual pentru subiectul numit.

Dacã specificaþi opþiunea -M listã_cãi, listã_cãi este o listã de directoare despãrþite prin douã puncte (:) în care cautã man.

Dacã nu specificaþi -M dar setaþi variabila de mediu MANPATH, valoarea acestei variabile este lista de directoare în care cautã man.

Dacã nu specificaþi explicit o listã de cãi cu -M sau MANPATH, man îºi creeazã propria listã de cãi bazatã pe conþinutul fiºierului de configurare /etc/man.conf. Declaraþiile MANPATH din fiºierul de configurare definesc anumite directoare care sã fie incluse în calea de cãutare.

Mai mult, declaraþiile MANPATH_MAP se adaugã la calea de cãutare depinzând de calea de cãutare a comenzilor (de ex. variabila de mediu PATH). Pentru fiecare director care este în calea de cãutare a comenzilor, o declaraþie MANPATH_MAP specificã un director care trebuie cã fie adãugat la calea de cãutare a fiºierelor cu paginile de manual. man analizeazã variabila PATH ºi adaugã directoarele corespunzãtoare la calea de cãutare a fiºierelor cu paginile de manual. Astfel, prin folosirea corectã a MANPATH_MAP, când executaþi comanda man xyz, obþineþi o paginã de manual pentru programul care ar rula dacã aþi executa comanda xyz.

În plus, pentru fiecare director în calea de cãutare a comenzilor (o vom denumi "director de comenzi") pentru care nu aveþi o declaraþie MANPATH_MAP, man cautã în mod automat un director cu pagini de manual "învecinat", respectiv ca un subdirector al directorului de comenzi sau în directorul pãrinte al directorului de comenzi.

Puteþi dezactiva cãutarea "învecinatã" automatã incluzând o declaraþie NOAUTOPATH în /etc/man.conf.

În fiecare director din calea de cãutare descris mai sus, man cautã un fiºier numit topic.section, cu un sufix opþional la numãrul secþiunii ºi posibil un sufix de compresie. Dacã nu gãseºte un astfel de fiºier, cautã în orice subdirectoare numite manN sau catN unde N este numãrul secþiunii de manual. Dacã fiºierul este într-ul subdirector catN, man considerã cã este o paginã de manual formatatã (paginã cat). Altfel, man considerã cã este neformatatã. În oricare caz, dacã numele fiºierului are un sufix cunoscut de compresie (ca .gz), man considerã cã este comprimat cu gzip.

Dacã doriþie sã vedeþi unde (sau dacã) man ar gãsi pagina de manual pentru un anumit subiect, folosiþi opþiunea --path (-w).

VARIABILE DE MEDIU

MANPATH: Dacã MANPATH este setatã, man o foloseºte drept cale de cãutare a fiºierelor cu paginile de manual. Ignorã fiºierul de configurare ºi calea de cãutare automatã, dar este ignoratã de opþiunea de apelare -M. Vezi ºi CALEA DE CÃUTARE A PAGINILOR MAN.
MANPL: Dacã MANPL este setatã, valoarea ei este folositã ca lungimea paginii afiºate. Altfel, întreaga paginã man va ocupa o singurã paginã (lungã).
MANROFFSEQ: Dacã MANROFFSEQ este setatã, valoarea ei este folositã pentru determinarea setului de preprocesoare rulate înainte de a rula nroff sau troff. Implicit, paginile sunt trecute prin preprocesorul tbl înainte de nroff.
MANSECT: Dacã MANSECT este setatã, valoare ei este folositã pentru a determina în ce secþiune de manual sã se caute.
MANWIDTH: Dacã MANWIDTH este setatã, valoare ei este folositã ca lãþimea pe care paginile de manual ar trebui sã fie afiºate. Altfel paginile ar putea fi afiºate peste lãþimea ecranului.
MANPAGER: Dacã MANPAGER este setatã, valoarea ei este folositã ca numele programului ce va fi folosit pentru a afiºa pagina man. Dacã nu, atunci PAGER este folositã. Dacã nici aceasta nu are o valoare, /usr/bin/less -isR este folosit.
LANG: Dacã LANG este setatã, valoarea ei defineºte numele subdirectorului unde man cautã prima datã paginile man. Astfel, comanda `LANG=dk man 1 foo' va determina man sã caute pagina man foo în .../../foo.1 ºi dacã nu poate gãsi un astfel de fiºier, în .../foo.1, unde ... este un director în calea de cãutare.
NLSPATH, LC_MESSAGES, LANG: Variabilele de mediu NLSPATH ºi LC_MESSAGES (sau LANG când ultima nu existã) joacã un rol în localizarea catalogului de mesaje. (Dar mesajele în englezã sunt incluse la compilare ºi pentru englezã nu este necesar nici un catalog.) Notaþi cã programe apelate de man ca col(1) folosesc ºi ele de ex. LC_CTYPE.
PATH: PATH ajutã la determinarea cãii de cãutare a fiºierelor cu paginile de manual. Vezi ºi CALEA DE CÃUTARE A PAGINILOR MAN.
SYSTEM: SYSTEM este folositã pentru a obþine numele implicit al sistemului alternativ (pentru a fi utilizat cu opþiunea -m).

VEZI ªI

apropos(1), whatis(1), less(1), groff(1), man.conf(5).

ERORI

Opþiunea -t funcþioneazã doar dacã un program gen troff este instalat.
Dacã vedeþi \255 sau <AD> clipind în loc de liniuþe, setaþi `LESSCHARSET=latin1' în mediu.

SFATURI

Dacã adãugaþi linia

(global-set-key [(f1)] (lambda () (interactive) (manual-entry (current-word))))

în fiºierul dumneavoastrã .emacs, apãsând F1 veþi obþine pagina man pentru apelul de librãrie la poziþia curentã a cursorului.

Pentru a obþine o versiune doar text a paginii man, fãrã backspace ºi liniuþe de subliniere (underscore), încercaþi

# man foo | col -b > foo.mantxt

This document was created by man2html using the manual pages.
Time: 17:41:17 GMT, May 11, 2012