Le lun. 28 juil. 2025 à 10:01, Jean-Christophe Arnu <jca...@gmail.com> a
écrit :

> Here's a first version of this tiny doc patch.
>
> Hope this is clear enough.
>

Sorry, the previous version had a bad wording for one file. Please do not
review it. The following version is the correct one.


-- 
Jean-Christophe Arnu
From 185012980d4f6b96a6081570f52975ca667d233e Mon Sep 17 00:00:00 2001
From: Jean-Christophe Arnu <jc.a...@loxodata.com>
Date: Mon, 28 Jul 2025 10:20:12 +0200
Subject: [PATCH v2] add details on restore-command return code >= 128

Documentation does not mention restore_command returns codes including
128 and above. If such a code is returned, the server is shut down.
---
 doc/src/sgml/backup.sgml | 3 ++-
 doc/src/sgml/config.sgml | 2 ++
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/doc/src/sgml/backup.sgml b/doc/src/sgml/backup.sgml
index 5f7489afbd1..da4bdd24a7c 100644
--- a/doc/src/sgml/backup.sgml
+++ b/doc/src/sgml/backup.sgml
@@ -1310,7 +1310,8 @@ restore_command = 'cp /mnt/server/archivedir/%f %p'
     a signal (other than <systemitem>SIGTERM</systemitem>, which is used as
     part of a database server shutdown) or an error by the shell (such as
     command not found), then recovery will abort and the server will not start
-    up.
+    up. However, the server will also not start if the command returns a code
+    of 128 and above.
    </para>
 
    <para>
diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
index 20ccb2d6b54..548bbb33ab0 100644
--- a/doc/src/sgml/config.sgml
+++ b/doc/src/sgml/config.sgml
@@ -4058,6 +4058,8 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"'  # Windows
         than <systemitem>SIGTERM</systemitem>, which is used as part of a
         database server shutdown) or an error by the shell (such as command
         not found), then recovery will abort and the server will not start up.
+        However, the server will also not start if the command returns a code
+        of 128 and above.
        </para>
 
        <para>
-- 
2.39.5

Reply via email to