Name

rdt −  read diagnostic tape

Syntax

rdt function-key [ −Bblksize ] [ −Ddensity ] [ filename ... ]

Description

The rdt command reads diagnostic programs to disk from labeled tapes.  The files are placed in the current user’s area.  The reading is based upon the precepts set forth in the ANSI standard x3.27-1978.  The tape is assumed to have been written by a VAX/VMS system. 

The filename arguments list the files to be read.  As each file is read from the tape, a disk file of the same name is created in the user’s area to contain the diagnostic program. 

Function Keys

The function performed by the rdt command is specified by one of the following characters:

t The names of the specified files are listed.  If no file argument is given, all the files on the tape are listed. 

v Normally, rdt does its  work  with little terminal output.  The v (for verbose) option causes rdt to type the name of each file after processing it.  With the t function, v gives more information about the tape entries than the name. 

x The named files are extracted from the tape.  If no filename argument is given, the entire content of the tape is extracted. 

Options

−Bblksize
The blksize parameter is the block size for tape records, in bytes.  The default is 2048, the maximum is 20480.  The block size may also be specified as multiples of 512 or 1024 by appending either the character b or k to blksize, respectively.  For example, block sizes 4b and 2k both equal 2048 bytes.

−Ddens The dens parameter is the density of the tape, in bits per inch.  Possible values are 800 or 1600.  The default is 1600 bits per inch.  If dens is neither 800 nor 1600, the rdt command takes dens to be the name of the tape device. For example, /dev/rmt0h.  The device must be a raw, nonrewinding magnetic tape drive. 

Examples

This example shows how to load the file TEST1 from rmt0h. 

rdt x TEST1

This example shows how to load the contents of a whole 800 bpi tape on /dev/nmt0l.

rdt -D/dev/nmt0l

Diagnostics

Diagnostics from rdt are written on the standard error file.  There are two forms: warnings, which are not fatal, and errors, which are.  The majority of diagnostics are intended to be self-explanatory.  Some that might not be are:

illegal label format (hdr).  The header rdt is reading contains an incorrect label identifier or label number.  The correct header label name is enclosed between parentheses. 

pwd failed! Cannot execute /bin/pwd or /usr/bin/pwd. 

cannot find mkdir! Cannot execute /bin/mkdir or /usr/bin/mkdir. 

Files

/dev/rmt0h
1600 bpi tape device (default)