Imported Upstream version 3.2.0
[debian/amanda] / man / amrmtape.8
index b625a5f7693ff31f953f88d6928618028c4926fb..1f34c1836d63b55d4b7a9bc97896a5d14040515f 100644 (file)
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "AMRMTAPE" 8 "" "" ""
-.SH NAME
-amrmtape \- remove a tape from the AMANDA database
-.SH "SYNOPSIS"
+'\" t
+.\"     Title: amrmtape
+.\"    Author: Adrian T. Filipi-Martin <atf3r@cs.virginia.edu>
+.\" Generator: DocBook XSL Stylesheets vsnapshot_8273 <http://docbook.sf.net/>
+.\"      Date: 10/18/2010
+.\"    Manual: System Administration Commands
+.\"    Source: Amanda 3.2.0
+.\"  Language: English
+.\"
+.TH "AMRMTAPE" "8" "10/18/2010" "Amanda 3\&.2\&.0" "System Administration Commands"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
 .ad l
-.hy 0
-.HP 9
-\fBamrmtape\fR [\-n] [\-v] [\-q] [\-d] \fIconfig\fR \fIlabel\fR
-.ad
-.hy
-
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+amrmtape \- remove a tape from the Amanda database
+.SH "SYNOPSIS"
+.HP \w'\fBamrmtape\fR\ 'u
+\fBamrmtape\fR [\-\-changer\ \fIchanger\-name\fR] [\-\-cleanup] [\-\-dryrun] [\-n] [\-\-erase] [\-\-keep\-label] [\-\-quiet] [\-q] [\-\-verbose] [\-v] \fIconfig\fR \fIlabel\fR
 .SH "DESCRIPTION"
-
 .PP
-\fBAmrmtape\fR invalidates the contents of an existing backup tape in the configuration database\&. This is meant as a recovery mechanism when a good backup is damaged either by faulty hardware or user error, e\&.g\&. the tape is eaten by the drive or is overwritten\&.
-
+\fBAmrmtape\fR
+invalidates the contents of an existing backup tape in the configuration database\&. This is meant as a recovery mechanism when a good backup is damaged either by faulty hardware or user error, e\&.g\&. the tape is eaten by the drive or is overwritten\&.
 .PP
-See the \fBamanda\fR(8) man page for more details about \fBAMANDA\fR\&.
-
+See the
+\fBamanda\fR(8)
+man page for more details about Amanda\&.
 .SH "OPTIONS"
-
-.TP
-\fB\-n\fR
-Generate new \fBtapelist\fR and database files with \fBlabel\fR removed, but leave them in \fI/tmp\fR and do not update the original copies\&.
-
-.TP
-\fB\-v\fR
+.PP
+\fB\-\-changer \fR\fB\fIchanger\-name\fR\fR\fB \fR
+.RS 4
+Specify which changer to use when erasing
+\fIlabel\fR
+.RE
+.PP
+\fB\-\-cleanup\fR
+.RS 4
+Remove logs and indexes associated with
+\fIlabel\fR\&. Otherwise, they\'ll remain until the next run of amdump\&.
+.RE
+.PP
+\fB\-\-dryrun\fR, \fB\-n\fR
+.RS 4
+Generate new
+\fBtapelist\fR(5)
+and database files with
+\fIlabel\fR
+removed, but leave them in
+/tmp
+and do not update the original copies\&.
+.RE
+.PP
+\fB\-\-erase\fR
+.RS 4
+Attempt to erase the data contained on the volume with the given label\&. This requires that Amanda be able to find that volume using the tape changer\&. Erasure is not supported by all Amanda devices, and the erasure is not "secure" in the sense that the data can most likely be recovered by someone with the right tools\&.
+.RE
+.PP
+\fB\-\-keep\-label\fR
+.RS 4
+Do not remove
+\fIlabel\fR
+from the tapelist\&.
+.RE
+.PP
+\fB\-\-verbose\fR, \fB\-v\fR
+.RS 4
 List backups of hosts and disks that are being discarded\&. Enabled by default\&.
-
-.TP
-\fB\-q\fR
-Opposite of \fB\-v\fR\&.
-
-.TP
-\fB\-d\fR
-Run in debugging mode so all executed commands are shown\&.
-
+.RE
+.PP
+\fB\-\-quiet\fR, \fB\-q\fR
+.RS 4
+Opposite of
+\fB\-v\fR\&.
+.RE
 .SH "EXAMPLE"
-
 .PP
-Remove tape labeled \fBDAILY034\fR from the \fBDailySet1\fR configuration\&.
+Remove tape labeled
+\fIDAILY034\fR
+from the
+\fIDailySet1\fR
+configuration\&.
 .nf
-
 # amrmtape DailySet1 DAILY034
 .fi
-
-.SH "AUTHOR"
-
+.SH "SEE ALSO"
 .PP
-Adrian T\&. Filipi\-Martin <atf3r@cs\&.virginia\&.edu>: Original text
-
+\fBamanda\fR(8),
+\fBamadmin\fR(8)
 .PP
-Stefan G\&. Weichinger, <sgw@amanda\&.org>, maintainer of the \fBAMANDA\fR\-documentation: XML\-conversion
-
-.SH "SEE ALSO"
-
+The Amanda Wiki:
+: http://wiki.zmanda.com/
+.SH "AUTHORS"
+.PP
+\fBAdrian T\&. Filipi\-Martin\fR <\&atf3r@cs\&.virginia\&.edu\&>
 .PP
-\fBamadmin\fR(8), \fBamanda\fR(8)
-
+\fBStefan G\&. Weichinger\fR <\&sgw@amanda\&.org\&>