# which¶

Find full path to specified files

## Synopsis¶

gmt which files [ -A ] [ -C ] [ -D ] [ -G[c|l|u] ] [ -V[level] ] [ --PAR=value ]

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

## Description¶

which 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), or (4) in $GMT_CACHEDIR (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.
-G[c|l|u]
-V[level] (more …)
Select verbosity level [c].
-^ or just -
Print a short message about the syntax of the command, then exits (NOTE: on Windows just use -).
-+ 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 all options, then exits.
--PAR=value
Temporarily override a GMT default setting; repeatable. See gmt.conf for parameters.

## Examples¶

To see the full path to the file myjunk.txt, use

gmt which myjunk.txt


To download the 10 arc-minute global relief file from the GMT data site, use

gmt which -Gu @earth_relief_10m.grd


which will print the path (after downloading if not already present). The file will be placed in the user’s GMT_USER_DIR. To obtain a GMT example or test file from the GMT cache site, try

gmt which -Gc @hotspots.txt