Commit d1e9214e authored by Tom Lane's avatar Tom Lane

Add missing documentation for PGC_SU_BACKEND in description of pg_settings.

Commit fe550b2a missed updating this list
of the PGC_XXX values, which in hindsight is not so surprising because
catalogs.sgml is not a place you'd think to look for them.  In addition to
adding the missing doco, insert the PGC_XXX C enum names in SGML comments,
so that grepping for the enum names will find this file.  That might spare
the next person similar embarrassment.

Spotted by Magnus Hagander.
parent 4f1b890b
...@@ -8833,6 +8833,7 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx ...@@ -8833,6 +8833,7 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<!-- PGC_INTERNAL -->
<term><literal>internal</literal></term> <term><literal>internal</literal></term>
<listitem> <listitem>
<para> <para>
...@@ -8844,6 +8845,7 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx ...@@ -8844,6 +8845,7 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<!-- PGC_POSTMASTER -->
<term><literal>postmaster</literal></term> <term><literal>postmaster</literal></term>
<listitem> <listitem>
<para> <para>
...@@ -8857,6 +8859,7 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx ...@@ -8857,6 +8859,7 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<!-- PGC_SIGHUP -->
<term><literal>sighup</literal></term> <term><literal>sighup</literal></term>
<listitem> <listitem>
<para> <para>
...@@ -8871,16 +8874,35 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx ...@@ -8871,16 +8874,35 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<!-- PGC_SU_BACKEND -->
<term><literal>superuser-backend</literal></term>
<listitem>
<para>
Changes to these settings can be made in
<filename>postgresql.conf</filename> without restarting the server.
They can also be set for a particular session in the connection request
packet (for example, via <application>libpq</>'s <literal>PGOPTIONS</>
environment variable), but only if the connecting user is a superuser.
However, these settings never change in a session after it is started.
If you change them in <filename>postgresql.conf</filename>, send a
<systemitem>SIGHUP</systemitem> signal to the postmaster to cause it to
re-read <filename>postgresql.conf</filename>. The new values will only
affect subsequently-launched sessions.
</para>
</listitem>
</varlistentry>
<varlistentry>
<!-- PGC_BACKEND -->
<term><literal>backend</literal></term> <term><literal>backend</literal></term>
<listitem> <listitem>
<para> <para>
Changes to these settings can be made in Changes to these settings can be made in
<filename>postgresql.conf</filename> without restarting the server; <filename>postgresql.conf</filename> without restarting the server.
they can also be set for a particular session in the connection request They can also be set for a particular session in the connection request
packet (for example, via <application>libpq</>'s <literal>PGOPTIONS</> packet (for example, via <application>libpq</>'s <literal>PGOPTIONS</>
environment variable). However, these settings never change in a environment variable); any user can make such a change for his session.
session after it is started. If you change them in However, these settings never change in a session after it is started.
<filename>postgresql.conf</filename>, send a If you change them in <filename>postgresql.conf</filename>, send a
<systemitem>SIGHUP</systemitem> signal to the postmaster to cause it to <systemitem>SIGHUP</systemitem> signal to the postmaster to cause it to
re-read <filename>postgresql.conf</filename>. The new values will only re-read <filename>postgresql.conf</filename>. The new values will only
affect subsequently-launched sessions. affect subsequently-launched sessions.
...@@ -8888,6 +8910,7 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx ...@@ -8888,6 +8910,7 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<!-- PGC_SUSET -->
<term><literal>superuser</literal></term> <term><literal>superuser</literal></term>
<listitem> <listitem>
<para> <para>
...@@ -8900,6 +8923,7 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx ...@@ -8900,6 +8923,7 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<!-- PGC_USERSET -->
<term><literal>user</literal></term> <term><literal>user</literal></term>
<listitem> <listitem>
<para> <para>
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment