git.gag.com Git - debian/amanda/blob - man/amanda.8

   1 '\" t
   2 .\"     Title: amanda
   3 .\"    Author: James da Silva <jds@amanda.org>
   4 .\" Generator: DocBook XSL Stylesheets vsnapshot_8273 <http://docbook.sf.net/>
   5 .\"      Date: 06/01/2010
   6 .\"    Manual: System Administration Commands
   7 .\"    Source: Amanda 3.1.0
   8 .\"  Language: English
   9 .\"
  10 .TH "AMANDA" "8" "06/01/2010" "Amanda 3\&.1\&.0" "System Administration Commands"
  11 .\" -----------------------------------------------------------------
  12 .\" * set default formatting
  13 .\" -----------------------------------------------------------------
  14 .\" disable hyphenation
  15 .nh
  16 .\" disable justification (adjust text to left margin only)
  17 .ad l
  18 .\" -----------------------------------------------------------------
  19 .\" * MAIN CONTENT STARTS HERE *
  20 .\" -----------------------------------------------------------------
  21 .SH "NAME"
  22 amanda \- The Open Source Backup Platform
  23 .SH "DESCRIPTION"
  24 .PP
  25 This manual page gives an overview of the Amanda commands and configuration files for quick reference\&.
  26 .SS "COMMANDS"
  27 .PP
  28 Here are all the Amanda commands\&. Each one has its own manual page\&. See them for all the gory details\&.
  29 .sp
  30 .RS 4
  31 .ie n \{\
  32 \h'-04'\(bu\h'+03'\c
  33 .\}
  34 .el \{\
  35 .sp -1
  36 .IP \(bu 2.3
  37 .\}
  38 \fBamaddclient\fR(8),
  39 .RE
  40 .sp
  41 .RS 4
  42 .ie n \{\
  43 \h'-04'\(bu\h'+03'\c
  44 .\}
  45 .el \{\
  46 .sp -1
  47 .IP \(bu 2.3
  48 .\}
  49 \fBamadmin\fR(8),
  50 .RE
  51 .sp
  52 .RS 4
  53 .ie n \{\
  54 \h'-04'\(bu\h'+03'\c
  55 .\}
  56 .el \{\
  57 .sp -1
  58 .IP \(bu 2.3
  59 .\}
  60 \fBamaespipe\fR(8),
  61 .RE
  62 .sp
  63 .RS 4
  64 .ie n \{\
  65 \h'-04'\(bu\h'+03'\c
  66 .\}
  67 .el \{\
  68 .sp -1
  69 .IP \(bu 2.3
  70 .\}
  71 \fBamarchiver\fR(8),
  72 .RE
  73 .sp
  74 .RS 4
  75 .ie n \{\
  76 \h'-04'\(bu\h'+03'\c
  77 .\}
  78 .el \{\
  79 .sp -1
  80 .IP \(bu 2.3
  81 .\}
  82 \fBamcheck\fR(8),
  83 .RE
  84 .sp
  85 .RS 4
  86 .ie n \{\
  87 \h'-04'\(bu\h'+03'\c
  88 .\}
  89 .el \{\
  90 .sp -1
  91 .IP \(bu 2.3
  92 .\}
  93 \fBamcheckdb\fR(8),
  94 .RE
  95 .sp
  96 .RS 4
  97 .ie n \{\
  98 \h'-04'\(bu\h'+03'\c
  99 .\}
 100 .el \{\
 101 .sp -1
 102 .IP \(bu 2.3
 103 .\}
 104 \fBamcheckdump\fR(8),
 105 .RE
 106 .sp
 107 .RS 4
 108 .ie n \{\
 109 \h'-04'\(bu\h'+03'\c
 110 .\}
 111 .el \{\
 112 .sp -1
 113 .IP \(bu 2.3
 114 .\}
 115 \fBamcleanup\fR(8),
 116 .RE
 117 .sp
 118 .RS 4
 119 .ie n \{\
 120 \h'-04'\(bu\h'+03'\c
 121 .\}
 122 .el \{\
 123 .sp -1
 124 .IP \(bu 2.3
 125 .\}
 126 \fBamcrypt-ossl-asym\fR(8),
 127 .RE
 128 .sp
 129 .RS 4
 130 .ie n \{\
 131 \h'-04'\(bu\h'+03'\c
 132 .\}
 133 .el \{\
 134 .sp -1
 135 .IP \(bu 2.3
 136 .\}
 137 \fBamcrypt-ossl\fR(8),
 138 .RE
 139 .sp
 140 .RS 4
 141 .ie n \{\
 142 \h'-04'\(bu\h'+03'\c
 143 .\}
 144 .el \{\
 145 .sp -1
 146 .IP \(bu 2.3
 147 .\}
 148 \fBamcrypt\fR(8),
 149 .RE
 150 .sp
 151 .RS 4
 152 .ie n \{\
 153 \h'-04'\(bu\h'+03'\c
 154 .\}
 155 .el \{\
 156 .sp -1
 157 .IP \(bu 2.3
 158 .\}
 159 \fBamcryptsimple\fR(8),
 160 .RE
 161 .sp
 162 .RS 4
 163 .ie n \{\
 164 \h'-04'\(bu\h'+03'\c
 165 .\}
 166 .el \{\
 167 .sp -1
 168 .IP \(bu 2.3
 169 .\}
 170 \fBamdevcheck\fR(8),
 171 .RE
 172 .sp
 173 .RS 4
 174 .ie n \{\
 175 \h'-04'\(bu\h'+03'\c
 176 .\}
 177 .el \{\
 178 .sp -1
 179 .IP \(bu 2.3
 180 .\}
 181 \fBamdump\fR(8),
 182 .RE
 183 .sp
 184 .RS 4
 185 .ie n \{\
 186 \h'-04'\(bu\h'+03'\c
 187 .\}
 188 .el \{\
 189 .sp -1
 190 .IP \(bu 2.3
 191 .\}
 192 \fBamfetchdump\fR(8),
 193 .RE
 194 .sp
 195 .RS 4
 196 .ie n \{\
 197 \h'-04'\(bu\h'+03'\c
 198 .\}
 199 .el \{\
 200 .sp -1
 201 .IP \(bu 2.3
 202 .\}
 203 \fBamflush\fR(8),
 204 .RE
 205 .sp
 206 .RS 4
 207 .ie n \{\
 208 \h'-04'\(bu\h'+03'\c
 209 .\}
 210 .el \{\
 211 .sp -1
 212 .IP \(bu 2.3
 213 .\}
 214 \fBamgetconf\fR(8),
 215 .RE
 216 .sp
 217 .RS 4
 218 .ie n \{\
 219 \h'-04'\(bu\h'+03'\c
 220 .\}
 221 .el \{\
 222 .sp -1
 223 .IP \(bu 2.3
 224 .\}
 225 \fBamgpgcrypt\fR(8),
 226 .RE
 227 .sp
 228 .RS 4
 229 .ie n \{\
 230 \h'-04'\(bu\h'+03'\c
 231 .\}
 232 .el \{\
 233 .sp -1
 234 .IP \(bu 2.3
 235 .\}
 236 \fBamgtar\fR(8),
 237 .RE
 238 .sp
 239 .RS 4
 240 .ie n \{\
 241 \h'-04'\(bu\h'+03'\c
 242 .\}
 243 .el \{\
 244 .sp -1
 245 .IP \(bu 2.3
 246 .\}
 247 \fBamlabel\fR(8),
 248 .RE
 249 .sp
 250 .RS 4
 251 .ie n \{\
 252 \h'-04'\(bu\h'+03'\c
 253 .\}
 254 .el \{\
 255 .sp -1
 256 .IP \(bu 2.3
 257 .\}
 258 \fBamoverview\fR(8),
 259 .RE
 260 .sp
 261 .RS 4
 262 .ie n \{\
 263 \h'-04'\(bu\h'+03'\c
 264 .\}
 265 .el \{\
 266 .sp -1
 267 .IP \(bu 2.3
 268 .\}
 269 \fBampgsql\fR(8),
 270 .RE
 271 .sp
 272 .RS 4
 273 .ie n \{\
 274 \h'-04'\(bu\h'+03'\c
 275 .\}
 276 .el \{\
 277 .sp -1
 278 .IP \(bu 2.3
 279 .\}
 280 \fBamplot\fR(8),
 281 .RE
 282 .sp
 283 .RS 4
 284 .ie n \{\
 285 \h'-04'\(bu\h'+03'\c
 286 .\}
 287 .el \{\
 288 .sp -1
 289 .IP \(bu 2.3
 290 .\}
 291 \fBamraw\fR(8),
 292 .RE
 293 .sp
 294 .RS 4
 295 .ie n \{\
 296 \h'-04'\(bu\h'+03'\c
 297 .\}
 298 .el \{\
 299 .sp -1
 300 .IP \(bu 2.3
 301 .\}
 302 \fBamrecover\fR(8),
 303 .RE
 304 .sp
 305 .RS 4
 306 .ie n \{\
 307 \h'-04'\(bu\h'+03'\c
 308 .\}
 309 .el \{\
 310 .sp -1
 311 .IP \(bu 2.3
 312 .\}
 313 \fBamreport\fR(8),
 314 .RE
 315 .sp
 316 .RS 4
 317 .ie n \{\
 318 \h'-04'\(bu\h'+03'\c
 319 .\}
 320 .el \{\
 321 .sp -1
 322 .IP \(bu 2.3
 323 .\}
 324 \fBamrestore\fR(8),
 325 .RE
 326 .sp
 327 .RS 4
 328 .ie n \{\
 329 \h'-04'\(bu\h'+03'\c
 330 .\}
 331 .el \{\
 332 .sp -1
 333 .IP \(bu 2.3
 334 .\}
 335 \fBamrmtape\fR(8),
 336 .RE
 337 .sp
 338 .RS 4
 339 .ie n \{\
 340 \h'-04'\(bu\h'+03'\c
 341 .\}
 342 .el \{\
 343 .sp -1
 344 .IP \(bu 2.3
 345 .\}
 346 \fBamsamba\fR(8),
 347 .RE
 348 .sp
 349 .RS 4
 350 .ie n \{\
 351 \h'-04'\(bu\h'+03'\c
 352 .\}
 353 .el \{\
 354 .sp -1
 355 .IP \(bu 2.3
 356 .\}
 357 \fBamserverconfig\fR(8),
 358 .RE
 359 .sp
 360 .RS 4
 361 .ie n \{\
 362 \h'-04'\(bu\h'+03'\c
 363 .\}
 364 .el \{\
 365 .sp -1
 366 .IP \(bu 2.3
 367 .\}
 368 \fBamservice\fR(8),
 369 .RE
 370 .sp
 371 .RS 4
 372 .ie n \{\
 373 \h'-04'\(bu\h'+03'\c
 374 .\}
 375 .el \{\
 376 .sp -1
 377 .IP \(bu 2.3
 378 .\}
 379 \fBamstar\fR(8),
 380 .RE
 381 .sp
 382 .RS 4
 383 .ie n \{\
 384 \h'-04'\(bu\h'+03'\c
 385 .\}
 386 .el \{\
 387 .sp -1
 388 .IP \(bu 2.3
 389 .\}
 390 \fBamstatus\fR(8),
 391 .RE
 392 .sp
 393 .RS 4
 394 .ie n \{\
 395 \h'-04'\(bu\h'+03'\c
 396 .\}
 397 .el \{\
 398 .sp -1
 399 .IP \(bu 2.3
 400 .\}
 401 \fBamsuntar\fR(8),
 402 .RE
 403 .sp
 404 .RS 4
 405 .ie n \{\
 406 \h'-04'\(bu\h'+03'\c
 407 .\}
 408 .el \{\
 409 .sp -1
 410 .IP \(bu 2.3
 411 .\}
 412 \fBamtape\fR(8),
 413 .RE
 414 .sp
 415 .RS 4
 416 .ie n \{\
 417 \h'-04'\(bu\h'+03'\c
 418 .\}
 419 .el \{\
 420 .sp -1
 421 .IP \(bu 2.3
 422 .\}
 423 \fBamtapetype\fR(8),
 424 .RE
 425 .sp
 426 .RS 4
 427 .ie n \{\
 428 \h'-04'\(bu\h'+03'\c
 429 .\}
 430 .el \{\
 431 .sp -1
 432 .IP \(bu 2.3
 433 .\}
 434 \fBamtoc\fR(8),
 435 .RE
 436 .sp
 437 .RS 4
 438 .ie n \{\
 439 \h'-04'\(bu\h'+03'\c
 440 .\}
 441 .el \{\
 442 .sp -1
 443 .IP \(bu 2.3
 444 .\}
 445 \fBamvault\fR(8),
 446 .RE
 447 .sp
 448 .RS 4
 449 .ie n \{\
 450 \h'-04'\(bu\h'+03'\c
 451 .\}
 452 .el \{\
 453 .sp -1
 454 .IP \(bu 2.3
 455 .\}
 456 \fBamzfs-sendrecv\fR(8),
 457 .RE
 458 .sp
 459 .RS 4
 460 .ie n \{\
 461 \h'-04'\(bu\h'+03'\c
 462 .\}
 463 .el \{\
 464 .sp -1
 465 .IP \(bu 2.3
 466 .\}
 467 \fBamzfs-snapshot\fR(8),
 468 .RE
 469 .sp
 470 .RS 4
 471 .ie n \{\
 472 \h'-04'\(bu\h'+03'\c
 473 .\}
 474 .el \{\
 475 .sp -1
 476 .IP \(bu 2.3
 477 .\}
 478 \fBscript-email\fR(8),
 479 .RE
 480 .SS "CONFIGURATION FILES"
 481 .sp
 482 .RS 4
 483 .ie n \{\
 484 \h'-04'\(bu\h'+03'\c
 485 .\}
 486 .el \{\
 487 .sp -1
 488 .IP \(bu 2.3
 489 .\}
 490 \fBamanda.conf\fR(5),
 491 .RE
 492 .sp
 493 .RS 4
 494 .ie n \{\
 495 \h'-04'\(bu\h'+03'\c
 496 .\}
 497 .el \{\
 498 .sp -1
 499 .IP \(bu 2.3
 500 .\}
 501 \fBamanda-client.conf\fR(5),
 502 .RE
 503 .sp
 504 .RS 4
 505 .ie n \{\
 506 \h'-04'\(bu\h'+03'\c
 507 .\}
 508 .el \{\
 509 .sp -1
 510 .IP \(bu 2.3
 511 .\}
 512 \fBdisklist\fR(5),
 513 .RE
 514 .sp
 515 .RS 4
 516 .ie n \{\
 517 \h'-04'\(bu\h'+03'\c
 518 .\}
 519 .el \{\
 520 .sp -1
 521 .IP \(bu 2.3
 522 .\}
 523 \fBtapelist\fR(5),
 524 .RE
 525 .SS "DATA FORMATS"
 526 .sp
 527 .RS 4
 528 .ie n \{\
 529 \h'-04'\(bu\h'+03'\c
 530 .\}
 531 .el \{\
 532 .sp -1
 533 .IP \(bu 2.3
 534 .\}
 535 \fBamanda-archive-format\fR(5),
 536 .RE
 537 .SS "CONCEPTS"
 538 .sp
 539 .RS 4
 540 .ie n \{\
 541 \h'-04'\(bu\h'+03'\c
 542 .\}
 543 .el \{\
 544 .sp -1
 545 .IP \(bu 2.3
 546 .\}
 547 \fBamanda-applications\fR(7),
 548 .RE
 549 .sp
 550 .RS 4
 551 .ie n \{\
 552 \h'-04'\(bu\h'+03'\c
 553 .\}
 554 .el \{\
 555 .sp -1
 556 .IP \(bu 2.3
 557 .\}
 558 \fBamanda-auth\fR(7),
 559 .RE
 560 .sp
 561 .RS 4
 562 .ie n \{\
 563 \h'-04'\(bu\h'+03'\c
 564 .\}
 565 .el \{\
 566 .sp -1
 567 .IP \(bu 2.3
 568 .\}
 569 \fBamanda-changers\fR(7),
 570 .RE
 571 .sp
 572 .RS 4
 573 .ie n \{\
 574 \h'-04'\(bu\h'+03'\c
 575 .\}
 576 .el \{\
 577 .sp -1
 578 .IP \(bu 2.3
 579 .\}
 580 \fBamanda-compatibility\fR(7),
 581 .RE
 582 .sp
 583 .RS 4
 584 .ie n \{\
 585 \h'-04'\(bu\h'+03'\c
 586 .\}
 587 .el \{\
 588 .sp -1
 589 .IP \(bu 2.3
 590 .\}
 591 \fBamanda-devices\fR(7),
 592 .RE
 593 .sp
 594 .RS 4
 595 .ie n \{\
 596 \h'-04'\(bu\h'+03'\c
 597 .\}
 598 .el \{\
 599 .sp -1
 600 .IP \(bu 2.3
 601 .\}
 602 \fBamanda-scripts\fR(7),
 603 .RE
 604 .sp
 605 .RS 4
 606 .ie n \{\
 607 \h'-04'\(bu\h'+03'\c
 608 .\}
 609 .el \{\
 610 .sp -1
 611 .IP \(bu 2.3
 612 .\}
 613 \fBamanda-taperscan\fR(7),
 614 .RE
 615 .SH "CONFIGURATION"
 616 .PP
 617 There are four user\-editable files that control the behavior of Amanda\&.
 618 .PP
 619 The first two are
 620 \fBamanda.conf\fR(5)
 621 and
 622 \fBamanda-client.conf\fR(5), the main configuration files for the server and client, respectively\&. They contain parameters to customize Amanda for the site\&.
 623 .PP
 624 Next is the
 625 \fBdisklist\fR(5)
 626 file, which lists hosts and disk partitions to back up\&.
 627 .PP
 628 Last is the seldom\-edited
 629 \fBtapelist\fR(5)
 630 file, which lists tapes that are currently active\&. These files are described in more detail in the following sections\&.
 631 .PP
 632 All configuration files are stored in individual configuration directories, usually under
 633 /etc/amanda/\&. A site will often have more than one configuration\&. For example, it might have a
 634 \fInormal\fR
 635 configuration for everyday backups and an
 636 \fIarchive\fR
 637 configuration for infrequent full archival backups\&. The configuration files would be stored under directories
 638 /etc/amanda/normal/
 639 and
 640 /etc/amanda/archive/, respectively\&. Part of the job of an Amanda administrator is to create, populate and maintain these directories\&.
 641 .PP
 642 Most Amanda applications take a "config" parameter; this is generally the (unqualified) name of the configuration directory, e\&.g\&.,
 643 normal\&. If the parameter is
 644 \&.
 645 (dot), the current directory is used\&. This feature is present for backward compatibility, but is not commonly used\&.
 646 .SH "LOG FILES"
 647 .PP
 648 All log and database files generated by Amanda go in corresponding directories somewhere\&. The exact location is controlled by entries in
 649 \fBamanda.conf\fR(5)\&. A typical location would be under
 650 /var/adm/amanda\&. For the above example, the files might go in
 651 /var/adm/amanda/normal/
 652 and
 653 /var/adm/amanda/archive/\&.
 654 .PP
 655 As log files are no longer needed (no longer contain relevant information), Amanda cycles them out in various ways, depending on the type of file\&.
 656 .PP
 657 Detailed information about
 658 \fBamdump\fR
 659 runs are stored in dump logs \-\- files named
 660 \fBamdump\&.\fR\fINN\fR
 661 where
 662 \fINN\fR
 663 is a sequence number, with 1 being the most recent file\&.
 664 \fBAmdump\fR
 665 rotates these files each run, keeping roughly the last
 666 \fBtapecycle\fR
 667 (see below) worth of them\&.
 668 .PP
 669 The file used by
 670 \fBamreport\fR
 671 to generate the mail summary is the trace log\&. This file constitutes the "catalog" describing the data on the tapes written in a run\&. It is named
 672 \fBlog\&.\fR\fIYYYYMMDDHHMMSS\&.NN\fR
 673 where
 674 \fIYYYYMMDDHHMMSS\fR
 675 is the datestamp of the start of the
 676 \fBamdump\fR
 677 or
 678 \fBamflush\fR
 679 run and
 680 \fINN\fR
 681 is a sequence number started at 0\&. At the end of each
 682 \fBamdump\fR
 683 run, log files for runs whose tapes have been reused are renamed into a subdirectory of the main log directory (see the
 684 \fBlogdir\fR
 685 parameter below) named
 686 \fBoldlog\fR\&. It is up to the Amanda administrator to remove them from this directory when desired\&.
 687 .PP
 688 Index (backup image catalogue) files older than the full dump matching the oldest backup image for a given client and disk are removed by
 689 \fBamdump\fR
 690 at the end of each run\&.
 691 .SH "USING SAMBA"
 692 .PP
 693 For Samba access, Amanda needs a file on the Samba server (which may or may not also be the tape server) named
 694 /etc/amandapass
 695 with share names, (clear text) passwords and (optional) domain names, in that order, one per line, whitespace separated\&. By default, the user used to connect to the PC is the same for all PC\'s and is compiled into Amanda\&. It may be changed on a host by host basis by listing it first in the password field followed by a percent sign and then the password\&. For instance:
 696 .nf
 697   //some\-pc/home normalpw
 698   //another\-pc/disk otheruser%otherpw
 699 .fi
 700 .PP
 701 With clear text passwords, this file should obviously be tightly protected\&. It only needs to be readable by the Amanda\-user on the Samba server\&.
 702 .SH "HOST & DISK EXPRESSION"
 703 .PP
 704 All host and disk arguments to programs are special expressions\&. The command applies to all DLEs that match the arguments\&. This section describes the matcher\&.
 705 .PP
 706 The matcher matches by word, each word is a glob expression, words are separated by the separator \'\&.\' for host and \'/\' for disk\&. You can anchor the expression at left with a \'^\'\&. You can anchor the expression at right with a \'$\'\&. The matcher is case insensitive for host but is case sensitive for disk\&. A match succeeds if all words in your expression match contiguous words in the host or disk\&.
 707 .PP
 708 If the disk is a UNC ("\e\ewindows\eshare") then all \'\e\' are converted to \'/\' before the match\&. Using \'\e\' is complicated because of the extra quoting required by the shell and amanda\&. It\'s easier to use \'/\' because it require less quoting ("//windows/share")
 709 .PP
 710 dot (\&.)
 711 .RS 4
 712 word separator for a host
 713 .RE
 714 .PP
 715 /
 716 .RS 4
 717 word separator for a disk
 718 .RE
 719 .PP
 720 \e
 721 .RS 4
 722 word separator for a UNC disk
 723 .RE
 724 .PP
 725 ^
 726 .RS 4
 727 anchor at left
 728 .RE
 729 .PP
 730 $
 731 .RS 4
 732 anchor at right
 733 .RE
 734 .PP
 735 ?
 736 .RS 4
 737 match exactly one character except the separator
 738 .RE
 739 .PP
 740 *
 741 .RS 4
 742 match zero or more characters except the separator
 743 .RE
 744 .PP
 745 **
 746 .RS 4
 747 match zero or more characters including the separator
 748 .RE
 749 .PP
 750 [\&.\&.\&.]
 751 .RS 4
 752 match a single character, namely any of the characters enclosed by the brackets\&.
 753 .RE
 754 .PP
 755 [!\&.\&.\&.]
 756 .RS 4
 757 match a single character, namely any characters that is not enclosed by the brackets\&.
 758 .RE
 759 .PP
 760 The shell interpret some of these characters, they must be escaped by a backslash \'\e\' and/or the expression must be enclosed in simple or double quote\&.
 761 .PP
 762 Some examples:
 763 .PP
 764 hosta
 765 .RS 4
 766 Will match
 767 hosta,
 768 foo\&.hosta\&.org, and
 769 hoSTA\&.dOMAIna\&.ORG
 770 but not
 771 hostb\&.
 772 .RE
 773 .PP
 774 host
 775 .RS 4
 776 Will match
 777 host
 778 but not
 779 hosta\&.
 780 .RE
 781 .PP
 782 host?
 783 .RS 4
 784 Will match
 785 hosta
 786 and
 787 hostb, but not
 788 host\&.
 789 .RE
 790 .PP
 791 ho*na
 792 .RS 4
 793 Will match
 794 hoina
 795 but not
 796 ho\&.aina\&.org\&.
 797 .RE
 798 .PP
 799 ho**na
 800 .RS 4
 801 Will match
 802 hoina
 803 and
 804 ho\&.aina\&.org\&.
 805 .RE
 806 .PP
 807 ^hosta
 808 .RS 4
 809 Will match
 810 hosta
 811 but not
 812 foo\&.hosta\&.org\&.
 813 .RE
 814 .PP
 815 sda*
 816 .RS 4
 817 Will match
 818 /dev/sda1
 819 and
 820 /dev/sda12\&.
 821 .RE
 822 .PP
 823 /opt
 824 .RS 4
 825 Will match the disk
 826 opt
 827 but not the host
 828 opt\&.
 829 .RE
 830 .PP
 831 (note dots:) \&.opt\&.
 832 .RS 4
 833 Will match the host
 834 opt
 835 but not the disk
 836 opt\&.
 837 .RE
 838 .PP
 839 /
 840 .RS 4
 841 Will match the disk
 842 /
 843 but no other disk\&.
 844 .RE
 845 .PP
 846 /usr
 847 .RS 4
 848 Will match the disks
 849 /usr
 850 and
 851 /usr/local\&.
 852 .RE
 853 .PP
 854 /usr$
 855 .RS 4
 856 Will match the disks
 857 /usr
 858 but not
 859 /usr/local\&.
 860 .RE
 861 .PP
 862 share
 863 .RS 4
 864 Will match the disks
 865 \e\ewindows1\eshare
 866 and
 867 \e\ewindows2\eshare\&.
 868 .RE
 869 .PP
 870 share*
 871 .RS 4
 872 Will match the disks
 873 \e\ewindows\eshare1
 874 and
 875 \e\ewindows\eshare2\&.
 876 .RE
 877 .PP
 878 //windows/share
 879 .RS 4
 880 Will match the disk
 881 \e\ewindows\eshare\&.
 882 .RE
 883 .SH "DATESTAMP EXPRESSION"
 884 .PP
 885 A
 886 \fIdatestamp\fR
 887 expression is a range expression where we only match the prefix\&. Leading ^ is removed\&. Trailing $ forces an exact match\&.
 888 .PP
 889 20001212\-14
 890 .RS 4
 891 match all dates beginning with 20001212, 20001213 or 20001214
 892 .RE
 893 .PP
 894 20001212\-4
 895 .RS 4
 896 same as previous
 897 .RE
 898 .PP
 899 20001212\-24
 900 .RS 4
 901 match all dates between 20001212 and 20001224
 902 .RE
 903 .PP
 904 2000121
 905 .RS 4
 906 match all dates that start with 2000121 (20001210\-20001219)
 907 .RE
 908 .PP
 909 2
 910 .RS 4
 911 match all dates that start with 2 (20000101\-29991231)
 912 .RE
 913 .PP
 914 2000\-10
 915 .RS 4
 916 match all dates between 20000101\-20101231
 917 .RE
 918 .PP
 919 200010$
 920 .RS 4
 921 match only 200010
 922 .RE
 923 .SH "DUMP SPECIFICATIONS"
 924 .PP
 925 A dump specification selects one or more dumps\&. It has the form
 926 \fI[host][:disk][@datestamp]\fR, where each component is a pattern as described above\&. If a component is missing, it is treated as a wildcard\&. The characters \':\', \'@\', and \'\e\' may be escaped within any component by preceding them with a \'\e\'\&.
 927 .PP
 928 Some examples:
 929 .PP
 930 client17
 931 .RS 4
 932 all dumps of client17
 933 .RE
 934 .PP
 935 @20080615
 936 .RS 4
 937 All dumps on with datestamps matching 20080615
 938 .RE
 939 .PP
 940 webserver:/var/www
 941 .RS 4
 942 All dumps of /var/www on host webserver
 943 .RE
 944 .PP
 945 webserver:/var/www@200806150317
 946 .RS 4
 947 The dump of webserver with datestamp 200806150317
 948 .RE
 949 .PP
 950 :/var/www
 951 .RS 4
 952 All dumps of /var/www on any host
 953 .RE
 954 .SH "CONFIGURATION OVERRIDE"
 955 .PP
 956 Most commands allow the override of specific configuration options on the command line, using the
 957 \-o
 958 option\&. This option has the form
 959 \-o\fIname\fR=\fIvalue\fR\&. An optional space is allowed after the
 960 \-o\&. Each configuration option should be specified in a separate command\-line option\&.
 961 .PP
 962 For global options,
 963 \fIname\fR
 964 is simply the name of the option, e\&.g\&.,
 965 .sp
 966 .nf
 967 amdump \-oruntapes=2
 968 .fi
 969 For options in a named section of the configuration,
 970 \fIname\fR
 971 has the form
 972 \fISECTION\fR:\fIsection_name\fR:\fIname\fR, where
 973 \fISECTION\fR
 974 is one of TAPETYPE, DUMPTYPE, HOLDINGDISK, or INTERFACE, and
 975 \fIsection_name\fR
 976 is the name of the tapetype, dumptype, holdingdisk, or interface\&. Examples:
 977 .sp
 978 .nf
 979 amdump \-o TAPETYPE:HP\-DAT:length=2000m
 980 amdump \-o DUMPTYPE:no\-compress:compress="server fast"
 981 amdump \-o HOLDINGDISK:hd1:use="\-100 mb"
 982 amdump \-o INTERFACE:local:use="2000 kbps"
 983 .fi
 984 .PP
 985 When overriding device properties, one must carefully quote the command line to simulate the syntax of real configuration files\&. The following example should serve as a guide:
 986 .sp
 987 .nf
 988 amdump \-o \'device\-property="PROPERTY_MAX_VOLUME_USAGE" "100000"\'
 989 .fi
 990 .PP
 991 Note that configuration overrides are not effective for tape changers, which supply a tapedev based on their own configuration\&. In order to override
 992 \fItapedev\fR, you must also disable any changer:
 993 .sp
 994 .nf
 995 amdump \-otapedev=/dev/nst1 \-otpchanger=\'\'
 996 .fi
 997 .SH "AUTHORS"
 998 .PP
 999 \fBJames da Silva\fR <\&jds@amanda\&.org\&>
1000 .PP
1001 \fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>