manual/util-linux/release/man1/whereis.1

   1 .\" Copyright (c) 1980, 1990 The Regents of the University of California.
   2 .\" All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\" 3. All advertising materials mentioning features or use of this software
  13 .\"    must display the following acknowledgement:
  14 .\"     This product includes software developed by the University of
  15 .\"     California, Berkeley and its contributors.
  16 .\" 4. Neither the name of the University nor the names of its contributors
  17 .\"    may be used to endorse or promote products derived from this software
  18 .\"    without specific prior written permission.
  19 .\"
  20 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  23 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  30 .\" SUCH DAMAGE.
  31 .\"
  32 .\" @(#)whereis.1 from UCB 4.2
  33 .\"
  34 .\" Japanese Version Copyright (c) 2001 Yuichi SATO
  35 .\"         all rights reserved.
  36 .\" Translated Sat Feb 17 03:19:58 JST 2001
  37 .\"         by Yuichi SATO <sato@complex.eng.hokudai.ac.jp>
  38 .\"
  39 .TH WHEREIS 1 "8 May 1994"
  40 .SH 名前
  41 whereis \- コマンドのバイナリ・ソース・man ページの場所を示す
  42 .SH 書式
  43 .B whereis
  44 [
  45 .B \-bmsu
  46 ] [
  47 .B \-BMS
  48 .IR directory .\|.\|.
  49 .B \-f
  50 ]
  51 \fIfilename\fP\|
  52 \&.\|.\|.
  53 .IX  "whereis command"  ""  "\fLwhereis\fP \(em find program"
  54 .IX  find "program \(em \fLwhereis\fP"
  55 .IX  "locate program"  ""   "locate program \(em \fLwhereis\fP"
  56 .IX  command  locate  ""   "locate \(em \fLwhereis\fP"
  57 .SH 説明
  58 .B whereis
  59 は指定したファイルのソース・バイナリ・man ページセクションの場所を示す。
  60 与えられた名前は、最初に始めのパス名の部分が取り除かれ、次に
  61 .BR .c
  62 のような
  63 .BI . ext
  64 という形式の拡張子が取り除かれる。
  65 ソースコード管理に使われている
  66 .B s.
  67 というプレフィックスがついたファイルも表示される。
  68 .B whereis
  69 は、標準的な Linux ファイル階層中で指定したプログラムを探す。
  70 .SH オプション
  71 .TP
  72 \fB\-b
  73 バイナリのみを探す。
  74 .TP
  75 .B \-m
  76 man ページセクションのみを探す。
  77 .TP
  78 .B \-s
  79 ソースのみを探す。
  80 .TP
  81 .B \-u
  82 通常とは異なるエントリを探す。
  83 要求されるタイプの 1 つのエントリがファイルにない場合、
  84 通常とは異なるファイルと呼ばれる。
  85 よって、
  86 .RB ` "whereis\ \ \-m\ \ \-u\ \ *" '
  87 は、カレントディレクトリのファイルから man ページがないものを探す。
  88 .TP
  89 .B \-B
  90 .B whereis
  91 がバイナリを探すディレクトリを変更または制限する。
  92 .TP
  93 .B \-M
  94 .B whereis
  95 が man ページセクションを探すディレクトリを変更または制限する。
  96 .TP
  97 .B \-S
  98 .B whereis
  99 がソースを探すディレクトリを変更または制限する。
 100 .TP
 101 .B \-f
 102 直前のディレクトリリストを終了させ、
 103 ファイル名指定の開始であることを示す。
 104 .BR \-B ,
 105 .BR \-M ,
 106 .B \-S
 107 オプションのいずれかを使う場合は、
 108 このオプションを
 109 .IR 使わなければならない 。
 110 .SH 例
 111 .B /usr/bin
 112 にあるファイルから
 113 .B /usr/man/man1
 114 に man ページがなく
 115 .BR /usr/src
 116 にソースがあるようなもの探す。
 117 .IP
 118 .nf
 119 .ft B
 120 example% cd /usr/bin
 121 example% whereis \-u \-M /usr/man/man1 \-S /usr/src \-f *
 122 .fi
 123 .ft R
 124 .SH ファイル
 125 .TP 20
 126 .B /{bin,sbin,etc}
 127 .TP
 128 .B /usr/{lib,bin,old,new,local,games,include,etc,src,man,sbin,
 129 .B X386,TeX,g++-include}
 130 .TP
 131 .B /usr/local/{X386,TeX,X11,include,lib,man,etc,bin,games,emacs}
 132 .SH 関連項目
 133 .BR chdir (2V)
 134 .SH バグ
 135 .B whereis
 136 は実行を速くするために
 137 .BR chdir (2V)
 138 を使うので、
 139 .BR \-M ,
 140 .BR \-S ,
 141 .B \-B
 142 に指定するパス名はフルパスでなければならない;
 143 つまりパス名は
 144 .RB ` / '
 145 で始まっていなければならない。
 146 .PP
 147 .B whereis
 148 はハードコードされたパスを持っているので、
 149 探しているものとは違うものが見つかるかもしれない。