.. _gdal_dataset_copy:

================================================================================
``gdal dataset copy``
================================================================================

.. versionadded:: 3.12

.. only:: html

    Copy files of a dataset

.. Index:: gdal dataset copy

:program:`gdal dataset copy` creates a copy of the dataset file(s),
including potential side-car/associated files.

Synopsis
--------

.. program-output:: gdal dataset copy --help-doc

Options
-------

.. option:: --source <FILENAME>

    Source file name or directory name. Required.

.. option:: --destination <FILENAME>

    Destination file name or directory name. Required.

.. option:: -f, ---format <FORMAT>

    Dataset format. Helps if automatic detection does not work.

.. include:: gdal_options/overwrite.rst

.. Return status code
.. ------------------

.. include:: return_code.rst

Examples
--------

.. example::
   :title: Copy a dataset

   .. code-block:: console

       $ gdal dataset copy source.tif destination.tif
