From: Tom Lane <tgl@sss.pgh.pa.us>
Date: Sat, 22 Oct 2005 22:09:49 +0000 (+0000)
Subject: Add a note about GNU tar's propensity to complain if a file changes
X-Git-Tag: REL8_1_0BETA4~1
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=c3a7b0577b6eb9586076d0cf91503ee30b3824fb;p=thirdparty%2Fpostgresql.git

Add a note about GNU tar's propensity to complain if a file changes
while tar is copying it.  This behavior is unhelpful when taking a base
backup.  Per gripe from Pallav Kalva back in April.
---

diff --git a/doc/src/sgml/backup.sgml b/doc/src/sgml/backup.sgml
index e8f8b8a5813..74f3add15c3 100644
--- a/doc/src/sgml/backup.sgml
+++ b/doc/src/sgml/backup.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/backup.sgml,v 2.72 2005/10/22 21:56:07 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/backup.sgml,v 2.73 2005/10/22 22:09:49 tgl Exp $
 -->
 <chapter id="backup">
  <title>Backup and Restore</title>
@@ -676,6 +676,15 @@ SELECT pg_stop_backup();
   </orderedlist>
    </para>
 
+   <para>
+    Some versions of GNU <application>tar</> consider it an error if a file
+    is changed while <application>tar</> is copying it.  This case is normal,
+    and not an error, when taking a base backup of an active database.
+    Since ignoring all errors from <application>tar</> would be unwise,
+    you should either manually inspect <application>tar</>'s messages or
+    else use a different backup tool that does not complain about this case.
+   </para>
+
    <para>
     It is not necessary to be very concerned about the amount of time elapsed
     between <function>pg_start_backup</> and the start of the actual backup,