srcpath -- Command

Find source files
srcpath [-aw] [-p path] filename pattern ...

The command srcpath  expands the environmental variable SRCPATH, applies it
to each argument, and prints the full path of each unique result.

An  argument can  either be  a file  name or a  pattern.  For  example, the
command

    srcpath "*.[ch]"

finds all .c  and .h files on SRCPATH. By  default.  srcpath keeps only the
first file that it finds  with a given name.  srcpath automatically appends
`.' to  the beginning  of SRCPATH  so files in  the current  directory have
precedence.

srcpath recognizes the following command-line options:

-p path
   Use path as its path instead of SRCPATH. For example,

       srcpath -p ".:/usr/src/cmd" "*.c"

   tells srcpath  to search `.' and /usr/src/cmd  instead of  SRCPATH. Note
   that with  this option, srcpath does not automatically  place `.' at the
   beginning of the list.

-a Disable shadowing.   Normally, if srcpath finds a file  is found in more
   than one directory on the path, it prints only the first.  The -a option
   forces srcpath to print all instances of the file name.

-w By default, srcpath silently bypasses directories and matching files for
   which it  has no read  permission.  The -w  option causes it  to print a
   warning message when this happens.

See Also

commands,
find,
make,
PATH

© 2012 by Stephen A. Ness