shtool-path (1) Linux Manual Page

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

OPTIONS

The following command line options are available.

-s, –suppress

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

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 GNU shtool path command was originally written by Ralf S. Engelschall <rse [at] engelschall.com> in 1998 for Apache. It was later taken over into GNU shtool.

SEE ALSO

shtool(1), which(1).

Index