gdal dataset rename

Added in version 3.12.

Rename files of a dataset

gdal dataset rename rename the dataset file(s), including potential side-car/associated files.

Synopsis

Usage: gdal dataset rename [OPTIONS] <SOURCE> <DESTINATION>

Rename files of a dataset.

Positional arguments:
  --source <SOURCE>            Source dataset name [required]
  --destination <DESTINATION>  Destination dataset name [required]

Common Options:
  -h, --help                   Display help message and exit
  --json-usage                 Display usage as JSON document and exit
  --config <KEY>=<VALUE>       Configuration option [may be repeated]

Options:
  --overwrite                  Whether overwriting existing output is allowed

Advanced Options:
  -f, --format <FORMAT>        Dataset format

Options

--source <FILENAME>

Source file name or directory name. Required.

--destination <FILENAME>

Destination file name or directory name. Required.

-f, ---format <FORMAT>

Dataset format. Overrides the automatic format detection.

--overwrite

Allow program to overwrite existing target file or dataset. Otherwise, by default, gdal errors out if the target file or dataset already exists.

Examples

Example 1: Rename a dataset

$ gdal dataset rename old_name.tif new_name.tif