manコマンド｜コマンドの説明書を読む

書式

man コマンド名

そのコマンドの公式の説明書を開きます。 本物の環境では less で表示されるので、q を押すと戻ります。

まず打ってみる

$ man ls | head -12
名前
    ls - ディレクトリの内容を一覧表示する

概要
    ls [オプション]... [ファイル]...

説明
    FILEに関する情報を一覧表示します（デフォルトは現在のディレクトリ）。

オプション
    -a, --all
        . で始まる隠しファイルも表示する

| head -12 は先頭だけを取り出すための書き方です。 man ls だけを打つと、説明書の全体が開きます。

読む順番

上から全部読む必要はありません。 だいたい次の順で見れば足ります。

最初に読むのは名前と概要の2つだけで十分です。 やりたいことに合うオプションが見つかったら、そこだけ読みます。

中を検索する

表示中に / に続けて文字列を打つと、その位置まで飛べます。

• /-l … -l の説明を探す
• n … 次の一致へ
• q … 閉じる

オプションは数が多いので、上から探すより検索したほうが速いです。

実務での使いどころ

man は、うろ覚えのオプションを確かめるために開きます。

つまずきやすいところ

q で抜けます。 less と同じです。 説明書は読むだけの画面なので、q で閉じても何も起きません。

説明書が無いコマンドもあります。

$ man nosuchcmd
No manual entry for 'nosuchcmd'

打ち間違いか、そのコマンドが入っていないか、シェルの組み込みかのいずれかです。

全部読もうとしないでください。 man は網羅的に書かれているので、通読するようにはできていません。 必要な節だけを拾い読みするのが正しい使い方です。