在 stderr 上打印大量调试日志输出。

使用硬链接而不是将文件复制到合成备份。重建合成备份可能会更快（无需复制文件）并占用更少的磁盘空间，但在使用输出目录时必须小心，因为对该目录的任何修改（例如，启动服务器）也可能影响输入目录。同样，对输入目录的更改（例如，在完整备份上启动服务器）也可能影响输出目录。因此，当输入目录仅为副本且将在 pg_combinebackup 完成后删除时，使用此选项最佳。

要求输入备份和输出目录在同一个文件系统中。

如果备份清单不可用或不包含正确类型的校验和，仍然会创建硬链接，但文件仍将逐块读取以进行校验和计算。

-n/--dry-run 选项指示 pg_combinebackup 在不实际创建目标目录或任何输出文件的情况下找出将要执行的操作。它与 --debug 结合使用特别有用。

默认情况下，pg_combinebackup 会等待所有文件安全写入磁盘。此选项导致 pg_combinebackup 在不等待的情况下返回，这样更快，但这意味着后续的操作系统崩溃可能会导致输出备份损坏。通常，此选项对于测试很有用，但不应用于创建生产环境。

指定应将合成完整备份写入的输出目录。目前，此参数是必需的。

在备份过程中，将目录 olddir 中的表空间重新定位到 newdir。olddir 是表空间在命令行指定的最终备份中存在的绝对路径，而 newdir 是在重建备份中用于表空间的绝对路径。如果任一路径需要包含等号 (=)，则在其前面加上反斜杠。此选项可以指定多次以用于多个表空间。

使用高效的文件克隆（在某些系统上称为““reflinks””）而不是将文件复制到新数据目录，这可以近乎即时地复制数据文件。

如果备份清单不可用或不包含正确类型的校验和，文件克隆将用于复制文件，但文件仍将逐块读取以进行校验和计算。

文件克隆仅在某些操作系统和文件系统上受支持。如果选择了但不支持，pg_combinebackup 运行将出错。目前，它支持 Linux（内核 4.5 或更高版本），使用 Btrfs 和 XFS（在创建时支持 reflink 的文件系统上），以及 macOS（使用 APFS）。

执行常规文件复制。这是默认行为。（另请参见 --copy-file-range、--clone 和 -k/--link。）

使用 copy_file_range 系统调用进行高效复制。在某些文件系统上，这会产生与 --clone 类似的结果，共享物理磁盘块，而在其他文件系统上，它仍可能复制块，但通过优化路径进行。目前，它支持 Linux 和 FreeBSD。

如果备份清单不可用或不包含正确类型的校验和，copy_file_range 将用于复制文件，但文件仍将逐块读取以进行校验和计算。

与 pg_basebackup 类似，pg_combinebackup 会在输出目录中写入备份清单。此选项指定应应用于备份清单中包含的每个文件的校验和算法。当前可用的算法为 NONE、CRC32C、SHA224、SHA256、SHA384 和 SHA512。默认值为 CRC32C。

禁用备份清单的生成。如果未指定此选项，将把重建备份的备份清单写入输出目录。

当设置为 fsync（默认值）时，pg_combinebackup 将递归打开并同步备份目录中的所有文件。当使用普通格式时，文件搜索将遵循 WAL 目录和每个已配置表空间的符号链接。

在 Linux 上，还可以使用 syncfs 来要求操作系统同步包含备份目录的整个文件系统。当使用普通格式时，pg_combinebackup 还会同步包含 WAL 文件和每个表空间的upaten系统。有关使用 syncfs 时需要注意的注意事项，请参阅 recovery_init_sync_method。

当使用 --no-sync 时，此选项无效。

打印 pg_combinebackup 版本并退出。

显示关于 pg_combinebackup 命令行参数的帮助，然后退出。