postgresql/src/backend/utils
Tom Lane 0245f8db36 Pre-beta mechanical code beautification.
Run pgindent, pgperltidy, and reformat-dat-files.

This set of diffs is a bit larger than typical.  We've updated to
pg_bsd_indent 2.1.2, which properly indents variable declarations that
have multi-line initialization expressions (the continuation lines are
now indented one tab stop).  We've also updated to perltidy version
20230309 and changed some of its settings, which reduces its desire to
add whitespace to lines to make assignments etc. line up.  Going
forward, that should make for fewer random-seeming changes to existing
code.

Discussion: https://postgr.es/m/20230428092545.qfb3y5wcu4cm75ur@alvherre.pgsql
2023-05-19 17:24:48 -04:00
..
activity Pre-beta mechanical code beautification. 2023-05-19 17:24:48 -04:00
adt Pre-beta mechanical code beautification. 2023-05-19 17:24:48 -04:00
cache Pre-beta mechanical code beautification. 2023-05-19 17:24:48 -04:00
error Update copyright for 2023 2023-01-02 15:00:37 -05:00
fmgr Pre-beta mechanical code beautification. 2023-05-19 17:24:48 -04:00
hash Update copyright for 2023 2023-01-02 15:00:37 -05:00
init Pre-beta mechanical code beautification. 2023-05-19 17:24:48 -04:00
mb Pre-beta mechanical code beautification. 2023-05-19 17:24:48 -04:00
misc Pre-beta mechanical code beautification. 2023-05-19 17:24:48 -04:00
mmgr Pre-beta mechanical code beautification. 2023-05-19 17:24:48 -04:00
resowner Pre-beta mechanical code beautification. 2023-05-19 17:24:48 -04:00
sort Pre-beta mechanical code beautification. 2023-05-19 17:24:48 -04:00
time Pre-beta mechanical code beautification. 2023-05-19 17:24:48 -04:00
.gitignore Rearrange makefile rules for running Gen_fmgrtab.pl. 2018-05-03 17:54:18 -04:00
Gen_dummy_probes.pl Pre-beta mechanical code beautification. 2023-05-19 17:24:48 -04:00
Gen_dummy_probes.pl.prolog Update copyright for 2023 2023-01-02 15:00:37 -05:00
Gen_dummy_probes.sed Update copyright for 2023 2023-01-02 15:00:37 -05:00
Gen_fmgrtab.pl Pre-beta mechanical code beautification. 2023-05-19 17:24:48 -04:00
Makefile Update copyright for 2023 2023-01-02 15:00:37 -05:00
README.Gen_dummy_probes Tweak generation of Gen_dummy_probes.pl 2021-05-11 20:02:02 -04:00
errcodes.txt Update copyright for 2023 2023-01-02 15:00:37 -05:00
generate-errcodes.pl Pre-beta mechanical code beautification. 2023-05-19 17:24:48 -04:00
meson.build Update copyright for 2023 2023-01-02 15:00:37 -05:00
postprocess_dtrace.sed Update copyright for 2023 2023-01-02 15:00:37 -05:00
probes.d bufmgr: Introduce infrastructure for faster relation extension 2023-04-05 16:21:09 -07: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.