1 '\" te
   2 .\" Copyright (c) 2001-2007 by Garrett D'Amore.
   3 .\" 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.
   4 .\" 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. Neither the name of the author nor the names of any co-contributors may be used to endorse
   5 .\" or promote products derived from this software    without specific prior written permission.  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
   6 .\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT HOLDER 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;
   7 .\" 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
   8 .\" Portions Copyright (c) 2007 by Sun Microsystems, Inc.  All Rights Reserved.
   9 .TH AFE 7D "Apr 1, 2007"
  10 .SH NAME
  11 afe \- ADMtek Fast Ethernet device driver
  12 .SH SYNOPSIS
  13 .LP
  14 .nf
  15 \fB/dev/afe\fR
  16 .fi
  17 
  18 .SH DESCRIPTION
  19 .sp
  20 .LP
  21 The \fBafe\fR driver is a multi-threaded,  loadable, clonable, GLD-based
  22 STREAMS  driver supporting the Data Link Provider Interface \fBdlpi\fR(7P) on
  23 ADMtek (now Infineon) Centaur and Comet Fast Ethernet controllers.
  24 .SH APPLICATION PROGRAMMING INTERFACE
  25 .sp
  26 .LP
  27 The \fBafe\fR driver can be used as either a "style 1" or a "style 2" Data Link
  28 Service Provider. Physical points of attachment (PPAs) are interpreted as the
  29 instance  number of the \fBafe\fR controller as assigned by the Solaris
  30 operating environment.
  31 .sp
  32 .LP
  33 The relevant fields returned as part of a \fBDL_INFO_ACK\fR response are:
  34 .RS +4
  35 .TP
  36 .ie t \(bu
  37 .el o
  38 Maximum SDU is 1500.
  39 .RE
  40 .RS +4
  41 .TP
  42 .ie t \(bu
  43 .el o
  44 Minimum SDU is 0.
  45 .RE
  46 .RS +4
  47 .TP
  48 .ie t \(bu
  49 .el o
  50 The dlsap address length is 8.
  51 .RE
  52 .RS +4
  53 .TP
  54 .ie t \(bu
  55 .el o
  56 MAC type is \fBDL_ETHER\fR.
  57 .RE
  58 .RS +4
  59 .TP
  60 .ie t \(bu
  61 .el o
  62 SAP length is -2. The 6-byte physical address is followed immediately by a
  63 2-byte SAP.
  64 .RE
  65 .RS +4
  66 .TP
  67 .ie t \(bu
  68 .el o
  69 Service mode is \fBDL_CLDLS\fR.
  70 .RE
  71 .RS +4
  72 .TP
  73 .ie t \(bu
  74 .el o
  75 Broadcast address is the 6-byte Ethernet broadcast address
  76 (\fBff:ff:ff:ff:ff:ff\fR).
  77 .RE
  78 .sp
  79 .LP
  80 If the SAP provided is zero, then \fIIEEE 802.3\fR mode is assumed and outbound
  81 frames will have the frame payload length written into the type field.
  82 Likewise, inbound frames with a SAP between zero and 1500 are interpreted as
  83 \fIIEEE 802.3\fR frames and delivered to any streams that are bound to SAP zero
  84 (the \fI802.3\fR SAP).
  85 .SH PROPERTIES
  86 .sp
  87 .LP
  88 The following properties  may  be  configured  using  either \fBndd\fR(1M) or
  89 the \fBafe.conf\fR configuration file as described by \fBdriver.conf\fR(4):
  90 .sp
  91 .ne 2
  92 .na
  93 \fB\fBadv_autoneg_cap\fR\fR
  94 .ad
  95 .sp .6
  96 .RS 4n
  97 Enables (default) or disables \fIIEEE 802.3u\fR auto-negotiation of link speed
  98 and duplex settings. If enabled, the device negotiates among the supported (and
  99 configured, see below) link options with the link partner.  If disabled, at
 100 least one of the link options below must be specified. The driver selects the
 101 first enabled link option according to the \fIIEEE 802.3u\fR specified
 102 preferences.
 103 .RE
 104 
 105 .sp
 106 .ne 2
 107 .na
 108 \fB\fBadv_100T4_cap\fR\fR
 109 .ad
 110 .sp .6
 111 .RS 4n
 112 Enables the 100 BaseT4 link option.  (Note that most hardware does not support
 113 this unusual link style.  Also, this uses two pairs of wires for data, rather
 114 than one.)
 115 .RE
 116 
 117 .sp
 118 .ne 2
 119 .na
 120 \fB\fBadv_100fdx_cap\fR\fR
 121 .ad
 122 .sp .6
 123 .RS 4n
 124 Enables the 100 Base TX full-duplex link option. (This is generally the fastest
 125 mode if both link partners support it. Most modern equipment supports this
 126 mode.)
 127 .RE
 128 
 129 .sp
 130 .ne 2
 131 .na
 132 \fB\fBadv_100hdx_cap\fR\fR
 133 .ad
 134 .sp .6
 135 .RS 4n
 136 Enables the 100 Base TX half-duplex link option. (Typically used when the link
 137 partner is a 100 Mbps hub.)
 138 .RE
 139 
 140 .sp
 141 .ne 2
 142 .na
 143 \fB\fBadv_10fdx_cap\fR\fR
 144 .ad
 145 .sp .6
 146 .RS 4n
 147 Enables the 10 Base-T full-duplex link option.  (This less-frequently used mode
 148 is typically used when the link partner is a 10 Mbps switch.)
 149 .RE
 150 
 151 .sp
 152 .ne 2
 153 .na
 154 \fB\fBadv_10hdx_cap\fR\fR
 155 .ad
 156 .sp .6
 157 .RS 4n
 158 Enables the 10 Base-T half-duplex link option.  (This is the fall-back when no
 159 other option is available.  It is typically used when the link partner is a 10
 160 Mbps hub or is an older network card.)
 161 .RE
 162 
 163 .SH ATTRIBUTES
 164 .sp
 165 .LP
 166 See \fBattributes\fR(5) for a description of the following attributes:
 167 .sp
 168 
 169 .sp
 170 .TS
 171 box;
 172 c | c
 173 l | l .
 174 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 175 _
 176 Architecture    SPARC, x86
 177 _
 178 Interface Stability     Committed
 179 .TE
 180 
 181 .SH FILES
 182 .sp
 183 .ne 2
 184 .na
 185 \fB\fB/dev/afe\fR\fR
 186 .ad
 187 .sp .6
 188 .RS 4n
 189 Special character device.
 190 .RE
 191 
 192 .sp
 193 .ne 2
 194 .na
 195 \fB\fB/kernel/drv/afe\fR\fR
 196 .ad
 197 .sp .6
 198 .RS 4n
 199 32-bit driver binary (x86).
 200 .RE
 201 
 202 .sp
 203 .ne 2
 204 .na
 205 \fB\fB/kernel/drv/amd64/afe\fR\fR
 206 .ad
 207 .sp .6
 208 .RS 4n
 209 64-bit driver binary (x86).
 210 .RE
 211 
 212 .sp
 213 .ne 2
 214 .na
 215 \fB\fB/kernel/drv/sparcv9/afe\fR\fR
 216 .ad
 217 .sp .6
 218 .RS 4n
 219 64-bit driver binary (SPARC).
 220 .RE
 221 
 222 .sp
 223 .ne 2
 224 .na
 225 \fB\fB/kernel/drv/afe.conf\fR\fR
 226 .ad
 227 .sp .6
 228 .RS 4n
 229 Configuration file.
 230 .RE
 231 
 232 .SH SEE ALSO
 233 .sp
 234 .LP
 235 \fBndd\fR(1M), \fBdriver.conf\fR(4), \fBattributes\fR(5), \fBstreamio\fR(7I),
 236 \fBdlpi\fR(7P)
 237 .sp
 238 .LP
 239 \fIIEEE 802.3\fR \(em Institute of Electrical and Electronics Engineers, 2002