Re: Correct documentation for protocol version

From: Jacob Champion <jacob(dot)champion(at)enterprisedb(dot)com>
To: Jelte Fennema-Nio <postgres(at)jeltef(dot)nl>
Cc: Heikki Linnakangas <hlinnaka(at)iki(dot)fi>, Dave Cramer <davecramer(at)gmail(dot)com>, Fujii Masao <masao(dot)fujii(at)oss(dot)nttdata(dot)com>, PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: Correct documentation for protocol version
Date: 2026-07-01 20:14:27
Message-ID: CAOYmi+=Lf5DkFKi3mdppBi+8ABx0j2HGD_TrnbyoRqh+XmEkcg@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Tue, Jun 30, 2026 at 1:28 PM Jelte Fennema-Nio <postgres(at)jeltef(dot)nl> wrote:
> > (To
> > put it another way: clients and servers don't have to support that in
> > order to claim protocol 3.0 compliance.)
>
> Based on my reading of the protocol docs[1] that's not the case.

IMNSHO:
1) the protocol docs serve the community, not the other way 'round, and
2) I don't think an observational description of what the server does
today should be used as evidence that all Postgres-compatible servers
MUST do the same.

(Heikki's welcome to jump in here and correct me, but if we'd intended
this to be a retroactively mandatory feature for all 3.0
implementations -- which I don't recall being part of the deal when
the patchset went in -- it should have been backported, no? Contrast
NegotiateProtocolVersion, which does absolutely belong in this list.)

> I think it would be a shame if there will never be a point when we can
> make clients default to sslmode=direct.

Luckily I think that discussion can probably sidestep any hypothetical
plan to drop support for servers that can't speak direct-TLS. See also
the SVCB discussion and the libpqrc discussion.

> But if you think it should be
> an optional feature, then the current docs should definitely be
> clarified in that respect.

Works for me; I'm generally happy to commit clarifications.

--Jacob

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Corey Huinker 2026-07-01 20:34:53 Re: use of SPI by postgresImportForeignStatistics
Previous Message Pavel Stehule 2026-07-01 19:51:30 Re: proposal - queryid can be used as filter for auto_explain