mirror/postgresql
2
0
Fork 0
mirror of https://git.postgresql.org/git/postgresql.git synced 2024-12-21 08:29:39 +08:00
Code Issues Packages Projects Releases Wiki Activity

Marginal improvement of description of recovery_end_command.

Browse Source
This commit is contained in:
Tom Lane 2009-06-26 22:06:11 +00:00
parent 2de48a83e6
commit df858fe58a
1 changed files with 14 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
doc/src/sgml/backup.sgml
View File

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/backup.sgml,v 2.128 2009/06/05 13:40:31 momjian Exp $ --> <!-- $PostgreSQL: pgsql/doc/src/sgml/backup.sgml,v 2.129 2009/06/26 22:06:11 tgl Exp $ -->
<chapter id="backup"> <chapter id="backup">
<title>Backup and Restore</title> <title>Backup and Restore</title>
@ -1108,8 +1108,9 @@ restore_command = 'cp /mnt/server/archivedir/%f %p'
last valid restart point. That is the earliest file that must be kept last valid restart point. That is the earliest file that must be kept
to allow a restore to be restartable, so this information can be used to allow a restore to be restartable, so this information can be used
to truncate the archive to just the minimum required to support to truncate the archive to just the minimum required to support
restart of the current restore. <literal>%r</> would only be used in a restart from the current restore. <literal>%r</> would typically be
warm-standby configuration (see <xref linkend="warm-standby">). used in a warm-standby configuration
(see <xref linkend="warm-standby">).
Write <literal>%%</> to embed an actual <literal>%</> character Write <literal>%%</> to embed an actual <literal>%</> character
in the command. in the command.
</para> </para>
@ -1132,19 +1133,23 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows
<para> <para>
This parameter specifies a shell command that will be executed once only This parameter specifies a shell command that will be executed once only
at the end of recovery. This parameter is optional. The purpose of the at the end of recovery. This parameter is optional. The purpose of the
recovery_end_command is to provide a mechanism for cleanup following <varname>recovery_end_command</> is to provide a mechanism for cleanup
replication or recovery. following replication or recovery.
Any <literal>%r</> is replaced by the name of the file Any <literal>%r</> is replaced by the name of the file
containing the last valid restart point. That is the earliest file that containing the last valid restart point. That is the earliest file that
must be kept to allow a restore to be restartable, so this information must be kept to allow a restore to be restartable, so this information
can be used to truncate the archive to just the minimum required to can be used to truncate the archive to just the minimum required to
support restart of the current restore. <literal>%r</> would only be support restart from the current restore. <literal>%r</> would
used in a warm-standby configuration (see <xref linkend="warm-standby">). typically be used in a warm-standby configuration
(see <xref linkend="warm-standby">).
Write <literal>%%</> to embed an actual <literal>%</> character Write <literal>%%</> to embed an actual <literal>%</> character
in the command. in the command.
</para>
<para>
If the command returns a non-zero exit status then a WARNING log If the command returns a non-zero exit status then a WARNING log
message will be written, unless signalled in which case we return message will be written and the database will proceed to start up
a FATAL error. anyway. An exception is that if the command was terminated by a
signal, the database will not proceed with startup.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>