NÁZEV
man - formát a zobrazí on - line manuálové stránky
manpath - určuje cestu uživatele pro stránky mana
SYNOPSE
man [ -cdfFhkKtwW ] [ --path ] [ -m systém ] [ -p řetězec ] [ -C config_file ] [ -M pathlist ] [ -P pager ] [ -S section_list ] [ název oddílu ]
POPIS
man formáty a zobrazí on-line manuálové stránky. Pokud zadáte část , člověk se podívá pouze do této části příručky. název je obvykle název manuální stránky, což je obvykle název příkazu, funkce nebo souboru. Pokud však název obsahuje lomítko ( / ), pak jej člověk interpretuje jako specifikaci souboru, takže můžete dělat man ./foo.5 nebo dokonce man /cd/foo/bar.1.gz .
Níže naleznete popis toho, kde člověk hledá ruční soubory stránek.
MOŽNOSTI
-C config_file
Určete konfigurační soubor, který chcete použít; výchozí hodnota je /etc/man.config . (Viz man.conf (5).)
-M cestu
Zadejte seznam adresářů, které chcete vyhledat v manuálových stránkách. Oddělte adresáře dvojtečkami. Prázdný seznam je stejný jako neurčující vůbec -M . Viz SEZNAM VYHLEDÁVÁNÍ RUČNÍCH STRÁNEK .
-P pager
Určete, který pager použít. Tato volba přepíše proměnnou prostředí MANPAGER , která pak přepíše proměnnou PAGER . Ve výchozím nastavení používá člověk / usr / bin / less -isr .
-S sekce_ seznamu
Seznam je seznam oddělených dvojtečky ručních úseků, které chcete vyhledat. Tato volba přepíše proměnnou prostředí MANSECT .
-A
Ve výchozím nastavení se člověk ukončí po zobrazení první manuální stránky, kterou najde. Použitím této volby je člověk povinen zobrazit všechny manuální stránky, které odpovídají názvu, nikoliv pouze prvnímu.
-C
Přeformátujte zdrojovou stránku zdroje, i když existuje aktuální stránka kočky . To může mít smysl, pokud byla stránka kočky naformátována pro obrazovku s odlišným počtem sloupců nebo pokud je předformátovaná stránka poškozena.
-d
Manuální stránky se v podstatě nezobrazují, ale tisknou informace o ladění.
-D
Oba zobrazují a tiskávají informace o ladění.
-F
Ekvivalent k whatis .
-F nebo --preformat
Pouze formátování - nezobrazovat.
-h
Vytiskněte jednu pomocnou zprávu a ukončete.
-k
Ekvivalentní k apropos .
-K
Vyhledejte zadaný řetězec v * all * man pages. Upozornění: je to pravděpodobně velmi pomalé! Pomáhá určit sekci. (Jen abych dělal hrubý nápad, na mém stroji to trvá asi minutu na 500 manských stránkách.)
-m systému
Určete alternativní soubor manuálových stránek pro vyhledávání podle daného názvu systému.
-p řetězec
Určete sekvenci předprocesorů, která se má spouštět před nroff nebo troff . Ne všechny instalace budou mít úplnou sadu preprocesorů. Některé z předprocesorů a písmena použitá k jejich označení jsou: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), odkaz (r). Tato volba přepíše proměnnou prostředí MANROFFSEQ .
-t
Použijte / usr / bin / groff -Tps -mandoc k formátování manuální stránky, předáním výstupu do stdout. Výstup z adresáře / usr / bin / groff -Tps -mandoc může být potřeba procházet některým filtrem nebo jiným způsobem před tiskem.
-w nebo - cesta
Vlastní stránky vlastně nezobrazují, ale vytiskněte umístění souborů, které by byly formátovány nebo zobrazeny. Není-li zadán žádný argument: zobrazení (na stdout) seznamu adresářů, které hledá člověk pro stránky mana. Pokud je manpath spojen s člověkem, pak "manpath" je ekvivalentní "man-path".
-W
Stejně jako -w, ale vytisknout jména souborů na jeden řádek bez dalších informací. To je užitečné v shell příkazy jako man -aW man | xargs ls -l
KATEGORIE
Člověk se pokusí uložit formátované stránky mana, aby ušetřil formátovací formát při příštím použití těchto stránek. Tradičně jsou ve DIR / manX uloženy naformátované verze stránek v DIR / cat, ale další mapování z adresáře man to dir mohou být zadány v souboru /etc/man.config . Žádné stránky koček nejsou uloženy, pokud neexistuje požadovaný adresář koček. Žádné stránky koček nejsou uloženy, pokud jsou formátovány pro délku řádku odlišnou od 80. Žádné stránky koček nejsou uloženy, když man.conf obsahuje řádek NOCACHE.
Je možné, aby člověk byl suid u uživatele. Poté, pokud má adresář kočky vlastník člověka a režim 0755 (jen člověk zapisovatelný) a soubory koček mají vlastníka a režim 0644 nebo 0444 (jen zapisovatelný člověkem nebo vůbec nezapisovatelný), žádný běžný uživatel nemůže změnit nebo vložte další soubory do adresáře koček. Pokud není člověk vyroben suid, pak adresář kočky by měl mít režim 0777, pokud by všichni uživatelé měli mít možnost nechat stránky koček tam.
Možnost -c vynucuje přeformátování stránky, i když existuje poslední stránka kočky.
VYHLEDÁVÁNÍ CESTU PRO RUČNÍ STRÁNKY
man využívá sofistikovanou metodu nalezení ručních souborů stránek založených na volbách vyvolání a proměnných prostředí, konfiguračním souboru /etc/man.config a některých vestavěných konvencích a heuristikách.
Nejprve, když jméno argumentu pro člověka obsahuje lomítko ( / ), člověk předpokládá, že je to samotná specifikace souboru a není zde žádné vyhledávání.
Ale v normálním případě, kdy název neobsahuje lomítko, hledá člověk řadu adresářů pro soubor, který by mohl být manuálovou stránkou pro pojmenované téma.
Pokud zadáte možnost -M pathlist , pathlist je seznam oddělených dvojteček adresářů, které člověk vyhledává.
Pokud nezadáte -M, ale nastavíte proměnnou prostředí MANPATH , hodnota této proměnné je seznam adresářů, které člověk prohledává.
Pokud nezadáte explicitní seznam cest s -M nebo MANPATH , člověk vytvoří svůj vlastní seznam cest založený na obsahu konfiguračního souboru /etc/man.config . Příkazy MANPATH v konfiguračním souboru identifikují konkrétní adresáře, které se mají zahrnout do vyhledávací cesty.
Příkazy MANPATH_MAP navíc přidávají do vyhledávací cesty v závislosti na vaší cestu hledání příkazů (tj. Proměnné prostředí PATH ). Pro každý adresář, který může být ve vyhledávací cestě příkazu, příkaz MANPATH_MAP určuje adresář, který by měl být přidán do vyhledávací cesty pro ruční soubory stránek. člověk se podívá na proměnnou PATH a přidá příslušné adresáře do cesty hledání ručního souboru. Proto při správném použití MANPATH_MAP , když vydáte příkaz man xyz , získáte manuálovou stránku programu, který by se spustil, pokud jste vydali příkaz xyz .
Navíc pro každého adresáře v příkazové cestě hledání (nazýváme jej "příkazový adresář"), pro který nemáte příkaz MANPATH_MAP , člověk automaticky vyhledá manuálový adresář "poblíž", a to jako podadresář v adresáři samotný příkazový adresář nebo v nadřazeném adresáři příkazového adresáře.
Automatické vyhledávání "v blízkosti" můžete deaktivovat tak, že v příkazu /etc/man.config vložíte příkaz NOAUTOPATH .
V každém adresáři ve vyhledávací cestě, jak je popsáno výše, hledá člověk soubor s názvem téma . , s volitelnou příponou na číslo oddílu a případně příponu komprese. Pokud takový soubor nenajde, pak se podívá na všechny podadresáře s názvem man N nebo cat N, kde N je číslo ručního oddílu. Pokud je soubor v podadresáři cat N , předpokládá se, že je to formátovaný manuálový soubor stránky (stránka kočky). Jinak člověk předpokládá, že je neformátovaný. V obou případech, jestliže má název souboru známou příponu komprese (například .gz ), předpokládá se, že je soubor gzip.
Chcete-li zjistit, kde (nebo pokud) člověk nalezne manuálovou stránku pro konkrétní téma, použijte volbu - path ( -w ).
Důležité: Použijte příkaz man ( % man ), abyste zjistili, jaký příkaz se používá v konkrétním počítači.