DIPSWITCH(5)        UNIX Programmer's Manual         DIPSWITCH(5)



NAME
     dipswitch - dip switch description table

DESCRIPTION
     D_i_p_s_w_i_t_c_h_ descrides the switch settings for various UNIBUS
     devices, for use by s_w_(1M).  Entries are of the general form
          devname: description
               swname: swbits
               swname: swbits
               ...
     The first line of each entry identifies the device.  D_e_v_n_a_m_e_
     is the (single-word) name of the board; this is the name
     specified on the command line to s_w_.  D_e_s_c_r_i_p_t_i_o_n_ is a more
     complete description.

     Lines after the first describe switch banks, one to a line.
     S_w_n_a_m_e_ is a short name identifying the switch, typically
     giving its function or its position on the board.  S_w_b_i_t_s_ is
     a list of single characters or small integers, separated by
     blanks.  Each item in the list represents one switch posi-
     tion.  If an entry is a small integer n_, it means that that
     position controls bit n_ of the switch's `value'.  A minus
     sign - marks a meaningless switch (one whose position is
     irrelevant); this will be printed as a blank by s_w_.  Any
     other character is simply printed literally for that switch
     position.  By convention, + represents a switch that must be
     on, and 0 a switch that must be off.

     Several special flags may appear in front of the s_w_b_i_t_s_
     (after the :): csr means that this switch controls the
     register address of the device, vec the vector; off may fol-
     low csr or vec, and means that a logical 1 is represented by
     a switch in the `off' position.  If csr (vec) is given, then
     the register address (vector address) as specified to s_w_ is
     the `value' for that switch.  By default, the `value' is
     zero.  off causes the value to be complemented.

     An entry is terminated by the start of the next, or by end-
     of-file.  White space at the beginning of a line is impor-
     tant; lines without initial white space are the beginnings
     of entries, lines with white space are switch lines.  Com-
     pletely empty lines are ignored.

FILES
     /etc/dipswitch

SEE ALSO
     sw(1M)

BUGS
     Since 0 is reserved for an off switch, it is impossible to
     specify which switch controls bit 0 of a value.  Since csr



Printed 6/15/82                HEP                              1






DIPSWITCH(5)        UNIX Programmer's Manual         DIPSWITCH(5)



     and vector addresses tend to be even, this is probably not a
     problem.

     Lines containing only blanks should probably be ignored, but
     instead confuse s_w_.


















































Printed 6/15/82                HEP                              2