名
man - 書式を設定し、オンラインマニュアルページを表示する
manpath - マニュアルページの検索パスを決定する
シノプシス
man [ -acdfFhkKtwW ] [ --path ] [ -m システム ] [ -p string ] [ -C config_file ] [ -M pathlist ] [ -P pager ] [ -S section_list ] [ section ] name ...
DESCRIPTION
manは、オンラインのマニュアルページをフォーマットして表示します。 sectionを指定すると、 manはマニュアルのそのセクションだけを見ます。 nameは通常マニュアルページの名前で、通常はコマンド、関数、またはファイルの名前です。 しかし、 名前にスラッシュ( / )が含まれていると、 manはそれをファイル指定として解釈し、 man ./foo.5やman /cd/foo/bar.1.gzを実行することができます。
manがマニュアルページファイルを探す場所については、以下を参照してください。
オプション
-C config_file
使用する構成ファイルを指定します。 デフォルトは/etc/man.configです。 ( man.conf (5)を参照してください)。
-Mパス
マニュアルページを検索するディレクトリのリストを指定します。 ディレクトリはコロンで区切ります。 空のリストは、 -Mを全く指定しないのと同じです。 マニュアルページの検索パスを参照してください。
-Pページャー
使用するページャを指定します。 このオプションはMANPAGER環境変数をオーバーライドし、 PAGER環境変数を上書きします。 デフォルトでは、 manは/ usr / bin / less -isrを使用します。
-S section_list
リストは、検索するマニュアルセクションのコロンで区切られたリストです。 このオプションは、 MANSECT環境変数を無効にします。
-a
デフォルトでは、 manは見つかった最初のマニュアルページを表示した後に終了します。 このオプションを使用すると、最初のページだけでなく、名前と一致するすべてのマニュアルページを表示するようになります。
-c
最新のcatページが存在する場合でも、ソースmanページを再フォーマットします 。 これは、catページが異なる数の列を持つ画面用に書式設定されている場合、または書式設定済みのページが破損している場合に意味があります。
-d
実際にはマニュアルページを表示せず、デバッグ情報のゴブを表示してください。
-D
デバッグ情報の表示と印刷の両方を行います。
-f
whatisと同等です。
-Fまたは--preformat
書式のみ - 表示しません。
-h
1行のヘルプメッセージを表示して終了します。
-k
aproposに相当します。
-K
* all * manページで指定された文字列を検索します。 警告:これはおそらく非常に遅いです! セクションを指定すると役立ちます。 (ちょうど大まかな考えを与えるために、私のマシンでは、これは500ページのマニュアルページあたり約1分かかります)。
-mシステム
指定されたシステム名に基づいて検索するマニュアルページのセットを指定します。
-p string
nroffまたはtroffの前に実行するプリプロセッサのシーケンスを指定します。 すべてのインストールにプリプロセッサの完全なセットがあるわけではありません。 いくつかのプリプロセッサとそれを指定する文字は、eqn(e)、grap(g)、pic(p)、tbl(t)、vgrind(v)、refer(r)です。 このオプションは、 MANROFFSEQ環境変数を無効にします。
-t
/ usr / bin / groff -Tps -mandocを使用してマニュアルページをフォーマットし、出力をstdoutに渡します。 / usr / bin / groff -Tps -mandocからの出力は、印刷される前にいくつかのフィルターなどを通す必要があるかもしれません。
-wまたは--path
実際にはマニュアルページを表示しないで、フォーマットまたは表示されるファイルの場所を表示してください。 引数が指定されていない場合:manページでmanによって検索されるディレクトリのリストを(stdoutに)表示します。 manpathがmanへのリンクであれば、 "manpath"は "man --path"に相当します。
-W
-wと似ていますが、行ごとに1つずつファイル名を出力します。 これは、 man -aW manのようなシェルコマンドで便利です。 xargs ls -l
CATページ
manは、次のページが必要になったときに書式設定時間を節約するために、書式付きのマニュアルページを保存しようとします。 伝統的に、DIR / manXの書式化されたバージョンはDIR / catXに保存されますが、man dirからcat dirへの他のマッピングは/etc/man.configで指定できます。 必要なcatディレクトリが存在しない場合、 catページは保存されません。 80以外の行の長さにフォーマットされていると、catページは保存されません。man.confにNOCACHE行が含まれていると、catページは保存されません。
ユーザーをユーザーに説得させることは可能です。 catディレクトリにowner manとmode 0755(manでのみ書き込み可能)があり、catファイルにowner manとmode 0644または0444(manのみ書き込み可能、または書き込み可能でない)がある場合、普通のユーザはcatページに挿入するか、catディレクトリに他のファイルを置く。 manがsuidになっていない場合、catディレクトリには、すべてのユーザがそこにcatページを残すことができなければならないモード0777が必要です。
オプション-cは 、最近のcatページが存在する場合でも、ページを再フォーマットします。
手動ページの検索パス
manは、呼び出しオプションと環境変数、 /etc/man.config構成ファイル、組み込みの規則と経験則に基づいて、マニュアルページファイルを見つける洗練された方法を使用します。
まずmanのname引数にスラッシュ( / )が含まれていると、 manはそれがファイル仕様であるとみなし、検索は行われません。
しかし、通常の場合、 名前にスラッシュが含まれていない場合、 manはさまざまなディレクトリを検索し、その名前のトピックのマニュアルページとなるファイルを探します。
-M pathlistオプションを指定すると、 pathlistは、 manが検索するディレクトリをコロンで区切ったリストになります。
-Mを指定せずにMANPATH環境変数を設定すると、その変数の値はmanが検索するディレクトリのリストになります。
-MまたはMANPATHで明示的なパス・リストを指定しないと、 manは構成ファイル/etc/man.configの内容に基づいて独自のパス・リストを作成します。 構成ファイル内のMANPATHステートメントは、検索パスに含める特定のディレクトリを識別します。
さらに、 MANPATH_MAPステートメントは、コマンド検索パス(つまりPATH環境変数)に応じて検索パスに追加されます。 MANPATH_MAPステートメントは、コマンド検索パスに含まれる各ディレクトリについて、マニュアルページファイルの検索パスに追加するディレクトリを指定します。 manはPATH変数を調べ、対応するディレクトリをマニュアルページファイル検索パスに追加します。 したがって、 MANPATH_MAPを適切に使用すると、 man xyzコマンドを発行すると、 xyzコマンドを発行した場合に実行されるプログラムのマニュアルページが表示されます。
さらに、 MANPATH_MAP文を持たないコマンド検索パス( "コマンドディレクトリ"と呼ぶ)の各ディレクトリについて、 manは自動的にマニュアルページディレクトリを "近く"、つまりディレクトリのサブディレクトリとして探します。コマンドディレクトリ自体またはコマンドディレクトリの親ディレクトリに保存します。
/etc/man.configにNOAUTOPATH文を含めることで、自動的に "近く"の検索を無効にすることができます。
上記の検索パスの各ディレクトリで、 manはtopicという名前のファイルを検索します。 セクション番号にオプションの接尾辞があり、場合によっては圧縮接尾辞が付いています。 そのようなファイルが見つからない場合は、 man Nまたはcat Nというサブディレクトリを探します。ここで、 Nは手動セクション番号です。 ファイルがcat Nサブディレクトリにある場合、 manはそれがフォーマットされたマニュアルページファイル(catページ)であるとみなします。 さもなければ、 人はそれがフォーマットされていないと仮定します。 どちらの場合でも、ファイル名に( .gzのような)既知の圧縮サフィックスがある場合、 manはgzippedとみなします。
manが特定のトピックのマニュアルページをどこで見つけるか見たい場合は、-- path ( -w )オプションを使います。
重要: man コマンド ( %man )を使用して、特定のコンピュータでコマンドがどのように使用されているかを確認してください。