NUME
man - format și afișa paginile de manual online
manpath - determină calea de căutare a utilizatorului pentru paginile manuale
REZUMAT
man [ -acdfFhkKtwW ] [ -path ] [ -m sistem ] [ -p string ] [ -C config_file ] [ -M pathlist ] [ -p pager ] [ -S section_list ] [ nume secțiune ] ...
DESCRIERE
man formate și afișează paginile de manual online. Dacă specificați secțiunea , omul arată numai în acea secțiune a manualului. numele este în mod normal numele paginii de manual, care este de obicei numele unei comenzi, unei funcții sau unui fișier. Cu toate acestea, dacă numele conține o slash ( / ), atunci omul îl interpretează ca specificație de fișier, astfel încât să puteți face om ./foo.5 sau chiar om /cd/foo/bar.1.gz .
Vedeți mai jos o descriere a locului în care omul caută fișierele cu pagini manuale.
OPȚIUNI
-C config_file
Specificați fișierul de configurare de utilizat; implicit este /etc/man.config . (Vezi man.conf (5).)
-M cale
Specificați lista de directoare pentru a căuta pagini manuale. Separați directoarele cu coloane. O listă goală este aceeași cu cea care nu specifică deloc -M . Vedeți CĂUTAREA CAUTĂ PENTRU PAGINILE MANUALE .
-P pager
Specificați ce pager să utilizați. Această opțiune înlocuiește variabila de mediu MANPAGER , care la rândul său suprascrie variabila PAGER . Implicit, omul folosește / usr / bin / less -isr .
-Subscrierea_secțiunii
Lista este o listă separată de secțiuni manual pentru a căuta. Această opțiune înlocuiește variabila de mediu MANSECT .
-A
Implicit, omul va ieși după ce a afișat prima pagină manuală pe care o găsește. Folosind această opțiune, omul trebuie să afișeze toate paginile manuale care se potrivesc cu numele, nu doar cu primul.
-c
Reformați pagina manusului sursă, chiar și atunci când există o pagină de pisică actualizată. Acest lucru poate fi semnificativ dacă pagina de pisici a fost formatată pentru un ecran cu un număr diferit de coloane sau dacă pagina preformată este coruptă.
-d
Nu afișați de fapt paginile cu manuale, dar imprimați gobs de informații de depanare.
-D
Atât afișarea cât și imprimarea informațiilor de depanare.
-f
Echivalent cu whatis .
-F sau -preformat
Formatare numai - nu se afișează.
-h
Imprimați un mesaj de ajutor cu o singură linie și ieșiți.
-k
Echivalent cu apropos .
-K
Căutați șirul specificat în * toate * paginile manuale. Avertisment: acest lucru este probabil foarte lent! Ajută la specificarea unei secțiuni. (Doar pentru a da o idee grosolană, pe mașina mea durează aproximativ un minut pe 500 de pagini manuale.)
-m sistem
Specificați un set alternativ de pagini manuale pentru a căuta pe baza numelui de sistem dat.
-p șir
Specificați succesiunea de preprocesoare pentru a rula înainte de nroff sau troff . Nu toate instalațiile vor avea un set complet de preprocesoare. Unele dintre preprocesoarele și literele folosite pentru a le desemna sunt: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), referință (r). Această opțiune înlocuiește variabila de mediu MANROFFSEQ .
-t
Utilizați / usr / bin / groff -Tps -mandoc pentru a formata pagina manuală, trecând ieșirea la stdout. Este posibil ca ieșirea din / usr / bin / groff -Tps -mandoc să treacă printr-un filtru sau altul înainte de a fi tipărită.
-w sau - calea
Nu afișați efectiv paginile man, dar imprimați locația (locațiile) fișierelor care ar fi formatate sau afișate. Dacă nu se dă niciun argument: afișați (pe stdout) lista directoarelor căutate de om pentru paginile manuale. Dacă manpa este o legătură cu omul, atunci "manpath" este echivalent cu "man-path".
-W
Ca și -w, dar imprimați numele fișierelor pe rând, fără informații suplimentare. Acest lucru este util în comenzile shell precum man-aW man | xargs ls -l
CAT PAGINI
Omul va încerca să salveze paginile manuale formatate, pentru a salva timpul de formatare data viitoare când sunt necesare aceste pagini. În mod tradițional, versiunile formatate ale paginilor în DIR / manX sunt salvate în DIR / catX, dar pot fi specificate și alte mapări de la mana dir la cat dir în /etc/man.config . Nu există pagini de pisică salvate atunci când directorul de pisici necesar nu există. Nu sunt salvate pagini de pisică atunci când sunt formatate pentru o lungime de linie diferită de 80. Nu sunt salvate pagini de pisică când man.conf conține linia NOCACHE.
Este posibil să se facă omul suid unui om utilizator. Apoi, dacă un director de pisici are omul proprietarului și modul 0755 (numai scrierea de către om), iar fișierele de pisică au proprietarul și modul 0644 sau 0444 (numai scriitorul poate fi scris sau nu), niciun utilizator obișnuit nu poate modifica pagini de pisică sau puneți alte fișiere în directorul de pisici. Dacă omul nu este făcut suid, atunci un director de pisici ar trebui să aibă modul 0777 dacă toți utilizatorii ar trebui să poată lăsa paginile de pisică acolo.
Opțiunea -c forțează reformatarea unei pagini, chiar dacă există o pagină de pisică recentă.
Căutați calea pentru pagini manuale
omul folosește o metodă sofisticată de găsire a fișierelor manuale de pagini, pe baza opțiunilor de invocare și a variabilelor de mediu, a fișierului de configurare /etc/man.config și a unor convenții construite și euristică.
Mai întâi, atunci când argumentul de nume pentru om conține o slash ( / ), omul presupune că este o specificare a fișierului în sine și că nu există nici o căutare implicată.
Dar în cazul normal în care numele nu conține o slash, omul caută o varietate de directoare pentru un fișier care ar putea fi o pagină manuală pentru subiectul numit.
Dacă specificați opțiunea pentru lista de cale -M , pathlist este o listă separată de colon a directoarelor căutate de om .
Dacă nu specificați -M, dar setați variabila de mediu MANPATH , valoarea acelei variabile este lista directoarelor căutate de om .
Dacă nu specificați o listă explicită de căi cu -M sau MANPATH , omul își dezvoltă propria listă de căi pe baza conținutului fișierului de configurare /etc/man.config . Exemplele MANPATH din fișierul de configurare identifică directoarele pe care să le includă în calea de căutare.
Mai mult, instrucțiunile MANPATH_MAP adaugă căii de căutare în funcție de calea de căutare a comenzii dvs. (de ex., Variabila de mediu PATH ). Pentru fiecare director care poate fi în calea de căutare a comenzii, o instrucțiune MANPATH_MAP specifică un director care ar trebui adăugat la calea de căutare pentru fișierele de pagină manuale. omul privește la variabila PATH și adaugă directoarele corespunzătoare în calea de căutare manuală a fișierului. Astfel, cu utilizarea corectă a MANPATH_MAP , când emiteți comanda man xyz , veți obține o pagină manuală pentru programul care ar fi rulat dacă ați emis comanda xyz .
În plus, pentru fiecare director din calea căutării comenzii (pe care îl vom numi un "director de comandă") pentru care nu aveți o mențiune MANPATH_MAP , omul caută automat un director de pagină manual "în apropiere" și anume ca un subdirector în comandă în sine sau în directorul părinte al directorului de comandă.
Puteți dezactiva căutările automate în apropiere prin includerea unei instrucțiuni NOAUTOPATH în /etc/man.config .
În fiecare director din căutarea de căutare descris mai sus, omul caută un fișier numit subiect . secțiune , cu un sufix opțional la numărul secțiunii și, eventual, un sufix de compresie. În cazul în care nu găsește un astfel de fișier, acesta va arăta apoi în orice subdirectoare numite om N sau cat N unde N este numărul secțiunii manuale. Dacă fișierul se află într-o subdirectoră cat N , omul presupune că este un fișier de pagină manual formatat (pagina cat). În caz contrar, omul presupune că este neformat. În ambele cazuri, dacă numele fișierului are un sufix de compresie cunoscut (cum ar fi .gz ), omul presupune că acesta este gzipped.
Dacă doriți să vedeți unde (sau dacă) omul ar găsi pagina manuală pentru un anumit subiect, utilizați opțiunea -path ( -w ).
Important: Utilizați comanda om ( % man ) pentru a vedea cum se utilizează o comandă pe computerul dvs. particular.