xref: /openbsd-src/share/man/man4/se.4 (revision 3ead84f28bf291f24701fa771c0e891591353c3e)
1.\"	$OpenBSD: se.4,v 1.9 2021/09/08 20:29:21 jmc Exp $
2.\"
3.\" Copyright (c) 2010
4.\"	Christopher Zimmermann <madroach@zakweb.de>. All rights reserved.
5.\" Copyright (c) 1997, 1998, 1999
6.\"	Bill Paul <wpaul@ee.columbia.edu>. All rights reserved.
7.\"
8.\" Redistribution and use in source and binary forms, with or without
9.\" modification, are permitted provided that the following conditions
10.\" are met:
11.\" 1. Redistributions of source code must retain the above copyright
12.\"    notice, this list of conditions and the following disclaimer.
13.\" 2. Redistributions in binary form must reproduce the above copyright
14.\"    notice, this list of conditions and the following disclaimer in the
15.\"    documentation and/or other materials provided with the distribution.
16.\" 3. All advertising materials mentioning features or use of this software
17.\"    must display the following acknowledgement:
18.\"	This product includes software developed by Bill Paul.
19.\" 4. Neither the name of the author nor the names of any co-contributors
20.\"    may be used to endorse or promote products derived from this software
21.\"   without specific prior written permission.
22.\"
23.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
24.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26.\" ARE DISCLAIMED.  IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD
27.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
28.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
29.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
30.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
31.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
32.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
33.\" THE POSSIBILITY OF SUCH DAMAGE.
34.\"
35.\" $FreeBSD: src/share/man/man4/sis.4,v 1.2 1999/11/15 23:14:27 phantom Exp $
36.\"
37.Dd $Mdocdate: September 8 2021 $
38.Dt SE 4
39.Os
40.Sh NAME
41.Nm se
42.Nd SiS 190/191 10/100/1Gb Ethernet device
43.Sh SYNOPSIS
44.Cd "se* at pci?"
45.Cd "atphy* at mii?"
46.Cd "brgphy* at mii?"
47.Cd "eephy* at mii?"
48.Cd "etphy* at mii?"
49.Cd "rlphy* at mii?"
50.Sh DESCRIPTION
51The
52.Nm
53driver provides support for the SiS190 Fast Ethernet controller
54integrated into the SiS965L and SiS966L southbridges,
55and the SiS191 Gigabit controller
56integrated into the SiS965 and SiS966 southbridges.
57.Pp
58Both SiS 190 and SiS 191 embed an Ethernet MAC with external PHY.
59They use a bus master DMA and a scatter/gather descriptor scheme
60and include a 64-bit multicast hash filter.
61.Pp
62The
63.Nm
64driver supports the following media types:
65.Bl -tag -width full-duplex
66.It autoselect
67Enable autoselection of the media type and options.
68The user can manually override
69the autoselected mode by adding media options to the
70.Xr hostname.if 5
71file.
72.It 10baseT
73Set 10Mbps operation.
74The
75.Ar mediaopt
76option can also be used to select either
77.Ar full-duplex
78or
79.Ar half-duplex
80modes.
81.It 100baseTX
82Set 100Mbps (Fast Ethernet) operation.
83The
84.Ar mediaopt
85option can also be used to select either
86.Ar full-duplex
87or
88.Ar half-duplex
89modes.
90.It 1000baseSX
91Set 1000Mbps (Gigabit Ethernet) on fiber operation.
92Only
93.Ar full-duplex
94mode is supported at this speed.
95.It 1000baseT
96Set 1000Mbps (Gigabit Ethernet) on copper operation.
97.El
98.Pp
99The
100.Nm
101driver supports the following media options:
102.Bl -tag -width full-duplex
103.It full-duplex
104Force full duplex operation.
105.It half-duplex
106Force half duplex operation.
107.El
108.Pp
109For more information on configuring this device, see
110.Xr ifconfig 8 .
111.Sh DIAGNOSTICS
112.Bl -diag
113.It "se0: EEPROM read timeout"
114The driver could not read the controller's MAC address from its EEPROM.
115.It "se0: invalid EEPROM signature"
116The driver could not find the expected EEPROM signature and could not read
117the controller's MAC address.
118.It "se0: Could not find PCI-ISA bridge"
119The driver could not read the controller's MAC address from the CMOS memory
120connected to the PCI-ISA bridge.
121.It "se0: PHY read timeout"
122The driver could not read data from the PHY.
123.It "se0: PHY write timeout"
124The driver could not write data to the PHY.
125.It "se0: watchdog timeout"
126The device has stopped responding to the network, or there is a problem with
127the network connection (cable).
128.El
129.Sh SEE ALSO
130.Xr arp 4 ,
131.Xr atphy 4 ,
132.Xr brgphy 4 ,
133.Xr eephy 4 ,
134.Xr etphy 4 ,
135.Xr ifmedia 4 ,
136.Xr intro 4 ,
137.Xr netintro 4 ,
138.Xr pci 4 ,
139.Xr rlphy 4 ,
140.Xr hostname.if 5 ,
141.Xr ifconfig 8
142.Sh HISTORY
143The
144.Nm
145driver first appeared in
146.Ox 4.8 .
147.Sh AUTHORS
148.An -nosplit
149The
150.Nm
151driver was adapted by
152.An Alexander Pohoyda Aq Mt alexander.pohoyda@gmx.net
153from the
154.Xr sis 4
155driver written by
156.An Bill Paul Aq Mt wpaul@ee.columbia.edu ,
157and ported to
158.Ox
159by
160.An Christopher Zimmermann Aq Mt madroach@zakweb.de .
161SiS 191 support was added by
162.An Nikolay Denev Aq Mt ndenev@gmail.com .
163