Scroll to navigation

GDALMANAGE(1) GDAL GDALMANAGE(1)

NAME

gdalmanage - Identify, delete, rename and copy raster data files.

SYNOPSIS

Usage: gdalmanage [--help] [--help-general]


                  <mode> [-r] [-fr] [-u] [-f <format>]


                  <datasetname> [<newdatasetname>]


DESCRIPTION

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
List data format of file(s).
Create a copy of the dataset file with a new name.
Change the name of the dataset file.
Delete dataset file(s).


Recursively scan files/folders for dataset files.

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

Report failures if file type is unidentified.

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


AUTHOR

Frank Warmerdam <warmerdam@pobox.com>

COPYRIGHT

1998-2026

April 15, 2026