diff options
Diffstat (limited to 'doc/src')
| -rw-r--r-- | doc/src/sgml/ref/pg_dump.sgml | 38 |
1 files changed, 30 insertions, 8 deletions
diff --git a/doc/src/sgml/ref/pg_dump.sgml b/doc/src/sgml/ref/pg_dump.sgml index 8b9d9f4cad4..363d1327e2c 100644 --- a/doc/src/sgml/ref/pg_dump.sgml +++ b/doc/src/sgml/ref/pg_dump.sgml @@ -644,17 +644,39 @@ PostgreSQL documentation </varlistentry> <varlistentry> - <term><option>-Z <replaceable class="parameter">0..9</replaceable></option></term> - <term><option>--compress=<replaceable class="parameter">0..9</replaceable></option></term> + <term><option>-Z <replaceable class="parameter">level</replaceable></option></term> + <term><option>-Z <replaceable class="parameter">method</replaceable></option>[:<replaceable>detail</replaceable>]</term> + <term><option>--compress=<replaceable class="parameter">level</replaceable></option></term> + <term><option>--compress=<replaceable class="parameter">method</replaceable></option>[:<replaceable>detail</replaceable>]</term> <listitem> <para> - Specify the compression level to use. Zero means no compression. + Specify the compression method and/or the compression level to use. + The compression method can be set to <literal>gzip</literal> or + <literal>none</literal> for no compression. + A compression detail string can optionally be specified. If the + detail string is an integer, it specifies the compression level. + Otherwise, it should be a comma-separated list of items, each of the + form <literal>keyword</literal> or <literal>keyword=value</literal>. + Currently, the only supported keyword is <literal>level</literal>. + </para> + + <para> + If no compression level is specified, the default compression + level will be used. If only a level is specified without mentioning + an algorithm, <literal>gzip</literal> compression will be used if + the level is greater than <literal>0</literal>, and no compression + will be used if the level is <literal>0</literal>. + </para> + + <para> For the custom and directory archive formats, this specifies compression of - individual table-data segments, and the default is to compress - at a moderate level. - For plain text output, setting a nonzero compression level causes - the entire output file to be compressed, as though it had been - fed through <application>gzip</application>; but the default is not to compress. + individual table-data segments, and the default is to compress using + <literal>gzip</literal> at a moderate level. For plain text output, + setting a nonzero compression level causes the entire output file to be compressed, + as though it had been fed through <application>gzip</application>; but the default + is not to compress. + </para> + <para> The tar archive format currently does not support compression at all. </para> </listitem> |