---
name: "gdalmanage"
section: "1"
platform: "linux"
package: "gdal"
version: "3.13.3-6"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/gdalmanage"
---

# gdalmanage(1)

Identify, delete, rename and copy raster data files.

## 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

  - **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
```

## AUTHOR

Frank Warmerdam \<warmerdam@pobox.com\>

## COPYRIGHT

1998-2026