pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedPostgres Protocol Message Formats Clarification
2+ messages / 2 participants
[nested] [flat]
* Postgres Protocol Message Formats Clarification
@ 2026-07-11 14:24 PG Doc comments form <noreply@postgresql.org>
2026-07-11 21:10 ` Re: Postgres Protocol Message Formats Clarification David G. Johnston <david.g.johnston@gmail.com>
0 siblings, 1 reply; 2+ messages in thread
From: PG Doc comments form @ 2026-07-11 14:24 UTC (permalink / raw)
To: pgsql-docs@lists.postgresql.org; +Cc: akindipejohn2017@gmail.com
The following documentation comment has been logged on the website:
Page: https://www.postgresql.org/docs/18/protocol-message-formats.html
Description:
While the docs correctly state here
(https://www.postgresql.org/docs/current/protocol-overview.html#PROTOCOL-MESSAGE-CONCEPTS)
that the size bytes represent the length of the message except the first
byte (the msg type byte), this page
(https://www.postgresql.org/docs/current/protocol-message-formats.html#PROTOCOL-MESSAGE-FORMATS)
which explicitly describes the message formats does not include this
clarification.
Readers who come across this page without reading the protocol overview page
will be quite confused should they try to implement the protocol and see
short by one message sizes.
I propose that this clarification be more explicitly added to the message
formats page to avoid confusing readers.
^ permalink raw reply [nested|flat] 2+ messages in thread
* Re: Postgres Protocol Message Formats Clarification
2026-07-11 14:24 Postgres Protocol Message Formats Clarification PG Doc comments form <noreply@postgresql.org>
@ 2026-07-11 21:10 ` David G. Johnston <david.g.johnston@gmail.com>
0 siblings, 0 replies; 2+ messages in thread
From: David G. Johnston @ 2026-07-11 21:10 UTC (permalink / raw)
To: akindipejohn2017@gmail.com; pgsql-docs@lists.postgresql.org
On Sat, Jul 11, 2026 at 10:58 AM PG Doc comments form <
noreply@postgresql.org> wrote:
> While the docs correctly state here
> (
> https://www.postgresql.org/docs/current/protocol-overview.html#PROTOCOL-MESSAGE-CONCEPTS
> )
> that the size bytes represent the length of the message
It states it's the length of the "message contents". That the leading byte
is a header and not content seems reasonably implied - otherwise the field
would just be 'the length of the message' and there would be no need to
even clarify that the length field itself is included in the count.
David J.
^ permalink raw reply [nested|flat] 2+ messages in thread
end of thread, other threads:[~2026-07-11 21:10 UTC | newest]
Thread overview: 2+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2026-07-11 14:24 Postgres Protocol Message Formats Clarification PG Doc comments form <noreply@postgresql.org>
2026-07-11 21:10 ` David G. Johnston <david.g.johnston@gmail.com>
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox