NAME
Man - snið og birta handbókina á netinu
manpath - ákvarða leitarslóð notanda fyrir mannasíður
Sýnishorn
maður [ -acdfFhkKtwW ] [ -path ] [ -m kerfi ] [ -p streng ] [ -C config_file ] [ -M slóðarlist ] [ -P pager ] [ -S section_list ] [ section ] nafn ...
LÝSING
maður snið og sýnir á netinu handbók síður. Ef þú tilgreinir hluta , lítur maður aðeins út í þessum hluta handbókarinnar. nafn er venjulega nafn handbókarsíðunnar, sem er yfirleitt heiti stjórnunar, aðgerða eða skráar. Hins vegar, ef nafn inniheldur skvetta ( / ) þá túlkar maður það sem skrá forskrift, svo að þú getir gert mann ./foo.5 eða jafnvel maður /cd/foo/bar.1.gz .
Sjá hér að neðan fyrir lýsingu á hvar maður leitar að handbókarsíðunni.
Valkostir
-C config_file
Tilgreindu stillingarskrána sem á að nota; Sjálfgefið er /etc/man.config . (Sjá man.conf (5).)
-M slóð
Tilgreindu lista yfir möppur til að leita að vefsíðum. Skiljaðu framkvæmdarstjóra með dálkum. Tómur listi er sá sami og ekki tilgreindur -M yfirleitt. Sjá SEARCH PATH FOR MANUAL PAGES .
-P pager
Tilgreindu hvaða kaupanda skal nota. Þessi valkostur fjallar um MANPAGER umhverfisbreytu, sem aftur á móti fjallar PAGER breytu. Sjálfgefið notar maður / usr / bin / minna -isr .
-S section_list
Listi er túlkuð aðskilinn listi yfir handbókarhluta til að leita. Þessi valkostur fjallar um MANSECT umhverfisbreytu.
-a
Sjálfgefið verður að maður loki eftir að hafa sýnt fyrstu handbókina sem hann finnur. Með því að nota þennan valkost verður maður að birta allar handbókarsíður sem passa við nafn, ekki bara fyrsta.
-c
Endurformaðu upphafsmannasíðuna, jafnvel þegar uppfærð köttasíða er til staðar. Þetta getur verið þýðingarmikið ef köttasíðan var formuð fyrir skjá með mismunandi fjölda dálka, eða ef forformatted page er skemmd.
-d
Sýna ekki raunverulega mannssíðurnar, en skrifaðu gobs af upplýsingum um kembiforrit.
-D
Bæði sýna og prenta kembiforrit upplýsingar.
-f
Jafngildir hvað sem er.
-F eða --preformat
Sniðið aðeins - ekki birta.
-h
Prenta einliða hjálparskeyti og hætta.
-k
Jafngildi apropos .
-K
Leitaðu að tilgreindu strengi í * öllum * mannssíðunum. Viðvörun: þetta er líklega mjög hægur! Það hjálpar til við að tilgreina hluta. (Bara til að gera gróft hugmynd, á vélinni minni tekur þetta um það bil eina mínútu á 500 manna síðum.)
-m kerfi
Tilgreina annað setja af vefsíðum manns til að leita miðað við nafn kerfisins.
-p strengur
Tilgreindu röð preprocessors til að keyra fyrir nroff eða troff . Ekki allir búnaður mun hafa fullt sett af preprocessors. Sumir preprocessors og stafina sem notuð eru til að tákna þá eru: eqn (e), grap (g), mynd (p), tbl (t), vgrind (v), vísa (r). Þessi valkostur fjallar um MANROFFSEQ umhverfisbreytu.
-t
Notaðu / usr / bin / groff -Tps -mandoc til að forsníða handbókina, sem sendir framleiðsluna til stdout. Framleiðsla frá / usr / bin / groff -Tps -mandoc gæti þurft að fara fram í gegnum síu eða annan áður en hún er prentuð.
-w eða -path
Sýnið í raun ekki mönnum síðum, en prentaðu staðsetningu (s) skrárnar sem mynduðu eða verða birtar. Ef engin rök eru gefin: Sýnið (á stdout) listanum yfir möppur sem leitað er af manni fyrir mannssíður. Ef manpath er tengill við mann, þá er "manpath" jafngildur "man - path".
-W
Eins og -w, en prenta skráarheiti eitt á línunni, án frekari upplýsinga. Þetta er gagnlegt í skipaskilum eins og maður - maðurinn | xargs ls -l
CAT Síður
Maður mun reyna að vista sniðmátarsíðuna, til þess að spara formatting tíma næst þegar þessar síður eru nauðsynlegar. Hefð eru sniðin útgáfur af síðum í DIR / manX vistuð í DIR / catX en aðrar mappings frá man dir til cat dir geta verið tilgreindar í /etc/man.config . Engar köttasíður eru vistaðar þegar nauðsynleg kötturskrá er ekki til. Engar köttasíður eru vistaðar þegar þau eru sniðin fyrir línu lengd frábrugðin 80. Engar köttasíður eru vistaðar þegar man.conf inniheldur línu NOCACHE.
Það er hægt að gera manninn suid til notanda manns. Þá, ef köttur skrá hefur eigandi maður og ham 0755 (aðeins skrifað af manni) og köttur skrár hafa eigandi maður og ham 0644 eða 0444 (aðeins skrifað af manni, eða ekki skriflegt yfirleitt), enginn venjulegur notandi getur breytt köttasíður eða setja aðrar skrár í köttaskránni. Ef maður er ekki suður, þá ætti kötturskrá að hafa ham 0777 ef allir notendur ættu að geta skilið köttasíður þar.
Valkosturinn -þarft að endurskipuleggja síðu, jafnvel þótt nýleg köttasíða sé til staðar.
Leiðbeiningar fyrir handbókarsíður
maður notar háþróaða aðferð við að finna handbókarsíðu skrár, byggt á boðunarvalkostum og umhverfisbreytur, /etc/man.config stillingarskránni, og sumir byggðar í samningum og heuristics.
Fyrst af öllu, þegar nafnargreinin við manninn inniheldur slash ( / ), gerir maður ráð fyrir að það sé skráarsnið sjálft, og það er engin leit að ræða.
En í venjulegu tilfelli þar sem nafn inniheldur ekki skástrik leitar maður að ýmsum framkvæmdarstjóra fyrir skrá sem gæti verið handbókarsíða fyrir efnið sem heitir.
Ef þú tilgreinir -M slóðarlistann , þá er slóðin listi með ristli sem er aðskilin frá möppum sem maður leitar.
Ef þú tilgreinir ekki -M en stillir MANPATH umhverfisbreytu, er gildi þessarar breytu listinn yfir þau möppur sem maður leitar.
Ef þú tilgreinir ekki skýr slóðarlista með -M eða MANPATH , þróar maður sinn eigin slóðarlista byggt á innihaldi stillingarskráarinnar /etc/man.config . The MANPATH yfirlýsingar í stillingaskránni bera kennsl á tilteknar möppur sem eru að finna í leitarslóðinni.
Ennfremur bætast MANPATH_MAP yfirlýsingarnar við leitarslóðina eftir því hvaða stjórn leitarleiðin er (þ.e. PATH umhverfisbreytan þín). Fyrir hverja möppu sem kann að vera í stjórnleitarslóðinni tilgreinir MANPATH_MAP yfirlýsing möppu sem ætti að vera bætt við leitarleiðina fyrir handvirka síðuskrár . maður lítur á PATH breytu og bætir samsvarandi möppum við handbók síðu skrá leitarslóð. Þannig að með réttri notkun MANPATH_MAP , þegar þú gefur út stjórnandann xyz færðu handbók síðu fyrir forritið sem myndi keyra ef þú gafst út skipunina xyz .
Að auki, fyrir hverja möppu í stjórnleitarslóðinni (við munum kalla það " stjórnaskrá ") sem þú hefur ekki MANPATH_MAP yfirlýsingu, leitar maður sjálfkrafa eftir handbókarsíðugreininni "nálægt", þ.e. sem undirmöppu í skipanalína sjálft eða í móðurmöppunni í stjórnaskránni.
Þú getur slökkt á sjálfvirkum "nálægum" leitum með því að nota NOAUTOPATH yfirlýsingu í /etc/man.config .
Í hverri möppu í leitarslóðinni eins og lýst er hér að framan leitar maður að skrá sem heitir efni . kafla með valfrjálst viðskeyti á hlutarnúmerinu og hugsanlega viðbótarþjöppun. Ef það finnur ekki slíkan skrá þá lítur hún þá út í einhverjum undirmöppum sem nefnast maður N eða köttur N þar sem N er handbókarnúmerið. Ef skráin er í katnesku N undirmöppu, gerir maður ráð fyrir að það sé sniðinn handbók blaðsíðu (köttur síðu). Annars telur maður að það sé ósniðið. Í báðum tilvikum, ef skráarnafnið hefur þekkt þjöppun viðskeyti (eins og .gz ), gerir maður ráð fyrir að það sé gzipped.
Ef þú vilt sjá hvar (eða ef) maðurinn myndi finna handbókina fyrir tiltekið efni skaltu nota - path ( -w ) valkostinn.
Mikilvægt: Notaðu stjórn mannsins ( % maður ) til að sjá hvernig stjórn er notuð á tölvunni þinni.