.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "GDAL" "1" "Aug 18, 2026" "" "GDAL"
.SH NAME
gdal \- Main gdal entry point
.sp
Added in version 3.11.

.SH SYNOPSIS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Usage: gdal <COMMAND> [OPTIONS]
where <COMMAND> is one of:
  \- convert:  Convert a dataset (shortcut for \(aqgdal raster convert\(aq or \(aqgdal vector convert\(aq).
  \- dataset:  Commands to manage datasets.
  \- driver:   Command for driver specific operations.
  \- info:     Return information on a dataset (shortcut for \(aqgdal raster info\(aq or \(aqgdal vector info\(aq).
  \- mdim:     Multidimensional commands.
  \- pipeline: Process a dataset applying several steps.
  \- 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

\(aqgdal <FILENAME>\(aq can also be used as a shortcut for \(aqgdal info <FILENAME>\(aq.
And \(aqgdal read <FILENAME> ! ...\(aq as a shortcut for \(aqgdal pipeline <FILENAME> ! ...\(aq.
.EE
.UNINDENT
.UNINDENT
.SH RETURN STATUS CODE
.sp
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).
.SH EXAMPLES
.SS Example 1: Display the GDAL version
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal \-\-version
GDAL 3.13.3 \(dqIowa City\(dq, released 2026/08/13 (debug build)
.EE
.UNINDENT
.UNINDENT
.SS Example 2: Getting information on the file utm.tif (with JSON output)
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal info utm.tif
.EE
.UNINDENT
.UNINDENT
.SS Example 3: Converting file utm.tif to GeoPackage raster
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal convert utm.tif utm.gpkg
.EE
.UNINDENT
.UNINDENT
.SS Example 4: Getting information on all available commands and subcommands as a JSON document.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal \-\-json\-usage
.EE
.UNINDENT
.UNINDENT
.SS Example 5: Getting list of all formats supported by the current GDAL build, as text
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal \-\-formats
.EE
.UNINDENT
.UNINDENT
.SS Example 6: Search for Parquet in the list of all formats using jq
Bash
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal \-\-drivers | jq \(aq.[] | select(.short_name == \(dqParquet\(dq)\(aq
.EE
.UNINDENT
.UNINDENT
PowerShell
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal \-\-drivers | jq \(aq.[] | select(.short_name == \e\(dqParquet\e\(dq)\(aq
.EE
.UNINDENT
.UNINDENT
.SH AUTHOR
Even Rouault <even.rouault@spatialys.com>
.SH COPYRIGHT
1998-2026
.\" Generated by docutils manpage writer.
.