shtool-path(1)

Usage

shtool path [{-s | --suppress}] [{-r | --reverse}] [{-d | --dirname}] [{-b | --basename}] [{-m | --magic}] [{-p | --path path}] str [str ...]

Overview

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

Examples

 #   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`

Releases

11 releases since Debian 3.1 (Sarge); the text changed 5 times.

Referred to by