例: man(1)
, find(3)
, updatedb(2)
?
括弧内の数字 (英国の「括弧」) は何を意味しますか?
これは、コマンドのマニュアルページが割り当てられているセクションです。
これらは次のように分割されます
各セクションの元の説明は、Unixプログラマーズマニュアル(iiページ)に記載されています。
「foo(5)」として指定されたマニュアルページにアクセスするには、次のコマンドを実行します。
man 5 foo
コマンドがマニュアルに記載されているセクション。セクションのリストはマニュアルに記載されています。例えば:
man 1 man
man 3 find
これは、異なるセクションに類似またはまったく同じコマンドが存在する場合に役立ちます。
セクション番号が重要な理由は、何年も前にディスク容量が現在よりも問題であったとき、セクションを個別にインストールできたためです。
たとえば、多くのシステムには 1 と 8 しかインストールされていませんでした。最近では、代わりに Google でコマンドを検索する傾向があります。
@Ian G が言うように、それらはマニュアルページのセクションです。ただし、これをさらに一歩進めましょう。
man
1. を含むコマンドのマニュアル ページを参照するとman man
、次の 9 つのセクションが表示されます。DESCRIPTION
man is the system's manual pager. Each page argument given
to man is normally the name of a program, utility or func‐
tion. The manual page associated with each of these argu‐
ments is then found and displayed. A section, if provided,
will direct man to look only in that section of the manual.
The default action is to search in all of the available sec‐
tions following a pre-defined order ("1 n l 8 3 2 3posix 3pm
3perl 5 4 9 6 7" by default, unless overridden by the SEC‐
TION directive in /etc/manpath.config), and to show only the
first page found, even if page exists in several sections.
The table below shows the section numbers of the manual fol‐
lowed by the types of pages they contain.
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 eg /etc/passwd
6 Games
7 Miscellaneous (including macro packages and conven‐
tions), e.g. man(7), groff(7)
8 System administration commands (usually only for root)
9 Kernel routines [Non standard]
A manual page consists of several sections.
man <section_num> <cmd>
Linux コマンドを探し回っているとしましょう。OPEN(2)
pgはオンラインで見つけることができます: open(2) — Linux man page。
お使いの PC のマニュアル ページでこれを確認するには、単純に と入力しman 2 open
ます。
FOPEN(3)
用途man 3 fopen
など_
man <section_num> intro
セクションの紹介ページを読むには、、、、などのように入力man <section_num> intro
しman 1 intro
ます。man 2 intro
man 7 intro
すべての man ページのイントロを順番に表示するには、 を実行しますman -a intro
。セクション 1 の紹介ページが開きます。を押しqて終了し、 を押しEnterてセクション 8 のイントロを表示します。 を押しqて終了し、 を押しEnterてセクション 3 のイントロを表示します。完了するまでこのプロセスを続けます。を押すたびqに、メインのターミナル画面に戻りますが、インタラクティブなプロンプトのままで、次の行が表示されます。
--Man-- next: intro(8) [ view (return) | skip (Ctrl-D) | quit (Ctrl-C) ]
セクションの順序man -a intro
は次のとおりです。
man man
ページで説明されているように、この検索順序は意図的なものです。
The default action is to search in all of the available sections follow‐
ing a pre-defined order ("1 n l 8 3 2 3posix 3pm 3perl 5 4 9 6 7" by default, unless overrid‐
den by the SECTION directive in /etc/manpath.config)
なぜ彼らはこの順序を選んだのですか?わかりませんが(知っている場合はコメントで答えてください)、この順序が正しく意図的なものであることを理解してください.
また、他の UNIX では、セクションの指定方法が異なります。たとえば、solaris では次のようになります。
man -s 1 man
これは、コマンドが見つかったマニュアルページのセクションを示します。manコマンドの-sスイッチを使用して、検索を特定のセクションに制限できます。
マニュアルページを表示すると、左上にセクションの名前が表示されます。例:
ユーザーコマンドprintf(1)
標準Cライブラリ関数printf(3C)
したがって、C関数を検索しようとしていて、同じ名前を共有するユーザーコマンドのページを誤って表示したくない場合は、「man-s3C...」を実行します。