Jak zobrazit konkrétní sekci na Manových stránkách v Linuxu

Když hledáte použití příkazu Linux/Unix, nemusíte Google ani hledat v diskusních fórech, na wiki stránkách, blozích nebo v jiných offline/online zdrojích. Vše je zdokumentováno na stránkách manuálů (krátce manuálové stránky) příkazu. Stačí se naučit efektivně používat manuálové stránky abyste snadno a rychle získali podrobnosti o příkazu nebo jeho možnostech/příznakech. Dnes se podělím o méně známý trik s manuálovými stránkami, tj. jak zobrazit konkrétní sekci v manuálových stránkách v Linuxu a Unixu.

Výchozí struktura manuálové stránky

Manuální stránka se skládá z několika různých sekcí, uspořádaných s nadpisy pro každou sekci, jako je JMÉNO, SYNOPSE, KONFIGURACE, POPIS, MOŽNOSTI, STAV VÝSTUPU, NÁVRATNÁ HODNOTA, CHYBY, PROSTŘEDÍ, SOUBORY, VERZE, ODPOVÍDAJÍCÍ, POZNÁMKY, CHYBY, PŘÍKLAD, AUTOŘI a VIZ TAKÉ. Každá manuálová stránka má svůj název příkazu následovaný číslem sekce v závorce.

Zde je seznam čísel sekcí příručky následovaný typy stránek, které obsahují:

1   - Executable programs or shell commands.
2   - System calls (functions provided by the kernel).
3   - Library calls (functions within program libraries).
4   - Special files (usually found in /dev).
5   - File formats and conventions e.g. /etc/passwd.
6   - Games.
7   - Miscellaneous (including  macro  packages  and conventions), e.g. man(7).
8   - System administration commands (usually only for root).
9   - Kernel routines [Non standard].

Některé stránky mají všechny tyto sekce a některé ne. Nyní se podívejme, jak zobrazit konkrétní část manuálové stránky příkazu.

Zobrazit konkrétní sekci v manuálových stránkách v Linuxu

Otevřete manuálovou stránku příkazu, například uname .

$ man uname

Přejděte dolů na konec manuálové stránky a uvidíte odkazy na další příkazy.

[...]
SEE ALSO
       arch(1), uname(2)
[...]

manuálová stránka příkazu uname

Vidíte všechna ta čísla za příkazy na konci? Na konci manuálových stránek téměř všech příkazů uvidíte jeden nebo více referenčních příkazů s čísly v závorkách. Tato čísla označují konkrétní sekci manuálové stránky příkazu, na kterou se chcete podívat. Jinými slovy, číslo odpovídá tomu, z jaké části manuálu daná stránka pochází.

Chcete-li uživateli výslovně říci, aby otevřel sekci 2 příkazu uname, jednoduše spusťte:

$ man 2 uname

Nebo,

$ man uname.2

Na následujícím snímku obrazovky levé okno Terminálu zobrazuje výstup příkazu "man uname". Pravá strana okna Terminál zobrazuje výstup „man 2 uname“ (tj. sekce 2 uname ) příkaz.

Zobrazit konkrétní sekci na Manových stránkách v Linuxu

Vezměte prosím na vědomí, že když spustíme příkaz man bez jakýchkoli čísel, je to obvykle ekvivalent:

$ man 1 <command>

Některé manuálové stránky nemají konkrétní sekci. V takových případech nedostanete nic zpět, když se pokusíte zobrazit manuálovou stránku s číslem sekce. Například spustím následující příkaz, abych viděl 5. sekci příkazu uname:

$ man 5 uname

Protože příkaz uname nemá sekci 5, dostávám následující výstup:

No manual entry for uname in section 5
See 'man 7 undocumented' for help when manual pages are not available.

Zobrazit všechny sekce v řadě

Jak jsem již řekl, manuálová stránka konkrétního příkazu má mnoho sekcí. Chcete-li zobrazit všechny odpovídající stránky v řadě, použijte -a příznak jako níže.

$ man -a uname

Stiskněte q pro ukončení jedné sekce a přechod na další sekci.

Zobrazit všechny příkazy odpovídající řetězci s čísly sekcí

Manuálové stránky obsahující hledaný řetězec můžeme hledat pomocí -k vlajka. Pokud tedy chcete získat všechna čísla sekcí konkrétního příkazu na manuálové stránce, použijte -k možnost jako níže.

$ man -k uname

Ukázkový výstup:

arch (1)             - print machine hardware name (same as uname -m)
oldolduname (2)      - get name and information about current kernel
olduname (2)         - get name and information about current kernel
uname (1)            - print system information
uname (1posix)       - return system name
uname (2)            - get name and information about current kernel

Jak vidíte ve výše uvedeném výstupu, uvedli jsme všechny příkazy (tj. podřetězce), které odpovídají danému řetězci klíčového slova. Chcete-li přísně omezit hledání v rámci shodného řetězce, použijte:

$ man -k '^uname'

Ukázkový výstup:

uname (1)            - print system information
uname (1posix)       - return system name
uname (2)            - get name and information about current kernel

Alternativně můžete použít -f vlajka.

$ man -f uname

Ukázkový výstup:

uname (1)            - print system information
uname (2)            - get name and information about current kernel
uname (1posix)       - return system name

Pro více podrobností se prosím podívejte na manuálové stránky "man".

$ man man

Podívejte se také na další sekce nápovědy pro manuálové stránky.

$ man -k man

$ info man

Doporučeno: 

• Dobré alternativy k manuálním stránkám, které musí znát každý uživatel Linuxu
• Jak najít nejdelší mužskou stránku v Linuxu
• Jak snadno vyvolat zapomenuté příkazy Linuxu
• Jak vytvořit a udržovat své vlastní Man Pages
• Jak nainstalovat chybějící manuálové stránky příkazů na Ubuntu
• Pinfo – program CLI pro barevné čtení informačních a manuálových stránek

Doufám, že to pomůže.