Merge commit 'b31320a79e2054c6739b5229259dbf98f3afc547' into merges
[unleashed.git] / share / man / man7d / sfe.7d
blobd923f85b276e923504cbe3226e848e425d70814a
1 '\" te
2 .\" Copyright (c) 2007 by 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 SFE 7D "Dec 12, 2007"
7 .SH NAME
8 sfe \- SiS900 series Fast Ethernet device driver
9 .SH SYNOPSIS
10 .LP
11 .nf
12 \fB/dev/sfe\fR
13 .fi
15 .SH DESCRIPTION
16 .sp
17 .LP
18 The \fBsfe\fR driver is a loadable, clonable, GLD-based  STREAMS driver
19 supporting the Data Link Provider Interface \fBdlpi\fR(7P) on Silicon
20 Integrated Systems 900 series Fast Ethernet controllers.
21 .SH APPLICATION PROGRAMMING INTERFACE
22 .sp
23 .LP
24 The relevant fields returned as part of a \fBDL_INFO_ACK\fR response are:
25 .RS +4
26 .TP
27 .ie t \(bu
28 .el o
29 Maximum SDU is 1500.
30 .RE
31 .RS +4
32 .TP
33 .ie t \(bu
34 .el o
35 Minimum SDU is 0.
36 .RE
37 .RS +4
38 .TP
39 .ie t \(bu
40 .el o
41 The dlsap address length is 8.
42 .RE
43 .RS +4
44 .TP
45 .ie t \(bu
46 .el o
47 MAC type is \fBDL_ETHER\fR.
48 .RE
49 .RS +4
50 .TP
51 .ie t \(bu
52 .el o
53 SAP length is -2. The 6-byte physical address is followed immediately by a
54 2-byte SAP.
55 .RE
56 .RS +4
57 .TP
58 .ie t \(bu
59 .el o
60 Service mode is \fBDL_CLDLS\fR.
61 .RE
62 .RS +4
63 .TP
64 .ie t \(bu
65 .el o
66 Broadcast address is the 6-byte Ethernet broadcast address
67 (\fBff:ff:ff:ff:ff:ff\fR).
68 .RE
69 .sp
70 .LP
71 If the SAP provided is zero, then \fIIEEE 802.3\fR mode is assumed and outbound
72 frames will have the frame payload length written into the type field.
73 Likewise, inbound frames with a SAP between zero and 1500 are interpreted as
74 \fIIEEE 802.3\fR frames and delivered to any streams that are bound to SAP zero
75 (the \fI802.3\fR SAP).
76 .SH PROPERTIES
77 .sp
78 .LP
79 The following properties  may  be  configured  using  either \fBndd\fR(8) or
80 the \fBsfe.conf\fR configuration file as described by \fBdriver.conf\fR(4):
81 .sp
82 .ne 2
83 .na
84 \fB\fBadv_100fdx_cap\fR\fR
85 .ad
86 .sp .6
87 .RS 4n
88 Enables the 100 Base TX full-duplex link option. (This is generally the fastest
89 mode if both link partners support it. Most modern equipment supports this
90 mode.)
91 .RE
93 .sp
94 .ne 2
95 .na
96 \fB\fBadv_100hdx_cap\fR\fR
97 .ad
98 .sp .6
99 .RS 4n
100 Enables the 100 Base TX half-duplex link option. (Typically used when the link
101 partner is a 100 Mbps hub.)
105 .ne 2
107 \fB\fBadv_10fdx_cap\fR\fR
109 .sp .6
110 .RS 4n
111 Enables the 10 Base-T full-duplex link option.  (This less-frequently used mode
112 is typically used when the link partner is a 10 Mbps switch.)
116 .ne 2
118 \fB\fBadv_10hdx_cap\fR\fR
120 .sp .6
121 .RS 4n
122 Enables the 10 Base-T half-duplex link option.  (This is the fall-back when no
123 other option is available.  It is typically used when the link partner is a 10
124 Mbps hub or is an older network card.)
127 .SH ATTRIBUTES
130 See \fBattributes\fR(5) for a description of the following attributes:
135 box;
136 c | c
137 l | l .
138 ATTRIBUTE TYPE  ATTRIBUTE VALUE
140 Interface Stability     Committed
143 .SH FILES
145 .ne 2
147 \fB\fB/dev/sfe\fR\fR
149 .sp .6
150 .RS 4n
151 Special character device.
155 .ne 2
157 \fB\fB/kernel/drv/sfe\fR\fR
159 .sp .6
160 .RS 4n
161 32-bit driver binary (x86).
165 .ne 2
167 \fB\fB/kernel/drv/amd64/sfe\fR\fR
169 .sp .6
170 .RS 4n
171 64-bit driver binary (x86).
175 .ne 2
177 \fB\fB/kernel/drv/sparcv9/sfe\fR\fR
179 .sp .6
180 .RS 4n
181 64-bit driver binary (SPARC).
185 .ne 2
187 \fB\fB/kernel/drv/sfe.conf\fR\fR
189 .sp .6
190 .RS 4n
191 Configuration file.
194 .SH SEE ALSO
197 \fBndd\fR(8), \fBdriver.conf\fR(4), \fBattributes\fR(5), \fBstreamio\fR(7I),
198 \fBdlpi\fR(7P)
201 \fIIEEE 802.3\fR \(em Institute of Electrical and Electronics Engineers, 2002