Re: Potential ABI breakage in upcoming minor releases - Mailing list pgsql-hackers

From Tom Lane
Subject Re: Potential ABI breakage in upcoming minor releases
Date
Msg-id 2638276.1731717056@sss.pgh.pa.us
Whole thread Raw
In response to Re: Potential ABI breakage in upcoming minor releases  ("David E. Wheeler" <david@justatheory.com>)
Responses Re: Potential ABI breakage in upcoming minor releases
List pgsql-hackers
"David E. Wheeler" <david@justatheory.com> writes:
> On Nov 15, 2024, at 16:13, Tom Lane <tgl@sss.pgh.pa.us> wrote:
>> In other words, our current guidelines
>> for preserving ABI compatibility actually *created* this disaster,
>> because the HEAD change was fine from an ABI standpoint but what
>> was done in back branches was not.  So we do need to rethink how
>> that's worded.

> What bit is mis-worded? The guidance Peter committed[1] says that “PostgreSQL makes an effort to avoid server
> ABI breaks in minor releases.”

That text says exactly nothing about what specific code changes to
make or not make.  I'm not sure offhand where (or if) we have this
documented, but there's an idea that adding fields at the end of
a struct is safer ABI-wise than putting them in the middle.  Which
is true if you can't squeeze them into padding space.  Here, that
could have been done and probably should have.

The other bit of documentation we probably need is some annotation in
struct ResultRelInfo saying "do not change the sizeof() this struct
in back branches, period".

            regards, tom lane



pgsql-hackers by date:

Previous
From: "David E. Wheeler"
Date:
Subject: Re: Potential ABI breakage in upcoming minor releases
Next
From: Pavel Stehule
Date:
Subject: Re: proposal: schema variables