aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBruce Momjian <bruce@momjian.us>2011-06-23 19:57:42 -0400
committerBruce Momjian <bruce@momjian.us>2011-06-23 19:58:14 -0400
commit194e6ee74b0282d0a7b8d0c815ea7204fc23cec9 (patch)
tree1d9388fefbd5d5167b29e878dda0f7e1065a9a46
parentd34e142c511c779a294ce96eee0e9ab535b24de3 (diff)
downloadpostgresql-194e6ee74b0282d0a7b8d0c815ea7204fc23cec9.tar.gz
postgresql-194e6ee74b0282d0a7b8d0c815ea7204fc23cec9.zip
In pg_upgrade docs, clarify that link mode uses "hard" links.
Backpatch to 9.1 and 9.0.
-rw-r--r--doc/src/sgml/pgupgrade.sgml20
1 files changed, 12 insertions, 8 deletions
diff --git a/doc/src/sgml/pgupgrade.sgml b/doc/src/sgml/pgupgrade.sgml
index a505707cc01..b24c1e7b981 100644
--- a/doc/src/sgml/pgupgrade.sgml
+++ b/doc/src/sgml/pgupgrade.sgml
@@ -105,7 +105,7 @@
<varlistentry>
<term><option>-k</option></term>
<term><option>--link</option></term>
- <listitem><para>link instead of copying files to new cluster</para></listitem>
+ <listitem><para>use hard links instead of copying files to the new cluster</para></listitem>
</varlistentry>
<varlistentry>
@@ -293,14 +293,18 @@ NET STOP pgsql-8.3 (<productname>PostgreSQL</> 8.3 and older used a different s
<para>
Always run the <application>pg_upgrade</> binary of the new server, not the old one.
<application>pg_upgrade</> requires the specification of the old and new cluster's
- data and executable (<filename>bin</>) directories. You can also specify separate
+ data and executable (<filename>bin</>) directories. You can also specify
user and port values, and whether you want the data linked instead of
- copied (the default). If you use linking, the upgrade will be much
- faster (hard link data files rather than copying them), but you
- will no longer be able to access your old cluster once you start
- the new cluster after the upgrade. Link mode also requires that the
- old and new cluster data directories be in the same file system.
- See <literal>pg_upgrade --help</> for a full list of options.
+ copied (the default).
+ </para>
+
+ <para>
+ If you use link mode, the upgrade will be much faster (no file
+ copying), but you will not be able to access your old cluster
+ once you start the new cluster after the upgrade. Link mode also
+ requires that the old and new cluster data directories be in the
+ same file system. See <literal>pg_upgrade --help</> for a full
+ list of options.
</para>
<para>