pgsql: doc: Clarify how to generate backup files with non-exclusive bac - Mailing list pgsql-committers

From Michael Paquier
Subject pgsql: doc: Clarify how to generate backup files with non-exclusive bac
Date
Msg-id E1lSENr-0008SL-L4@gemulon.postgresql.org
Whole thread Raw
List pgsql-committers
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

Branch
------
REL_10_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/89bd8e8b332841247649551e95c8d22c19a97529

Modified Files
--------------
doc/src/sgml/backup.sgml | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)


pgsql-committers by date:

Previous
From: Fujii Masao
Date:
Subject: pgsql: Fix typos in comments.
Next
From: Fujii Masao
Date:
Subject: pgsql: Fix pgstat_report_replslot() to use proper data types for its ar