BSD 4_4 release
[unix-history] / usr / src / share / man / man4 / man4.vax / hdh.4
index db73fd1..786b608 100644 (file)
-.\" Copyright (c) 1983 The Regents of the University of California.
-.\" All rights reserved.
+.\" Copyright (c) 1983, 1991, 1993
+.\"    The Regents of the University of California.  All rights reserved.
 .\"
 .\"
-.\" Redistribution and use in source and binary forms are permitted provided
-.\" that: (1) source distributions retain this entire copyright notice and
-.\" comment, and (2) distributions including binaries display the following
-.\" acknowledgement:  ``This product includes software developed by the
-.\" University of California, Berkeley and its contributors'' in the
-.\" documentation or other materials provided with the distribution and in
-.\" all advertising materials mentioning features or use of this software.
-.\" Neither the name of the University nor the names of its contributors may
-.\" be used to endorse or promote products derived from this software without
-.\" specific prior written permission.
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
-.\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
-.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
 .\"
 .\"
-.\"    @(#)hdh.4       6.3 (Berkeley) 6/23/90
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
 .\"
 .\"
-.TH HDH 4 "June 23, 1990"
-.UC 6
-.SH NAME
-hdh \- ACC IF-11/HDH IMP interface
-.SH SYNOPSIS
-.B "pseudo-device imp"
-.br
-.B "device hdh0 at uba0 csr 166740 vector hdhintr"
-.SH DESCRIPTION
+.\"     @(#)hdh.4      8.1 (Berkeley) 6/5/93
+.\"
+.Dd June 5, 1993
+.Dt HDH 4 vax
+.Os BSD 4.3
+.Sh NAME
+.Nm hdh
+.Nd
+.Tn ACC
+.Tn IF-11/HDH 
+.Tn IMP
+interface
+.Sh SYNOPSIS
+.Cd "pseudo-device imp"
+.Cd "device hdh0 at uba0 csr 166740 vector hdhintr"
+.Sh DESCRIPTION
 The 
 The 
-.I hdh
-device provides an HDLC Host (HDH)
-interface to an IMP.  It is normally used when participating
-in the DARPA Internet.  The controller itself is not accessible
-to users, but instead provides the hardware support to the IMP
+.Nm hdh
+device provides an
+.Tn HDLC
+Host
+.Pq Tn HDH
+interface to an
+.Tn IMP .
+It is normally used when participating
+in the
+.Tn DARPA
+Internet.  The controller itself is not accessible
+to users, but instead provides the hardware support to the
+.Tn IMP
 interface described in
 interface described in
-.IR imp (4).
-When configuring, the 
-.I imp
-pseudo-device must also be included.
-.SH DIAGNOSTICS
-.BR "hdh%d: not alive" .
+.Xr imp 4 .
+The configuration entry for the
+.Tn IMP
+must also include the
+.Em pseudo-device
+as shown above in the
+.Sx SYNOPSIS .
+.Sh DIAGNOSTICS
+.Bl -diag
+.It hdh%d: not alive.
 The initialization routine was entered even though the device
 did not autoconfigure.  This indicates a system problem.
 The initialization routine was entered even though the device
 did not autoconfigure.  This indicates a system problem.
-.PP
-.BR "hdh%d: cannot get chan %d uba resources" .
-Insufficient UNIBUS resources existed to initialize the device.
-This is likely to be a shortage of UNIBUS mapping registers.
-.PP
-.BR "hdh%d: LINE UP" .
-This indicates that both the HDLC and HDH protocols have declared the
-link to the IMP alive.
-.PP
-.BR "hdh%d: LINE DOWN" .
-This indicates that the link to the IMP has died.
-.PP
-.BR "hdh%d: HOST SEQUENCE ERROR"
-.br
-.BR "hdh%d: IMP SEQUENCE ERROR"
-.br
-.BR "hdh%d: HOST DATA ERROR"
-.br
-.BR "hdh%d: TIMEOUT"
-.br
-These errors indicate that an HDH protocol error has been detected.
-.PP
-.BR "hdh%d: cannot get supervisor cmnd buffer" .
+.Pp
+.It hdh%d: cannot get chan %d uba resources.
+Insufficient
+.Tn UNIBUS
+resources existed to initialize the device.
+This is likely to be a shortage of
+.Tn UNIBUS
+mapping registers.
+.Pp
+.It hdh%d: LINE UP.
+This indicates that both the
+.Tn HDLC
+and
+.Tn HDH
+protocols have declared the
+link to the
+.Tn IMP
+alive.
+.Pp
+.It hdh%d: LINE DOWN.
+This indicates that the link to the
+.Tn IMP
+has died.
+.Pp
+.It hdh%d: TIMEOUT.
+.It hdh%d: HOST DATA ERROR.
+.It hdh%d: IMP SEQUENCE ERROR.
+.It hdh%d: HOST SEQUENCE ERROR.
+These errors indicate that an
+.Tn HDH
+protocol error has been detected.
+.Pp
+.It hdh%d: cannot get supervisor cmnd buffer.
 This error indicates that an
 This error indicates that an
-.I mbuf
-could not be allocated to send a command to the IF-11/HDH.
-.PP
+.Em mbuf
+could not be allocated to send a command to the
+.Tn IF-11/HDH .
+.El
+.Pp
 Any other error message from hdh%d: indicates a serious error
 Any other error message from hdh%d: indicates a serious error
-detected by either the driver or the IF-11/HDH firmware.
-.SH "SEE ALSO"
-netintro(4)
+detected by either the driver or the
+.Tn IF-11/HDH
+firmware.
+.Sh SEE ALSO
+.Xr netintro 4
+.Sh HISTORY
+The
+.Nm
+driver appeared in
+.Bx 4.3 .