初心者のためのLinux manpathコマンドチュートリアル（5つの例）

Linuxのマニュアルページは、コマンドラインユーティリティに関する最初のサポートを提供する場所です。ほとんどの方がご存知のように、単に「man [コマンド名]」と入力すると、対応するマニュアルページが表示されます。しかし、これらのマニュアルページが検索されるパスを知っていますか？

このチュートリアルでは、この情報を示すユーティリティであるmanpathについて説明します。しかし、説明を始める前に、ここでのすべての例はUbuntu 18.04 LTSマシンでテストされていることを述べておく価値があります。

Linux manpathチュートリアル

Linuxのmanpathコマンドは、マニュアルページの検索パスを決定するのに役立ちます。以下がその構文です：

manpath [-qgdc?V] [-m system[,...]] [-C file]

そして、ツールのマニュアルページは次のように説明しています：

       $MANPATHが設定されている場合、manpathはその内容を単に表示し、警告を発します。設定されていない場合、manpathは適切なマニュアルページ階層の検索パスを決定し、結果を表示します。

       コロン区切りのパスは、man-db設定ファイル（/etc/manpath.config）およびユーザーの環境から得た情報を使用して決定されます。

以下は、manpathコマンドがどのように機能するかを理解するためのQ&A形式の例です。

Q1. manpathコマンドはどのように機能しますか？

基本的な使用法は非常に簡単です - オプションなしで「manpath」を実行するだけです。

manpath

例えば、上記のコマンドが私のシステムで生成した出力は次のとおりです：

/usr/local/man:/usr/local/share/man:/usr/share/man

このように、manpathはマニュアルページのためのコロン区切りのパスのリストを生成します。

man-db設定ファイル内で「global」と名付けられたすべてのパスを含むmanpathを生成したい場合は、-gコマンドラインオプションを使用できます。

Q2. manpathの代わりにcatpathを出力するにはどうすればよいですか？

これには、-cコマンドラインオプションを使用します。

manpath -c

ツールのマニュアルページはこの操作を次のように説明しています：

manpathが決定されると、各パス要素はその相対catpathに変換されます。

例えば、私のシステムで生成された出力は次のとおりです：

/var/cache/man/oldlocal:/var/cache/man/local:/var/cache/man

Q3. manpathにデバッグ情報を印刷させるにはどうすればよいですか？

これには、-dコマンドラインオプションを使用します。

manpath -d

例えば、このコマンドが私のシステムで生成した出力は次のとおりです：

このオプションは頻繁には使用しないかもしれませんが、ツールの出力をデバッグする必要がある場合には少なくとも知っておくべきです。

Q4. manpathが他のOSのマニュアル階層にアクセスするにはどうすればよいですか？

これには、-mコマンドラインオプションを使用します。ツールのマニュアルページはこのオプションを次のように説明しています：

-m system[,...], --systems=system[,...]  

              このシステムが他のオペレーティングシステムのマニュアル階層にアクセスできる場合、このオプションを使用してそれらをmanpathの出力に含めることができます。NewOSのマニュアルページ階層を含めるには、オプション-m NewOSを使用します。

              指定されたシステムは、カンマ区切りのオペレーティングシステム名の組み合わせである場合があります。ネイティブオペレーティングシステムのマニュアルページ階層を含めるには、システム名manを引数文字列に含める必要があります。このオプションは$SYSTEM環境変数を上書きします。

Q5. manpathがカスタム設定ファイルを使用するようにするにはどうすればよいですか？

デフォルトでは、manpathは次のファイルから情報を取得します：

/etc/manpath.config

しかし、他のファイルを読み込むようにmanpathを強制することもできます。これには、-Cコマンドラインオプションを使用します。

manpath -C NEWFILE-PATH

結論

Linuxのコマンドライン作業がマニュアルページの取り扱いを含む場合、manpathコマンドはあなたにとって便利なツールです。このチュートリアルでは、manpathコマンドのコマンドラインオプションの大部分について説明しました。ツールに関する詳細情報は、そのマニュアルページを参照してください。