NAME

       gmtwhich - Find full path to specified files

SYNOPSIS

       gmtwhich files [  ] [  ] [  ] [ [level] ]

       Note: No space is allowed between the option flag and the associated arguments.

DESCRIPTION

       gmtwhich  reports  the  full paths to the files given on the command line. We look for the
       file in (1) the current directory, (2) in $GMT_USERDIR (if defined), (3)  in  $GMT_DATADIR
       (if  defined).  If  found we print the full path name to the file, just the directory (see
       -D), or a confirmation (see -C). The $GMT_USERDIR and $GMT_DATADIR  environment  variables
       can  be  colon-separated list of directories, and we search recursively down any directory
       that ends with / (i.e., /export/data is a single directory whereas /export/data/  will  be
       searched recursively.)

REQUIRED ARGUMENTS

       files  One or more file names of any data type (grids, tables, etc.).

OPTIONAL ARGUMENTS

       -A     Only  consider  files  that  the  user has permission to read [Default consider all
              files found].

       -C     Instead of reporting the paths, print the confirmation Y if the file is found and N
              if it is not.

       -D     Instead of reporting the paths, print the directories that contains the files.

       -V[level] (more ...)
              Select verbosity level [c].

       -^ or just -
              Print a short message about the syntax of the command, then exits (NOTE: on Windows
              use just -).

       -+ or just +
              Print  an  extensive  usage  (help)  message,  including  the  explanation  of  any
              module-specific option (but not the GMT common options), then exits.

       -? or no arguments
              Print  a  complete usage (help) message, including the explanation of options, then
              exits.

       --version
              Print GMT version and exit.

       --show-datadir
              Print full path to GMT share directory and exit.

SEE ALSO

       gmt

COPYRIGHT

       2015, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe