ambiser
/
btrbk
mirror of https://github.com/digint/btrbk
9
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

documentation: added documentation for ---raw-output command line option

pull/57/head
Axel Burri 2015-09-24 00:39:29 +02:00
parent a1467fa629
commit 8059fa28db
3 changed files with 37 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
ChangeLog
View File

@ -2,6 +2,8 @@ btrbk-current
* Added configuration option "group". * Added configuration option "group".
* Allow filtering subcommands by group as well as targets. * Allow filtering subcommands by group as well as targets.
* Added "--raw-output" command line option, producing raw
(machine-readable) output for "(dry)run" and "tree" commands.
* Added configuration option "ssh_cipher_spec" (close: #47). * Added configuration option "ssh_cipher_spec" (close: #47).
* Hardened ssh_filter_btrbk.sh script: fine-grained access control, * Hardened ssh_filter_btrbk.sh script: fine-grained access control,
restrict-path option, sudo option (close: #45) restrict-path option, sudo option (close: #45)

1
btrbk
View File

@ -147,6 +147,7 @@ sub HELP_MESSAGE
print STDERR " -v, --verbose be verbose (set loglevel=info)\n"; print STDERR " -v, --verbose be verbose (set loglevel=info)\n";
print STDERR " -q, --quiet be quiet (do not print summary for the \"run\" command)\n"; print STDERR " -q, --quiet be quiet (do not print summary for the \"run\" command)\n";
print STDERR " -l, --loglevel=LEVEL set logging level (warn, info, debug, trace)\n"; print STDERR " -l, --loglevel=LEVEL set logging level (warn, info, debug, trace)\n";
print STDERR " --raw-output print raw (machine-readable) output\n";
print STDERR " --progress show progress bar on send-receive operation\n"; print STDERR " --progress show progress bar on send-receive operation\n";
print STDERR "\n"; print STDERR "\n";
print STDERR "commands:\n"; print STDERR "commands:\n";

34
doc/btrbk.1
View File

@ -74,6 +74,12 @@ Set the level of verbosity. Accepted levels are warn, info, debug,
and trace. and trace.
.RE .RE
.PP .PP
\-\-raw\-output
.RS 4
Print raw (machine-readable) output. Changes output format for
\fBrun\fR, \fBdryrun\fR and \fBtree\fR. Useful for further scripting.
.RE
.PP
\-\-progress \-\-progress
.RS 4 .RS 4
Show progress bar on send-receive operation. Show progress bar on send-receive operation.
@ -109,6 +115,26 @@ snapshots and backup subvolumes that are not preserved by their
configured retention policy will be deleted. Note that the latest configured retention policy will be deleted. Note that the latest
snapshot as well as the latest backup is always preserved, regardless snapshot as well as the latest backup is always preserved, regardless
of the retention policy. of the retention policy.
.PP
If the \-\-raw\-output command line option is set, print the output in
the following format:
.PP
.RS 4
snapshot <snapshot-url> <src-subvol-url>
...
.RE
.RS 4
receive <target-url> <src-subvol-url> [<parent-subvol-url>]
...
.RE
.RS 4
delete <target-url>
...
.RE
.RS 4
aborted [volume|subvolume|target] <url> -- abort_reason
...
.RE
.RE .RE
.PP .PP
.B dryrun .B dryrun
@ -134,6 +160,14 @@ STATEMENTS\fR below).
Print the snapshots and their corresponding backup subvolumes as a Print the snapshots and their corresponding backup subvolumes as a
tree. Optionally filtered by [filter...] arguments (see \fIFILTER tree. Optionally filtered by [filter...] arguments (see \fIFILTER
STATEMENTS\fR below). STATEMENTS\fR below).
.PP
If the \-\-raw\-output command line option is set, print the output in
the following format:
.PP
.RS 4
<subvol-url> <snapshot-url> <received-from-url>
...
.RE
.RE .RE
.PP .PP
.B origin .B origin