diff --git a/doc/src/sgml/backup.sgml b/doc/src/sgml/backup.sgml
index b646c7c598..cec8ff5fe2 100644
--- a/doc/src/sgml/backup.sgml
+++ b/doc/src/sgml/backup.sgml
@@ -560,7 +560,8 @@ tar -cf backup.tar /usr/local/pgsql/data
character in the command. The simplest useful command is something
like:
-archive_command = 'cp -i %p /mnt/server/archivedir/%f </dev/null'
+archive_command = 'test ! -f /mnt/server/archivedir/%f && cp %p /mnt/server/archivedir/%f' # Unix
+archive_command = 'copy "%p" "C:\\server\\archivedir\\%f"' # Windows
which will copy archivable WAL segments to the directory
/mnt/server/archivedir>. (This is an example, not a
@@ -568,7 +569,7 @@ archive_command = 'cp -i %p /mnt/server/archivedir/%f </dev/null'
%p> and %f> parameters have been replaced,
the actual command executed might look like this:
-cp -i pg_xlog/00000001000000A900000065 /mnt/server/archivedir/00000001000000A900000065 </dev/null
+test ! -f /mnt/server/archivedir/00000001000000A900000065 && cp pg_xlog/00000001000000A900000065 /mnt/server/archivedir/00000001000000A900000065
A similar command will be generated for each new file to be archived.
@@ -597,17 +598,19 @@ cp -i pg_xlog/00000001000000A900000065 /mnt/server/archivedir/00000001000000A900
preserve the integrity of your archive in case of administrator error
(such as sending the output of two different servers to the same archive
directory).
+
+
+
It is advisable to test your proposed archive command to ensure that it
indeed does not overwrite an existing file, and that it returns
- nonzero status in this case>. We have found that cp -i> does
- this correctly on some platforms but not others. If the chosen command
- does not itself handle this case correctly, you should add a command
- to test for pre-existence of the archive file. For example, something
- like:
-
-archive_command = 'test ! -f .../%f && cp %p .../%f'
-
- works correctly on most Unix variants.
+ nonzero status in this case>.
+ The example command above for Unix ensures this by including a separate
+ test> step. On some Unix platforms, cp> has
+ switches such as