.\" 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-VSI-MOVE" "1" "May 06, 2025" "" "GDAL"
.SH NAME
gdal-vsi-move \- Move/rename a file/directory located on GDAL Virtual System Interface (VSI)
.sp
Added in version 3.11.

.SH SYNOPSIS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
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]
  \-\-progress                   Display progress bar
.EE
.UNINDENT
.UNINDENT
.SH DESCRIPTION
.sp
\fBgdal vsi move\fP move files and directories located on \fI\%GDAL Virtual File Systems (compressed, network hosted, etc...): /vsimem, /vsizip, /vsitar, /vsicurl, ...\fP\&.
.sp
If the destination path is an existing directory, the file will be moved to it.
.sp
It can move files and directories between different virtual file systems,
but this will involve copying and deletion.
.sp
Note that for cloud object storage, moving/renaming a directory may involve
renaming all files it contains recursively, and is thus not an atomic
operation (and could be slow and expensive on directories with many files!)
.sp
This is implemented by \fI\%VSIMove()\fP\&.
.sp
This is an analog of the UNIX \fBmv\fP command, and \fBgdal vsi mv\fP is an
alias for \fBgdal vsi move\fP\&.
.SH EXAMPLES
.SS Example 1: Rename a file within the same virtual file system
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal vsi move /vsis3/bucket/my.tif /vsis3/bucket/new_name.tif
.EE
.UNINDENT
.UNINDENT
.SS Example 2: Move a file into another directory within the same virtual file system
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal vsi move /vsis3/bucket/my.tif /vsis3/bucket/existing_subdir
.EE
.UNINDENT
.UNINDENT
.SS Example 3: Move a directory between two different virtual file systems
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal vsi move /vsis3/bucket/my_directory /vsigs/bucket/
.EE
.UNINDENT
.UNINDENT
.SH AUTHOR
Even Rouault <even.rouault@spatialys.com>
.SH COPYRIGHT
1998-2025
.\" Generated by docutils manpage writer.
.