Return to mt.1 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / mt

Annotation of 43BSDReno/usr.bin/mt/mt.1, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1981, 1990 The Regents of the University of California.
                      2: .\" All rights reserved.
                      3: .\"
                      4: .\" Redistribution and use in source and binary forms are permitted provided
                      5: .\" that: (1) source distributions retain this entire copyright notice and
                      6: .\" comment, and (2) distributions including binaries display the following
                      7: .\" acknowledgement:  ``This product includes software developed by the
                      8: .\" University of California, Berkeley and its contributors'' in the
                      9: .\" documentation or other materials provided with the distribution and in
                     10: .\" all advertising materials mentioning features or use of this software.
                     11: .\" Neither the name of the University nor the names of its contributors may
                     12: .\" be used to endorse or promote products derived from this software without
                     13: .\" specific prior written permission.
                     14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
                     15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
                     16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                     17: .\"
                     18: .\"     @(#)mt.1       6.5 (Berkeley) 7/24/90
                     19: .\"
                     20: .Dd July 24, 1990
                     21: .Os BSD 4.4
                     22: .Dt MT 1
                     23: .Os BSD 4
                     24: .Sh NAME
                     25: .Nm mt
                     26: .Nd magnetic tape manipulating program
                     27: .Sh SYNOPSIS
                     28: .Nm mt
                     29: .Op Fl f Ar tapename
                     30: .Ar command
                     31: .Op Ar count
                     32: .Sh DESCRIPTION
                     33: .Nm Mt
                     34: is used to give commands to a magnetic tape drive.
                     35: If a tape name is not specified, the environment variable
                     36: .Ev TAPE
                     37: is used;  if
                     38: .Ev TAPE
                     39: does not exist,
                     40: .Nm mt
                     41: uses the device
                     42: .Pa /dev/rmt12 .
                     43: Note
                     44: that
                     45: .Ar tapename
                     46: must reference a raw (not block) tape device.
                     47: By default
                     48: .Nm mt
                     49: performs the requested operation once.  Operations
                     50: may be performed multiple times by specifying
                     51: .Ar count  .
                     52: .Pp
                     53: The available commands are listed below.  Only as many
                     54: characters as are required to uniquely identify a command
                     55: need be specified.
                     56: .Tp Cm eof , weof
                     57: Write
                     58: .Ar count
                     59: end-of-file marks at the current position on the tape.
                     60: .Tp Cm fsf
                     61: Forward space
                     62: .Ar count
                     63: files.
                     64: .Tp Cm fsr
                     65: Forward space
                     66: .Ar count
                     67: records.
                     68: .Tp Cm bsf
                     69: Back space
                     70: .Ar count
                     71: files.
                     72: .Tp Cm bsr
                     73: Back space
                     74: .Ar count
                     75: records.
                     76: .Tp Cm rewind
                     77: Rewind the tape
                     78: (Count is ignored).
                     79: .Tp Cm offline , rewoffl
                     80: Rewind the tape and place the tape unit off-line
                     81: (Count is ignored).
                     82: .Tp Cm status
                     83: Print status information about the tape unit.
                     84: .Tp
                     85: .Pp
                     86: .Nm Mt
                     87: returns a 0 exit status when the operation(s) were successful,
                     88: 1 if the command was unrecognized, and 2 if an operation failed.
                     89: .Sh ENVIRONMENT
                     90: If the following environment variable exists, it is utilized by
                     91: .Nm mt .
                     92: .Tw Fl
                     93: .Tp Ev TAPE
                     94: .Nm Mt
                     95: checks the
                     96: .Ev TAPE
                     97: environment variable if the
                     98: argument
                     99: .Ar tapename
                    100: is not given.
                    101: .Sh FILES
                    102: .Dw /dev/rmt*
                    103: .Di L
                    104: .Dp Pa /dev/rmt*
                    105: Raw magnetic tape interface
                    106: .Dp
                    107: .Sh SEE ALSO
                    108: .\".Xr mtio 4 ,
                    109: .Xr dd 1 ,
                    110: .Xr ioctl 2 ,
                    111: .Xr environ 7
                    112: .Sh HISTORY
                    113: .Nm Mt
                    114: appeared in 4.3 BSD.
                    115: .\" mt.1: mtio(4) missing

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.