gdal-vsi-delete(1)

GDAL-VSI-DELETE(1)

GDAL

GDAL-VSI-DELETE(1)

NAME

gdal-vsi-delete - Delete files located on GDAL Virtual System Interface (VSI)

Added in version 3.11.

SYNOPSIS

Usage: gdal vsi delete [OPTIONS] <FILENAME>
Delete files located on GDAL Virtual System Interface (VSI).
Positional arguments:


  --filename <FILENAME>   File or directory name to delete [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]
Options:


  -r, -R, --recursive     Delete directories recursively

DESCRIPTION

gdal vsi delete delete files and directories located on GDAL Virtual File Systems (compressed, network hosted, etc...): /vsimem, /vsizip, /vsitar, /vsicurl, ... <#virtual-file-systems>.

This is the equivalent of the UNIX rm command, and gdal vsi rm is an alias for gdal vsi delete.

Warning:

Be careful. This command cannot be undone. It can also act on the "real" file system.

Options

-r, -R, --recursive: Delete directories recursively.

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: Delete recursively files from /vsis3/bucket/my_dir

$ gdal vsi delete -r /vsis3/bucket/my_dir

Author

Even Rouault <even.rouault@spatialys.com>

Copyright

1998-2026

June 10, 2026