IME
man - format i prikaz on - line priručnik stranice
manpath - utvrdite korisnički put pretraživanja za muške stranice
SINOPSIS
čovjek [ -acdfFhkKtwW ] [ --path ] [ -m sustav ] [ -p string ] [ -C config_file ] [ -M putopis ] [ -P pager ] [ -S section_list ] [ dio ] ime ...
OPIS
man formata i prikazuje on-line priručnik stranice. Ako navedete odjeljak , čovjek samo gleda u taj odjeljak priručnika. naziv je obično naziv ručne stranice, što je obično naziv naredbe, funkcije ili datoteke. Međutim, ako naziv sadrži crtu ( / ), čovjek ga tumači kao specifikaciju datoteke, tako da možete učiniti čovjeka ./foo.5 ili čak čovjeka /cd/foo/bar.1.gz .
Pogledajte dolje za opis gdje čovjek traži datoteke s ručnim datotekama.
OPCIJE
-C config_file
Navedite konfiguracijsku datoteku koju želite koristiti; zadano je /etc/man.config . (Vidi man.conf (5).)
-M put
Navedite popis direktorija za pretraživanje manskih stranica. Odvojite direktorije dvosmjernim točkama. Prazni popis je isti kao što ne specificira -M uopće. Pogledajte SEARCH PATH FOR MANUAL PAGES .
-P pager
Odredite koji će pager koristiti. Ova opcija nadjačava varijablu okruženja MANPAGER koja zauzvrat nadjačava varijablu PAGER . Prema zadanim postavkama čovjek koristi / usr / bin / less -isr .
-S section_list
Popis je popis od ručnih odjeljaka odijeljen od debelog lista za pretraživanje. Ova opcija nadjačava varijablu okruženja MANSECT .
-a
Prema zadanim postavkama, čovjek će izaći nakon prikazivanja prve priručničke stranice koju pronađe. Upotreba ove opcije prisiljava čovjeka da prikaže sve ručne stranice koje se podudaraju s imenom, a ne samo prvi.
c
Obnovite stranicu s izvorima, čak i kada postoji ažurirana mačka stranica . To može biti korisno ako je stranica mačke formatirana za zaslon s različitim brojem stupaca ili ako je preformattirana stranica oštećena.
-D
Nemojte zapravo prikazati stranice za čovjeka, ali ispisivati podatke o pogreškama.
-D
Prikaz i ispis informacija o uklanjanju pogrešaka.
f
Odgovara onome što.
-F ili --preformat
Samo format - nemojte prikazivati.
-h
Ispišite poruku za pomoć u jednoj liniji i izađite.
-k
Jednako vrijedi za apropos .
-K
Potražite navedeni niz u svim * stranicama. Upozorenje: ovo je vjerojatno vrlo sporo! Pomaže u određivanju odjeljka. (Samo da dajem grubu ideju, na mojem stroju to traje oko jedne minute po 500 stranica.)
-m sustav
Navedite zamjenski skup stranica za pretraživanje na temelju određenog naziva sustava.
-p string
Navedite slijed predprocesora koji će se pokrenuti prije noff ili troff . Nijedna instalacija neće imati čitav skup predprocesora. Neki od predprocesora i slova kojima se označavaju su: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r). Ova opcija nadjačava MANROFFSEQ varijablu okruženja.
-t
Upotrijebite / usr / bin / groff -Tps -mandoc za formatiranje ručne stranice, dajući izlaz na stdout. Izlaz iz / usr / bin / groff -Tps -mandoc možda će biti prošao kroz neki filtar ili drugi prije ispisa.
-w ili - put
Nemojte zapravo prikazivati stranice s manom, ali ispisujte lokacije datoteka koje bi bile oblikovane ili prikazane. Ako se ne dodjeljuje argument: prikažite (na stdoutu) popis direktorija koje čovjek pretražuje za stranice čovjeka. Ako je čovjekov put povezan s čovjekom, onda je "putanje" jednako "putu čovjeka".
W
Kao i -w, ali ispisuje datoteke jedan po retku, bez dodatnih informacija. Ovo je korisno u naredbama ljuske poput čovjeka -W man | xargs ls -l
CAT PAGES
Čovjek će pokušati spremiti formatirane stranice za čovjeka, kako bi se spremio vrijeme oblikovanja sljedeći put kada su te stranice potrebne. Tradicionalno, oblikovane inačice stranica u DIR / manX spremaju se u DIR / catX, ali druge mape od čovjeka dir do cat dir mogu biti specificirane u /etc/man.config . Nijedna stranica mačke nije spremljena kada ne postoji potrebna mapa mačke. Nijedna stranica mačke nije spremljena kada su oblikovana za duljinu linije koja je različita od 80. Nijedna stranica mačke nije spremljena kada man.conf sadrži liniju NOCACHE.
Moguće je da muškarac bude suid korisniku. Zatim, ako popis mačića ima vlasnika čovjeka i način rada 0755 (samo ga može zapisati čovjek), a mačke datoteke imaju vlasnika čovjeka i način rada 0644 ili 0444 (samo ih može zapisivati ili se ne može pisati), niti jedan obični korisnik ne može promijeniti mačka stranica ili stavite druge datoteke u katalog mačke. Ako se čovjek ne podvrgne, cat folder bi trebao imati način 0777 ako bi svi korisnici trebali ostaviti mačke stranice tamo.
Opcija -c snaga ponovno oblikuje stranicu, čak i ako postoji nedavna mačka stranica.
PRETRAŽITE PUT ZA RUJNE STRANICE
čovjek koristi sofisticiranu metodu pronalaženja datoteka s ručnim datotekama, na temelju opcija pozivanja i varijabli okoline, /etc/man.config konfiguracijske datoteke i nekih ugrađenih konvencija i heuristika.
Prije svega, kada argument za ime čovjeka sadrži prorez ( / ), čovjek pretpostavlja da je riječ o specifikaciji datoteke, a ne uključuje se pretraživanje.
Ali u uobičajenom slučaju gdje ime ne sadrži sloj, čovjek pretražuje niz direktorija za datoteku koja bi mogla biti ručna stranica za temu s imenom.
Ako navedete opciju -M putopisni popis , popis putnih mapa je popis odjeće koje je čovjek pretraživao odvojeno od dvotočke.
Ako ne navedete -M ali postavite MANPATH varijablu okruženja, vrijednost te varijable je popis direktorija koje čovjek pretražuje.
Ako ne navedete eksplicitan popis putova s -M ili MANPATH , čovjek razvija vlastiti popis putova na temelju sadržaja konfiguracijske datoteke /etc/man.config . Izjave MANPATH u konfiguracijskoj datoteci određuju određene direktorije za uključivanje u putanje pretraživanja.
Nadalje, izjave MANPATH_MAP dodaju put pretraživaču, ovisno o putu traženja naredbi (tj. Vašoj varijabli okoline PATH ). Za svaki direktorij koji može biti u traci za pretraživanje naredbi, MANPATH_MAP izjava određuje direktorij koji bi trebao biti dodan u putanje pretraživanja za datoteke s ručnim datotekama. čovjek promatra varijablu PATH i dodaje odgovarajuće direktorije u ručni način traženja datoteka stranice. Dakle, kada pravilno upotrebljavate MANPATH_MAP , kada izdate naredbu man xyz , dobit ćete priručnu stranicu za program koji će se pokrenuti ako ste izdali naredbu xyz .
Osim toga, za svaki direktorij u putanju traganja pretraživanja (zvat ćemo ga kao "naredbeni direktorij") za koji nemate MANPATH_MAP izjavu, čovjek automatski traži direktorij priručnika stranica "u blizini", kao poddirektorij u sam naziv naredbe ili u nadređenom direktoriju naredbenog direktorija.
Možete isključiti automatsko pretraživanje "u blizini" uključivanjem izjave NOAUTOPATH u /etc/man.config .
U svakom direktoriju na putu pretraživanja kao što je gore opisano, čovjek pretražuje datoteku koja se zove tema . s dodatnim sufiksom o broju odjeljka i eventualno kompresijskom sufiksu. Ako ne pronađe takvu datoteku, onda izgleda u bilo kojem poddirektoriju pod nazivom čovjek N ili cat N gdje je N broj priručnika. Ako se datoteka nalazi u pod-direktoriju mačke N , čovjek pretpostavlja da je formatirana ručna stranica (mačka stranica). Inače, čovjek pretpostavlja da je neformatiran. U svakom slučaju, ako naziv datoteke ima poznati sufiks kompresije (kao što je .gz ), čovjek pretpostavlja da je gzipped.
Ako želite vidjeti gdje (ili ako) čovjek pronađe ručnu stranicu za određenu temu, upotrijebite opciju --path ( -w ).
Važno: Upotrijebite naredbu čovjek ( % man ) kako biste vidjeli kako se naredba koristi na vašem računalu.