MAN(1)

名称
man - オンラインマニュアルを表示する

書式
man [-achw] [-C file] [-M path] [-m path] [section] name ...

解説
man は、 name で指定したタイトルのオンラインマニュアルを表示します。

sectionの指定は、 man が検索するオンラインマニュアルが格納されているディレクトリを 特定のセクションに限定するものです。セクションとオンラインマニュアルが 格納されているディレクトリとの関係は、man の設定ファイル (/etc/man.conf です。この内容に詳細については man.conf(5) 参照) のなかで指定されています。

引数が 1 つだけの場合や、最初の引数がセクションの指定ではない場合、 man は name が指定されたものとみなします。

オプションとしては以下のものがあります:

-a  man のデフォルトでは、最初に見つかったマニュアルだけ表示して終了しますが、 このオプションを指定すると、続けてマニュアルを検索し、ほかにも該当する マニュアルが見つかった場合は、それらをすべて表示します。

-C file
    デフォルトの設定ファイル /etc/man.conf のかわりに、 file で指定されたファイルを使用します。自分でオンラインマニュアルの環境 をカスタマイズするための機能です。設定ファイルの内容については、 man.conf(5) を参照してください。

-c  通常、標準出力が端末の場合、 man は、マニュアルを 1 ページずつ表示するためにページャとして more(1) を使用しますが、このオプションが指定された場合は、 標準出力にそのまま一気に出力します。標準出力が端末ではない場合は、 デフォルトでこの動作となります。

-h  “SYNOPSYS” (書式)の行だけを表示します。

-M path
    man の検索を、 path で指定したディレクトリに対して行います。複数のディレクトリを指定する場合 は、ディレクトリ名を ``:'' で区切ってください。この検索ディレクトリは、環境変数 MANPATH を使ってもセットすることができます。各ディレクトリの検索すべき サブディレクトリ、および、その検索順序は、 man の設定ファイル (man.conf) の ``_subdir'' 部で指定します。

-m path
    標準の検索ディレクトリに加え、 path で指定したディレクトリも検索するようにします。ここで指定したディレクトリは、 標準の検索ディレクトリや -M オプション、環境変数 MANPATH の指定などよりも先に検索されます。

-w  section および name で見つかったオンラインマニュアルの中身ではなく、 そのマニュアルファイルのパス名を表示します。

環境変数

MACHINE
    オンラインマニュアルのなかには特定のアーキテクチャだけを扱ったものもあるので、 man は通常の検索ディレクトリに加え、カレントのアーキテクチャ と同じ名前のサブディレクトリも検索します。ここは、一般エリアより前に 検索されます。環境変数 MACHINE としてアーキテクチャがセットされていた場合は、カレントのアーキテクチャの かわりに、このアーキテクチャが使用されます。

MANPATH
    標準の検索ディレクトリのかわりに、検索ディレクトリを指定します。

PAGER
    man がデフォルトで使用するページャ more(1) のかわりに、 PAGER で指定したプログラムを使用します。

関連ファイル
/etc/man.conf
    man のデフォルトの設定ファイル

関連項目
apropos(1), whatis(1), whereis(1), man.conf(5)

歴史
man コマンドは AT&T UNIX から登場しました。