'\" t
.\"     Title: amanda-match
.\"    Author: Dustin J. Mitchell <dustin@zmanda.com>
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: 12/01/2017
.\"    Manual: Miscellanea
.\"    Source: Amanda 3.5.1
.\"  Language: English
.\"
.TH "AMANDA\-MATCH" "7" "12/01/2017" "Amanda 3\&.5\&.1" "Miscellanea"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
amanda-match \- Common Amanda Match Expression
.SH "DESCRIPTION"
.PP
Several Amanda commands allow the user to specify dumps using "match expressions"\&. This manual page describes the syntax of these expressions\&.
.PP
In some places, only certain match expressions are allowed\&. However, several commands take a dump specification ("dumpspec") consisting of a sequence of several expressions intended to match particular dumps in the catalog\&. Other applications take a DLE specification which indicates a set of DLEs to be operated on\&. These formats are described below\&.
.PP
An expression can be disabled be preceding it with the \*(Aq=\*(Aq character, in that case, an exact match is used\&.
.PP
Many program have an \*(Aq\-\-exact\-match\*(Aq argument that disable expression and exact match are used\&.
.SH "HOST & DISK EXPRESSIONS"
.PP
The hosts and disks match by word\&. Each word is a glob expression, and words are separated by the character \*(Aq\&.\*(Aq for host expressions and \*(Aq/\*(Aq for disk expressions\&. You can anchor the expression on the left with a \*(Aq^\*(Aq or on the right with a \*(Aq$\*(Aq\&. The matcher is case insensitive for hosts but case sensitive for disks\&. A match succeeds if all words in the expression match contiguous words in the host or disk\&.
.PP
If the disk is a UNC ("\e\ewindows\eshare") then all \*(Aq\e\*(Aq are converted to \*(Aq/\*(Aq before the match\&. Using \*(Aq\e\*(Aq is complicated because of the extra quoting required by the shell and amanda\&. It\*(Aqs easier to use \*(Aq/\*(Aq because it requires less quoting ("//windows/share")
.PP
The special characters follow\&. Note that the shell interprets some of these characters, so when used on the command line, they must be escaped appropriately for the shell\&.
.PP
dot (\&.)
.RS 4
word separator for a host
.RE
.PP
/
.RS 4
word separator for a disk
.RE
.PP
\e
.RS 4
word separator for a UNC disk
.RE
.PP
^
.RS 4
anchor at left of word
.RE
.PP
$
.RS 4
anchor at right of word
.RE
.PP
?
.RS 4
match exactly one character except the separator
.RE
.PP
*
.RS 4
match zero or more characters except the separator
.RE
.PP
**
.RS 4
match zero or more characters including the separator
.RE
.PP
[\&.\&.\&.]
.RS 4
match exactly one of the characters enclosed by the brackets\&.
.RE
.PP
[!\&.\&.\&.]
.RS 4
match exactly one character that is not enclosed by the brackets\&.
.RE
.SS "Examples"
.PP
hosta
.RS 4
Will match
hosta,
foo\&.hosta\&.org, and
hoSTA\&.dOMAIna\&.ORG
but not
hostb\&.
.RE
.PP
host
.RS 4
Will match
host
but not
hosta\&.
.RE
.PP
host?
.RS 4
Will match
hosta
and
hostb, but not
host
or
hostabc\&.
.RE
.PP
ho*na
.RS 4
Will match
hoina
but not
ho\&.aina\&.org\&.
.RE
.PP
ho**na
.RS 4
Will match
hoina
and
ho\&.aina\&.org\&.
.RE
.PP
^hosta
.RS 4
Will match
hosta
but not
foo\&.hosta\&.org\&.
.RE
.PP
sda*
.RS 4
Will match
/dev/sda1
and
/dev/sda12\&.
.RE
.PP
/opt
.RS 4
Will match the disk
opt
but not the host
opt\&.
.RE
.PP
(note dots:) \&.opt\&.
.RS 4
Will match the host
opt
but not the disk
opt\&.
.RE
.PP
/
.RS 4
Will match the disk
/
but no other disk\&.
.RE
.PP
/usr
.RS 4
Will match the disks
/usr
and
/usr/local\&.
.RE
.PP
/usr$
.RS 4
Will match the disks
/usr
but not
/usr/local\&.
.RE
.PP
share
.RS 4
Will match the disks
\e\ewindows1\eshare
and
\e\ewindows2\eshare\&.
.RE
.PP
share*
.RS 4
Will match the disks
\e\ewindows\eshare1
and
\e\ewindows\eshare2\&.
.RE
.PP
//windows/share
.RS 4
Will match the disk
\e\ewindows\eshare\&.
.RE
.SH "DATESTAMP EXPRESSIONS"
.PP
A datestamp expression is either a prefix of the datestamp, or a range expression (separated by \*(Aq\-\*(Aq) matching several prefixes\&. A leading ^ is removed, while arailing $ will force an exact match\&.
.SS "Examples"
.PP
20001212\-14
.RS 4
match all dates beginning with 20001212, 20001213 or 20001214
.RE
.PP
20001212\-4
.RS 4
same as previous
.RE
.PP
20001212\-24
.RS 4
match all dates between 20001212 and 20001224
.RE
.PP
2000121
.RS 4
match all dates that start with 2000121 (20001210\-20001219)
.RE
.PP
2
.RS 4
match all dates that start with 2 (20000101\-29991231)
.RE
.PP
2000\-10
.RS 4
match all dates between 20000101\-20101231
.RE
.PP
200010$
.RS 4
match only 200010
.RE
.SH "LEVEL EXPRESSIONS"
.PP
Level expressions are either prefix matches e\&.g\&., "1", which matches "1", "10", and "123", absolute matches e\&.g\&., "3$" which only matches "3", or a range e\&.g\&., "3\-5" which only matches levels 3, 4, and 5\&.
.SH "DUMP SPECIFICATIONS"
.PP
A dump specification is used to select one or more dumps from the catalog\&. It consists of a sequence of match expressions in the order host, disk, datestamp, and level\&. Note that some commands do not take a level argument, out of historical accident\&. Note, too, that the datestamp expression matches the time that the dump was made on the Amanda client, rather than the date it was moved to tape\&.
.SS "Examples"
.PP
amtool MyConfig ^vpdesktop$
.RS 4
all dumps of host "vpdesktop"
.RE
.PP
amtool MyConfig \*(Aq*\*(Aq /var/stage
.RS 4
All dumps of
/var/stage
on any host
.RE
.PP
amtool MyConfig www1 /var/www \*(Aq*\*(Aq www2 /var/www \*(Aq*\*(Aq
.RS 4
All dumps of /var/www on www1 and www2 (assuming amtool does not require a level argument)
.RE
.SH "DLE SPECIFICATIONS"
.PP
A DLE specification is used to select one or more DLEs\&. It consists of a sequence of match expressions\&. The first must be a host, and subsequent expressions will be experimentally matched against both hosts and disks in the
\fBdisklist\fR(5), preferring hosts\&. This dynamic matching process can lead to odd behavior in extreme cases (e\&.g\&., where a disk and a host have the same name), but for most uses does exactly what is expected\&.
.SS "Examples"
.PP
amtool MyConfig vpdesktop /home/anderson
.RS 4
/home/anderson
on host vpdesktop
.RE
.PP
amtool MyConfig \*(Aq*\*(Aq ^/etc \*(Aq*\*(Aq ^/var
.RS 4
All DLEs matching
^/var
or
^/etc
on any host
.RE
.PP
amtool MyConfig web1 www web2 www
.RS 4
If no host matches "www", all DLEs matching
www
on hosts web1 and web2\&. If a host matches "www", then all DLEs on hosts www, web1, and web2\&.
.RE
.SH "SEE ALSO"
.PP
\fBamanda\fR(8),
\fBamanda\fR(8),
\fBamfetchdump\fR(8),
\fBamrestore\fR(8),
\fBamadmin\fR(8),
\fBamvault\fR(8),
\fBamflush\fR(8),
\fBamdump\fR(8)
.PP
The Amanda Wiki:
: http://wiki.zmanda.com/
.SH "AUTHOR"
.PP
\fBDustin J\&. Mitchell\fR <\&dustin@zmanda\&.com\&>
.RS 4
Zmanda, Inc\&. (http://www\&.zmanda\&.com)
.RE