shtool−path − GNU shtool command dealing with shell path variables
shtool path [−s|−−suppress] [−r|−−reverse] [−d|−−dirname] [−b|−−basename] [−m|−−magic] [−p|−−path path] str [str ...]
This command deals with shell $PATH variables. It can find a program through one or more filenames given by one or more str arguments. It prints the absolute filesystem path to the program displayed on "stdout" plus an exit code of 0 if it was really found.
The following command line options are available.
−s, −−suppress
Suppress output. Useful to only test whether a program exists with the help of the return code.
−r, −−reverse
Transform a forward path to a subdirectory into a reverse path.
−d, −−dirname
Output the directory name of str.
−b, −−basename
Output the base name of str.
−m, −−magic
Enable advanced magic search for ""perl"" and ""cpp"".
−p, −−path path
Search in path. Default is to search in $PATH.
# shell script awk=`shtool path −p "${PATH}:." gawk nawk awk` perl=`shtool path −m perl` cpp=`shtool path −m cpp` revpath=`shtool path −r path/to/subdir`
The GNU shtool path command was originally written by Ralf S. Engelschall <rse AT engelschall DOT com> in 1998 for Apache. It was later taken over into GNU shtool.