Manuálové stránky v Linuxu jsou místem pro první úroveň podpory, pokud jde o nástroje příkazového řádku. Jak většina z vás ví, stačí napsat 'man [jméno-příkazu]' a objeví se odpovídající manuálová stránka. Ale znáte cestu, kde se tyto manuálové stránky hledají?
V tomto tutoriálu probereme manpath , nástroj, který vám tyto informace zobrazí. Ale než začneme s vysvětlením, stojí za zmínku, že všechny příklady zde byly testovány na počítači Ubuntu 18.04 LTS.
Výukový program pro manpath Linux
Příkaz manpath v Linuxu vám pomůže určit cestu pro vyhledávání manuálových stránek. Následuje jeho syntaxe:
manpath [-qgdc?V] [-m system[,...]] [-C file]
A zde je návod, jak to popisuje manuálová stránka nástroje:
If $MANPATH is set, manpath will simply display its contents and issue
a warning. If not, manpath will determine a suitable manual page hier?
archy search path and display the results.
The colon-delimited path is determined using information gained from
the man-db configuration file - (/etc/manpath.config) and the user's
environment.
Následuje několik příkladů ve stylu otázek a odpovědí, které by vám měly poskytnout dobrou představu o tom, jak příkaz manpath funguje.
O1. Jak funguje příkaz manpath?
Základní použití je docela jednoduché - stačí spustit 'manpath' bez jakékoli možnosti.
manpath
Zde je například to, co výše uvedený příkaz vytvořil ve výstupu v mém systému:
/usr/local/man:/usr/local/share/man:/usr/share/man
Takže můžete vidět, že manpath vytváří dvojtečkou oddělený seznam cest pro manuální stránky.
Všimněte si, že můžete použít volbu -g příkazového řádku v případě, že chcete vytvořit manpath sestávající ze všech cest pojmenovaných jako 'global' v konfiguračním souboru man-db.
Q2. Jak mít ve výstupu catpath místo manpath?
K tomu použijte volbu -c příkazového řádku.
manpath -c
Manuálová stránka nástroje vysvětluje tuto operaci následovně:
Once the manpath is determined, each path element is converted to its relative catpath.
Zde je například výstup vytvořený v mém systému:
/var/cache/man/oldlocal:/var/cache/man/local:/var/cache/man
Q3. Jak přimět manpath tisknout informace o ladění?
K tomu použijte volbu -d příkazového řádku.
manpath -d
Zde je například výstup, který tento příkaz vytvořil v mém systému:
Souhlasím, tuto možnost možná nepoužíváte příliš často, ale měli byste o ní vědět alespoň pro případ, že byste potřebovali ladit výstup nástroje.
O4. Jak zpřístupnit manpath manuální hierarchie jiných OS?
K tomu použijte volbu -m příkazového řádku. Manuálová stránka nástroje vysvětluje tuto možnost takto:
-m system[,...], --systems=system[,...]
If this system has access to other operating sys?
tem's manual hierarchies, this option can be used to
include them in the output of manpath. To include
NewOS's manual page hierarchies use the option -m
NewOS.
The system specified can be a combination of comma
delimited operating system names. To include the
native operating system's manual page hierarchies,
the system name man must be included in the argument
string. This option will override the $SYSTEM envi?
ronment variable.
O5. Jak přimět manpath používat vlastní konfigurační soubor?
Ve výchozím nastavení manpath načítá informace z následujícího souboru:
/etc/manpath.config
Pokud však chcete, můžete přinutit manpath číst jakýkoli jiný soubor. To můžete provést pomocí volby příkazového řádku -C.
manpath -C NEWFILE-PATH
Závěr
Pokud vaše práce na příkazovém řádku Linuxu zahrnuje práci s manuálovými stránkami, je pro vás příkaz manpath užitečným nástrojem. Zde v tomto tutoriálu jsme probrali většinu možností příkazového řádku manpath. Pro více informací o nástroji přejděte na jeho manuálovou stránku.