info/GNU_which/draft/info/which.info

   1 This is which.info, produced by makeinfo version 6.8 from which.texi.
   2
   3 INFO-DIR-SECTION System administration
   4 START-INFO-DIR-ENTRY
   5 * Which: (which).            コマンドのフルパスを表示
   6 END-INFO-DIR-ENTRY
   7
   8
   9 このファイルは ‘which’ version 2.x を説明するものです。
  10
  11 Copyright © 2000 - 2015, by
  12
  13 Carlo Wood, Run on IRC <carlo@alinoe.com>
  14 RSA-1024 0x624ACAD5 1997-01-26                    Sign & Encrypt
  15 Fingerprint16 = 32 EC A7 B6 AC DB 65 A6  F6 F6 55 DD 1C DC FF 61
  16
  17 Permission is granted to make and distribute verbatim copies of
  18 this manual provided the copyright notice and this permission notice
  19 are preserved on all copies.
  20
  21 \1f
  22 File: which.info,  Node: Top,  Next: which プログラム,  Prev: (dir),  Up: (dir)
  23
  24 ‘which’: コマンドのフルパス表示
  25 *******************************
  26
  27 ‘which’ プログラムは（シェル）コマンドのフルパスを表示します。
  28
  29 This file documents ‘which’ version 2.21, updated 20 March 2015.
  30
  31 * Menu:
  32
  33 * which プログラム::    ‘which’ プログラム
  34 * which の起動::          ‘which’ の起動方法
  35 * オプションの概要::  コマンドラインオプションの概要
  36 * 返り値::                ‘which’ が返す値
  37 * 例::                      コマンドの実行例
  38 * バグ::                   既知のバグ
  39 * 関連項目::             関連する UNIX コマンド
  40 * さくいん::             さくいん
  41
  42 \1f
  43 File: which.info,  Node: which プログラム,  Next: which の起動,  Prev: Top,  Up: Top
  44
  45 1 ‘which’ プログラム
  46 ********************
  47
  48 ‘which’ は 1 つまたは複数の引数を取ります。その引数それぞれに対して、そ
  49 の引数がシェルプロンプトから入力された際に、実行されることになる実行モジ
  50 ュールのフルパスを stdout に出力します。 これを実現する際には、環境変数
  51 ‘PATH’ に列記されたディレクトリ内から実行ファイルやスクリプトを検索しま
  52 す。 これは ‘bash(1)’ と同じアルゴリズムを用いています。
  53
  54 \1f
  55 File: which.info,  Node: which の起動,  Next: オプションの概要,  Prev: which プログラム,  Up: Top
  56
  57 2 ‘which’ の実行
  58 ****************
  59
  60 ‘which’ の実行書式は以下のとおりです。
  61
  62      which [options] [--] programname [...]
  63
  64 * Menu:
  65
  66 * オプションの概要::  オプション概要
  67
  68 \1f
  69 File: which.info,  Node: オプションの概要,  Next: 返り値,  Prev: which の起動,  Up: Top
  70
  71 3 オプションの概要
  72 ******************
  73
  74 ‘--all’
  75 ‘-a’
  76      ‘PATH’ において見つかった実行ファイルをすべて表示します。最初に見つ
  77      かった一つだけではありません。
  78
  79 ‘--read-alias’
  80 ‘-i’
  81      標準入力からエイリアスを読み込んで、合致したものを標準出力します。
  82      これは which そのものを含む alias において、本オプションを合わせて
  83      利用すると便利です。 たとえば以下です。
  84      ‘alias which='alias | which -i'’
  85
  86 ‘--skip-alias’
  87      ‘--read-alias’ が指定されても無視します。which に対するエイリアスや
  88      関数の中で ‘--read-alias’ オプションを利用している場合であっても、
  89      明示的に通常の実行ファイルを検索する場合に利用できます。
  90
  91 ‘--read-functions’
  92      標準入力からシェル関数定義を読み込んで、合致したものを標準出力しま
  93      す。これは which そのものを含むシェル関数において、本オプションを合
  94      わせて利用すると便利です。たとえば以下です。
  95      ‘which() { declare -f | which --read-functions $@ }
  96      export -f which’
  97
  98 ‘--skip-functions’
  99      ‘--read-functions’ が指定されても無視します。which に対するエイリア
 100      スや関数の中で ‘--read-functions’ オプションを利用している場合であ
 101      っても、明示的に通常の実行ファイルを検索する場合に利用できます。
 102
 103 ‘--skip-dot’
 104      ‘PATH’ 内のディレクトリにうち、ドットで始まるディレクトリは除外しま
 105      す。
 106
 107 ‘--skip-tilde’
 108      チルダで始まる ‘PATH’ 内のディレクトリ、および ‘HOME’ ディレクトリ
 109      内に存在する実行ファイルは除外します。
 110
 111 ‘--show-dot’
 112      ‘PATH’ 内にドットで始まるディレクトリがあって、合致した実行ファイル
 113      がその中に見つかった場合には、フルパスでなく "./programname" と表示
 114      します。
 115
 116 ‘--show-tilde’
 117      ディレクトリが ‘HOME’ に合致した場合、チルダを表示します。 このオプ
 118      ションは root ユーザーが実行した際には無視されます。
 119
 120 ‘--tty-only’
 121      tty 上でない場合、この右側に指定されたオプションの実行を停止します
 122      。
 123
 124 ‘--version, -v, -V’
 125      バージョン情報を標準出力して正常終了します。
 126
 127 ‘--help’
 128      利用方法を標準出力して正常終了します。
 129
 130 \1f
 131 File: which.info,  Node: 返り値,  Next: 例,  Prev: オプションの概要,  Up: Top
 132
 133 4 返り値
 134 ********
 135
 136 ‘which’ は、処理に失敗した引数の数を返します。また ‘programname’ が指定
 137 されなかった場合は -1 を返します。
 138
 139 \1f
 140 File: which.info,  Node: 例,  Next: バグ,  Prev: 返り値,  Up: Top
 141
 142 5 例
 143 ****
 144
 145 本ユーティリティーを利用するには、‘which’ に対して、エイリアスを追加する
 146 (C シェルの場合) 、あるいはシェル関数を追加する (Bourne シェル) 方法が推
 147 奨されます。たとえば以下のようにします。
 148
 149    [ba]sh:
 150
 151      which ()
 152      {
 153        (alias; declare -f) | /usr/bin/which --tty-only --read-alias --read-functions --show-tilde --show-dot $@
 154      }
 155      export -f which
 156
 157    [t]csh:
 158
 159      alias which 'alias | /usr/bin/which --tty-only --read-alias --show-dot --show-tilde'
 160
 161 この方法にすると、端末から起動した際には、わかりやすく ~/ や ./ を表示し
 162 ます。一方でスクリプトから実行した際には、フルパスを表示します。
 163
 164      > which q2
 165      ~/bin/q2
 166      > echo `which q2`
 167      /home/carlo/bin/q2
 168
 169 \1f
 170 File: which.info,  Node: バグ,  Next: 関連項目,  Prev: 例,  Up: Top
 171
 172 6 バグ
 173 ******
 174
 175 ‘HOME’ ディレクトリは、環境変数 ‘HOME’ を調べることで決定されますが、こ
 176 の変数が存在しない場合には、その処理がキャンセルされます。‘which’ は 2 つ
 177 の同等のディレクトリであっても、その 1 つにシンボリックリンクを使ったパ
 178 スが含まれている場合に、別のディレクトリと取り扱ってしまいます。
 179
 180 \1f
 181 File: which.info,  Node: 関連項目,  Next: さくいん,  Prev: バグ,  Up: Top
 182
 183 7 関連項目
 184 **********
 185
 186 ‘bash(1)’
 187
 188 \1f
 189 File: which.info,  Node: さくいん,  Prev: 関連項目,  Up: Top
 190
 191 さくいん
 192 ********
 193
 194 \0\b[index\0\b]
 195 * Menu:
 196
 197 * --all:                                 オプションの概要.     (line  6)
 198 * --help:                                オプションの概要.     (line 59)
 199 * --read-alias:                          オプションの概要.     (line 11)
 200 * --read-functions:                      オプションの概要.     (line 23)
 201 * --show-dot:                            オプションの概要.     (line 43)
 202 * --show-tilde:                          オプションの概要.     (line 48)
 203 * --skip-alias:                          オプションの概要.     (line 18)
 204 * --skip-dot:                            オプションの概要.     (line 35)
 205 * --skip-functions:                      オプションの概要.     (line 30)
 206 * --skip-tilde:                          オプションの概要.     (line 39)
 207 * --tty-only:                            オプションの概要.     (line 52)
 208 * --version:                             オプションの概要.     (line 56)
 209 * -a:                                    オプションの概要.     (line  6)
 210 * -i:                                    オプションの概要.     (line 11)
 211 * -v:                                    オプションの概要.     (line 56)
 212 * -V:                                    オプションの概要.     (line 56)
 213 * aliases, handling of:                  例.                   (line  6)
 214 * Bugs, known:                           バグ.                 (line  6)
 215 * Command line Options:                  オプションの概要.     (line  6)
 216 * Description of which:                  which プログラム.     (line  6)
 217 * Examples:                              例.                   (line  6)
 218 * Options, command line:                 オプションの概要.     (line  6)
 219 * Overview of command line options:      オプションの概要.     (line  6)
 220 * Return value of which:                 返り値.               (line  6)
 221 * Synopsis:                              which の起動.         (line  6)
 222 * which の実行:                          which の起動.         (line  6)
 223
 224
 225 \1f
 226 Tag Table:
 227 Node: Top\7f662
 228 Node: which プログラム\7f1450
 229 Node: which の起動\7f2108
 230 Node: オプションの概要\7f2433
 231 Node: 返り値\7f5201
 232 Node: 例\7f5471
 233 Node: バグ\7f6388
 234 Node: 関連項目\7f6904
 235 Node: さくいん\7f7033
 236 \1f
 237 End Tag Table
 238
 239 \1f
 240 Local Variables:
 241 coding: utf-8
 242 End: