1
1
<!--
2
- $PostgreSQL: pgsql/doc/src/sgml/ref/pg_dumpall.sgml,v 1.68 2007/03/26 17:23:37 tgl Exp $
2
+ $PostgreSQL: pgsql/doc/src/sgml/ref/pg_dumpall.sgml,v 1.69 2007/12/11 19:57:32 tgl Exp $
3
3
PostgreSQL documentation
4
4
-->
5
5
@@ -59,7 +59,7 @@ PostgreSQL documentation
59
59
<para>
60
60
<application>pg_dumpall</application> needs to connect several
61
61
times to the <productname>PostgreSQL</productname> server (once per
62
- database). If you use password authentication itis likely to ask for
62
+ database). If you use password authentication itwill ask for
63
63
a password each time. It is convenient to have a
64
64
<filename>~/.pgpass</> file in such cases. See <xref
65
65
linkend="libpq-pgpass"> for more information.
@@ -367,7 +367,7 @@ PostgreSQL documentation
367
367
<term>--username=<replaceable>username</replaceable></term>
368
368
<listitem>
369
369
<para>
370
- Connect as the given user .
370
+ User name to connect as .
371
371
</para>
372
372
</listitem>
373
373
</varlistentry>
@@ -377,8 +377,24 @@ PostgreSQL documentation
377
377
<term>--password</term>
378
378
<listitem>
379
379
<para>
380
- Force a password prompt. This should happen automatically if
381
- the server requires password authentication.
380
+ Force <application>pg_dumpall</application> to prompt for a
381
+ password before connecting to a database.
382
+ </para>
383
+
384
+ <para>
385
+ This option is never essential, since
386
+ <application>pg_dumpall</application> will automatically prompt
387
+ for a password if the server demands password authentication.
388
+ However, <application>pg_dumpall</application> will waste a
389
+ connection attempt finding out that the server wants a password.
390
+ In some cases it is worth typing <option>-W</> to avoid the extra
391
+ connection attempt.
392
+ </para>
393
+
394
+ <para>
395
+ Note that the password prompt will occur again for each database
396
+ to be dumped. Usually, it's better to set up a
397
+ <filename>~/.pgpass</> file than to rely on manual password entry.
382
398
</para>
383
399
</listitem>
384
400
</varlistentry>