Home | History | Annotate | Line # | Download | only in mt
mt.1 revision 1.3 
 Copyright (c) 1981, 1990 The Regents of the University of California.
 All rights reserved.


 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions
 are met:
 1. Redistributions of source code must retain the above copyright
 notice, this list of conditions and the following disclaimer.
 2. Redistributions in binary form must reproduce the above copyright
 notice, this list of conditions and the following disclaimer in the
 documentation and/or other materials provided with the distribution.
 3. All advertising materials mentioning features or use of this software
 must display the following acknowledgement:
 This product includes software developed by the University of
 California, Berkeley and its contributors.
 4. Neither the name of the University nor the names of its contributors
 may be used to endorse or promote products derived from this software
 without specific prior written permission.

 THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
 ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
 FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 SUCH DAMAGE.

 from: @(#)mt.1 6.7 (Berkeley) 7/28/91
 $Id: mt.1,v 1.3 1994/10/16 11:46:49 andrew Exp $

.Dd July 28, 1991
.Dt MT 1
.Os BSD 4
.Sh NAME
.Nm mt
.Nd magnetic tape manipulating program
.Sh SYNOPSIS
.Nm mt
.Op Fl f Ar tapename
.Ar command
.Op Ar count
.Sh DESCRIPTION
.Nm Mt
is used to give commands to a magnetic tape drive.
By default
.Nm mt
performs the requested operation once. Operations
may be performed multiple times by specifying
.Ar count .
Note
that
.Ar tapename
must reference a raw (not block) tape device.

p
The available commands are listed below. Only as many
characters as are required to uniquely identify a command
need be specified.
l -tag -width "eof, weof" t Cm eof , weof Write
.Ar count
end-of-file marks at the current position on the tape.
t Cm fsf Forward space
.Ar count
files.
t Cm fsr Forward space
.Ar count
records.
t Cm bsf Back space
.Ar count
files.
t Cm bsr Back space
.Ar count
records.
t Cm rewind Rewind the tape
(Count is ignored).
t Cm offline , rewoffl Rewind the tape and place the tape unit off-line
(Count is ignored).
t Cm status Print status information about the tape unit.
t Cm retension Retensions the tape (if this operation is supported by the tape unit).
t Cm erase Erases the tape (if this operation is supported by the tape unit).
t Cm eom Forward space to the end of the media.
.El

p
If a tape name is not specified, and the environment variable
.Ev TAPE
does not exist;
.Nm mt
uses the device

a /dev/rmt12 .

p
.Nm Mt
returns a 0 exit status when the operation(s) were successful,
1 if the command was unrecognized, and 2 if an operation failed.
.Sh ENVIRONMENT
If the following environment variable exists, it is utilized by
.Nm mt .
l -tag -width Fl t Ev TAPE .Nm Mt
checks the
.Ev TAPE
environment variable if the
argument
.Ar tapename
is not given.
.Sh FILES
l -tag -width /dev/rmt* -compact t Pa /dev/rmt* Raw magnetic tape interface
.El
.Sh SEE ALSO
.Xr mtio 4 ,
.Xr dd 1 ,
.Xr ioctl 2 ,
.Xr environ 7
.Sh HISTORY
The
.Nm mt
command appeared in
x 4.3 .  mt.1: mtio(4) missing