gdal dataset check

Added in version 3.13.

Check whether there are errors when reading the content of a dataset.

gdal dataset check check whether there are errors when reading the content of a dataset and return 1 as the program exit code (or in the return-code output parameter of the algorithm) if that happens, or 0 when no errors are detected.

Warning

Most drivers or data formats do not have a built-in integrity mechanism. Thus a successful run of that program does not necessarily mean that the dataset is identical to the state it had just after being generated. The checks performed are generally sufficient to detect whether the dataset is truncated compared to its expected size, but this is not even necessarily guaranteed for some formats (for example the CSV driver may not be able to detect truncation).

Synopsis

Usage: gdal dataset check [OPTIONS] <INPUT>

Check whether there are errors when reading the content of a dataset.

Positional arguments:
  -i, --input <INPUT>                  Input raster, vector or multidimensional raster dataset [required]

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]
  -q, --quiet                          Quiet mode (no progress bar or warning message) [not available in pipelines]

Advanced Options:
  --oo, --open-option <KEY>=<VALUE>    Open options [may be repeated]
  --if, --input-format <INPUT-FORMAT>  Input formats [may be repeated]

Options

--input <FILENAME>

Input vector, raster or multidimensional dataset. Required.

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 successful execution).

Examples

Example 1: Check whether there are errors when reading a dataset

$ gdal dataset check NE1_50M_SR_W.tif