Man - Linux Command - Unix Command

NAAM

man-formaat en vertoon die on-line handleiding bladsye
manpath - bepaal die gebruiker se soekpad vir manbladsye

SINOPSIS

man [ -acdfFhkKtwW ] [- path ] [ -m stelsel ] [ -p string ] [ -C config_file ] [ -M padlys ] [ -P pager ] [ -S section_list ] [ afdeling ] naam ...

BESKRYWING

man formate en vertoon die aanlyn-handleiding bladsye. As u 'n afdeling spesifiseer, kyk die mens net in daardie gedeelte van die handleiding. naam is gewoonlik die naam van die handleiding, wat gewoonlik die naam van 'n opdrag, funksie of lêer is. As die naam egter 'n slash ( / ) bevat, interpreteer die man dit as 'n lêerspesifikasie , sodat jy die mens kan ./foo.5 of selfs man /cd/foo/bar.1.gz .

Sien hieronder vir 'n beskrywing van waar die mens kyk na die handleidingbladsye.

OPTIONS

-C config_file

Spesifiseer die konfigurasie lêer om te gebruik; die standaard is /etc/man.config . (Sien man.conf (5).)

-M-pad

Spesifiseer die lys van gidse om na manbladsye te soek. Skei die dopgehou met kolonies. 'N Leë lys is dieselfde as wat nie spesifiseer nie -M glad nie. Sien SEARCH PATH FOR MANUAL PAGES .

-P pager

Spesifiseer watter pager om te gebruik. Hierdie opsie oortree die MANPAGER omgewing veranderlike, wat op sy beurt die PAGER veranderlike oortree. By verstek gebruik die mens / usr / bin / less -isr .

-S afdeling_lys

Lys is 'n kolon geskeide lys van handleiding afdelings om te soek. Hierdie opsie oortree die MANSECT omgewing veranderlike.

-a

By verstek sal die man verlaat nadat die eerste handleiding wat dit vind, vertoon word. Deur hierdie opsie te gebruik, dwing die man om al die handleidingbladsye wat ooreenstem met die naam, nie net die eerste nie.

-c

Herskryf die bron man bladsy, selfs as daar 'n opgedateerde katbladsy bestaan. Dit kan sinvol wees as die katbladsy vir 'n skerm met 'n ander aantal kolomme geformateer is, of as die voorafformateerde bladsy korrup is.

d

Moet nie eintlik die manbladsye vertoon nie, maar druk gobs van ontfoutingsinligting.

-D

Beide vertoon en druk debugging info.

f

Ekwivalent aan wat .

-F of --preformat

Formateer slegs - moenie vertoon nie.

h

Druk 'n eenhulp-hulpboodskap af en sluit af.

k

Ekwivalent aan apropos .

-K

Soek die gespesifiseerde string in * alle * manbladsye. Waarskuwing: dit is waarskynlik baie stadig! Dit help om 'n afdeling te spesifiseer. (Om net 'n rowwe idee te gee, duur dit ongeveer 'n minuut per 500 manbladsye op my masjien.)

-m stelsel

Spesifiseer 'n alternatiewe stel manbladsye om te soek gebaseer op die stelselnaam wat gegee word.

-p-string

Spesifiseer die volgorde van voorverwerkers om voor nroff of troff te hardloop. Nie alle installasies sal 'n volledige stel preprocessors hê nie. Sommige van die voorverwerkers en die briewe wat gebruik word om hulle te benoem is: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), verwys (r). Hierdie opsie oortree die MANROFFSEQ omgewing veranderlike.

t

Gebruik / usr / bin / groff -Tps -mandoc om die handleiding te formateer, wat die uitvoer na stdout verbystuur. Die uitset van / usr / bin / groff-Tps-mandoc moet dalk deur middel van 'n filter of ander oorgedra word voordat dit gedruk word.

-w of -pad

Moet nie eintlik die manbladsye vertoon nie, maar druk die plek (e) van die lêers wat geformateer of vertoon sou word. Indien geen argument gegee word nie: vertoon (op stdout) die lys van dopgehou wat deur man vir manbladsye gesoek word. As manpath 'n skakel na die mens is, is "manpath" ekwivalent aan "manpath".

-W

Soos -w, maar druk lêer name een per reël, sonder bykomende inligting. Dit is handig in dop opdragte soos man -AW man | xargs ls -l

RTT BLADSYE

