gmtwhich — GMT 5.1.1 documentation

### Navigation

- index
- next
- previous
- Project Home »
- GMT 5.1.1 documentation »
- GM »
- Search:

# gmtwhich

gmtwhich - Find full path to specified files

## Synopsis

gmtwhich files [ -A ] [ -C ] [ -D ] [ -V[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].

-^
  Print a short message about the syntax of the command, then exits (NOTE: on Windows use just -).
+
  Print an extensive usage (help) message, including the explanation of any module-specific option (but not the GMT common options), then exits.
-?
  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

### Navigation

- index
- next
- previous
- Project Home »
- GMT 5.1.1 documentation »
- GM »
- Search: