1Install 2======= 3 4You will need an ANSI C compiler (like gcc) to compile this package. 5 6Just type `make', followed by `make install'. 7 8History 9======= 10 11The main difference with version 1.0 by Paul Vixie is that this 12version will not return directory names as being executables 13and that by default it will expand a leading "./" and "~/" to 14its full path on output. 15 16The -all option has been added in example of a version of which 17on Ultrix. They use `-a' as option. 18 19The --read-alias idea has been copied from a version of which by 20Maarten Litmaath called `which-v6', he was using `-i' as option 21which stands for `interactive'. 22 23Manual page 24=========== 25 26 27NAME 28 which - shows the full path of (shell) commands. 29 30SYNOPSIS 31 which [options] [--] programname [...] 32 33DESCRIPTION 34 Which takes one or more arguments. For each of its arguments it prints 35 to stdout the full path of the executables that would have been exe- 36 cuted when this argument had been entered at the shell prompt. It does 37 this by searching for an executable or script in the directories listed 38 in the environment variable PATH using the same algorithm as bash(1). 39 40 This man page is generated from the file which.texinfo. 41 42OPTIONS 43 --all, -a 44 Print all matching executables in PATH, not just the first. 45 46 --read-alias, -i 47 Read aliases from stdin, reporting matching ones on stdout. This is 48 useful in combination with using an alias for which itself. For 49 example 50 alias which='alias | which -i'. 51 52 --skip-alias 53 Ignore option `--read-alias', if any. This is useful to explicity 54 search for normal binaries, while using the `--read-alias' option 55 in an alias or function for which. 56 57 --read-functions 58 Read shell function definitions from stdin, reporting matching ones 59 on stdout. This is useful in combination with using a shell func- 60 tion for which itself. For example: 61 which() { declare -f | which --read-functions $@ } 62 export -f which 63 64 --skip-functions 65 Ignore option `--read-functions', if any. This is useful to explic- 66 ity search for normal binaries, while using the `--read-functions' 67 option in an alias or function for which. 68 69 --skip-dot 70 Skip directories in PATH that start with a dot. 71 72 --skip-tilde 73 Skip directories in PATH that start with a tilde and executables 74 which reside in the HOME directory. 75 76 --show-dot 77 If a directory in PATH starts with a dot and a matching executable 78 was found for that path, then print "./programname" rather than the 79 full path. 80 81 --show-tilde 82 Output a tilde when a directory matches the HOME directory. This 83 option is ignored when which is invoked as root. 84 --version,-v,-V 85 Print version information on standard output then exit success- 86 fully. 87 88 --help 89 Print usage information on standard output then exit successfully. 90 91RETURN VALUE 92 Which returns the number of failed arguments, or -1 when no `program- 93 name' was given. 94 95EXAMPLE 96 The recommended way to use this utility is by adding an alias (C shell) 97 or shell function (Bourne shell) for which like the following: 98 99 [ba]sh: 100 101 which () 102 { 103 (alias; declare -f) | /usr/bin/which --tty-only --read-alias --read-functions --show-tilde --show-dot $@ 104 } 105 export -f which 106 107 [t]csh: 108 109 alias which 'alias | /usr/bin/which --tty-only --read-alias --show-dot --show-tilde' 110 111 This will print the readable ~/ and ./ when starting which from your 112 prompt, while still printing the full path when used from a script: 113 114 > which q2 115 ~/bin/q2 116 > echo `which q2` 117 /home/carlo/bin/q2 118 119 120BUGS 121 The HOME directory is determined by looking for the HOME environment 122 variable, which aborts when this variable doesn't exist. Which will 123 consider two equivalent directories to be different when one of them 124 contains a path with a symbolic link. 125 126AUTHOR 127 Carlo Wood <carlo@gnu.org> 128 129SEE ALSO 130 bash(1) 131 132 133 134 WHICH(1) 135