Om formate și afișează paginile manuale on-line. Dacă specificați secțiune , om doar arată în acea secțiune a manualului. Nume este, în mod normal, numele paginii manuale, care este de obicei numele unei comenzi, unei funcții sau unui fișier. Cu toate acestea, dacă Nume conține o slash (/) atunciomîl interpretează ca pe o specificație de fișier, astfel încât să puteți face acest lucruom ./foo.5 sau chiarom /cd/foo/bar.1.gz. Vedeți mai jos o descriere a locațieiom caută fișierele paginilor manuale.
Nume
man - format și afișa paginile de manual onlinemanpath - determină calea de căutare a utilizatorului pentru paginile manuale om-acdfFhkKtwW --cale -m sistem -p şir -C config_file -M listă_căi -P pager -S section_list secțiune Nume … -C config_file Specificați fișierul de configurare de utilizat; este implicit/etc/man.config. (Vedeaman.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 se specifică-M deloc. VedeaCăutați calea pentru pagini manuale. -P pager Specificați ce pager să utilizați. Această opțiune are prioritate asupra funcțieiMANPAGER variabila de mediu, care la rândul său suprascriePAGER variabil. În mod implicit,om utilizări/ usr / bin / mai puțin -isr. -Subscrierea_secțiunii Lista este o listă separată de secțiuni manual pentru a căuta. Această opțiune are prioritate asupra funcțieiMANSECTvariabilă de mediu. -A În mod implicit,om va ieși după ce a afișat prima pagină manuală pe care o găsește. Utilizând această forțăom pentru a afișa toate paginile manuale care se potrivescNume,nu doar 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ă cuce este. -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ă cuoportun. -K Căutați șirul specificat în * toate * paginile manuale. Avertizare: 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 secvența de preprocesoare pentru a fi rulată înaintenroff sautroff. 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 are prioritate asupra funcțieiMANROFFSEQ variabilă de mediu. -t Utilizare/ usr / bin / groff -Tps -mandoc pentru a formata pagina manuală, trecând la ieșirestdout. Rezultatul de la/ usr / bin / groff -Tps -mandoc poate fi necesar să fie trecut printr-un filtru sau altul înainte de a fi imprimat. -wsau - 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ă nici un argument: afișați (pe stdout) lista directoarelor căutate de cătreom pentru paginile manuale. Dacăcale_man 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 cum ar fiomul - omul | xargs ls -l 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 dir om la dir pisică/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ăom suid unui om de folos. 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ăom 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. Optiunea-c forțează reformatarea unei pagini, chiar dacă există o pagină de pisică recentă. om utilizează o metodă sofisticată de găsire a fișierelor de pagină manual, pe baza opțiunilor de invocare și a variabilelor de mediu,/etc/man.configfișier de configurare și unele convenții încorporate și euristică. Mai întâi de toate, atunci când Nume argumentul pentruom conține o slash (/), om presupune că este o specificare a fișierului în sine și nu există nici o căutare implicată. Dar în cazul normal unde Nume nu conține o slash,om caută o varietate de directoare pentru un fișier care ar putea fi o pagină manuală pentru subiectul numit. Dacă specificați-M listă_căi opțiune, listă_căi este o listă a directoarelor separate de colonomcăutări. Dacă nu specificați-M dar setațiMANPATH variabila de mediu, valoarea acelei variabile este lista directoarelor careom căutări. Dacă nu specificați o listă cu trasee explicite-M sauMANPATH, om își dezvoltă propria listă de căi pe baza conținutului fișierului de configurare/etc/man.config.MANPATH instrucțiunile din fișierul de configurare identifică anumite directoare care trebuie incluse în calea de căutare. Mai mult decât atât,MANPATH_MAPinstrucțiunile adaugă la calea de căutare în funcție de calea de căutare a comenzii dvs. (adică dvs.CALEvariabilă de mediu). Pentru fiecare director care poate fi în calea de căutare a comenzii, aMANPATH_MAP instrucțiunea specifică un director care ar trebui adăugat la calea de căutare pentru fișierele de pagină manuale.om se uită laCALE variabilă și adaugă directoarele corespunzătoare în calea de căutare manuală a fișierului. Astfel, cu utilizarea corectă aMANPATH_MAP, când emiteți comandaom xyz, veți obține o pagină manuală pentru programul care ar fi rulat dacă ați lansat comandaxyz. În plus, pentru fiecare director din calea de căutare a comenzii (îl vom numi un "director de comandă") pentru care faceți nu ia oMANPATH_MAPafirmație,om caută automat un director de pagină manual "în apropiere" și anume ca un subdirector în directorul de comandă sau în directorul părinte al directorului de comandă. Puteți dezactiva căutările automate "în apropiere", inclusiv aNOAUTOPATH declarație în/etc/man.config. În fiecare director din calea de căutare descrisă mai sus,om caută un fișier numit subiect . secțiune , cu un sufix opțional la numărul secțiunii și, eventual, un sufix de compresie. Dacă nu găsește un astfel de fișier, atunci se va afișa în orice subdirectoare numiteom N saupisică N Unde N este numărul secțiunii manuale. Dacă fișierul este într-opisică N subdirector,om presupune că este un fișier de pagină manual formatat (pagină pisică). In caz contrar,om presupune că este neformatată. În ambele cazuri, dacă numele fișierului are un sufix de compresie cunoscut (cum ar fi.gz), om presupune că este gzipped. Dacă doriți să vedeți unde (sau dacă)om ar găsi pagina manuală pentru un anumit subiect, utilizați--cale(-w) opțiune. Important: Folosește om comandă ( % om ) pentru a vedea cum se utilizează o comandă pe computerul dvs. particular. Rezumat
Opțiuni
CAT Pagini
Calea de căutare pentru paginile manuale
