amanda-match man page on Oracle

Man page or keyword search:  
man Server   33470 pages
apropos Keyword Search (all sections)
Output format
Oracle logo
[printable version]

AMANDA-MATCH(7)			  Miscellanea		       AMANDA-MATCH(7)

       amanda-match - Common Amanda Match Expression

       Several Amanda commands allow the user to specify dumps using "match
       expressions". This manual page describes the syntax of these

       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

       An expression can be disabled be preceding it with the '=' character,
       in that case, an exact match is used.

       Many program have an '--exact-match' argument that disable expression
       and exact match are used.

       The hosts and disks match by word. Each word is a glob expression, and
       words are separated by the character '.' for host expressions and '/'
       for disk expressions. You can anchor the expression on the left with a
       '^' or on the right with a '$'. 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.

       If the disk is a UNC ("\\windows\share") then all '\' are converted to
       '/' before the match. Using '\' is complicated because of the extra
       quoting required by the shell and amanda. It's easier to use '/'
       because it requires less quoting ("//windows/share")

       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.

       dot (.)
	   word separator for a host

	   word separator for a disk

	   word separator for a UNC disk

	   anchor at left of word

	   anchor at right of word

	   match exactly one character except the separator

	   match zero or more characters except the separator

	   match zero or more characters including the separator

	   match exactly one of the characters enclosed by the brackets.

	   match exactly one character that is not enclosed by the brackets.

	   Will match hosta,, and hoSTA.dOMAIna.ORG but not

	   Will match host but not hosta.

	   Will match hosta and hostb, but not host or hostabc.

	   Will match hoina but not

	   Will match hoina and

	   Will match hosta but not

	   Will match /dev/sda1 and /dev/sda12.

	   Will match the disk opt but not the host opt.

       (note dots:) .opt.
	   Will match the host opt but not the disk opt.

	   Will match the disk / but no other disk.

	   Will match the disks /usr and /usr/local.

	   Will match the disks /usr but not /usr/local.

	   Will match the disks \\windows1\share and \\windows2\share.

	   Will match the disks \\windows\share1 and \\windows\share2.

	   Will match the disk \\windows\share.

       A datestamp expression is either a prefix of the datestamp, or a range
       expression (separated by '-') matching several prefixes. A leading ^ is
       removed, while arailing $ will force an exact match.

	   match all dates beginning with 20001212, 20001213 or 20001214

	   same as previous

	   match all dates between 20001212 and 20001224

	   match all dates that start with 2000121 (20001210-20001219)

	   match all dates that start with 2 (20000101-29991231)

	   match all dates between 20000101-20101231

	   match only 200010

       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.

       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.

       amtool MyConfig ^vpdesktop$
	   all dumps of host "vpdesktop"

       amtool MyConfig '*' /var/stage
	   All dumps of /var/stage on any host

       amtool MyConfig www1 /var/www '*' www2 /var/www '*'
	   All dumps of /var/www on www1 and www2 (assuming amtool does not
	   require a level argument)

       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 disklist(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.

       amtool MyConfig vpdesktop /home/anderson
	   /home/anderson on host vpdesktop

       amtool MyConfig '*' ^/etc '*' ^/var
	   All DLEs matching ^/var or ^/etc on any host

       amtool MyConfig web1 www web2 www
	   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.

       amanda(8), amanda(8), amfetchdump(8), amrestore(8), amadmin(8),
       amvault(8), amflush(8), amdump(8)

       The Amanda Wiki: :

       Dustin J. Mitchell <>
	   Zmanda, Inc. (

Amanda 3.3.3			  01/10/2013		       AMANDA-MATCH(7)

List of man pages available for Oracle

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net