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