xref: /freebsd/share/man/man4/sge.4 (revision e0c4386e)
1.\" Copyright (c) 2010 Pyun YongHyeon
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\"    notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\"    notice, this list of conditions and the following disclaimer in the
11.\"    documentation and/or other materials provided with the distribution.
12.\"
13.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23.\" SUCH DAMAGE.
24.\"
25.Dd January 16, 2011
26.Dt SGE 4
27.Os
28.Sh NAME
29.Nm sge
30.Nd Silicon Integrated Systems SiS190/191 Fast/Gigabit Ethernet driver
31.Sh SYNOPSIS
32To compile this driver into the kernel,
33place the following lines in your
34kernel configuration file:
35.Bd -ragged -offset indent
36.Cd "device miibus"
37.Cd "device sge"
38.Ed
39.Pp
40Alternatively, to load the driver as a
41module at boot time, place the following line in
42.Xr loader.conf 5 :
43.Bd -literal -offset indent
44if_sge_load="YES"
45.Ed
46.Sh DESCRIPTION
47The
48.Nm
49device driver provides support for SiS190 Fast Ethernet
50controllers and SiS191 Fast/Gigabit Ethernet controllers.
51.Pp
52All LOMs supported by the
53.Nm
54driver have TCP/UDP/IP checksum offload for transmit and receive,
55TCP segmentation offload (TSO), hardware VLAN tag stripping/insertion
56features.
57Due to lack of documentation Wake On Lan (WOL), Jumbo frame and an
58interrupt moderation mechanism are not supported yet.
59.Pp
60The
61.Nm
62driver supports the following media types:
63.Bl -tag -width ".Cm 10baseT/UTP"
64.It Cm autoselect
65Enable autoselection of the media type and options.
66The user can manually override
67the autoselected mode by adding media options to
68.Xr rc.conf 5 .
69.It Cm 10baseT/UTP
70Set 10Mbps operation.
71.It Cm 100baseTX
72Set 100Mbps (Fast Ethernet) operation.
73.It Cm 1000baseTX
74Set 1000baseTX operation over twisted pair.
75.El
76.Pp
77The
78.Nm
79driver supports the following media options:
80.Bl -tag -width ".Cm full-duplex"
81.It Cm full-duplex
82Force full duplex operation.
83.It Cm half-duplex
84Force half duplex operation.
85.El
86.Pp
87For more information on configuring this device, see
88.Xr ifconfig 8 .
89.Sh HARDWARE
90The
91.Nm
92device driver provides support for the following Ethernet controllers:
93.Pp
94.Bl -bullet -compact
95.It
96SiS190 Fast Ethernet controller
97.It
98SiS191 Fast/Gigabit Ethernet controller
99.El
100.Sh SEE ALSO
101.Xr altq 4 ,
102.Xr arp 4 ,
103.Xr miibus 4 ,
104.Xr netintro 4 ,
105.Xr ng_ether 4 ,
106.Xr rgephy 4 ,
107.Xr vlan 4 ,
108.Xr ifconfig 8
109.Sh HISTORY
110The
111.Nm
112driver was written by
113.An Alexander Pohoyda Aq Mt alexander.pohoyda@gmx.net .
114And enhanced by
115.An Nikolay Denev Aq Mt ndenev@gmail.com .
116It first appeared in
117.Fx 8.1 .
118