1AMANDA-MATCH(7) Miscellanea AMANDA-MATCH(7)
2
6 amanda-match - Common Amanda Match Expression
7
9 Several Amanda commands allow the user to specify dumps using "match
10 expressions". This manual page describes the syntax of these
11 expressions.
12 In some places, only certain match expressions are allowed. However,
14 several commands take a dump specification ("dumpspec") consisting of a
15 sequence of several expressions intended to match particular dumps in
16 the catalog. Other applications take a DLE specification which
17 indicates a set of DLEs to be operated on. These formats are described
18 below.
19 An expression can be disabled be preceding it with the '=' character,
21 in that case, an exact match is used.
22 Many program have an '--exact-match' argument that disable expression
24 and exact match are used.
25
27 The hosts and disks match by word. Each word is a glob expression, and
28 words are separated by the character '.' for host expressions and '/'
29 for disk expressions. You can anchor the expression on the left with a
30 '^' or on the right with a '$'. The matcher is case insensitive for
31 hosts but case sensitive for disks. A match succeeds if all words in
32 the expression match contiguous words in the host or disk.
33 If the disk is a UNC ("\\windows\share") then all '\' are converted to
35 '/' before the match. Using '\' is complicated because of the extra
36 quoting required by the shell and amanda. It's easier to use '/'
37 because it requires less quoting ("//windows/share")
38 The special characters follow. Note that the shell interprets some of
40 these characters, so when used on the command line, they must be
41 escaped appropriately for the shell.
42 dot (.)
44 word separator for a host
45 /
47 word separator for a disk
48 \
50 word separator for a UNC disk
51 ^
53 anchor at left of word
54 $
56 anchor at right of word
57 ?
59 match exactly one character except the separator
60 *
62 match zero or more characters except the separator
63 **
65 match zero or more characters including the separator
66 [...]
68 match exactly one of the characters enclosed by the brackets.
69 [!...]
71 match exactly one character that is not enclosed by the brackets.
72 Examples
74 hosta
75 Will match hosta, foo.hosta.org, and hoSTA.dOMAIna.ORG but not
76 hostb.
77 host
79 Will match host but not hosta.
80 host?
82 Will match hosta and hostb, but not host or hostabc.
83 ho*na
85 Will match hoina but not ho.aina.org.
86 ho**na
88 Will match hoina and ho.aina.org.
89 ^hosta
91 Will match hosta but not foo.hosta.org.
92 sda*
94 Will match /dev/sda1 and /dev/sda12.
95 /opt
97 Will match the disk opt but not the host opt.
98 (note dots:) .opt.
100 Will match the host opt but not the disk opt.
101 /
103 Will match the disk / but no other disk.
104 /usr
106 Will match the disks /usr and /usr/local.
107 /usr$
109 Will match the disks /usr but not /usr/local.
110 share
112 Will match the disks \\windows1\share and \\windows2\share.
113 share*
115 Will match the disks \\windows\share1 and \\windows\share2.
116 //windows/share
118 Will match the disk \\windows\share.
119
121 A datestamp expression is either a prefix of the datestamp, or a range
122 expression (separated by '-') matching several prefixes. A leading ^ is
123 removed, while arailing $ will force an exact match.
124 Examples
126 20001212-14
127 match all dates beginning with 20001212, 20001213 or 20001214
128 20001212-4
130 same as previous
131 20001212-24
133 match all dates between 20001212 and 20001224
134 2000121
136 match all dates that start with 2000121 (20001210-20001219)
137 2
139 match all dates that start with 2 (20000101-29991231)
140 2000-10
142 match all dates between 20000101-20101231
143 200010$
145 match only 200010
146
148 Level expressions are either prefix matches e.g., "1", which matches
149 "1", "10", and "123", absolute matches e.g., "3$" which only matches
150 "3", or a range e.g., "3-5" which only matches levels 3, 4, and 5.
151
153 A dump specification is used to select one or more dumps from the
154 catalog. It consists of a sequence of match expressions in the order
155 host, disk, datestamp, and level. Note that some commands do not take a
156 level argument, out of historical accident. Note, too, that the
157 datestamp expression matches the time that the dump was made on the
158 Amanda client, rather than the date it was moved to tape.
159 Examples
161 amtool MyConfig ^vpdesktop$
162 all dumps of host "vpdesktop"
163 amtool MyConfig '*' /var/stage
165 All dumps of /var/stage on any host
166 amtool MyConfig www1 /var/www '*' www2 /var/www '*'
168 All dumps of /var/www on www1 and www2 (assuming amtool does not
169 require a level argument)
170
172 A DLE specification is used to select one or more DLEs. It consists of
173 a sequence of match expressions. The first must be a host, and
174 subsequent expressions will be experimentally matched against both
175 hosts and disks in the disklist(5), preferring hosts. This dynamic
176 matching process can lead to odd behavior in extreme cases (e.g., where
177 a disk and a host have the same name), but for most uses does exactly
178 what is expected.
179 Examples
181 amtool MyConfig vpdesktop /home/anderson
182 /home/anderson on host vpdesktop
183 amtool MyConfig '*' ^/etc '*' ^/var
185 All DLEs matching ^/var or ^/etc on any host
186 amtool MyConfig web1 www web2 www
188 If no host matches "www", all DLEs matching www on hosts web1 and
189 web2. If a host matches "www", then all DLEs on hosts www, web1,
190 and web2.
191
193 amanda(8), amanda(8), amfetchdump(8), amrestore(8), amadmin(8),
194 amvault(8), amflush(8), amdump(8)
195 The Amanda Wiki: : http://wiki.zmanda.com/
197
199 Dustin J. Mitchell <dustin@zmanda.com>
200 Zmanda, Inc. (http://www.zmanda.com)
201Amanda 3.5.4 07/27/2023 AMANDA-MATCH(7)