X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=man%2Fxml-source%2Famreport.8.xml;h=f56d6337e4b34fbad26b7832a8f6b6ac7c3407ed;hb=fd48f3e498442f0cbff5f3606c7c403d0566150e;hp=72c5395942aaf44361ef4ab03f1240cd57739a9d;hpb=96f35b20267e8b1a1c846d476f27fcd330e0b018;p=debian%2Famanda diff --git a/man/xml-source/amreport.8.xml b/man/xml-source/amreport.8.xml index 72c5395..f56d633 100644 --- a/man/xml-source/amreport.8.xml +++ b/man/xml-source/amreport.8.xml @@ -3,7 +3,7 @@ "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ - + %global_entities; ]> @@ -19,7 +19,7 @@ amreport -generate a formatted output of statistics for an &A; run +generate a formatted output of statistics for an Amanda run &author.sgw.xml; @@ -29,37 +29,117 @@ amreport config + &configoverride.synopsis; + + command-line options | script options + + + --log=logfile + --ps=filename + --text=filename + --xml=filename + --print=printer + --mail-text=recipient + + -i -M address -l logfile -f outputfile -p postscriptfile - -o configoption + --from-amdump + DESCRIPTION -Amreport -generates a summary report of an -amanda8 -backup run. -If no configuration name is specified, amanda.conf is -read from the current directory. - -See the -amanda8 -man page for more details about &A;. + +Amreport generates a summary report of an +Amanda backup run. + +See the man page for more details about +Amanda. + OPTIONS + config -Name of the configuration to process. +Name of the configuration to process. If no configuration name is +specified, amanda.conf is read from the current directory. + + + &configoverride.varlistentry; + + +Amreport operates in two distinct modes. Command-line mode is intended for use +by an administrator from the command line, and uses long command-line options +for clarity. Script mode is intended for use from scripts such as amdump, and +has a lot of non-obvious default behaviors to suit that need. + +Unless a script-mode option is given, amreport defaults to command-line mode. +If no options are given, amreport writes a report for the most recent logfile to +stdout. + +Command-Line Mode Options + + + + +Use this logfile as the basis for the report. If this option is given, then +the report is a "historical" report and will not include current state from +e.g., holding disk and curinfo. If this option is not specified, then the +most recent logfile will be used. + + + + + +Write a postscript label to filename. +See "LABEL PRINTING" below. If filename is not specified, then the +label is written to stdout. + + + + + +Write a human-readable text report to filename. +If filename is not specified, then the report is written to stdout. + + + + + +Write an XML-formatted report to filename. +If filename is not specified, then the report is written to stdout. + + + + + +Pipe a postscript label to lp or lpr, +specifying the given printer. If the printer is +not specified, uses the default from the Amanda configuration, or the system +default printer. + + + + + +Send a human-readable text report to the given recipient via +the mailer specified in the Amanda configuration. If the recipient is +not specified, this uses the mailto from the Amanda configuration. + + + +Script Mode Options + @@ -69,11 +149,8 @@ man page for more details about &A;. address -Mail the report to -address -instead of the -mailto -value from +Mail the report to address +instead of the mailto value from amanda.conf. @@ -82,61 +159,42 @@ value from logfile Name of the log file to parse to generate the report. -If a log file is not specified, it defaults to the file: +If a log file is not specified, it defaults to the file +$logdir/log, where +$logdir is the log directory defined in amanda.conf. - - - - -logdir/log - - - -where -logdir -is the log directory defined in amanda.conf. - outputfile -Normally, -amreport -sends the report via e-mail to the -mailto -user as defined in the amanda.conf file. -If -outputfile -is specified, then the report is put in -outputfile. +Normally, amreport sends the report via e-mail to the +mailto user as defined in the amanda.conf +file. If outputfile is specified, then the +report is put in outputfile. postscriptfile Send the postscript output to the file -postscriptfile -instead of to the -lpr1 -command. -This option has an effect only if the -lbl-templ -directive is specified in amanda.conf. +postscriptfile instead of to the + command. This option has an effect only if the +lbl-templ directive is specified in amanda.conf. - - -o configoption + -See the "CONFIGURATION OVERRIDE" section in amanda8. + Force script mode. Has no other effect. + LABEL PRINTING -&A; can print postscript labels describing the contents +Amanda can print postscript labels describing the contents of tape(s) written in a run. The labels are designed to be folded and inserted into the tape case along with the tape or hole punched and put @@ -161,14 +219,14 @@ tapetype definition, will not print tape labels. You may use the -remap='I'>printer +printer keyword in amanda.conf to print to other than the system default printer. TEMPLATES -&A; provides label templates for the following tape types. +Amanda provides label templates for the following tape types. These are pretty generic labels and should be easy to customize for other tape types or particular site needs. @@ -197,11 +255,9 @@ The exit code of amreport is the ORed value of: -SEE ALSO -amanda8, -amflush8, - - - + + + +