EDMTDESC(8) Domain/OS BSD EDMTDESC(8)
NAME
edmtdesc - edit magtape descriptor file
SYNOPSIS
/etc/edmtdesc pathname {options}
DESCRIPTION
edmtdesc allows you to create, list, and modify magnetic tape descriptor
objects. These descriptor files provide information to the streams
manager so that it can handle subsequent tape operations much as an sio
descriptor file describes the configuration of an sio line.
pathname (required)
Specify name of magtape descriptor file to be created,
listed, or edited.
OPTIONS
At least one of the following options must be specified.
-c Create a new magtape descriptor object with the name given
in the pathname argument.
-l [var...] List the values of the variable(s) specified. If no
variables are named, the entire magtape descriptor is
listed.
-s {var value}...
Set the variable(s) indicated to the specified value(s).
At least one variable/value pair is required if -s is
specified. Multiple variable/value pairs are permitted,
separated by blanks.
VARIABLES
The variables known to edmtdesc are listed below, along with their types
and default values. The variable types are: integer (int), Boolean
(y/n), character string of n letters (c [n]), and date (in format
yy/mm/dd.hh:mm).
Name Type Default Definition
_____________________________________________________________
dev c[1] m device type ('m' for magtape, 'c'
for cartridge)
u int 0 magtape unit number (normally 0)
lab y/n yes 'yes' to reopen previously used
volume, 'no' to open new volume
('yes' suppresses rewind)
clv y/n yes 'yes' closes volume when file is
closed, 'no' leaves volume open
spos y/n no 'yes' saves volume position when
volume is closed (for reopen), 'no'
rewinds volume when closed
vid c[6] -auto volume identifier (labeled volumes)
vacc c[1] volume accessibility (labeled
volumes)
own c[14] -auto volume owner (labeled volumes)
f int* 1 file sequence number: integer or
"cur" for current file, or "end"
for new file at end of labeled
volume
rf c[1] D record format -- "f" for fixed
length, "d" for variable length,
"s" for spanned, "u" for undefined
bl int 2048 block length, in bytes
rl int 2048 (maximum) record length, in bytes
ascnl y/n yes 'yes' for ascii newline handling
(strip newlines on write, supply
them on read), 'no' for no newline
handling
fsect int 1 file section number (labeled
volumes)
fid c[17] file identifier (labeled volumes)
fsid c[6] file set identifier (labeled
volumes)
gen int 1 generation of file (labeled
volumes)
genv int 1 generation version of file (labeled
volumes)
cdate date -auto creation date of file (labeled
volumes)
edate date -auto expiration date of file (labeled
volumes)
facc c[1] file accessibility (labeled
volumes)
sysc c[xx] system code (labeled volumes)
sysu c[xx] system use (labeled volumes)
boff int 0 buffer offset (labeled volumes,
should be 0)
For cartridge tape (dev c), you must change the block length (bl) and the
record length (rl) to be 512 or less and the record format to be fixed
(rf f).
EXAMPLES
Edit file set_tape; set the tape unit number to 1; declare tape as ANSI
labeled.
$ /etc/edmtdesc set_tape -s u 1 lab yes
Create descriptor file ct for cartridge tape, blocking 4 records of
maximum length 128 to each block.
$ /etc/edmtdesc ct -c -s dev c bl 512 rl 128 rf f