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

documentation: btrbk.1: update filter statements section

pull/286/head
Axel Burri 2019-04-17 16:55:59 +02:00
parent 95819f03ea
commit 14b5edcf68
1 changed files with 31 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

47
doc/btrbk.1.asciidoc
View File

@ -362,27 +362,42 @@ FILTER STATEMENTS
Filter arguments are accepted in form: Filter arguments are accepted in form:
<group-name>:: <group-name>::
Matches the 'group' configuration option of a 'volume', Matches the 'group' configuration option of 'volume', 'subvolume'
'subvolume' or 'target' section (including all underlying or 'target' sections.
sections).
[hostname:]<volume-directory>:: <hostname>[:<port>]::
Matches all subvolumes and targets of a 'volume' configuration Matches the 'hostname' portion from '<url>' of 'volume' or
section. 'target' sections.
[hostname:]<volume-directory>/<subvolume-name>:: <directory>|<url>::
Matches the specified subvolume and all targets of a 'subvolume' Matches 'volume', 'subvolume' or 'target' sections by either
configuration section. relative or absolute path (if starting with "/" or "ssh://" or
"<hostname>:/"), accepting wildcard character "*". Relative paths
are matched against the end of the pathname. Either:
+
--
<volume-directory>::
Matches 'volume' sections.
[hostname:]<target-directory>:: <volume-directory>/<subvolume-name>::
Matches all targets of a 'target' configuration section. Matches 'subvolume' sections.
[hostname:]<target-directory>/<snapshot-name>:: <volume-directory>/<snapshot-dir>/<snapshot-name>::
Matches a single target of a 'target' section within a 'subvolume' Matches 'subvolume' sections defining snapshots with the
section with given <snapshot-name>. configured 'snapshot_dir' and 'snapshot_name'.
For convenience, [hostname:] can be specified as either "hostname:" or <target-directory>::
"ssh://hostname[:port]/". Matches 'target' sections.
<target-directory>/<snapshot-name>::
Matches 'target' sections within 'subvolume' sections defining
snapshots with the configured 'snapshot_name'.
Accepted formats for '<url>' are:
ssh://<hostname>[:<port>]/<directory>
<hostname>:<directory>
--
Note that for *run* and *snapshot* commands, a filter matching a Note that for *run* and *snapshot* commands, a filter matching a
'target' configuration section also enables snapshot creation of the 'target' configuration section also enables snapshot creation of the