3 .\" Author: Ian Turner <ian@zmanda.com>
4 .\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
6 .\" Manual: System Administration Commands
7 .\" Source: Amanda 3.3.2
10 .TH "AMDEVCHECK" "8" "07/25/2012" "Amanda 3\&.3\&.2" "System Administration Commands"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
25 .\" disable justification (adjust text to left margin only)
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
31 amdevcheck \- Validate an Amanda device and volume\&.
33 .HP \w'\fBamdevcheck\fR\ 'u
34 \fBamdevcheck\fR [\-\-label] [\-properties\ \fIlist\fR] [\fB\-o\fR\ \fIconfigoption\fR...] \fIconfig\fR [\fIdevice\-name\fR]
39 provides a way to check that a particular Amanda device is accessible, whether or not it contains a volume, and whether or not that volume is labeled\&. Some devices can\*(Aqt distinguish between all of these cases; a missing volume and an unlabeled volume might generate the same error code, for example\&. In those cases, this tool reports all possible causes of the error\&. Optionally this tools lists the properties for the device\&.
43 man page for more details about Amanda\&. See
44 \fBamanda-devices\fR(7)
45 for more information on devices\&.
50 Amanda configuration to use\&. Note that
52 ignores any tape changer configuration\&.
57 Amanda device to use\&. This option overrides any tapedev configuration specified in the configuration file\&.
62 Get the device\*(Aqs label\&. If this option is given, the usual check output is omitted, and the label of the loaded volume is printed to stdout\&. Returns with error if the label is not found\&.
65 \fI\-\-properties [list]\fR
67 List device properties\&. If this option is given, the usual check output is omitted, and property values are printed to stdout, one per line, as a property name, followed by \*(Aq=\*(Aq, followed by the property value\&. Returns with error if properties are not available\&.
71 is given, it is treated as a comma\-separated list of properties to display\&. If it is omitted, all supported properties are displayed\&.
74 \fB\-o \fR\fB\fIconfigoption\fR\fR
76 See the "CONFIGURATION OVERRIDE" section in
82 exit with code 0 if the device is working of if it get an expected error, look at the MESSAGE line for the error\&. It exit with code 1 if it get an unexpected error\&.
85 returns one or more of the following lines\&. If multiple lines appear, then at least one, but not necessarily all of the messages apply\&. This situation can occur when working with hardware or operating systems which cannot distinguish, for example, between a malfunctioning drive and a functional but unloaded drive\&.
94 A device error has occurred\&.
104 No tape is loaded in the drive\&.
107 \fBVOLUME_UNLABELED\fR
109 The tape in the drive is unlabeled\&.
114 A volume error has occurred\&.
117 \fBMESSAGE\fR \fItext\fR
119 Where text provides a human\-readable description of the problem\&.
124 \fBamanda-devices\fR(7)
127 : http://wiki.zmanda.com/
130 \fBIan Turner\fR <\&ian@zmanda\&.com\&>
132 Zmanda, Inc\&. (http://www\&.zmanda\&.com)