.TH DIPSWITCH 5 HEP
.SH NAME
dipswitch \- dip switch description table
.SH DESCRIPTION
.I Dipswitch
descrides the switch settings
for various
.SM UNIBUS
devices,
for use by
.IR sw (1M).
Entries are of the general form
.RS
.nf
devname: description
	swname: swbits
	swname: swbits
	.\|.\|.
.fi
.RE
The first line of each entry
identifies the device.
.I Devname
is the (single-word)
name of the board;
this is the name specified on the command line to
.IR sw .
.I Description
is a more complete description.
.PP
Lines after the first describe switch banks,
one to a line.
.I Swname
is a short name
identifying the switch,
typically giving its function
or its position on the board.
.I Swbits
is a list of single characters
or small integers,
separated by blanks.
Each item in the list represents one switch position.
If an entry is a small integer
.IR n ,
it means that that position controls
bit
.I n
of the switch's `value'.
A minus sign
.B \-
marks a meaningless switch
(one whose position is irrelevant);
this will be printed as a blank
by
.IR sw .
Any other character
is simply printed literally
for that switch position.
By convention,
.B \+
represents a switch that must be on,
and
.B 0
a switch that must be off.
.PP
Several special flags may appear
in front of the
.I swbits
(after the
.BR : ):
.B csr
means that this switch controls the
register address of the device,
.B vec
the vector;
.B off
may follow
.B csr
or
.BR vec ,
and means that a logical 1 is represented by
a switch in the `off' position.
If
.B csr
.RB ( vec )
is given,
then the register address
(vector address)
as specified to
.I sw
is the `value' for that switch.
By default,
the `value' is zero.
.B off
causes the value to be complemented.
.PP
An entry is terminated by the start of the next,
or by end-of-file.
White space at the beginning of a line is important;
lines without initial white space are the beginnings of entries,
lines with white space are switch lines.
Completely empty lines are ignored.
.SH FILES
/etc/dipswitch
.SH SEE ALSO
sw(1M)
.SH BUGS
Since
.B 0
is reserved for an off switch,
it is impossible to specify which switch
controls bit 0 of a value.
Since csr and vector addresses
tend to be even,
this is probably not a problem.
.PP
Lines containing only blanks
should probably be ignored,
but instead confuse
.IR sw .