shtool-path

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).