xref: /freebsd/share/man/man4/lge.4 (revision 6b806d21d144c25f4fad714e1c0cf780f5e27d7e)
1.\" Copyright (c) 2001 Wind River Systems
2.\" Copyright (c) 1997, 1998, 1999, 2000, 2001
3.\"	Bill Paul <william.paul@windriver.com>. All rights reserved.
4.\"
5.\" Redistribution and use in source and binary forms, with or without
6.\" modification, are permitted provided that the following conditions
7.\" are met:
8.\" 1. Redistributions of source code must retain the above copyright
9.\"    notice, this list of conditions and the following disclaimer.
10.\" 2. Redistributions in binary form must reproduce the above copyright
11.\"    notice, this list of conditions and the following disclaimer in the
12.\"    documentation and/or other materials provided with the distribution.
13.\" 3. All advertising materials mentioning features or use of this software
14.\"    must display the following acknowledgement:
15.\"	This product includes software developed by Bill Paul.
16.\" 4. Neither the name of the author nor the names of any co-contributors
17.\"    may be used to endorse or promote products derived from this software
18.\"   without specific prior written permission.
19.\"
20.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
21.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23.\" ARE DISCLAIMED.  IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD
24.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
25.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
26.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
30.\" THE POSSIBILITY OF SUCH DAMAGE.
31.\"
32.\" $FreeBSD$
33.\"
34.Dd August 24, 2004
35.Dt LGE 4
36.Os
37.Sh NAME
38.Nm lge
39.Nd "Level 1 LXT1001 NetCellerator PCI Gigabit Ethernet adapter driver"
40.Sh SYNOPSIS
41.Cd "device miibus"
42.Cd "device lge"
43.Sh DESCRIPTION
44The
45.Nm
46driver provides support for various NICs based on the Level 1 LXT1001
47NetCellerator Gigabit Ethernet controller chip.
48.Pp
49The LXT1001 supports fiber PHYs and also a GMII port for use with
5010/100/1000 copper PHYs, however there are currently no NICs on the
51market that use this feature.
52.Pp
53The LXT1001 supports TCP/IP checksum offload for receive and
54VLAN-based filtering as well as a 64-bit multicast hash filter.
55It also supports jumbo frames, which can be configured
56via the interface MTU setting.
57Selecting an MTU larger than 1500 bytes with the
58.Xr ifconfig 8
59utility configures the adapter to receive and transmit jumbo frames.
60Using jumbo frames can greatly improve performance for certain tasks,
61such as file transfers and data streaming.
62.Pp
63The
64.Nm
65driver supports the following media types:
66.Bl -tag -width ".Cm 1000baseSX"
67.It Cm autoselect
68Enable autoselection of the media type and options.
69The user can manually override
70the autoselected mode by adding media options to
71.Xr rc.conf 5 .
72.It Cm 1000baseSX
73Set 1000baseSX operation over fiber optic cable.
74Both
75.Cm full-duplex
76and
77.Cm half-duplex
78modes are supported.
79.El
80.Pp
81The
82.Nm
83driver supports the following media options:
84.Bl -tag -width ".Cm full-duplex"
85.It Cm full-duplex
86Force full duplex operation.
87.It Cm half-duplex
88Force half duplex operation.
89.El
90.Pp
91For more information on configuring this device, see
92.Xr ifconfig 8 .
93.Sh HARDWARE
94Adapters supported by the
95.Nm
96driver include:
97.Pp
98.Bl -bullet -compact
99.It
100SMC TigerCard 1000 (SMC9462SX)
101.It
102D-Link DGE-500SX
103.El
104.Sh DIAGNOSTICS
105.Bl -diag
106.It "lge%d: couldn't map memory"
107A fatal initialization error has occurred.
108.It "lge%d: couldn't map ports"
109A fatal initialization error has occurred.
110.It "lge%d: couldn't map interrupt"
111A fatal initialization error has occurred.
112.It "lge%d: no memory for softc struct!"
113The driver failed to allocate memory for per-device instance information
114during initialization.
115.It "lge%d: failed to enable memory mapping!"
116The driver failed to initialize PCI shared memory mapping.
117This might
118happen if the card is not in a bus-master slot.
119.It "lge%d: no memory for jumbo buffers!"
120The driver failed to allocate memory for jumbo frames during
121initialization.
122.It "lge%d: watchdog timeout"
123The device has stopped responding to the network, or there is a problem with
124the network connection (cable).
125.El
126.Sh SEE ALSO
127.Xr arp 4 ,
128.Xr miibus 4 ,
129.Xr netintro 4 ,
130.Xr ng_ether 4 ,
131.Xr ifconfig 8
132.Rs
133.%T Level 1 LXT1001 Programming Manual
134.%O http://www.FreeBSD.org/~wpaul/Level1/LXT1001SRM.pdf
135.Re
136.Sh HISTORY
137The
138.Nm
139device driver first appeared in
140.Fx 4.4 .
141.Sh AUTHORS
142The
143.Nm
144driver was written by
145.An Bill Paul Aq william.paul@windriver.com .
146