gdal - Man Page

Name

gdal — Main gdal entry point

Added in version 3.11.

Synopsis

Usage: gdal <COMMAND> [OPTIONS]
where <COMMAND> is one of:
  - convert:  Convert a dataset (shortcut for 'gdal raster convert' or 'gdal vector convert').
  - driver:   Command for driver specific operations.
  - info:     Return information on a dataset (shortcut for 'gdal raster info' or 'gdal vector info').
  - mdim:     Multidimensional commands.
  - pipeline: Execute a pipeline (shortcut for 'gdal raster pipeline' or 'gdal vector pipeline').
  - raster:   Raster commands.
  - vector:   Vector commands.
  - vsi:      GDAL Virtual System Interface (VSI) commands.

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:
  --version               Display GDAL version and exit
  --drivers               Display driver list as JSON document

'gdal <FILENAME>' can also be used as a shortcut for 'gdal info <FILENAME>'.
And 'gdal read <FILENAME> ! ...' as a shortcut for 'gdal pipeline <FILENAME> ! ...'.

Examples

Example 1: Getting information on the file utm.tif (with JSON output)

$ gdal info utm.tif

Example 2: Converting file utm.tif to GeoPackage raster

$ gdal convert utm.tif utm.gpkg

Example 3: Getting information on all available commands and subcommands as a JSON document.

$ gdal --json-usage

Example 4: Getting list of all formats supported by the current GDAL build, as text

$ gdal --formats

Example 5: Getting list of all formats supported by the current GDAL build, as JSON.

$ gdal --formats --json

Author

Even Rouault <even.rouault@spatialys.com>

Info

Jul 12, 2025 GDAL