From d54ae17b630bb579fae976bfc4dac1ce88b16165 Mon Sep 17 00:00:00 2001
From: Bruce Momjian <bruce@momjian.us>
Date: Sat, 7 Feb 2009 14:31:30 +0000
Subject: [PATCH] Document disabling the statistics collector pg_dump activity,
and give a bit more visibility to the PGOPTIONS environment variable
supported by libpq.
Bryce Nesbitt
---
doc/src/sgml/ref/pg_dump.sgml | 13 +++++++++++--
doc/src/sgml/ref/pg_dumpall.sgml | 3 ++-
doc/src/sgml/ref/pg_restore.sgml | 3 ++-
3 files changed, 15 insertions(+), 4 deletions(-)
diff --git a/doc/src/sgml/ref/pg_dump.sgml b/doc/src/sgml/ref/pg_dump.sgml
index 34536bf18f3..71bab9681b7 100644
--- a/doc/src/sgml/ref/pg_dump.sgml
+++ b/doc/src/sgml/ref/pg_dump.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.106 2009/01/05 16:54:36 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.107 2009/02/07 14:31:30 momjian Exp $
PostgreSQL documentation
-->
@@ -726,14 +726,16 @@ PostgreSQL documentation
<varlistentry>
<term><envar>PGDATABASE</envar></term>
<term><envar>PGHOST</envar></term>
+ <term><envar>PGOPTIONS</envar></term>
<term><envar>PGPORT</envar></term>
- <term><envar>PGUSER</envar></term>
+ <term><envar>PGUSER</envar></term>
<listitem>
<para>
Default connection parameters.
</para>
</listitem>
+
</varlistentry>
</variablelist>
@@ -757,6 +759,13 @@ PostgreSQL documentation
variables used by the <application>libpq</application> front-end
library will apply.
</para>
+ <para>
+ The database activity of <application>pg_dump</application> is normally collected by the statistics collector.
+ If this is undesirable, you can set parameters <literal>stats_block_level</literal> and <literal>stats_row_level</literal> to false
+ via the <application>libpq</> <envar>PGOPTIONS</envar> environment variable, or via <literal>ALTER USER</literal>.
+ </para>
+
+
</refsect1>
diff --git a/doc/src/sgml/ref/pg_dumpall.sgml b/doc/src/sgml/ref/pg_dumpall.sgml
index e05e4f075d7..dfb8d0dc6f7 100644
--- a/doc/src/sgml/ref/pg_dumpall.sgml
+++ b/doc/src/sgml/ref/pg_dumpall.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/pg_dumpall.sgml,v 1.74 2009/01/05 16:54:36 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/pg_dumpall.sgml,v 1.75 2009/02/07 14:31:30 momjian Exp $
PostgreSQL documentation
-->
@@ -445,6 +445,7 @@ PostgreSQL documentation
<variablelist>
<varlistentry>
<term><envar>PGHOST</envar></term>
+ <term><envar>PGOPTIONS</envar></term>
<term><envar>PGPORT</envar></term>
<term><envar>PGUSER</envar></term>
diff --git a/doc/src/sgml/ref/pg_restore.sgml b/doc/src/sgml/ref/pg_restore.sgml
index 92c9f4be935..787db5e884b 100644
--- a/doc/src/sgml/ref/pg_restore.sgml
+++ b/doc/src/sgml/ref/pg_restore.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/ref/pg_restore.sgml,v 1.78 2009/02/02 20:07:36 adunstan Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/ref/pg_restore.sgml,v 1.79 2009/02/07 14:31:30 momjian Exp $ -->
<refentry id="APP-PGRESTORE">
<refmeta>
@@ -559,6 +559,7 @@
<variablelist>
<varlistentry>
<term><envar>PGHOST</envar></term>
+ <term><envar>PGOPTIONS</envar></term>
<term><envar>PGPORT</envar></term>
<term><envar>PGUSER</envar></term>
--
GitLab