.\" 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-COPY" "1" "Aug 18, 2026" "" "GDAL"
.SH NAME
gdal-vsi-copy \- Copy files 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 copy [OPTIONS] <SOURCE> <DESTINATION>

Copy files 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]

Options:
  \-r, \-\-recursive              Copy subdirectories recursively
  \-\-skip\-errors                Skip errors
.EE
.UNINDENT
.UNINDENT
.SH DESCRIPTION
.sp
\fBgdal vsi copy\fP copy files and directories located on \fI\%GDAL Virtual File Systems (compressed, network hosted, etc...): /vsimem, /vsizip, /vsitar, /vsicurl, ...\fP\&.
.sp
It can copy files and directories between different virtual file systems.
.sp
This is the equivalent of the UNIX \fBcp\fP command, and \fBgdal vsi cp\fP is an
alias for \fBgdal vsi copy\fP\&.
.SS Options
.INDENT 0.0
.TP
.B \-r, \-\-recursive
Copy directories recursively.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-skip\-errors
Skip errors that occur while while copying.
.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 EXAMPLES
.SS Example 1: Copy recursively files from /vsis3/bucket/my_dir to local directory, creating a my_dir directory if it does not exist.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal vsi copy \-r /vsis3/bucket/my_dir .
.EE
.UNINDENT
.UNINDENT
.SS Example 2: Copy recursively files from /vsis3/bucket/my_dir to local directory, without creating a my_dir directory, without progress bar
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal vsi copy \-\-quiet \-r /vsis3/bucket/my_dir/* .
.EE
.UNINDENT
.UNINDENT
.SH AUTHOR
Even Rouault <even.rouault@spatialys.com>
.SH COPYRIGHT
1998-2026
.\" Generated by docutils manpage writer.
.