postgres.git / summary / log / commit / refs

commit    6cf5b10ce96c0aa24ce2129fcc7b53fc836608e5
Author:   Fujii Masao <fujii@postgresql.org>
Date:     Sun Jul 20 02:58:31 2025 +0000
First released in: 13.22, 14.19, 15.14, 16.10, 17.6, 18.0

    doc: Document reopen of output file via SIGHUP in pg_recvlogical.
    
    When pg_recvlogical receives a SIGHUP signal, it closes the current
    output file and reopens a new one. This is useful since it allows us to
    rotate the output file by renaming the current file and sending a SIGHUP.
    
    This behavior was previously undocumented. This commit adds
    the missing documentation.
    
    Back-patch to all supported versions.
    
    Author: Fujii Masao <masao.fujii@gmail.com>
    Reviewed-by: Shinya Kato <shinya11.kato@gmail.com>
    Discussion: https://postgr.es/m/0977fc4f-1523-4ecd-8a0e-391af4976367@oss.nttdata.com
    Backpatch-through: 13


 doc/src/sgml/ref/pg_recvlogical.sgml | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/doc/src/sgml/ref/pg_recvlogical.sgml b/doc/src/sgml/ref/pg_recvlogical.sgml
index f68182266a9..263ebdeeab4 100644
--- a/doc/src/sgml/ref/pg_recvlogical.sgml
+++ b/doc/src/sgml/ref/pg_recvlogical.sgml
@@ -53,6 +53,16 @@ PostgreSQL documentation
    (<keycombo action="simul"><keycap>Control</keycap><keycap>C</keycap></keycombo>)
    or <systemitem>SIGTERM</systemitem> signal.
   </para>
+
+  <para>
+   When <application>pg_recvlogical</application> receives
+   a <systemitem>SIGHUP</systemitem> signal, it closes the current output file
+   and opens a new one using the filename specified by
+   the <option>--file</option> option.  This allows us to rotate
+   the output file by first renaming the current file and then sending
+   a <systemitem>SIGHUP</systemitem> signal to
+   <application>pg_recvlogical</application>.
+  </para>
  </refsect1>
 
  <refsect1>


[parent: 226c5674540f]