gdalmanage(1)

gdalmanage1

Identify, delete, rename and copy raster data files.

Usage

Usage: gdalmanage [--help] [--help-general]
                  <mode> [-r] [-fr] [-u] [-f <format>]
                  <datasetname> [<newdatasetname>]

Overview

The gdalmanage program can perform various operations on dataset files, depending on the chosen mode. This includes identifying dataset types and deleting, renaming or copying the files.

<mode>

Mode of operation

identify <datasetname>:

List data format of file(s).

copy <datasetname> <newdatasetname>:

Create a copy of the dataset file with a new name.

rename <datasetname> <newdatasetname>:

Change the name of the dataset file.

delete <datasetname>:

Delete dataset file(s).

-r

Recursively scan files/folders for dataset files.

-fr

Recursively scan folders for dataset files, forcing recursion in folders recognized as valid formats.

-u

Report failures if file type is unidentified.

-f <format>

Specify format of dataset file if unknown by the application. Uses short data format name (e.g. GTiff).

<datasetname>

Raster file to operate on. With identify may be repeated for multiple files.

<newdatasetname>

For copy and rename modes, you provide a source filename and a target filename, just like copy and move commands in an operating system.

Return status code

The program returns status code 0 in case of success, and non-zero in case of error (non-blocking errors emitted as warnings are considered as a successful execution).

Examples

Using identify mode

Report the data format of the dataset file by using the identify mode and specifying a data file name:

$ gdalmanage identify NE1_50M_SR_W.tif
NE1_50M_SR_W.tif: GTiff

Recursive mode will scan subfolders and report the data format:

$ gdalmanage identify -r 50m_raster/
NE1_50M_SR_W/ne1_50m.jpg: JPEG
NE1_50M_SR_W/ne1_50m.png: PNG
NE1_50M_SR_W/ne1_50m_20pct.tif: GTiff
NE1_50M_SR_W/ne1_50m_band1.tif: GTiff
NE1_50M_SR_W/ne1_50m_print.png: PNG
NE1_50M_SR_W/NE1_50M_SR_W.aux: HFA
NE1_50M_SR_W/NE1_50M_SR_W.tif: GTiff
NE1_50M_SR_W/ne1_50m_sub.tif: GTiff
NE1_50M_SR_W/ne1_50m_sub2.tif: GTiff

Using copy mode

Copy the dataset:

$ gdalmanage copy NE1_50M_SR_W.tif ne1_copy.tif

Using rename mode

Rename dataset:

$ gdalmanage rename NE1_50M_SR_W.tif ne1_rename.tif

Using delete mode

Delete the dataset:

gdalmanage delete NE1_50M_SR_W.tif

Releases

7 releases since Debian 8 (Jessie); the text changed 6 times.

  1. 8
  2. 9
  3. 10
  4. 11
  5. 12
  6. 13
  7. Arch

-fr since Debian 13 (Trixie); -r since Debian 11 (Bullseye); -u since Debian 11 (Bullseye).

Author

Frank Warmerdam <[email protected]>

From gdal 3.13.3-6 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.