Allow copying files using clone/copy_file_range
commitf8ce4ed78ca6e35bf135545e34bd49cd65d88ea2
authorTomas Vondra <tomas.vondra@postgresql.org>
Fri, 5 Apr 2024 16:01:26 +0000 (5 18:01 +0200)
committerTomas Vondra <tomas.vondra@postgresql.org>
Fri, 5 Apr 2024 16:01:32 +0000 (5 18:01 +0200)
tree5d3b4e32f541fb34b89ba585d88f96ddbf924dad
parent3c5ff36aba8a3df19967d0ddc1249c63417bb9b0
Allow copying files using clone/copy_file_range

Adds --clone/--copy-file-range options to pg_combinebackup, to allow
copying files using file cloning or copy_file_range(). These methods may
be faster than the standard block-by-block copy, but the main advantage
is that they enable various features provided by CoW filesystems.

This commit only uses these copy methods for files that did not change
and can be copied as a whole from a single backup.

These new copy methods may not be available on all platforms, in which
case the command throws an error (immediately, even if no files would be
copied as a whole). This early failure seems better than failing later
when trying to copy the first file, after performing a lot of work on
earlier files.

If the requested copy method is available, but a checksum needs to be
recalculated (e.g. because of a different checksum type), the file is
still copied using the requested method, but it is also read for the
checksum calculation. Depending on the filesystem this may be more
expensive than just performing the simple copy, but it does enable the
CoW benefits.

Initial patch by Jakub Wartak, various reworks and improvements by me.

Author: Tomas Vondra, Jakub Wartak
Reviewed-by: Thomas Munro, Jakub Wartak, Robert Haas
Discussion: https://postgr.es/m/3024283a-7491-4240-80d0-421575f6bb23%40enterprisedb.com
doc/src/sgml/ref/pg_combinebackup.sgml
src/bin/pg_combinebackup/copy_file.c
src/bin/pg_combinebackup/copy_file.h
src/bin/pg_combinebackup/pg_combinebackup.c
src/bin/pg_combinebackup/reconstruct.c
src/bin/pg_combinebackup/reconstruct.h
src/tools/pgindent/typedefs.list