xref: /freebsd/share/man/man4/lge.4 (revision 90296834d97db401ea834f9e27960d66a97091d0)
1c678bc4fSBill Paul.\" Copyright (c) 2001 Wind River Systems
2c678bc4fSBill Paul.\" Copyright (c) 1997, 1998, 1999, 2000, 2001
3c678bc4fSBill Paul.\"	Bill Paul <william.paul@windriver.com>. All rights reserved.
4c678bc4fSBill Paul.\"
5c678bc4fSBill Paul.\" Redistribution and use in source and binary forms, with or without
6c678bc4fSBill Paul.\" modification, are permitted provided that the following conditions
7c678bc4fSBill Paul.\" are met:
8c678bc4fSBill Paul.\" 1. Redistributions of source code must retain the above copyright
9c678bc4fSBill Paul.\"    notice, this list of conditions and the following disclaimer.
10c678bc4fSBill Paul.\" 2. Redistributions in binary form must reproduce the above copyright
11c678bc4fSBill Paul.\"    notice, this list of conditions and the following disclaimer in the
12c678bc4fSBill Paul.\"    documentation and/or other materials provided with the distribution.
13c678bc4fSBill Paul.\" 3. All advertising materials mentioning features or use of this software
14c678bc4fSBill Paul.\"    must display the following acknowledgement:
15c678bc4fSBill Paul.\"	This product includes software developed by Bill Paul.
16c678bc4fSBill Paul.\" 4. Neither the name of the author nor the names of any co-contributors
17c678bc4fSBill Paul.\"    may be used to endorse or promote products derived from this software
18c678bc4fSBill Paul.\"   without specific prior written permission.
19c678bc4fSBill Paul.\"
20c678bc4fSBill Paul.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
21c678bc4fSBill Paul.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22c678bc4fSBill Paul.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23c678bc4fSBill Paul.\" ARE DISCLAIMED.  IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD
24c678bc4fSBill Paul.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
25c678bc4fSBill Paul.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
26c678bc4fSBill Paul.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27c678bc4fSBill Paul.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28c678bc4fSBill Paul.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29c678bc4fSBill Paul.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
30c678bc4fSBill Paul.\" THE POSSIBILITY OF SUCH DAMAGE.
31c678bc4fSBill Paul.\"
32c678bc4fSBill Paul.\" $FreeBSD$
33c678bc4fSBill Paul.\"
3486e3186eSTom Rhodes.Dd July 16, 2005
35c678bc4fSBill Paul.Dt LGE 4
36c678bc4fSBill Paul.Os
37c678bc4fSBill Paul.Sh NAME
38c678bc4fSBill Paul.Nm lge
39a0f1044fSChristian Brueffer.Nd "Level 1 LXT1001 NetCellerator PCI Gigabit Ethernet adapter driver"
40c678bc4fSBill Paul.Sh SYNOPSIS
4186e3186eSTom RhodesTo compile support for the
4286e3186eSTom Rhodes.Nm
4390296834STom Rhodesdriver into your kernel, place the following lines in your
4490296834STom Rhodeskernel configuration file:
4586e3186eSTom Rhodes.Bd -ragged -offset indent
46c678bc4fSBill Paul.Cd "device miibus"
47c678bc4fSBill Paul.Cd "device lge"
4886e3186eSTom Rhodes.Ed
4986e3186eSTom Rhodes.Pp
5086e3186eSTom RhodesAlternatively, to load the
5186e3186eSTom Rhodes.Nm
5286e3186eSTom Rhodesdriver at boot time, place the following line in
5386e3186eSTom Rhodes.Xr loader.conf 5 :
5486e3186eSTom Rhodes.Bd -literal -offset indent
5586e3186eSTom Rhodesif_lge_load="YES"
5686e3186eSTom Rhodes.Ed
57c678bc4fSBill Paul.Sh DESCRIPTION
58c678bc4fSBill PaulThe
59c678bc4fSBill Paul.Nm
60c678bc4fSBill Pauldriver provides support for various NICs based on the Level 1 LXT1001
61a0f1044fSChristian BruefferNetCellerator Gigabit Ethernet controller chip.
62c678bc4fSBill Paul.Pp
6387f3d8beSChristian BruefferThe LXT1001 supports fiber PHYs and also a GMII port for use with
6487f3d8beSChristian Brueffer10/100/1000 copper PHYs, however there are currently no NICs on the
6587f3d8beSChristian Brueffermarket that use this feature.
6687f3d8beSChristian Brueffer.Pp
67c678bc4fSBill PaulThe LXT1001 supports TCP/IP checksum offload for receive and
68c678bc4fSBill PaulVLAN-based filtering as well as a 64-bit multicast hash filter.
69c678bc4fSBill PaulIt also supports jumbo frames, which can be configured
70c678bc4fSBill Paulvia the interface MTU setting.
71c678bc4fSBill PaulSelecting an MTU larger than 1500 bytes with the
72c678bc4fSBill Paul.Xr ifconfig 8
73c678bc4fSBill Paulutility configures the adapter to receive and transmit jumbo frames.
74c92a454eSBill PaulUsing jumbo frames can greatly improve performance for certain tasks,
75c678bc4fSBill Paulsuch as file transfers and data streaming.
76c678bc4fSBill Paul.Pp
77c678bc4fSBill PaulThe
78c678bc4fSBill Paul.Nm
79c678bc4fSBill Pauldriver supports the following media types:
80e8b02a42SRuslan Ermilov.Bl -tag -width ".Cm 1000baseSX"
81c678bc4fSBill Paul.It Cm autoselect
82c678bc4fSBill PaulEnable autoselection of the media type and options.
83c678bc4fSBill PaulThe user can manually override
84c678bc4fSBill Paulthe autoselected mode by adding media options to
85c678bc4fSBill Paul.Xr rc.conf 5 .
86c678bc4fSBill Paul.It Cm 1000baseSX
876120025fSRuslan ErmilovSet 1000baseSX operation over fiber optic cable.
886120025fSRuslan ErmilovBoth
89c678bc4fSBill Paul.Cm full-duplex
90c678bc4fSBill Pauland
91c678bc4fSBill Paul.Cm half-duplex
92c678bc4fSBill Paulmodes are supported.
93c678bc4fSBill Paul.El
94c678bc4fSBill Paul.Pp
95c678bc4fSBill PaulThe
96c678bc4fSBill Paul.Nm
97c678bc4fSBill Pauldriver supports the following media options:
98e8b02a42SRuslan Ermilov.Bl -tag -width ".Cm full-duplex"
99c678bc4fSBill Paul.It Cm full-duplex
100c678bc4fSBill PaulForce full duplex operation.
101c678bc4fSBill Paul.It Cm half-duplex
102c678bc4fSBill PaulForce half duplex operation.
103c678bc4fSBill Paul.El
104c678bc4fSBill Paul.Pp
105c678bc4fSBill PaulFor more information on configuring this device, see
106c678bc4fSBill Paul.Xr ifconfig 8 .
107a0f1044fSChristian Brueffer.Sh HARDWARE
108a0f1044fSChristian BruefferAdapters supported by the
109a0f1044fSChristian Brueffer.Nm
110a0f1044fSChristian Bruefferdriver include:
111a0f1044fSChristian Brueffer.Pp
112a0f1044fSChristian Brueffer.Bl -bullet -compact
113a0f1044fSChristian Brueffer.It
114a0f1044fSChristian BruefferSMC TigerCard 1000 (SMC9462SX)
115a0f1044fSChristian Brueffer.It
116a0f1044fSChristian BruefferD-Link DGE-500SX
117a0f1044fSChristian Brueffer.El
118c678bc4fSBill Paul.Sh DIAGNOSTICS
119c678bc4fSBill Paul.Bl -diag
120c678bc4fSBill Paul.It "lge%d: couldn't map memory"
121c678bc4fSBill PaulA fatal initialization error has occurred.
122c678bc4fSBill Paul.It "lge%d: couldn't map ports"
123c678bc4fSBill PaulA fatal initialization error has occurred.
124c678bc4fSBill Paul.It "lge%d: couldn't map interrupt"
125c678bc4fSBill PaulA fatal initialization error has occurred.
126c678bc4fSBill Paul.It "lge%d: no memory for softc struct!"
127c678bc4fSBill PaulThe driver failed to allocate memory for per-device instance information
128c678bc4fSBill Paulduring initialization.
129c678bc4fSBill Paul.It "lge%d: failed to enable memory mapping!"
130c678bc4fSBill PaulThe driver failed to initialize PCI shared memory mapping.
131c678bc4fSBill PaulThis might
132c678bc4fSBill Paulhappen if the card is not in a bus-master slot.
133c678bc4fSBill Paul.It "lge%d: no memory for jumbo buffers!"
134c678bc4fSBill PaulThe driver failed to allocate memory for jumbo frames during
135c678bc4fSBill Paulinitialization.
136c678bc4fSBill Paul.It "lge%d: watchdog timeout"
137c678bc4fSBill PaulThe device has stopped responding to the network, or there is a problem with
138c678bc4fSBill Paulthe network connection (cable).
139c678bc4fSBill Paul.El
140c678bc4fSBill Paul.Sh SEE ALSO
141c678bc4fSBill Paul.Xr arp 4 ,
142130b84f5SChristian Brueffer.Xr miibus 4 ,
143c678bc4fSBill Paul.Xr netintro 4 ,
144c678bc4fSBill Paul.Xr ng_ether 4 ,
145c678bc4fSBill Paul.Xr ifconfig 8
146c678bc4fSBill Paul.Rs
147c678bc4fSBill Paul.%T Level 1 LXT1001 Programming Manual
1486120025fSRuslan Ermilov.%O http://www.FreeBSD.org/~wpaul/Level1/LXT1001SRM.pdf
149c678bc4fSBill Paul.Re
150c678bc4fSBill Paul.Sh HISTORY
151c678bc4fSBill PaulThe
152c678bc4fSBill Paul.Nm
153c678bc4fSBill Pauldevice driver first appeared in
15486f47875SSheldon Hearn.Fx 4.4 .
155c678bc4fSBill Paul.Sh AUTHORS
156c678bc4fSBill PaulThe
157c678bc4fSBill Paul.Nm
158c678bc4fSBill Pauldriver was written by
159c678bc4fSBill Paul.An Bill Paul Aq william.paul@windriver.com .
160