Die mens sal probeer om die geformateerde manbladsye te red, om formateringstyd te bespaar, die volgende keer wat hierdie bladsye benodig word. Tradisioneel word geformateerde weergawes van bladsye in DIR / manX gestoor in DIR / catX, maar ander mappings van man dir na cat dir kan in /etc/man.config gespesifiseer word. Geen kat bladsye word gestoor wanneer die vereiste kat gids nie bestaan ​​nie. Geen katbladsye word gestoor wanneer hulle geformateer is vir 'n lynlengte wat verskil van 80. Geen katbladsye word gestoor wanneer man.conf die lyn NOCACHE bevat nie.

Dit is moontlik om die mens na 'n gebruikersman te suid. Dan, as 'n kattenmap eienaar eienaar en modus 0755 het (slegs skrifbaar deur die mens), en die kat lêers het eienaar man en modus 0644 of 0444 (kan slegs deur die mens geskryf word of glad nie skryfbaar nie), kan geen gewone gebruiker die kat bladsye of ander lêers in die kat gids. As die mens nie suid gemaak word nie, moet 'n katlys 0777 hê indien alle gebruikers daar kattebladsye moet verlaat.

Die opsie -c magte om 'n bladsy te herformatteer, selfs as daar 'n onlangse kat bladsy bestaan.

SOEK PAD VIR HANDLEIDING BLADSYE

Die mens gebruik 'n gesofistikeerde metode om handleidingbladsye te vind, gebaseer op die aanroep opsies en omgewing veranderlikes, die konfigurasie lêer /etc/man.config , en sommige in konvensies en heuristiek gebou.

Eerstens, as die naambegrip vir die mens 'n slash ( / ) bevat, aanvaar die mens dit is 'n lêerspesifikasie self, en daar is geen soek betrokke nie.

Maar in die normale geval waar die naam nie 'n snit bevat nie, soek die man ' n verskeidenheid van gidse vir 'n lêer wat 'n handleiding vir die genoemde naam kan wees.

As u die opsie -M- padlys spesifiseer, is padlys 'n kolon geskeide lys van die dopgehou wat die man soek.

As jy nie -M spesifiseer, maar stel die MANPATH omgewing veranderlike in, is die waarde van daardie veranderlike die lys van die dopgehou wat die man soek.

As jy nie 'n eksplisiete padlys spesifiseer met -M of MANPATH nie , ontwikkel die mens sy eie padlys gebaseer op die inhoud van die konfigurasielêer /etc/man.config . Die MANPATH- stellings in die konfigurasielêer identifiseer spesifieke dopgehou om in die soekpad in te sluit.

Verder voeg die MANPATH_MAP- stellings by die soekpad, afhangende van jou opdrag soekpad (dit wil sê jou PATH omgewing veranderlike). Vir elke gids wat dalk in die opdrag soekpad is, spesifiseer 'n MANPATH_MAP- stelling 'n gids wat by die soekpad vir handleidingbladsy-lêers gevoeg moet word. Die mens kyk na die PATH- veranderlike en voeg die ooreenstemmende gidse by die handleiding vir die soek na die handleiding. Dus, met die korrekte gebruik van MANPATH_MAP , wanneer u die bevelman xyz uitreik, kry u 'n handleiding vir die program wat sou loop as u die bevel xyz uitgereik het.

Daarbenewens word vir elke gids in die opdrag soekpad (ons noem dit 'n " opdraggids ") waarvoor u nie 'n MANPATH_MAP- stelling het nie. Die man soek outomaties 'n gids vir handleiding 'naby', naamlik as 'n subgids in die opdrag gids self of in die ouer gids van die opdrag gids.

U kan die outomatiese "nabygeleë" soektogte deaktiveer deur 'n NOAUTOPATH- stelling in /etc/man.config insluit .

In elke gids in die soekpad soos hierbo beskryf, soek die mens na 'n lêer met die naam . afdeling , met 'n opsionele agtervoegsel op die artikelnommer en moontlik 'n kompressie-agtervoegsel. As dit nie so 'n lêer vind nie, lyk dit in enige subdirectories genaamd man N of kat N waar N die handleiding afdeling nommer is. As die lêer in 'n kat N subgids is, aanvaar die mens dit is 'n geformateerde handleidingbladsy (katblad). Anders aanvaar die mens dit is geformateer. In elk geval, as die lêernaam 'n bekende kompressie-agtervoegsel (soos .gz ) het, neem die mens aan dat dit gzipped is.

As jy wil sien waar (of indien) die handleiding vir 'n spesifieke onderwerp sou vind, gebruik die - pad ( -w ) opsie.

Belangrik: Gebruik die man opdrag ( % man ) om te sien hoe 'n opdrag op u rekenaar gebruik word.