Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
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, de-
     pending  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  multi-
	    ple files.

     <newdatasetname>
	    For  copy and rename modes, you provide a source filename and a tar-
	    get filename, just like copy and move commands in an operating  sys-
	    tem.

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  suc-
     cessful 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

				  Jun 05, 2026			   GDALMANAGE(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gdalmanage&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help