diff options
Diffstat (limited to 'doc/src/sgml/config.sgml')
-rw-r--r-- | doc/src/sgml/config.sgml | 54 |
1 files changed, 32 insertions, 22 deletions
diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml index 2b34921e70b..7a44f074a86 100644 --- a/doc/src/sgml/config.sgml +++ b/doc/src/sgml/config.sgml @@ -1,4 +1,4 @@ -<!-- $PostgreSQL: pgsql/doc/src/sgml/config.sgml,v 1.223 2009/08/04 16:08:35 tgl Exp $ --> +<!-- $PostgreSQL: pgsql/doc/src/sgml/config.sgml,v 1.224 2009/08/24 20:08:31 tgl Exp $ --> <chapter Id="runtime-config"> <title>Server Configuration</title> @@ -2588,7 +2588,37 @@ local0.* /var/log/postgresql </para> </listitem> </varlistentry> - + + <varlistentry id="guc-silent-mode" xreflabel="silent_mode"> + <term><varname>silent_mode</varname> (<type>boolean</type>)</term> + <indexterm> + <primary><varname>silent_mode</> configuration parameter</primary> + </indexterm> + <listitem> + <para> + Runs the server silently. If this parameter is set, the server + will automatically run in background and disassociate from the + controlling terminal. + This parameter can only be set at server start. + </para> + + <caution> + <para> + When this parameter is set, + the server's standard output and standard error are redirected + to the file <filename>postmaster.log</> within the data directory. + There is no provision for rotating this file, so it will grow + indefinitely unless server log output is redirected elsewhere + by other settings. It is recommended that <varname>log_destination</> + be set to <literal>syslog</> or that <varname>logging_collector</> be + enabled when using this option. Even with those measures, errors + reported early during startup may appear in + <filename>postmaster.log</> rather than the normal log destination. + </para> + </caution> + </listitem> + </varlistentry> + </variablelist> </sect2> <sect2 id="runtime-config-logging-when"> @@ -2722,26 +2752,6 @@ local0.* /var/log/postgresql </listitem> </varlistentry> - <varlistentry id="guc-silent-mode" xreflabel="silent_mode"> - <term><varname>silent_mode</varname> (<type>boolean</type>)</term> - <indexterm> - <primary><varname>silent_mode</> configuration parameter</primary> - </indexterm> - <listitem> - <para> - Runs the server silently. If this parameter is set, the server - will automatically run in background and any controlling - terminals are disassociated. - The server's standard output and standard error are redirected - to <literal>/dev/null</>, so any messages sent to them will be lost. - Unless <application>syslog</> logging is selected or - <varname>logging_collector</> is enabled, using this parameter - is discouraged because it makes it impossible to see error messages. - This parameter can only be set at server start. - </para> - </listitem> - </varlistentry> - </variablelist> <para> |