xref: /netbsd-src/share/man/man4/man4.vax/dz.4 (revision cda4f8f6ee55684e8d311b86c99ea59191e6b74f)
1.\" Copyright (c) 1980, 1991, 1993
2.\"	The Regents of the University of California.  All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\"    notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\"    notice, this list of conditions and the following disclaimer in the
11.\"    documentation and/or other materials provided with the distribution.
12.\" 3. All advertising materials mentioning features or use of this software
13.\"    must display the following acknowledgement:
14.\"	This product includes software developed by the University of
15.\"	California, Berkeley and its contributors.
16.\" 4. Neither the name of the University nor the names of its contributors
17.\"    may be used to endorse or promote products derived from this software
18.\"    without specific prior written permission.
19.\"
20.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30.\" SUCH DAMAGE.
31.\"
32.\"     @(#)dz.4	8.1 (Berkeley) 6/5/93
33.\"
34.Dd June 5, 1993
35.Dt DZ 4 vax
36.Os BSD 4
37.Sh NAME
38.Nm dz
39.Nd
40.Tn DZ-11
41multiplexer device interface
42.Sh SYNOPSIS
43.Cd "device dz0 at uba0 csr 0160100 vector dzrint dzxint"
44.Sh DESCRIPTION
45A
46.Tn DZ-11
47provides 8 communication lines with partial modem control,
48adequate for
49.Tn UNIX
50dialup use.
51.Pp
52An optional argument
53.Ar flags
54may be supplied with the device specification
55in the config file indicating
56that the line corresponding to
57bit number
58.Ar i
59is not properly
60connected, and should be treated as hard-wired with carrier
61always present.  Thus specifying
62.Ql flags 0x04
63for
64.Li dz0
65would cause line
66.Pa tty02
67to be treated in this way.
68.Pp
69Normal I/O
70control parameters for individual lines are managed by
71.Xr ioctl 2
72calls.
73Line speeds may be initiated via
74the
75.Xr ttys 5
76file,
77.Xr stty 1
78or
79.Xr ifconfig 8
80to name a few,
81see
82.Xr tty 4 .
83.Pp
84The
85.Nm dz
86driver monitors the rate of input on each board,
87and switches between the use of character-at-a-time interrupts
88and input silos.
89While the silo is enabled during periods of high-speed input,
90the driver polls for input 30 times per second.
91.Sh FILES
92.Bl -tag -width /dev/tty[0-9][0-9]xx -compact
93.It Pa /dev/tty[0-9][0-9]
94.It Pa /dev/ttyd[0-9a-f]
95dialups
96.El
97.Sh DIAGNOSTICS
98.Bl -diag
99.It dz%d: silo overflow .
100The 64 character input silo overflowed
101before it could be serviced.  This can happen if a hard error occurs
102when the
103.Tn CPU
104is running with elevated priority, as the system will
105then print a message on the console with interrupts disabled.
106It is not serious.
107.El
108.Sh SEE ALSO
109.Xr stty 1 ,
110.Xr tty 4 ,
111.Xr ttys 5 ,
112.Xr getty 8
113.Sh HISTORY
114A
115.Nm
116driver appeared in
117.At 32v .
118