xref: /netbsd-src/share/man/man4/man4.vax/dn.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.\"     @(#)dn.4	8.1 (Berkeley) 6/5/93
33.\"
34.Dd June 5, 1993
35.Dt DN 4 vax
36.Os BSD 4
37.Sh NAME
38.Nm dn
39.Nd
40.Tn DN-11
41autocall unit interface
42.Sh SYNOPSIS
43.Cd "device dn0 at uba? csr 0160020 vector dnintr"
44.Sh DESCRIPTION
45The
46.Nm dn
47device provides an interface through a
48.Tn DEC
49.Tn DN-11
50(or equivalent
51such as the Able Quadracall) to an auto-call unit
52.Pq Tn ACU .
53To place an outgoing call one forks a sub-process which
54opens the appropriate call unit file,
55.Pa /dev/cua?
56and writes the phone number on it.  The parent process
57then opens the corresponding modem line
58.Pa /dev/cul? .
59When the connection has been
60established, the open on the modem line
61.Pa /dev/cul?
62will return and the process will be connected.
63A timer is normally used to timeout the opening of
64the modem line.
65.Pp
66The codes for the phone numbers are:
67.Bl -column xxxx -offset indent
680-9	number to be dialed
69*	dial * (`:' is a synonym)
70#	dial # (`;' is a synonym)
71\-	delay 20 milliseconds
72<	end of phone number (`e' is a synonym)
73=	delay for a second dial tone (`w' is a synonym)
74f	force a hangup of any existing connection
75.El
76.Pp
77The phone number to be dialed must be presented as one contiguous string.
78.Pp
79By convention, even numbered call units are for 300 baud
80modem lines, while odd numbered units are for 1200 baud lines.
81For example,
82.Pa /dev/cua0
83is associated with a 300 baud modem line,
84.Pa /dev/cul0 ,
85while
86.Pa /dev/cua1
87is associated with a 1200 baud modem line,
88.Pa /dev/cul1 .
89For devices such as the Quadracall which simulate multiple
90.Tn DN-11
91units, the minor device indicates which outgoing modem to use.
92.Sh FILES
93.Bl -tag -width /dev/cul? -compact
94.It Pa /dev/cua?
95call units
96.It Pa /dev/cul?
97associated modem lines
98.El
99.Sh DIAGNOSTICS
100Two error numbers are of interest at open time.
101.Bl -tag -width EBUSYxx
102.It Bq Er EBUSY
103The dialer is in use.
104.It Bq Er ENXIO
105The device doesn't exist, or there's no power to it.
106.El
107.Sh SEE ALSO
108.Xr tip 1
109.Sh HISTORY
110A
111.Nm
112driver appeared in
113.At v6 .
114