]> git.ipfire.org Git - thirdparty/postgresql.git/commit
doc: Clarify how to generate backup files with non-exclusive backups
authorMichael Paquier <michael@paquier.xyz>
Fri, 2 Apr 2021 07:37:11 +0000 (16:37 +0900)
committerMichael Paquier <michael@paquier.xyz>
Fri, 2 Apr 2021 07:37:11 +0000 (16:37 +0900)
commit677357047b9c920e351b73d9670a813fcdc6801b
treeddcba2ba5d0c255e9b208e327e96ba1686708f51
parentd6ca789dde70f2c323b79559b8ce0746ddf7a48d
doc: Clarify how to generate backup files with non-exclusive backups

The current instructions describing how to write the backup_label and
tablespace_map files are confusing.  For example, opening a file in text
mode on Windows and copy-pasting the file's contents would result in a
failure at recovery because of the extra CRLF characters generated.  The
documentation was not stating that clearly, and per discussion this is
not considered as a supported scenario.

This commit extends a bit the documentation to mention that it may be
required to open the file in binary mode before writing its data.

Reported-by: Wang Shenhao
Author: David Steele
Reviewed-by: Andrew Dunstan, Magnus Hagander
Discussion: https://postgr.es/m/8373f61426074f2cb6be92e02f838389@G08CNEXMBPEKD06.g08.fujitsu.local
Backpatch-through: 9.6
doc/src/sgml/backup.sgml