usr/src/usr.bin/mt/mt.1

.\" Copyright (c) 1980 Regents of the University of California.
.\" All rights reserved.  The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\"	@(#)mt.1	6.1 (Berkeley) %G%
.\"
.TH MT 1 ""
.UC 4
.SH NAME
mt \- magnetic tape manipulating program
.SH SYNOPSIS
.B mt
[
.B \-f
.I tapename
]
.I command
[
.I count
]
.SH DESCRIPTION
.I Mt
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
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
end-of-file marks at the current position on the tape.
.TP
.B fsf
Forward space
.I count
files.
.TP
.B fsr
Forward space
.I count
records.
.TP
.B bsf
Back space
.I count
files.
.TP
.B bsr
Back space
.I count
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 "SEE ALSO"
mtio(4), dd(1), ioctl(2), environ(7)
Commit	Line	Data
	1	.\" Copyright (c) 1980 Regents of the University of California.
	2	.\" All rights reserved. The Berkeley software License Agreement
	3	.\" specifies the terms and conditions for redistribution.
	4	.\"
	5	.\" @(#)mt.1 6.1 (Berkeley) %G%
	6	.\"
	7	.TH MT 1 ""
	8	.UC 4
	9	.SH NAME
	10	mt \- magnetic tape manipulating program
	11	.SH SYNOPSIS
	12	.B mt
	13	[
	14	.B \-f
	15	.I tapename
	16	]
	17	.I command
	18	[
	19	.I count
	20	]
	21	.SH DESCRIPTION
	22	.I Mt
	23	is used to give commands to a magnetic tape drive.
	24	If a tape name is not specified, the environment variable
	25	TAPE is used; if TAPE does not exist,
	26	.I mt
	27	uses the device
	28	.IR /dev/rmt12 .
	29	Note
	30	that
	31	.I tapename
	32	must reference a raw (not block) tape device.
	33	By default
	34	.I mt
	35	performs the requested operation once. Operations
	36	may be performed multiple times by specifying
	37	.IR count .
	38	.PP
	39	The available commands are listed below. Only as many
	40	characters as are required to uniquely identify a command
	41	need be specified.
	42	.TP
	43	.BR eof , " weof"
	44	Write
	45	.I count
	46	end-of-file marks at the current position on the tape.
	47	.TP
	48	.B fsf
	49	Forward space
	50	.I count
	51	files.
	52	.TP
	53	.B fsr
	54	Forward space
	55	.I count
	56	records.
	57	.TP
	58	.B bsf
	59	Back space
	60	.I count
	61	files.
	62	.TP
	63	.B bsr
	64	Back space
	65	.I count
	66	records.
	67	.TP
	68	.B rewind
	69	Rewind the tape
	70	.RI ( Count
	71	is ignored.)
	72	.TP
	73	.BR offline , " rewoffl"
	74	Rewind the tape and place the tape unit off-line
	75	.RI ( Count
	76	is ignored.)
	77	.TP
	78	.B status
	79	Print status information about the tape unit.
	80	.PP
	81	.I Mt
	82	returns a 0 exit status when the operation(s) were successful,
	83	1 if the command was unrecognized, and 2 if an operation failed.
	84	.SH FILES
	85	.DT
	86	/dev/rmt* Raw magnetic tape interface
	87	.SH "SEE ALSO"
	88	mtio(4), dd(1), ioctl(2), environ(7)