whereis コマンド
目的
プログラムのソース、バイナリー、またはマニュアルの位置を探します。
構文
所在 [ -s ] [ -b ] [ -m (M) ] [ -ウー ] [ { { -S (S) | -B | -M (M) } ディレクトリー ... }... 「-f」 ] ファイル ...
説明
whereis コマンドは、指定されたファイルのソース、バイナリー、およびマニュアルの各セクションの位置を探し出します。 名前を与えると、最初に先行パス名コンポーネントと形式 .ext (例えば .c) のすべての (単一の) 後書き拡張子が取り除かれます。 s. の接頭部 ソース・コード制御システム ( SCCSを参照) を使用した結果も説明されています。 次に、コマンドは要求されたプログラムを標準ロケーション・リストから見つけようとします。
無効なオプションを入力すると、使用方法メッセージが戻ります。 その他の場合、診断はありません。
フラグ
-b, -s, -m ,-u フラグのいずれかを与えると、 whereis コマンドは、それぞれバイナリー・セクション、ソース・セクション、マニュアル・セクション、または異常セクションのみ (またはそのうちの 2 つ) を検索します。
| 項目 | 説明 |
|---|---|
| -b | ファイルのバイナリー・セクションを検索します。 |
| -m | ファイルのマニュアル・セクションを検索します。 |
| -s | ファイルのソース・セクションを検索します。 |
| -u | 異常ファイルを検索します。 ファイルは、要求された各タイプのエントリーが 1 つなければ、異常と見なされます。 whereis
-m -u * と入力すると、現行ディレクトリー内に文書のないファイルが要求されます。 |
-B、-M、-S フラグを使用すると、whereis コマンドが検索する場所を変更または制限できます。 プログラムは実行速度を上げるために chdir サブルーチンを使用するので、-M、-S および -B フラグのディレクトリー・リストの既定パス名は絶対パス名でなくてはなりません。つまり、/ (スラッシュ) で始まるパス名を指定しなければなりません。
| 項目 | 説明 |
|---|---|
| -B | -b と同様です。ただし、検索対象にディレクトリーを追加します。 whereis コマンドがバイナリーの検索を行う場所を変更または制限します。 |
| -M | -m と同様です。ただし、検索対象にディレクトリーを追加します。 whereis コマンドがマニュアル・セクションの検索を行う場所を変更または制限します。 |
| -S | -s と同様です。ただし、検索対象にディレクトリーを追加します。 whereis コマンドがソースの検索を行う場所を変更または制限します。 |
| -f | 最後の -M、-S、または -B ディレクトリー・リストを終了し、ファイル名の開始シグナルを送信します。 |
例
/usr/ucb ディレクトリー内のファイルのうち、/usr/man/man1 ディレクトリー内で文書化されていないもの、あるいは /usr/src/cmd ディレクトリー内にソースがないものをすべて探すには、下記のように入力します。
cd /usr/ucb
whereis -u -M /usr/man/man1 -S /usr/src/cmd -f *ファイル
| 項目 | 説明 |
|---|---|
| /usr/share/man/* | マニュアル・ファイルが入っているディレクトリー。 |
| /sbin、 /etc、 /usr/{lib、bin、ucb、lpp} | バイナリー・ファイルが入っているディレクトリー。 |
| /usr/src/* | ソース・コード・ファイルが入っているディレクトリー。 |