From: Bruce Momjian <bruce@momjian.us>
Date: Fri, 14 Sep 2007 04:16:44 +0000 (+0000)
Subject: Update GNU tar error code documentation.
X-Git-Url: http://git.postgresql.org/gitweb/static/gitweb.js?a=commitdiff_plain;h=9d0c82b5cba2332b0bff38e27d77242a52f57f9b;p=users%2Fbernd%2Fpostgres.git

Update GNU tar error code documentation.

Backpatch to 8.2.X.
---

diff --git a/doc/src/sgml/backup.sgml b/doc/src/sgml/backup.sgml
index 0342d76fa8..8417d424d0 100644
--- a/doc/src/sgml/backup.sgml
+++ b/doc/src/sgml/backup.sgml
@@ -718,13 +718,12 @@ SELECT pg_stop_backup();
     complaints of this sort from real errors.  For example, some versions
     of <application>rsync</> return a separate exit code for <quote>vanished
     source files</>, and you can write a driver script to accept this exit
-    code as a non-error case.  Also,
-    some versions of GNU <application>tar</> consider it an error if a file
-    is changed while <application>tar</> is copying it.  There does not seem
-    to be any very convenient way to distinguish this error from other types
-    of errors, other than manual inspection of <application>tar</>'s messages.
-    GNU <application>tar</> is therefore not the best tool for making base
-    backups.
+    code as a non-error case.  Also, some versions of GNU
+    <application>tar</> consider it an error if a file was truncated while
+    <application>tar</> is copying it.  Fortunately, GNU
+    <application>tar</> versions 1.16 and later exits with <literal>1</>
+    if a file was changed during the backup, and <literal>2</> for other
+    errors.
    </para>
 
    <para>