# gdal

Added in version 3.11.

Main "gdal" entry point.

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