date and time created 88/12/14 16:21:45 by marc

[unix-history] / usr / src / usr.bin / mt / mt.1

diff --git a/usr/src/usr.bin/mt/mt.1 b/usr/src/usr.bin/mt/mt.1
index 42f29d0..8ff58bf 100644 (file)
--- a/usr/src/usr.bin/mt/mt.1
+++ b/usr/src/usr.bin/mt/mt.1
@@ -2,16 +2,16 @@
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"

-.\"    @(#)mt.1        4.1 (Berkeley) %G%
+.\"    @(#)mt.1        6.2 (Berkeley) %G%

 .\"
 .\"

-.TH MT 1 5/11/81
+.TH MT 1 ""

 .UC 4
 .SH NAME
 mt \- magnetic tape manipulating program
 .SH SYNOPSIS
 .B mt
 [
 .UC 4
 .SH NAME
 mt \- magnetic tape manipulating program
 .SH SYNOPSIS
 .B mt
 [

-.B \-t
+.B \-f

 .I tapename
 ]
 .I command
 .I tapename
 ]
 .I command


@@ -19,40 +19,70 @@ mt \- magnetic tape manipulating program
 .I count
 ]
 .SH DESCRIPTION
 .I count
 ]
 .SH DESCRIPTION

-.PP

 .I Mt
 .I Mt

-is used to give commands to the tape drive.  If a tape name is not
-specified, /dev/rmt12 is used.  If a count is not specified, 1 is assumed.
+is used to give commands to a magnetic tape drive.
+If a tape name is not specified, the environment variable
+TAPE is used;  if TAPE does not exist,
+.I mt
+uses the device
+.IR /dev/rmt12 .
+Note
+that
+.I tapename
+must reference a raw (not block) tape device.
+By default
+.I mt
+performs the requested operation once.  Operations
+may be performed multiple times by specifying
+.IR count .

 .PP
 .PP

-Here are the commands:
-.in +.5i
-.BR eof "      write"
+The available commands are listed below.  Only as many
+characters as are required to uniquely identify a command
+need be specified.
+.TP
+.BR eof , " weof"
+Write 

 .I count
 .I count

-end-of-file marks
-.br
-.BR fsf "      space forward"
+end-of-file marks at the current position on the tape.
+.TP
+.B fsf
+Forward space

 .I count
 .I count

-files
-.br
-.BR fsr "      space forward"
+files.
+.TP
+.B fsr
+Forward space 

 .I count
 .I count

-records
-.br
-.BR bsf "      space backward"
+records.
+.TP
+.B bsf
+Back space 

 .I count
 .I count

-files
-.br
-.BR bsr "      space backward"
+files.
+.TP 
+.B bsr
+Back space

 .I count
 .I count

-records
-.br
-.BR rew "      rewind tape"
-.br
-.BR offl "     rewind tape and go offline:
-.in -.5i
+records.
+.TP
+.B rewind
+Rewind the tape
+.RI ( Count
+is ignored). 
+.TP
+.BR offline , " rewoffl"
+Rewind the tape and place the tape unit off-line
+.RI ( Count
+is ignored).
+.TP
+.B status
+Print status information about the tape unit.
+.PP
+.I 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 FILES
 .DT
 /dev/rmt*      Raw magnetic tape interface
 .SH FILES
 .DT
 /dev/rmt*      Raw magnetic tape interface

-.SH SEE ALSO
-mt(4), dd(1)
-.SH BUGS
+.SH "SEE ALSO"
+mtio(4), dd(1), ioctl(2), environ(7)