postgresql/src/backend/utils
Tom Lane adaf34241a Improve ruleutils' printout of LATERAL references within subplans.
Commit 1cc29fe7c, which taught EXPLAIN to print PARAM_EXEC Params as
the referenced expressions, included some checks to prevent matching
Params found in SubPlans or InitPlans to NestLoopParams of upper query
levels.  At the time, this seemed possibly necessary to avoid false
matches because of the planner's habit of re-using the same PARAM_EXEC
slot in multiple places in a plan.  Furthermore, in the absence of
LATERAL no such reference could be valid anyway.  But it's possible
now that we have LATERAL, and in the wake of 46c508fbc and 1db5667ba
I believe the false-match hazard is gone.  Hence, remove the
in_same_plan_level checks.  As shown in the regression test changes,
this provides a useful improvement in readability for EXPLAIN of
LATERAL-using subplans.

Richard Guo, reviewed by Greg Stark and myself

Discussion: https://postgr.es/m/CAMbWs4-YSOcQXAagJetP95cAeZPqzOy5kM5yijG0PVW5ztRb4w@mail.gmail.com
2022-11-16 20:06:09 -05:00
..
activity Add doubly linked count list implementation 2022-11-02 14:06:05 +13:00
adt Improve ruleutils' printout of LATERAL references within subplans. 2022-11-16 20:06:09 -05:00
cache Remove unused include 2022-11-16 11:28:44 +01:00
error Clean up some inconsistencies with GUC declarations 2022-10-31 12:44:48 +09:00
fmgr Refactor aclcheck functions 2022-11-13 09:02:41 +01:00
hash Make some minor improvements in memory-context infrastructure. 2022-10-14 11:55:56 -04:00
init Refactor aclcheck functions 2022-11-13 09:02:41 +01:00
mb meson: Add windows resource files 2022-10-05 09:56:05 -07:00
misc Refactor ownercheck functions 2022-11-13 08:12:37 +01:00
mmgr Add repalloc0 and repalloc0_array 2022-11-12 20:34:44 +01:00
resowner Allow callback functions to deregister themselves during a call. 2022-09-28 11:23:27 -04:00
sort Remove AssertArg and AssertState 2022-10-28 09:19:06 +02:00
time Improve comments referring snapshot's subxip array. 2022-11-15 09:37:19 +05:30
.gitignore Rearrange makefile rules for running Gen_fmgrtab.pl. 2018-05-03 17:54:18 -04:00
Gen_dummy_probes.pl Update copyright for 2022 2022-01-07 19:04:57 -05:00
Gen_dummy_probes.pl.prolog Update copyright for 2022 2022-01-07 19:04:57 -05:00
Gen_dummy_probes.sed Update copyright for 2022 2022-01-07 19:04:57 -05:00
Gen_fmgrtab.pl Update copyright for 2022 2022-01-07 19:04:57 -05:00
Makefile Clean up temp file from refactored dtrace rule 2022-07-19 07:31:58 +02:00
README.Gen_dummy_probes Tweak generation of Gen_dummy_probes.pl 2021-05-11 20:02:02 -04:00
errcodes.txt Add another SQL/JSON error code 2022-07-18 14:26:43 +02:00
generate-errcodes.pl Add output file argument to generate-errcodes.pl 2022-07-18 12:24:35 -07:00
meson.build meson: Add initial version of meson based build system 2022-09-21 22:37:17 -07:00
postprocess_dtrace.sed Refactor dtrace postprocessing make rules 2022-07-18 12:33:02 -07:00
probes.d Update copyright for 2022 2022-01-07 19:04:57 -05:00

README.Gen_dummy_probes

# Generating dummy probes

If Postgres isn't configured with dtrace enabled, we need to generate
dummy probes for the entries in probes.d, that do nothing.

This is accomplished in Unix via the sed script `Gen_dummy_probes.sed`. We
used to use this in MSVC builds using the perl utility `psed`, which mimicked
sed. However, that utility disappeared from Windows perl distributions and so
we converted the sed script to a perl script to be used in MSVC builds.

We still keep the sed script as the authoritative source for generating
these dummy probes because except on Windows perl is not a hard requirement
when building from a tarball.

So, if you need to change the way dummy probes are generated, first change
the sed script, and when it's working generate the perl script. This can
be accomplished by using the perl utility s2p.

s2p is no longer part of the perl core, so it might not be on your system,
but it is available on CPAN and also in many package systems. e.g.
on Fedora it can be installed using `cpan App::s2p` or
`dnf install perl-App-s2p`.

The Makefile contains a recipe for regenerating Gen_dummy_probes.pl, so all
you need to do is once you have s2p installed is `make Gen_dummy_probes.pl`
Note that in a VPATH build this will generate the file in the vpath tree,
not the source tree.