summaryrefslogtreecommitdiff
path: root/doc/src
diff options
context:
space:
mode:
authorTom Lane <tgl@sss.pgh.pa.us>2021-07-01 13:33:05 -0400
committerTom Lane <tgl@sss.pgh.pa.us>2021-07-01 13:33:05 -0400
commitb741f4c3ee67666aa333dbb25bd71906b3474def (patch)
tree2d729ddb09ea71e44234340da38426eb939a0e5e /doc/src
parentd700518d744e53994fdded14b23ebc15b031b0dd (diff)
Add --clobber-cache option to initdb, for CCA testing.
Commit 4656e3d66 replaced the "#define CLOBBER_CACHE_ALWAYS" testing mechanism with a GUC, which has been a great help for doing cache-clobber testing in more efficient ways; but there is a gap in the implementation. The only way to do cache-clobber testing during an initdb run is to use the old method with #define, because one can't set the GUC from outside. Improve this by adding a switch to initdb for the purpose. (Perhaps someday we should let initdb pass through arbitrary "-c NAME=VALUE" switches. Quoting difficulties dissuaded me from attempting that right now, though.) Back-patch to v14 where 4656e3d66 came in. Discussion: https://postgr.es/m/1582507.1624227029@sss.pgh.pa.us
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/sgml/ref/initdb.sgml11
1 files changed, 11 insertions, 0 deletions
diff --git a/doc/src/sgml/ref/initdb.sgml b/doc/src/sgml/ref/initdb.sgml
index afd344b4c06..3077530c7b4 100644
--- a/doc/src/sgml/ref/initdb.sgml
+++ b/doc/src/sgml/ref/initdb.sgml
@@ -389,6 +389,17 @@ PostgreSQL documentation
<variablelist>
<varlistentry>
+ <term><option>--clobber-cache</option></term>
+ <listitem>
+ <para>
+ Run the bootstrap backend with the
+ <literal>debug_invalidate_system_caches_always=1</literal> option.
+ This takes a very long time and is only of use for deep debugging.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>-d</option></term>
<term><option>--debug</option></term>
<listitem>