aboutsummaryrefslogtreecommitdiff
path: root/doc/src
diff options
context:
space:
mode:
authorPeter Eisentraut <peter@eisentraut.org>2021-01-05 08:17:40 +0100
committerPeter Eisentraut <peter@eisentraut.org>2021-01-05 08:17:40 +0100
commit854434c50a35e7cb2ae22588c80ebf36e889197a (patch)
tree5848ae3fdad15d78264cc01f5f9504e5ff4d5e78 /doc/src
parent83e3239ee77089f76fad022eeef91c83cdf9181d (diff)
downloadpostgresql-854434c50a35e7cb2ae22588c80ebf36e889197a.tar.gz
postgresql-854434c50a35e7cb2ae22588c80ebf36e889197a.zip
doc: Document how to run regression tests with custom server settings
Author: Craig Ringer <craig.ringer@2ndquadrant.com> Discussion: https://www.postgresql.org/message-id/flat/CAMsr+YF=+ctXBZj3ywmvKNUjWpxmuTuUKuv-rgbHGX5i5pLstQ@mail.gmail.com
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/sgml/regress.sgml25
1 files changed, 25 insertions, 0 deletions
diff --git a/doc/src/sgml/regress.sgml b/doc/src/sgml/regress.sgml
index 083d0bf46b8..890ec7c88ee 100644
--- a/doc/src/sgml/regress.sgml
+++ b/doc/src/sgml/regress.sgml
@@ -352,6 +352,31 @@ make check LANG=C ENCODING=EUC_JP
</sect2>
<sect2>
+ <title>Custom Server Settings</title>
+
+ <para>
+ Custom server settings to use when running a regression test suite can be
+ set in the <varname>PGOPTIONS</varname> environment variable (for settings
+ that allow this):
+<screen>
+make check PGOPTIONS="-c log_checkpoints=on -c work_mem=50MB"
+</screen>
+ When running against a temporary installation, custom settings can also be
+ set by supplying a pre-written <filename>postgresql.conf</filename>:
+<screen>
+echo 'log_checkpoints = on' > test_postgresql.conf
+echo 'work_mem = 50MB' >> test_postgresql.conf
+make check EXTRA_REGRESS_OPTS="--temp-config=test_postgresql.conf"
+</screen>
+ </para>
+
+ <para>
+ This can be useful to enable additional logging, adjust resource limits,
+ or enable extra run-time checks.
+ </para>
+ </sect2>
+
+ <sect2>
<title>Extra Tests</title>
<para>