NAME
shtool path - GNU shtool command dealing with shell path variables
SYNOPSIS
shtool path
[-s|--suppress]
[-r|--reverse]
[-d|--dirname]
[-b|--basename]
[-m|--magic]
[-p|--path path]
str [str ...]
DESCRIPTION
This command deals with shell CW$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
CWstdout plus an exit code of 0 if it was really found.
OPTIONS
The following command line options are available.
"-s,
Supress output. Useful to only test whether a program exists with the
help of the return code.
"-r,
Transform a forward path to a subdirectory into a reverse path.
"-d,
Output the directory name of str.
"-b,
Output the base name of str.
"-m,
Enable advanced magic search for "CWperl and CWcpp".
"-p,
Search in path. Default is to search in CW$PATH.
EXAMPLE
# 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`
HISTORY
The \s-1GNU\s0 shtool path command was originally written by Ralf S.
Engelschall <rse@engelschall.com> in 1998 for Apache. It was
later taken over into \s-1GNU\s0 shtool.
SEE ALSO
shtool(1), which(1).