250 lines
5.1 KiB
HTML
250 lines
5.1 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of MT</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>MT</H1>
|
|
Section: GNU CPIO (1)<BR>Updated: January 28, 2014<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
mt - control magnetic tape drive operation
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>mt</B>
|
|
|
|
[<B>-V</B>] [<B>-f</B> <I>device</I>] [<B>--file=</B><I>device</I>] [<B>--rsh-command=</B><I>command</I>] [<B>--version</B>]
|
|
<I>operation</I> [<I>count</I>]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
This manual page
|
|
documents the GNU version of
|
|
<B>mt</B>.
|
|
|
|
<B>mt</B>
|
|
|
|
performs the given
|
|
<I>operation</I>,
|
|
|
|
which must be one of the tape operations listed below, on a tape
|
|
drive.
|
|
<P>
|
|
|
|
The default tape device to operate on is taken from the file
|
|
<B>/usr/include/sys/mtio.h</B>
|
|
|
|
when
|
|
<B>mt</B>
|
|
|
|
is compiled. It can be overridden by giving a device file name in
|
|
the environment variable
|
|
<B>TAPE</B>
|
|
|
|
or by a command line option (see below), which also overrides the
|
|
environment variable.
|
|
<P>
|
|
|
|
The device must be either a character special file or a
|
|
remote tape drive. To use a tape drive on another machine as the
|
|
archive, use a filename that starts with `HOSTNAME:'. The
|
|
hostname can be preceded by a username and an `@' to access the remote
|
|
tape drive as that user, if you have permission to do so (typically an
|
|
entry in that user's `~/.rhosts' file).
|
|
<P>
|
|
|
|
The available operations are listed below. Unique abbreviations are
|
|
accepted. Not all operations are available on all systems, or work on
|
|
all types of tape drives.
|
|
Some operations optionally take a repeat count, which can be given
|
|
after the operation name and defaults to 1.
|
|
<DL COMPACT>
|
|
<DT id="1"><B>eof</B>, <B>weof</B>
|
|
|
|
<DD>
|
|
Write
|
|
<I>count</I>
|
|
|
|
EOF marks at current position.
|
|
<DT id="2"><B>fsf</B>
|
|
|
|
<DD>
|
|
Forward space
|
|
<I>count</I>
|
|
|
|
files.
|
|
The tape is positioned on the first block of the next file.
|
|
<DT id="3"><B>bsf</B>
|
|
|
|
<DD>
|
|
Backward space
|
|
<I>count</I>
|
|
|
|
files.
|
|
The tape is positioned on the first block of the next file.
|
|
<DT id="4"><B>fsr</B>
|
|
|
|
<DD>
|
|
Forward space
|
|
<I>count</I>
|
|
|
|
records.
|
|
<DT id="5"><B>bsr</B>
|
|
|
|
<DD>
|
|
Backward space
|
|
<I>count</I>
|
|
|
|
records.
|
|
<DT id="6"><B>bsfm</B>
|
|
|
|
<DD>
|
|
Backward space
|
|
<I>count</I>
|
|
|
|
file marks.
|
|
The tape is positioned on the beginning-of-the-tape side of
|
|
the file mark.
|
|
<DT id="7"><B>fsfm</B>
|
|
|
|
<DD>
|
|
Forward space
|
|
<I>count</I>
|
|
|
|
file marks.
|
|
The tape is positioned on the beginning-of-the-tape side of
|
|
the file mark.
|
|
<DT id="8"><B>asf</B>
|
|
|
|
<DD>
|
|
Absolute space to file number
|
|
<I>count</I>.
|
|
|
|
Equivalent to rewind followed by fsf
|
|
<I>count</I>.
|
|
|
|
<DT id="9"><B>seek</B>
|
|
|
|
<DD>
|
|
Seek to block number
|
|
<I>count</I>.
|
|
|
|
<DT id="10"><B>eom</B>
|
|
|
|
<DD>
|
|
Space to the end of the recorded media on the tape
|
|
(for appending files onto tapes).
|
|
<DT id="11"><B>rewind</B>
|
|
|
|
<DD>
|
|
Rewind the tape.
|
|
<DT id="12"><B>offline</B>, <B>rewoffl</B>
|
|
|
|
<DD>
|
|
Rewind the tape and, if applicable, unload the tape.
|
|
<DT id="13"><B>status</B>
|
|
|
|
<DD>
|
|
Print status information about the tape unit.
|
|
<DT id="14"><B>retension</B>
|
|
|
|
<DD>
|
|
Rewind the tape, then wind it to the end of the reel,
|
|
then rewind it again.
|
|
<DT id="15"><B>erase</B>
|
|
|
|
<DD>
|
|
Perform long erase of tape. If
|
|
<I>count</I>
|
|
|
|
is 0, perform short erase of tape (some devices do not support this).
|
|
</DL>
|
|
<P>
|
|
|
|
<B>mt</B>
|
|
|
|
exits with a status of 0 if the operation succeeded, 1 if the
|
|
operation or device name given was invalid, or 2 if the operation
|
|
failed.
|
|
<A NAME="lbAE"> </A>
|
|
<H3>OPTIONS</H3>
|
|
|
|
<DL COMPACT>
|
|
<DT id="16"><B>-f</B>, <B>--file=</B><I>device</I><DD>
|
|
Use
|
|
<I>device</I>
|
|
|
|
as the file name of the tape drive to operate on.
|
|
To use a
|
|
tape drive on another machine, use a filename that
|
|
starts with `HOSTNAME:'. The hostname can be preceded by a
|
|
username and an `@' to access the remote tape drive as that user, if
|
|
you have permission to do so (typically an entry in that user's
|
|
`~/.rhosts' file).
|
|
<DT id="17"><B>--rsh-command=</B><I>command</I><DD>
|
|
Notifies
|
|
<B>mt</B>
|
|
|
|
that it should use
|
|
<I>command</I>
|
|
|
|
to communicate with remote devices instead of
|
|
<B>/usr/bin/ssh</B>
|
|
|
|
or
|
|
<B>/usr/bin/rsh</B>.
|
|
|
|
<DT id="18"><B>-V</B>, <B>--version</B><DD>
|
|
Print the version number of
|
|
<B>mt</B>.
|
|
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>BUG REPORTS</H2>
|
|
|
|
Report bugs to <<A HREF="mailto:bug-cpio@gnu.org">bug-cpio@gnu.org</A>>.
|
|
<A NAME="lbAG"> </A>
|
|
<H2>COPYRIGHT</H2>
|
|
|
|
Copyright © 2014 Free Software Foundation, Inc.
|
|
<BR>
|
|
|
|
|
|
License GPLv3+: GNU GPL version 3 or later <<A HREF="http://gnu.org/licenses/gpl.html">http://gnu.org/licenses/gpl.html</A>>
|
|
<BR>
|
|
|
|
|
|
This is free software: you are free to change and redistribute it.
|
|
There is NO WARRANTY, to the extent permitted by law.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<P>
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="19"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="20"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="21"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DL>
|
|
<DT id="22"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
</DL>
|
|
<DT id="23"><A HREF="#lbAF">BUG REPORTS</A><DD>
|
|
<DT id="24"><A HREF="#lbAG">COPYRIGHT</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:19 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|