woist
Package: WA2L/edrc 1.5.57
Section: General Commands (3)
Updated: 26 June 2005
Index
Return to Main Contents
NAME
woist - Search a Path For a File
SYNOPSIS
edrc/bin/woist
[
-a
] [
-xdflrs
] [
-p directory-list
]
file
AVAILABILITY
WA2L/edrc
DESCRIPTION
does what whereis should have done. It examines a list of directories and looks for a file whose
attributes match the corresponding arguments. The default is to look on $PATH for executable files,
but any of the standard arguments to
test
may be given, so that it is possible to look for a readable file, a writable file, or a non-empty file
on any arbitrary path. If the file is found in one of directories in the path, the files path is
printed to stdout.
If the file name contains a slash ( "/" ), the directory-list is ignored. The specified file is
checked according to the conditions; if it exists and matches, its path is printed to stdout.
OPTIONS
- -a
-
All - list all instances found in all directories on the path. Otherwise only print the first one found.
- -dfhrsx
-
test
argument. Only one may be specified. Options are:
- -d
-
Directory
- -f
-
Existing File of Any Type
- -h
-
Symbolic Link
- -r
-
Readable file
- -s
-
Non-Empty File
- -w
-
Writable File
- -x
-
Executable File (default)
- -p 'directory-list'
-
List of directories to examine. Default is $PATH, but any colon separated list
of directories may be used. The list is echoed by csh(1), to ensure that tilde-usernames
in a directory have been properly resolved.
- file
-
File to be found.
EXIT STATUS
- 0
-
file found
- 1
-
error
- 4
-
usage listed or file not found
EXAMPLES
-
SEE ALSO
edrcintro(1),
whereis(1)
FILES
-
NOTES
Parts of this manpage were extracted from the documentation of
the
SFI-Director
and modified to fit to the
WA2L/edrc
package. See
http://sfidirector.sourceforge.net
for more information about the
SFI-Director.
BUGS
-
AUTHOR
woist was developed by Peter Stevens, SFI and integrated into
WA2L/edrc
by Christian Walther. Send suggestions
and bug reports to wa2l@users.sourceforge.net .
COPYRIGHT
Copyright © 2008
Christian Walther
This is free software; see
edrc/doc/COPYING
for copying conditions. There is ABSOLUTELY NO WARRANTY; not
even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
This document was created by man2html
using the manual pages.
Time: 16:55:08 GMT, August 28, 2024