share/man/man7d/dnet.7d

   1 '\" te
   2 .\"  All Rights Reserved.  Copyright (c) 2000, Sun Microsystems, Inc.  All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH DNET 7D "Oct 20, 2000"
   7 .SH NAME
   8 dnet \- Ethernet driver for DEC 21040, 21041, 21140 Ethernet cards
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/kernel/drv/dnet\fR
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 The \fBdnet\fR Ethernet driver is a multithreaded, loadable, clonable,
  19 \fBSTREAMS GLD\fR driver. Multiple controllers installed within the system are
  20 supported by the driver. The \fBdnet\fR driver functions include controller
  21 initialization, frame transmit and receive, functional addresses, promiscuous
  22 and multicast support, and error recovery and reporting.
  23 .SH APPLICATION PROGRAMMING INTERFACE
  24 .sp
  25 .LP
  26 The cloning character-special device, \fB/dev/dnet\fR, is used to access all
  27 DEC 21040/21041/21140 devices installed in the system.
  28 .sp
  29 .LP
  30 The \fBdnet\fR driver is dependent on \fB/kernel/misc/gld\fR, a loadable kernel
  31 module that provides the \fBdnet\fR driver with the \fBDLPI\fR and
  32 \fBSTREAMS\fR functionality required of a \fBLAN\fR driver.  See \fBgld\fR(7D)
  33 for more details on the primitives supported by the driver.
  34 .sp
  35 .LP
  36 The device is initialized on the first attach and de-initialized (stopped) on
  37 the last detach.
  38 .sp
  39 .LP
  40 The values returned by the driver in the \fBDL_INFO_ACK\fR primitive in
  41 response to a \fBDL_INFO_REQ\fR from the user are as follows:
  42 .RS +4
  43 .TP
  44 .ie t \(bu
  45 .el o
  46 The maximum \fBSDU\fR is \fB1500\fR (\fBETHERMTU\fR - defined in
  47 <\fBsys/ethernet.h\fR>).
  48 .RE
  49 .RS +4
  50 .TP
  51 .ie t \(bu
  52 .el o
  53 The minimum \fBSDU\fR is \fB0\fR.
  54 .RE
  55 .RS +4
  56 .TP
  57 .ie t \(bu
  58 .el o
  59 The \fBDLSAP\fR address length is \fB8\fR.
  60 .RE
  61 .RS +4
  62 .TP
  63 .ie t \(bu
  64 .el o
  65 The \fBMAC\fR type is \fBDL_ETHER\fR.
  66 .RE
  67 .RS +4
  68 .TP
  69 .ie t \(bu
  70 .el o
  71 The \fBsap\fR length value is \fB\(mi2\fR, meaning the physical address
  72 component is followed immediately by a 2-byte \fBsap\fR component within the
  73 \fBDLSAP\fR address.
  74 .RE
  75 .RS +4
  76 .TP
  77 .ie t \(bu
  78 .el o
  79 The broadcast address value is the Ethernet/IEEE broadcast address
  80 (\fBFF:FF:FF:FF:FF:FF\fR).
  81 .RE
  82 .sp
  83 .LP
  84 Once in the \fBDL_ATTACHED\fR state, the user must send a \fBDL_BIND_REQ\fR to
  85 associate a particular Service Access Point (SAP) with the stream.
  86 .SH PRECONFIGURATION
  87 .sp
  88 .LP
  89 The PCI configuration process varies from system to system. Follow the
  90 instructions provided by the vendor.
  91 .SS "Known Problems and Limitations"
  92 .RS +4
  93 .TP
  94 .ie t \(bu
  95 .el o
  96 On multiport cards (exception: Osicom (Rockwell) RNS2340), the first port is
  97 the top port. (On the Osicom RNS2340, the first port is the bottom port.)
  98 .RE
  99 .RS +4
 100 .TP
 101 .ie t \(bu
 102 .el o
 103 If the  \fBdnet\fR driver fails to determine the correct speed and duplex mode
 104 resulting in a corresponding drop in performance, set the speed and duplex mode
 105 using the \fBdnet.conf\fR file.
 106 .RE
 107 .RS +4
 108 .TP
 109 .ie t \(bu
 110 .el o
 111 The \fBdnet\fR driver incorrectly counts carrier lost or no carrier errors
 112 while in full-duplex mode. There is no carrier signal present when in
 113 full-duplex mode and it should not be counted as an error.
 114 .RE
 115 .RS +4
 116 .TP
 117 .ie t \(bu
 118 .el o
 119 Version 4 SROM formats are not supported.
 120 .RE
 121 .SH CONFIGURATION
 122 .sp
 123 .LP
 124 The \fB/kernel/drv/dnet.conf\fR file supports the following options:
 125 .sp
 126 .ne 2
 127 .na
 128 \fB\fBfull-duplex\fR\fR
 129 .ad
 130 .RS 15n
 131 For full duplex operation use \fBfull-duplex=1\fR, for half duplex use
 132 \fBfull-duplex=0\fR. Half-duplex operation gives better results on older 10mbit
 133 networks.
 134 .RE
 135
 136 .sp
 137 .ne 2
 138 .na
 139 \fB\fBspeed\fR\fR
 140 .ad
 141 .RS 15n
 142 For 10mbit operation use \fBspeed=10\fR, for 100mbit operation use
 143 \fBspeed=100\fR. Certain 21140 based cards will operate at either speed. Use
 144 the speed property to override the 100mbit default in this case.
 145 .RE
 146
 147 .SH FILES
 148 .sp
 149 .ne 2
 150 .na
 151 \fB\fB/dev/dnet\fR\fR
 152 .ad
 153 .RS 25n
 154 character special device
 155 .RE
 156
 157 .sp
 158 .ne 2
 159 .na
 160 \fB\fB/kernel/drv/dnet.conf\fR\fR
 161 .ad
 162 .RS 25n
 163 \fBdnet\fR configuration file
 164 .RE
 165
 166 .SH ATTRIBUTES
 167 .sp
 168 .LP
 169 See \fBattributes\fR(5) for descriptions of the following attributes:
 170 .sp
 171
 172 .sp
 173 .TS
 174 box;
 175 c | c
 176 l | l .
 177 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 178 _
 179 Architecture    x86
 180 .TE
 181
 182 .SH SEE ALSO
 183 .sp
 184 .LP
 185 \fBattributes\fR(5), \fBdlpi\fR(7P), \fBgld\fR(7D) \fBstreamio\fR(7I)
 186 .sp
 187 .LP
 188 \fIWriting Device Drivers\fR
 189 .sp
 190 .LP
 191  \fISTREAMS Programming Guide\fR