diff options
| author | Magnus Hagander <magnus@hagander.net> | 2011-01-14 16:30:33 +0100 |
|---|---|---|
| committer | Magnus Hagander <magnus@hagander.net> | 2011-01-14 16:30:33 +0100 |
| commit | fcd810c69adf11b6ec1cff35359be0dd27662eff (patch) | |
| tree | b4edb043afe37dc221b765572aa90dafafefcfc7 /doc/src | |
| parent | 688423d004f4092aed73c73a3281c281d476436d (diff) | |
| download | postgresql-fcd810c69adf11b6ec1cff35359be0dd27662eff.tar.gz postgresql-fcd810c69adf11b6ec1cff35359be0dd27662eff.zip | |
Use a lexer and grammar for parsing walsender commands
Makes it easier to parse mainly the BASE_BACKUP command
with it's options, and avoids having to manually deal
with quoted identifiers in the label (previously broken),
and makes it easier to add new commands and options in
the future.
In passing, refactor the case statement in the walsender
to put each command in it's own function.
Diffstat (limited to 'doc/src')
| -rw-r--r-- | doc/src/sgml/protocol.sgml | 21 |
1 files changed, 16 insertions, 5 deletions
diff --git a/doc/src/sgml/protocol.sgml b/doc/src/sgml/protocol.sgml index 80c14fb74cd..76c062fd516 100644 --- a/doc/src/sgml/protocol.sgml +++ b/doc/src/sgml/protocol.sgml @@ -1460,16 +1460,27 @@ The commands accepted in walsender mode are: </varlistentry> <varlistentry> - <term>BASE_BACKUP <replaceable>options</><literal>;</><replaceable>label</></term> + <term>BASE_BACKUP [<literal>LABEL</literal> <replaceable>'label'</replaceable>] [<literal>PROGRESS</literal>]</term> <listitem> <para> Instructs the server to start streaming a base backup. - The system will automatically be put in backup mode with the label - specified in <replaceable>label</> before the backup is started, and - taken out of it when the backup is complete. The following options - are accepted: + The system will automatically be put in backup mode before the backup + is started, and taken out of it when the backup is complete. The + following options are accepted: <variablelist> <varlistentry> + <term><literal>LABEL</literal> <replaceable>'label'</replaceable></term> + <listitem> + <para> + Sets the label of the backup. If none is specified, a backup label + of <literal>base backup</literal> will be used. The quoting rules + for the label are the same as a standard SQL string with + <xref linkend="guc-standard-conforming-strings"> turned on. + </para> + </listitem> + </varlistentry> + + <varlistentry> <term><literal>PROGRESS</></term> <listitem> <para> |