Date: Wed, 17 Feb 2021 15:01:18 +0900
From: Michael Paquier <michael@paquier.xyz>
To: kuzmin.db4@gmail.com, pgsql-docs@lists.postgresql.org
Subject: Re: Inaccuracy in wal_receiver_status_interval parameter description
Message-ID: <YCyxLhg2ZHk0P9rA@paquier.xyz>
References: <161346024420.3455.1345266601055047937@wrigleys.postgresql.org>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha512;
	protocol="application/pgp-signature"; boundary="cd/K8HIeKVFVed0n"
Content-Disposition: inline
In-Reply-To: <161346024420.3455.1345266601055047937@wrigleys.postgresql.org>
Precedence: bulk


--cd/K8HIeKVFVed0n
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

On Tue, Feb 16, 2021 at 07:24:04AM +0000, PG Doc comments form wrote:
> The documentation says that setting wal_receiver_status_interval to 0
> disable updates of replication status completely. However walreceiver keep
> sending status in some cases. For example, when startup has finished
> processing WALs and start waiting for more:
> https://github.com/postgres/postgres/blob/master/src/backend/access/transam/xlog.c#L12598-L12609
> It would be helpful to document in what cases status updates are still being
> sent.

The docs say only that:
"Updates are sent each time the write or flush positions change, or at
least as often as specified by this parameter."

So it could make sense to complete a bit this paragraph with some
words about the places where WalRcvForceReply() or similar logic is
used.  The case of the end of the WAL stream ending would be an extra
one.  How would you formulate that and what are the cases you think
would be worth mentioning?
--
Michael

--cd/K8HIeKVFVed0n
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCgAdFiEEG72nH6vTowiyblFKnvQgOdbyQH0FAmAssS4ACgkQnvQgOdby
QH16lQ/8DfWefNdqvs+mipB8gtPt2B2vyR8uFh2efaAqsiwPccEafERAk7BfdD+L
xGBe4JlXhwFxdeY+bpg8NfxwOkW9gskpTPX/ocshvs4MKbQGszfULvZpf+w1ynSG
/SX2y6Ryojtb8iMsWJhMjpWqziCO6RqQWuVFK6/uhVA53T03hDSoRA73928qH5DJ
FohB+CxpZRIZAn9PCFLCLol14PqZhFt5T3oG0NpnV896RVEZTwd2ABHIunlWAlkh
sLjJcm/5sbKxXevcPryWEmdY6MO8D1bVNn5WJVbpM4sahKB4bs5OngY0JRlDYonU
inNCYGVlQ2xvdikRGzYHKGc7RSADNhhQw4Dc7F0HbfT8ZUXC7kWUFagOQWQM9M5s
nGVubfTTS1HpJPLNUkspjpjoXxpcqtiv0zf6SRdLQfBFesBIoGmvfzZXMh0of2KX
oyy++Rchb+nU68+frWigyFpgbz9SFX7YV5fbHsoQ5bTzLX1NBknznMQk4KqynhJr
dN1KWMoxrPCGgQLF/aN/3j6j1gWAYDy1YLhVGk05ezGPjHwQ6uMFDZi9GWQJyN5d
E3i7FRhs4UC1ueFcR/mnm1I1iZAQOFiR9PY0ZuIlL5wDLpz2XT571TjS/+RAUFKk
DlE5UIlNRROQp8T//IOFiLeRqUydoErhaB5vmo9X+5XNEZO+joQ=
=X/DP
-----END PGP SIGNATURE-----

--cd/K8HIeKVFVed0n--