|  |  | The `getwrite` Command

## The `getwrite` Command

The `getwrite` command gets information from the receiver and writes it to a file:

    getwrite IN-TYPES FORMAT [OUT-PARAMS] [OUT-TYPES] PATH

where

- `IN-TYPES` are the data types to get; the possible types are `WP`, `RT` and `TR`; `all` can be used as an abbreviation of `WP RT TR`;
- `FORMAT [OUT-PARAMS]` is the output file format and its parameters (if any); use `show formats` for a list of the currently accepted formats;
- `OUT-TYPES` may be absent in which case they are taken to be `IN-TYPES`, what is valid only when they are all valid for the selected output format; if `RT` occurs in `IN-TYPES` then `WP` can appear in `OUT-TYPES` but no other type "conversions" are allowed; some file formats impose that there is a single data type per file; `all` can be used as an abbreviation of `WP RT TR`;
- `PATH` is the path to the output file, or, in the case of the `Shapefile` format, the path to the Shapefiles basename (file extensions will be discarded). If the `PATH` is `stdout` output will be to the standard output unless the format is the `Shapefile` format (in which case the command fails). Existing files will be silently overwritten.

This command only works with Garmin receivers.

Examples: the command

    getwrite WP RT gpsman data/myWPRTs

download the waypoints and routes from the receiver and writes them to the file `data/myWPRTs` in GPSMan format, while the command

    getwrite TR Shapefile dim=3 pformat=UTM datum="WGS 84" shp/myTRs

downloads the tracks and writes them in Shapefiles with basename `myTRs` in the directory `shp`, keeping altitude information (3 dimensions) and using UTM coordinates for the WGS84 datum.

|  |  | The `getwrite` Command