Re: Document reopen of output file via SIGHUP in pg_recvlogical

On Thu, Jul 10, 2025 at 4:48 PM Fujii Masao <masao(dot)fujii(at)oss(dot)nttdata(dot)com> wrote:
>
> Hi,
>
> pg_recvlogical continuously writes to the file specified with the --file option,
> which means the output file can grow indefinitely. To manage file size,
> some users may want to rotate the output periodically.
>
> While reviewing the source code to find the way to rotate the file, I noticed
> that pg_recvlogical reopens the output file when it receives a SIGHUP signal.
> This makes file rotation possible: we can rename the current output file and
> then send a SIGHUP to pg_recvlogical, which will close the renamed file and
> open a new one with the same original name.
>
> This is a useful feature, but it's currently undocumented. So I'd like to
> apply the attached patch that adds this information to the documentation.
> Thought?

Agreed.
I have confirmed the behavior and I think it should be documented.

Your patch looks good, except that you should use "specified by"
instead of "given with" to be consistent with the other documents.

--
Best regards,
Shinya Kato
NTT OSS Center