Выводить подробные отладочные сообщения в stderr.

Использовать жёсткие ссылки вместо копирования файлов в синтетическую резервную копию. Восстановление синтетической резервной копии может быть быстрее (так как нет копирования файлов) и требует меньше места на диске, но нужно соблюдать осторожность при использовании выходного каталога, потому что любые изменения в этом каталоге (например, запуск сервера) могут также повлиять на входные каталоги. Подобным образом, изменения во входных каталогах (например, запуск сервера из полной резервной копии) могут повлиять на выходной каталог. Таким образом, лучше всего использовать этот параметр, когда входные каталоги представляют собой только копии, которые будут удалены после завершения pg_combinebackup.

Необходимо, чтобы входные резервные копии и выходной каталог находились в одной файловой системе.

Если манифест копии недоступен или не содержит контрольную сумму нужного типа, жёсткие ссылки всё равно будут созданы, но файл также будет прочитан по блокам для расчёта контрольной суммы.

Параметр -n/--dry-run даёт указание pg_combinebackup выяснить, что будет сделано без фактического создания целевого каталога или каких-либо выходных файлов. Он особенно полезен в сочетании с --debug.

По умолчанию pg_combinebackup ожидает безопасной записи файлов на диск. Этот параметр заставляет pg_combinebackup возвращать результат без ожидания, что быстрее, но означает, что последующий сбой операционной системы может повредить получившуюся резервную копию. Как правило, этот параметр полезен для тестирования, но его не следует использовать в производственной среде.

Указывает выходной каталог, в который должна быть записана синтетическая полная резервная копия. В настоящее время этот аргумент является обязательным.

Перемещает табличное пространство из старого_каталога в новый_каталог во время резервного копирования. старый_каталог — это абсолютный путь табличного пространства в том виде, в котором оно существует в последней резервной копии, указанной в командной строке, а новый_каталог — это абсолютный путь для использования табличного пространства в восстановленной резервной копии. Если какой-либо из путей должен содержать знак равенства (=), поставьте перед ним обратную косую черту. Этот параметр можно указывать несколько раз для нескольких табличных пространств.

Использовать эффективное клонирование файлов (в ряде систем это называется «reflink») вместо копирования файлов в новый каталог. В результате файлы данных могут копироваться практически мгновенно.

Если манифест копии недоступен или не содержит контрольную сумму нужного типа, для копирования файла будет использовано клонирование, но файл также будет прочитан по блокам для расчёта контрольной суммы.

Клонирование файлов поддерживается только в некоторых операционных и файловых системах. Если оно выбрано, но не поддерживается, запуск 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 и каждое табличное пространство. Для получения дополнительной информации об особенностях, которые необходимо учитывать при использовании syncfs, обратитесь к recovery_init_sync_method.

В режиме --no-sync этот параметр не оказывает никакого влияния.

Вывести версию pg_combinebackup и завершиться.

Вывести справку по аргументам командной строки pg_combinebackup и завершиться.