Print this page
5073 need ieee802.3(5) man page
5074 elxl(7D) page needed
5054 rtls(7D) needed
5053 need iprb(7D) man page
Reviewed by: Eric Sproul <esproul@omniti.com>
Approved by: TBD
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man7d/afe.7d
+++ new/usr/src/man/man7d/afe.7d
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
1 +.\" Copyright 2014 Garrett D'Amore <garrett@damore.org>
2 +.\" Redistribution and use in source and binary forms, with or without
3 +.\" modification, are permitted provided that the following conditions
4 +.\" are met:
5 +.\" 1. Redistributions of source code must retain the above copyright
6 +.\" notice, this list of conditions and the following disclaimer.
7 +.\" 2. Redistributions in binary form must reproduce the above copyright
8 +.\" notice, this list of conditions and the following disclaimer in the
9 +.\" documentation and/or other materials provided with the distribution.
10 +.\"
11 +.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER AND CONTRIBUTORS
12 +.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
13 +.\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
14 +.\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
15 +.\" COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
16 +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
17 +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
18 +.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
19 +.\" ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
20 +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
21 +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE
22 +.\"
23 +.Dd "Aug 3, 2014"
24 +.Dt AFE 7D
25 +.Os
26 +.Sh NAME
27 +.Nm afe
28 +.Nd ADMtek Fast Ethernet device driver
29 +.Sh SYNOPSIS
30 +.Pa /dev/afe
31 +.Sh DESCRIPTION
32 +The
33 +.Nm
34 +driver provides support for the Centaur and Comet families of Fast Ethernet
35 +PCI controllers originally produced by ADMtek and Infineon.
36 +.Lp
37 +These devices generally support the standard Fast Ethernet features, including
38 +10BASE-T and 100BASE-TX, both full and half duplex operation, IEEE 802.3
39 +autonegotiation, etc. They also support full size MTUs (1500 bytes),
40 +even when used with VLANs. Most of them also support flow control.
41 +.
42 +.Lp
43 +The device driver supports the
44 +.Xr ieee802.3 5
45 +properties, which can be configured with
46 +.Xr dladm 1M .
47 +.
48 +.\" The driver also has a "forcefiber" driver.conf setting, but this is for
49 +.\" very very obscure hardware, and we are not documenting this option
50 +.\" for now.
51 +.
52 +.Sh FILES
53 +.Bl -tag -width /dev/afe
54 +.It Pa /dev/afe
189 55 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
56 +.El
57 +.Sh SEE ALSO
58 +.Xr dladm 1M ,
59 +.Xr ifconfig 1M ,
60 +.Xr pci 4 ,
61 +.Xr ieee802.3 5 ,
62 +.Xr dlpi 7P
63 +.Rs
64 +.%T IEEE 802.3: Ethernet
65 +.%Q IEEE Standards Association
66 +.Re
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX