.\" 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 "GDALINFO" "1" "Aug 18, 2026" "" "GDAL"
.SH NAME
gdalinfo \- Lists various information about a GDAL supported raster dataset
.SH SYNOPSIS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Usage: gdalinfo [\-\-help] [\-\-long\-usage] [\-\-help\-general]
                [\-json] [\-mm]
                [[\-stats]|[\-approx_stats]]
                [\-hist]
                [\-nogcp] [\-nomd] [\-norat] [\-noct] [\-nofl] [\-nonodata] [\-nomask]
                [\-checksum] [\-listmdd] [\-proj4]
                [\-wkt_format <WKT1|WKT1_ESRI|WKT2|WKT2_2015|WKT2_2018|WKT2_2019>]
                [\-sd <n>] [\-oo <NAME>=<VALUE>]... [\-if <format>]...
                [\-mdd <domain>|all]
                <dataset_name>
.EE
.UNINDENT
.UNINDENT
.SH DESCRIPTION
.sp
\fBgdalinfo\fP program lists various information about a GDAL supported
raster dataset.
.sp
The following command line parameters can appear in any order
.sp
\fBTIP:\fP
.INDENT 0.0
.INDENT 3.5
Equivalent in new \(dqgdal\(dq command line interface:
.sp
See \fI\%gdal raster info\fP\&.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help
Show this help message and exit
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-general
Gives a brief usage message for the generic GDAL commandline options and exit.
.UNINDENT
.INDENT 0.0
.TP
.B \-json
Display the output in json format. Since GDAL 3.6, this includes key\-value
pairs useful for building a \X'tty: link https://github.com/radiantearth/stac-spec/blob/v1.0.0/item-spec/item-spec.md'\fI\%STAC item\fP\X'tty: link'
, including statistics and histograms if \fB\-stats\fP or \fB\-hist\fP flags are
passed, respectively.
.UNINDENT
.INDENT 0.0
.TP
.B \-mm
Force computation of the actual min/max values for each band in the
dataset.
.UNINDENT
.INDENT 0.0
.TP
.B \-stats
Read and display image statistics. Force computation if no
statistics are stored in an image.
.UNINDENT
.INDENT 0.0
.TP
.B \-approx_stats
Read and display image statistics. Force computation if no
statistics are stored in an image. However, they may be computed
based on overviews or a subset of all tiles. Useful if you are in a
hurry and don\(aqt need precise stats.
.UNINDENT
.INDENT 0.0
.TP
.B \-hist
Report histogram information for all bands.
.UNINDENT
.INDENT 0.0
.TP
.B \-nogcp
Suppress ground control points list printing. It may be useful for
datasets with huge amount of GCPs, such as L1B AVHRR or HDF4 MODIS
which contain thousands of them.
.UNINDENT
.INDENT 0.0
.TP
.B \-nomd
Suppress metadata printing. Some datasets may contain a lot of
metadata strings.
.UNINDENT
.INDENT 0.0
.TP
.B \-norat
Suppress printing of raster attribute table.
.UNINDENT
.INDENT 0.0
.TP
.B \-noct
Suppress printing of color table.
.UNINDENT
.INDENT 0.0
.TP
.B \-nonodata
Added in version 3.10.

.sp
Suppress nodata printing. Implies \fI\%\-nomask\fP\&.
.sp
Can be useful for example when querying a remove GRIB2 dataset that has an
index .idx side\-car file, together with \fI\%\-nomd\fP
.UNINDENT
.INDENT 0.0
.TP
.B \-nomask
Added in version 3.10.

.sp
Suppress band mask printing. Is implied if \fI\%\-nonodata\fP is specified.
.UNINDENT
.INDENT 0.0
.TP
.B \-checksum
Force computation of the checksum for each band in the dataset.
.UNINDENT
.INDENT 0.0
.TP
.B \-listmdd
List all metadata domains available for the dataset.
.UNINDENT
.INDENT 0.0
.TP
.B \-mdd <domain>|all
adds metadata using:
.sp
\fBdomain\fP Report metadata for the specified domain.
.sp
\fBall\fP Report metadata for all domains.
.UNINDENT
.INDENT 0.0
.TP
.B \-nofl
Only display the first file of the file list.
.UNINDENT
.INDENT 0.0
.TP
.B \-wkt_format WKT1|WKT1_ESRI|WKT2|WKT2_2015|WKT2_2018|WKT2_2019
WKT format used to display the SRS.
Currently the supported values are:
.sp
\fBWKT1\fP
.sp
\fBWKT1_ESRI\fP
.sp
\fBWKT2\fP (latest WKT version, currently \fIWKT2_2019\fP)
.sp
\fBWKT2_2015\fP
.sp
\fBWKT2_2018\fP (deprecated)
.sp
\fBWKT2_2019\fP
.sp
Added in version 3.0.0.

.UNINDENT
.INDENT 0.0
.TP
.B \-sd <n>
If the input dataset contains several subdatasets read and display
a subdataset with specified \fBn\fP number (starting from 1).
This is an alternative of giving the full subdataset name.
.UNINDENT
.INDENT 0.0
.TP
.B \-proj4
Report a PROJ.4 string corresponding to the file\(aqs coordinate system.
.UNINDENT
.INDENT 0.0
.TP
.B \-oo <NAME>=<VALUE>
Dataset open option (format specific).
.UNINDENT
.INDENT 0.0
.TP
.B \-if <format>
Format/driver name to be attempted to open the input file(s). It is generally
not necessary to specify it, but it can be used to skip automatic driver
detection, when it fails to select the appropriate driver.
This option can be repeated several times to specify several candidate drivers.
Note that it does not force those drivers to open the dataset. In particular,
some drivers have requirements on file extensions.
.sp
Added in version 3.2.

.UNINDENT
.sp
The gdalinfo will report all of the following (if known):
.INDENT 0.0
.IP \(bu 2
The format driver used to access the file.
.IP \(bu 2
Raster size (in pixels and lines).
.IP \(bu 2
The coordinate system for the file (in OGC WKT).
.IP \(bu 2
The geotransform associated with the file (rotational coefficients
are currently not reported).
.IP \(bu 2
Corner coordinates in georeferenced, and if possible lat/long based
on the full geotransform (but not GCPs).
.IP \(bu 2
Ground control points.
.IP \(bu 2
File wide (including subdatasets) metadata.
.IP \(bu 2
Band data types.
.IP \(bu 2
Band color interpretations.
.IP \(bu 2
Band block size.
.IP \(bu 2
Band descriptions.
.IP \(bu 2
Band min/max values (internally known and possibly computed).
.IP \(bu 2
Band checksum (if computation asked).
.IP \(bu 2
Band NODATA value.
.IP \(bu 2
Band overview resolutions available.
.IP \(bu 2
Band unit type (i.e.. \(dqmeters\(dq or \(dqfeet\(dq for elevation bands).
.IP \(bu 2
Band pseudo\-color tables.
.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 C API
.sp
This utility is also callable from C with \fI\%GDALInfo()\fP\&.
.SH EXAMPLES
.SS Example 1: Default output format
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdalinfo utmsmall.tif
Driver: GTiff/GeoTIFF
Files: utmsmall.tif
Size is 100, 100
Coordinate System is:
PROJCRS[\(dqNAD27 / UTM zone 11N\(dq,
    BASEGEOGCRS[\(dqNAD27\(dq,
        DATUM[\(dqNorth American Datum 1927\(dq,
            ELLIPSOID[\(dqClarke 1866\(dq,6378206.4,294.978698213898,
                LENGTHUNIT[\(dqmetre\(dq,1]]],
        PRIMEM[\(dqGreenwich\(dq,0,
            ANGLEUNIT[\(dqdegree\(dq,0.0174532925199433]],
        ID[\(dqEPSG\(dq,4267]],
    CONVERSION[\(dqTransverse Mercator\(dq,
        METHOD[\(dqTransverse Mercator\(dq,
            ID[\(dqEPSG\(dq,9807]],
        PARAMETER[\(dqLatitude of natural origin\(dq,0,
            ANGLEUNIT[\(dqdegree\(dq,0.0174532925199433],
            ID[\(dqEPSG\(dq,8801]],
        PARAMETER[\(dqLongitude of natural origin\(dq,\-117,
            ANGLEUNIT[\(dqdegree\(dq,0.0174532925199433],
            ID[\(dqEPSG\(dq,8802]],
        PARAMETER[\(dqScale factor at natural origin\(dq,0.9996,
            SCALEUNIT[\(dqunity\(dq,1],
            ID[\(dqEPSG\(dq,8805]],
        PARAMETER[\(dqFalse easting\(dq,500000,
            LENGTHUNIT[\(dqmetre\(dq,1],
            ID[\(dqEPSG\(dq,8806]],
        PARAMETER[\(dqFalse northing\(dq,0,
            LENGTHUNIT[\(dqmetre\(dq,1],
            ID[\(dqEPSG\(dq,8807]]],
    CS[Cartesian,2],
        AXIS[\(dqeasting\(dq,east,
            ORDER[1],
            LENGTHUNIT[\(dqmetre\(dq,1]],
        AXIS[\(dqnorthing\(dq,north,
            ORDER[2],
            LENGTHUNIT[\(dqmetre\(dq,1]],
    ID[\(dqEPSG\(dq,26711]]
Data axis to CRS axis mapping: 1,2
Origin = (440720.000000000000000,3751320.000000000000000)
Pixel Size = (60.000000000000000,\-60.000000000000000)
Metadata:
  AREA_OR_POINT=Area
Image Structure Metadata:
  INTERLEAVE=BAND
Corner Coordinates:
Upper Left  (  440720.000, 3751320.000) (117d38\(aq28.21\(dqW, 33d54\(aq 8.47\(dqN)
Lower Left  (  440720.000, 3745320.000) (117d38\(aq26.75\(dqW, 33d50\(aq53.66\(dqN)
Upper Right (  446720.000, 3751320.000) (117d34\(aq34.59\(dqW, 33d54\(aq 9.62\(dqN)
Lower Right (  446720.000, 3745320.000) (117d34\(aq33.28\(dqW, 33d50\(aq54.82\(dqN)
Center      (  443720.000, 3748320.000) (117d36\(aq30.71\(dqW, 33d52\(aq31.66\(dqN)
Band 1 Block=100x81 Type=Byte, ColorInterp=Gray
.EE
.UNINDENT
.UNINDENT
.SS Example 2: JSON output
.sp
For corner coordinates formatted as decimal degree instead of the above degree, minute, second, inspect the \fBwgs84Extent\fP member of \fBgdalinfo \-json\fP:
.sp
Example of JSON output with \fBgdalinfo \-json utmsmall.tif\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqdescription\(dq:\(dqutmsmall.tif\(dq,
  \(dqdriverShortName\(dq:\(dqGTiff\(dq,
  \(dqdriverLongName\(dq:\(dqGeoTIFF\(dq,
  \(dqfiles\(dq:[
    \(dqutmsmall.tif\(dq
  ],
  \(dqsize\(dq:[
    100,
    100
  ],
  \(dqcoordinateSystem\(dq:{
    \(dqwkt\(dq:\(dqPROJCRS[\e\(dqNAD27 / UTM zone 11N\e\(dq,\en    BASEGEOGCRS[\e\(dqNAD27\e\(dq,\en        DATUM[\e\(dqNorth American Datum 1927\e\(dq,\en            ELLIPSOID[\e\(dqClarke 1866\e\(dq,6378206.4,294.978698213898,\en                LENGTHUNIT[\e\(dqmetre\e\(dq,1]]],\en        PRIMEM[\e\(dqGreenwich\e\(dq,0,\en            ANGLEUNIT[\e\(dqdegree\e\(dq,0.0174532925199433]],\en        ID[\e\(dqEPSG\e\(dq,4267]],\en    CONVERSION[\e\(dqTransverse Mercator\e\(dq,\en        METHOD[\e\(dqTransverse Mercator\e\(dq,\en            ID[\e\(dqEPSG\e\(dq,9807]],\en        PARAMETER[\e\(dqLatitude of natural origin\e\(dq,0,\en            ANGLEUNIT[\e\(dqdegree\e\(dq,0.0174532925199433],\en            ID[\e\(dqEPSG\e\(dq,8801]],\en        PARAMETER[\e\(dqLongitude of natural origin\e\(dq,\-117,\en            ANGLEUNIT[\e\(dqdegree\e\(dq,0.0174532925199433],\en            ID[\e\(dqEPSG\e\(dq,8802]],\en        PARAMETER[\e\(dqScale factor at natural origin\e\(dq,0.9996,\en            SCALEUNIT[\e\(dqunity\e\(dq,1],\en            ID[\e\(dqEPSG\e\(dq,8805]],\en        PARAMETER[\e\(dqFalse easting\e\(dq,500000,\en            LENGTHUNIT[\e\(dqmetre\e\(dq,1],\en            ID[\e\(dqEPSG\e\(dq,8806]],\en        PARAMETER[\e\(dqFalse northing\e\(dq,0,\en            LENGTHUNIT[\e\(dqmetre\e\(dq,1],\en            ID[\e\(dqEPSG\e\(dq,8807]]],\en    CS[Cartesian,2],\en        AXIS[\e\(dqeasting\e\(dq,east,\en            ORDER[1],\en            LENGTHUNIT[\e\(dqmetre\e\(dq,1]],\en        AXIS[\e\(dqnorthing\e\(dq,north,\en            ORDER[2],\en            LENGTHUNIT[\e\(dqmetre\e\(dq,1]],\en    ID[\e\(dqEPSG\e\(dq,26711]]\(dq,
    \(dqdataAxisToSRSAxisMapping\(dq:[
      1,
      2
    ]
  },
  \(dqgeoTransform\(dq:[
    440720.0,
    60.0,
    0.0,
    3751320.0,
    0.0,
    \-60.0
  ],
  \(dqmetadata\(dq:{
    \(dq\(dq:{
      \(dqAREA_OR_POINT\(dq:\(dqArea\(dq
    },
    \(dqIMAGE_STRUCTURE\(dq:{
      \(dqINTERLEAVE\(dq:\(dqBAND\(dq
    }
  },
  \(dqcornerCoordinates\(dq:{
    \(dqupperLeft\(dq:[
      440720.0,
      3751320.0
    ],
    \(dqlowerLeft\(dq:[
      440720.0,
      3745320.0
    ],
    \(dqlowerRight\(dq:[
      446720.0,
      3745320.0
    ],
    \(dqupperRight\(dq:[
      446720.0,
      3751320.0
    ],
    \(dqcenter\(dq:[
      443720.0,
      3748320.0
    ]
  },
  \(dqwgs84Extent\(dq:{
    \(dqtype\(dq:\(dqPolygon\(dq,
    \(dqcoordinates\(dq:[
      [
        [
          \-117.6420428,
          33.9023684
        ],
        [
          \-117.6416377,
          33.848257
        ],
        [
          \-117.5767844,
          33.8485775
        ],
        [
          \-117.5771485,
          33.9026895
        ],
        [
          \-117.6420428,
          33.9023684
        ]
      ]
    ]
  },
  \(dqbands\(dq:[
    {
      \(dqband\(dq:1,
      \(dqblock\(dq:[
        100,
        81
      ],
      \(dqtype\(dq:\(dqByte\(dq,
      \(dqcolorInterpretation\(dq:\(dqGray\(dq,
      \(dqmetadata\(dq:{
      }
    }
  ],
  \(dqstac\(dq:{
    \(dqproj:shape\(dq:[
      100,
      100
    ],
    \(dqproj:wkt2\(dq:\(dqPROJCRS[\e\(dqNAD27 / UTM zone 11N\e\(dq,\en    BASEGEOGCRS[\e\(dqNAD27\e\(dq,\en        DATUM[\e\(dqNorth American Datum 1927\e\(dq,\en            ELLIPSOID[\e\(dqClarke 1866\e\(dq,6378206.4,294.978698213898,\en                LENGTHUNIT[\e\(dqmetre\e\(dq,1]]],\en        PRIMEM[\e\(dqGreenwich\e\(dq,0,\en            ANGLEUNIT[\e\(dqdegree\e\(dq,0.0174532925199433]],\en        ID[\e\(dqEPSG\e\(dq,4267]],\en    CONVERSION[\e\(dqTransverse Mercator\e\(dq,\en        METHOD[\e\(dqTransverse Mercator\e\(dq,\en            ID[\e\(dqEPSG\e\(dq,9807]],\en        PARAMETER[\e\(dqLatitude of natural origin\e\(dq,0,\en            ANGLEUNIT[\e\(dqdegree\e\(dq,0.0174532925199433],\en            ID[\e\(dqEPSG\e\(dq,8801]],\en        PARAMETER[\e\(dqLongitude of natural origin\e\(dq,\-117,\en            ANGLEUNIT[\e\(dqdegree\e\(dq,0.0174532925199433],\en            ID[\e\(dqEPSG\e\(dq,8802]],\en        PARAMETER[\e\(dqScale factor at natural origin\e\(dq,0.9996,\en            SCALEUNIT[\e\(dqunity\e\(dq,1],\en            ID[\e\(dqEPSG\e\(dq,8805]],\en        PARAMETER[\e\(dqFalse easting\e\(dq,500000,\en            LENGTHUNIT[\e\(dqmetre\e\(dq,1],\en            ID[\e\(dqEPSG\e\(dq,8806]],\en        PARAMETER[\e\(dqFalse northing\e\(dq,0,\en            LENGTHUNIT[\e\(dqmetre\e\(dq,1],\en            ID[\e\(dqEPSG\e\(dq,8807]]],\en    CS[Cartesian,2],\en        AXIS[\e\(dqeasting\e\(dq,east,\en            ORDER[1],\en            LENGTHUNIT[\e\(dqmetre\e\(dq,1]],\en        AXIS[\e\(dqnorthing\e\(dq,north,\en            ORDER[2],\en            LENGTHUNIT[\e\(dqmetre\e\(dq,1]],\en    ID[\e\(dqEPSG\e\(dq,26711]]\(dq,
    \(dqproj:epsg\(dq:26711,
    \(dqproj:projjson\(dq:{
      \(dq$schema\(dq:\(dqhttps://proj.org/schemas/v0.7/projjson.schema.json\(dq,
      \(dqtype\(dq:\(dqProjectedCRS\(dq,
      \(dqname\(dq:\(dqNAD27 / UTM zone 11N\(dq,
      \(dqbase_crs\(dq:{
        \(dqname\(dq:\(dqNAD27\(dq,
        \(dqdatum\(dq:{
          \(dqtype\(dq:\(dqGeodeticReferenceFrame\(dq,
          \(dqname\(dq:\(dqNorth American Datum 1927\(dq,
          \(dqellipsoid\(dq:{
            \(dqname\(dq:\(dqClarke 1866\(dq,
            \(dqsemi_major_axis\(dq:6378206.4,
            \(dqinverse_flattening\(dq:294.978698213898
          }
        },
        \(dqcoordinate_system\(dq:{
          \(dqsubtype\(dq:\(dqellipsoidal\(dq,
          \(dqaxis\(dq:[
            {
              \(dqname\(dq:\(dqGeodetic latitude\(dq,
              \(dqabbreviation\(dq:\(dqLat\(dq,
              \(dqdirection\(dq:\(dqnorth\(dq,
              \(dqunit\(dq:\(dqdegree\(dq
            },
            {
              \(dqname\(dq:\(dqGeodetic longitude\(dq,
              \(dqabbreviation\(dq:\(dqLon\(dq,
              \(dqdirection\(dq:\(dqeast\(dq,
              \(dqunit\(dq:\(dqdegree\(dq
            }
          ]
        },
        \(dqid\(dq:{
          \(dqauthority\(dq:\(dqEPSG\(dq,
          \(dqcode\(dq:4267
        }
      },
      \(dqconversion\(dq:{
        \(dqname\(dq:\(dqTransverse Mercator\(dq,
        \(dqmethod\(dq:{
          \(dqname\(dq:\(dqTransverse Mercator\(dq,
          \(dqid\(dq:{
            \(dqauthority\(dq:\(dqEPSG\(dq,
            \(dqcode\(dq:9807
          }
        },
        \(dqparameters\(dq:[
          {
            \(dqname\(dq:\(dqLatitude of natural origin\(dq,
            \(dqvalue\(dq:0,
            \(dqunit\(dq:\(dqdegree\(dq,
            \(dqid\(dq:{
              \(dqauthority\(dq:\(dqEPSG\(dq,
              \(dqcode\(dq:8801
            }
          },
          {
            \(dqname\(dq:\(dqLongitude of natural origin\(dq,
            \(dqvalue\(dq:\-117,
            \(dqunit\(dq:\(dqdegree\(dq,
            \(dqid\(dq:{
              \(dqauthority\(dq:\(dqEPSG\(dq,
              \(dqcode\(dq:8802
            }
          },
          {
            \(dqname\(dq:\(dqScale factor at natural origin\(dq,
            \(dqvalue\(dq:0.9996,
            \(dqunit\(dq:\(dqunity\(dq,
            \(dqid\(dq:{
              \(dqauthority\(dq:\(dqEPSG\(dq,
              \(dqcode\(dq:8805
            }
          },
          {
            \(dqname\(dq:\(dqFalse easting\(dq,
            \(dqvalue\(dq:500000,
            \(dqunit\(dq:\(dqmetre\(dq,
            \(dqid\(dq:{
              \(dqauthority\(dq:\(dqEPSG\(dq,
              \(dqcode\(dq:8806
            }
          },
          {
            \(dqname\(dq:\(dqFalse northing\(dq,
            \(dqvalue\(dq:0,
            \(dqunit\(dq:\(dqmetre\(dq,
            \(dqid\(dq:{
              \(dqauthority\(dq:\(dqEPSG\(dq,
              \(dqcode\(dq:8807
            }
          }
        ]
      },
      \(dqcoordinate_system\(dq:{
        \(dqsubtype\(dq:\(dqCartesian\(dq,
        \(dqaxis\(dq:[
          {
            \(dqname\(dq:\(dqEasting\(dq,
            \(dqabbreviation\(dq:\(dq\(dq,
            \(dqdirection\(dq:\(dqeast\(dq,
            \(dqunit\(dq:\(dqmetre\(dq
          },
          {
            \(dqname\(dq:\(dqNorthing\(dq,
            \(dqabbreviation\(dq:\(dq\(dq,
            \(dqdirection\(dq:\(dqnorth\(dq,
            \(dqunit\(dq:\(dqmetre\(dq
          }
        ]
      },
      \(dqid\(dq:{
        \(dqauthority\(dq:\(dqEPSG\(dq,
        \(dqcode\(dq:26711
      }
    },
    \(dqproj:transform\(dq:[
      60.0,
      0.0,
      440720.0,
      0.0,
      \-60.0,
      3751320.0
    ],
    \(dqraster:bands\(dq:[
      {
        \(dqdata_type\(dq:\(dquint8\(dq
      }
    ],
    \(dqeo:bands\(dq:[
      {
        \(dqname\(dq:\(dqb1\(dq,
        \(dqdescription\(dq:\(dqGray\(dq
      }
    ]
  }
}
.EE
.UNINDENT
.UNINDENT
.SH AUTHOR
Frank Warmerdam <warmerdam@pobox.com>
.SH COPYRIGHT
1998-2026
.\" Generated by docutils manpage writer.
.