I think this is ready to be committed now.It's been a long and tiresome
road ;-)
Last-minute comments welcome.
cheers
andrew
Index: doc/src/sgml/config.sgml
===
RCS file: /cvsroot/pgsql/doc/src/sgml/config.sgml,v
retrieving revision 1.136
diff -c -r1.136 config.sgml
*** doc/src/sgml/config.sgml 4 Aug 2007 01:26:53 - 1.136
--- doc/src/sgml/config.sgml 11 Aug 2007 02:00:58 -
***
*** 2253,2259
para
productnamePostgreSQL/productname supports several methods
for logging server messages, including
! systemitemstderr/systemitem and
systemitemsyslog/systemitem. On Windows,
systemitemeventlog/systemitem is also supported. Set this
parameter to a list of desired log destinations separated by
--- 2253,2259
para
productnamePostgreSQL/productname supports several methods
for logging server messages, including
! systemitemstderr/systemitem, systemitemcsvlog/systemitem and
systemitemsyslog/systemitem. On Windows,
systemitemeventlog/systemitem is also supported. Set this
parameter to a list of desired log destinations separated by
***
*** 2262,2278
This parameter can only be set in the filenamepostgresql.conf/
file or on the server command line.
/para
/listitem
/varlistentry
! varlistentry id=guc-redirect-stderr xreflabel=redirect_stderr
! termvarnameredirect_stderr/varname (typeboolean/type)/term
indexterm
!primaryvarnameredirect_stderr/ configuration parameter/primary
/indexterm
listitem
para
! This parameter allows messages sent to applicationstderr/ to be
captured and redirected into log files.
This method, in combination with logging to applicationstderr/,
is often more useful than
--- 2262,2285
This parameter can only be set in the filenamepostgresql.conf/
file or on the server command line.
/para
+para If varnamelog_destination/ is set to systemitemcsvlog/systemitem,
+ the log is output as comma seperated values. The format is:
+ timestamp with milliseconds, username, database name, session id, host:port number,
+ process id, per process line number, command tag, session start time, transaction id,
+ error severity, SQL state code, statement/error message.
+/para
/listitem
/varlistentry
! varlistentry id=guc-start-log-collector xreflabel=start_log_collector
! termvarnamestart_log-collector/varname (typeboolean/type)/term
indexterm
!primaryvarnamestart_log_collector/ configuration parameter/primary
/indexterm
listitem
para
! This parameter allows messages sent to applicationstderr/,
! and CSV logs, to be
captured and redirected into log files.
This method, in combination with logging to applicationstderr/,
is often more useful than
***
*** 2280,2285
--- 2287,2293
might not appear in applicationsyslog/ output (a common example
is dynamic-linker failure messages).
This parameter can only be set at server start.
+ It is required to be on if CSV logs are to be generated.
/para
/listitem
/varlistentry
***
*** 2291,2298
/indexterm
listitem
para
! When varnameredirect_stderr/ is enabled, this parameter
! determines the directory in which log files will be created.
It can be specified as an absolute path, or relative to the
cluster data directory.
This parameter can only be set in the filenamepostgresql.conf/
--- 2299,2306
/indexterm
listitem
para
! When varnamestart_log_collector/ is enabled,
! this parameter determines the directory in which log files will be created.
It can be specified as an absolute path, or relative to the
cluster data directory.
This parameter can only be set in the filenamepostgresql.conf/
***
*** 2308,2315
/indexterm
listitem
para
! When varnameredirect_stderr/varname is enabled, this parameter
! sets the file names of the created log files. The value
is treated as a systemitemstrftime/systemitem pattern,
so literal%/literal-escapes can be used to specify time-varying
file names. (Note that if there are
--- 2316,2323
/indexterm
listitem
para
! When varnamestart_log_collector/varname is enabled,
! this parameter sets the file names of the created log files. The value
is treated as a