GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  SHTOOL-PATH (1)

.ds Aq ’

NAME

shtool path - GNU shtool command dealing with shell path variables

CONTENTS

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@engelschall.com> in 1998 for Apache. It was later taken over into GNU shtool.

SEE ALSO

shtool(1), which(1).
Search for    or go to Top of page |  Section 1 |  Main Index


18-Jul-2008 SHTOOL-PATH.TMP (1) shtool 2.0.8

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.