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
commitd0477080174b227e6f5cbe0dd10c4d79abb7f3e6 (patch)
tree9787e2e9c99b8a6da36981a5c2629879f9e58483 /doc/src
parentbe280cdad2985749e558212b0a5c8bdf9abb4e6a (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>