1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
5 <!-- entities files to use -->
6 <!ENTITY % global_entities SYSTEM 'global.entities'>
10 <!-- lifted from troff+man by doclifter -->
12 <refentry id='amstatus.8'>
15 <refentrytitle>amstatus</refentrytitle>
16 <manvolnum>8</manvolnum>
22 <refname>amstatus</refname>
23 <refpurpose>display the state of an Amanda run</refpurpose>
28 <!-- body begins here -->
31 <command>amstatus</command>
32 <arg choice='opt'><arg choice='plain'>--file </arg><arg choice='plain'><replaceable>amdumpfile</replaceable></arg></arg>
33 <arg choice='opt'>--summary </arg>
34 <arg choice='opt'>--dumping </arg>
35 <arg choice='opt'>--waitdumping </arg>
36 <arg choice='opt'>--waittaper </arg>
37 <arg choice='opt'>--dumpingtape </arg>
38 <arg choice='opt'>--writingtape </arg>
39 <arg choice='opt'>--finished </arg>
40 <arg choice='opt'>--failed </arg>
41 <arg choice='opt'>--estimate </arg>
42 <arg choice='opt'>--gestimate </arg>
43 <arg choice='opt'>--stats </arg>
44 <arg choice='opt'>--locale-independent-date-format </arg>
45 <arg choice='opt'>--config </arg>
46 <arg choice='plain'><replaceable>config</replaceable></arg>
51 <refsect1><title>DESCRIPTION</title>
52 <para><emphasis remap='B'>Amstatus</emphasis>
53 gives the current state of the Amanda run specified by the
54 <emphasis remap='I'>config</emphasis>
56 If there is no active Amanda running, it summarizes the result of the last run.
57 It may also be used to summarize the results of a previous run.</para>
60 <manref name="amanda" vol="8"/>
61 man page for more details about Amanda.</para>
64 <refsect1><title>OPTIONS</title>
65 <para>All options may be abbreviated to the shortest non-ambiguous sub-string.
66 If no options are given, everything is displayed.</para>
67 <variablelist remap='TP'>
69 <term><emphasis remap='B'>[--config] config</emphasis></term>
71 <para>Specify the Amanda configuration you want to display the state for.</para>
75 <term><option>--file amdumpfile</option></term>
77 <para>Specify an alternate file instead of the
78 <emphasis remap='I'>amdump</emphasis>
80 <emphasis remap='I'>amflush</emphasis>
85 <term><option>--summary</option></term>
87 <para>Display a summary of the state of the run.</para>
91 <term><option>--dumping</option></term>
93 <para>Display all partitions that are dumping.</para>
97 <term><option>--waitdumping|wdumping</option></term>
99 <para>Display all partitions that are waiting to be dumped.</para>
103 <term><option>--waittaper|wtaper</option></term>
105 <para>Display all partitions dumped that are waiting to be written to tape.</para>
109 <term><option>--dumpingtape|dtape</option></term>
111 <para>Display all partitions that are dumping directly to tape.</para>
115 <term><option>--writingtape|wtape</option></term>
117 <para>Display all partitions that are writing to tape.</para>
121 <term><option>--finished</option></term>
123 <para>Display all partitions that are dumped and written to tape.</para>
127 <term><option>--failed|error</option></term>
129 <para>Display all partitions that failed.</para>
133 <term><option>--estimate</option></term>
135 <para>Display all partitions whose estimate is finished.
136 Works only during the estimate phase.</para>
140 <term><option>--gestimate|gettingestimate</option></term>
142 <para>Display all partitions whose estimate is not finished.
143 Works only during the estimate phase.</para>
147 <term><option>--stats|statistics</option></term>
149 <para>Display statistics about active-time of taper and dumpers.</para>
153 <term><option>--locale-independent-date-format</option></term>
155 <para>Output the date in a locale independent format. The format is the same executing: date +'%Y-%m-%d %H:%M:%S %Z'</para>
161 <refsect1><title>EXIT CODE</title>
162 The exit code of <command>amstatus</command> is the ORed value of:
167 8 = Don't know the status of a dle (RESULT_MISSING in the report)
168 16 = tape error or no more tape
173 <manref name="amcheck" vol="8"/>,
174 <manref name="amdump" vol="8"/>,
175 <manref name="amrestore" vol="8"/>,
176 <manref name="amadmin" vol="8"/>