FreeBSD Manual Pages
GDAL-VSI-MOVE(1) GDAL GDAL-VSI-MOVE(1) NAME gdal-vsi-move - Move/rename a file/directory located on GDAL Virtual System Interface (VSI) Added in version 3.11. SYNOPSIS Usage: gdal vsi move [OPTIONS] <SOURCE> <DESTINATION> Move/rename a file/directory located on GDAL Virtual System Interface (VSI). Positional arguments: --source <SOURCE> Source file or directory name [required] --destination <DESTINATION> Destination file or directory name [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] DESCRIPTION gdal vsi move move files and directories located on GDAL Virtual File Sys- tems (compressed, network hosted, etc...): /vsimem, /vsizip, /vsitar, /vsi- curl, .... If the destination path is an existing directory, the file will be moved to it. It can move files and directories between different virtual file systems, but this will involve copying and deletion. Note that for cloud object storage, moving/renaming a directory may involve renaming all files it contains recursively, and is thus not an atomic oper- ation (and could be slow and expensive on directories with many files!) This is implemented by VSIMove(). This is an analog of the UNIX mv command, and gdal vsi mv is an alias for gdal vsi move. 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 suc- cessful execution). EXAMPLES Example 1: Rename a file within the same virtual file system $ gdal vsi move /vsis3/bucket/my.tif /vsis3/bucket/new_name.tif Example 2: Move a file into another directory within the same virtual file system $ gdal vsi move /vsis3/bucket/my.tif /vsis3/bucket/existing_subdir Example 3: Move a directory between two different virtual file systems $ gdal vsi move /vsis3/bucket/my_directory /vsigs/bucket/ AUTHOR Even Rouault <even.rouault@spatialys.com> COPYRIGHT 1998-2026 Jun 05, 2026 GDAL-VSI-MOVE(1)
NAME | SYNOPSIS | DESCRIPTION | RETURN STATUS CODE | EXAMPLES | AUTHOR | COPYRIGHT
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gdal-vsi-move&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>