diff options
| author | Tom Lane | 2014-09-14 01:01:49 +0000 |
|---|---|---|
| committer | Tom Lane | 2014-09-14 01:01:57 +0000 |
| commit | fe550b2ac249af5fbd8e9e19290a4ba43c882f2d (patch) | |
| tree | f75803db65008b33b34fc69d92ba70dde3372814 /doc/src | |
| parent | c2a01439c04404ad8b271f788188c807a3de67d1 (diff) | |
Invent PGC_SU_BACKEND and mark log_connections/log_disconnections that way.
This new GUC context option allows GUC parameters to have the combined
properties of PGC_BACKEND and PGC_SUSET, ie, they don't change after
session start and non-superusers can't change them. This is a more
appropriate choice for log_connections and log_disconnections than their
previous context of PGC_BACKEND, because we don't want non-superusers
to be able to affect whether their sessions get logged.
Note: the behavior for log_connections is still a bit odd, in that when
a superuser attempts to set it from PGOPTIONS, the setting takes effect
but it's too late to enable or suppress connection startup logging.
It's debatable whether that's worth fixing, and in any case there is
a reasonable argument for PGC_SU_BACKEND to exist.
In passing, re-pgindent the files touched by this commit.
Fujii Masao, reviewed by Joe Conway and Amit Kapila
Diffstat (limited to 'doc/src')
| -rw-r--r-- | doc/src/sgml/config.sgml | 16 |
1 files changed, 9 insertions, 7 deletions
diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml index 74110f07722..5be8fdcc252 100644 --- a/doc/src/sgml/config.sgml +++ b/doc/src/sgml/config.sgml @@ -4345,8 +4345,9 @@ local0.* /var/log/postgresql <para> Causes each attempted connection to the server to be logged, as well as successful completion of client authentication. - This parameter cannot be changed after session start. - The default is off. + Only superusers can change this parameter at session start, + and it cannot be changed at all within a session. + The default is <literal>off</>. </para> <note> @@ -4368,11 +4369,12 @@ local0.* /var/log/postgresql </term> <listitem> <para> - This outputs a line in the server log similar to - <varname>log_connections</varname> but at session termination, - and includes the duration of the session. This is off by - default. - This parameter cannot be changed after session start. + Causes session terminations to be logged. The log output + provides information similar to <varname>log_connections</varname>, + plus the duration of the session. + Only superusers can change this parameter at session start, + and it cannot be changed at all within a session. + The default is <literal>off</>. </para> </listitem> </varlistentry> |