pgsql: Add defenses against unexpected changes in the NodeTag enum list

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: pgsql-committers(at)lists(dot)postgresql(dot)org
Subject: pgsql: Add defenses against unexpected changes in the NodeTag enum list
Date: 2022-07-12 15:23:03
Message-ID: E1oBHj4-002S6f-Cy@gemulon.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-committers

Add defenses against unexpected changes in the NodeTag enum list.

Having different build systems producing different contents of the
NodeTag enum would be catastrophic for extension ABI stability.
But that ordering depends on the order in which gen_node_support.pl
processes its input files. It seems too fragile to let the Makefiles,
MSVC build scripts, and soon meson build scripts all set this order
independently. As a klugy but serviceable solution, put a canonical
copy of the file list into gen_node_support.pl itself, and check that
against the files given on the command line.

Also, while it's fine to add and delete node tags during development,
we must not let the assigned NodeTag values change unexpectedly in
stable branches. Add a cross-check that can be enabled when a branch
is forked off (or later, but that is a time when we're unlikely to
miss doing it). It just checks that the last auto-assigned number
doesn't change, which is simplistic but will catch the most likely
sorts of mistakes.

From time to time we do need to add a node tag in a stable branch.
To support doing that without changing the branch's auto-assigned
tag numbers, invent pg_node_attr(nodetag_number(VALUE)) which can
be used to give such a node a hand-assigned tag above the last
auto-assigned one.

Discussion: https://postgr.es/m/1249010.1657574337@sss.pgh.pa.us

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/eea9fa9b250f4044aa35d537f234c7d44fa9db3d

Modified Files
--------------
src/backend/nodes/gen_node_support.pl | 126 ++++++++++++++++++++++++++++------
src/include/nodes/nodes.h | 5 ++
src/tools/RELEASE_CHANGES | 4 ++
3 files changed, 113 insertions(+), 22 deletions(-)

Browse pgsql-committers by date

  From Date Subject
Next Message Larry Rosenman 2022-07-12 15:29:20 Re: pgsql: Fix out-of-bounds read in json_lex_string
Previous Message Alvaro Herrera 2022-07-12 15:20:59 test_oat_hooks bug (was: Re: pgsql: Add copy/equal support for XID lists)