xref: /freebsd/share/man/man4/lge.4 (revision 16d78bb878deb14559061f5733b2439e9a3392cf)
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
4116d78bb8STom RhodesTo compile this driver into the kernel,
4216d78bb8STom Rhodesplace the following lines in your
4390296834STom Rhodeskernel configuration file:
4486e3186eSTom Rhodes.Bd -ragged -offset indent
45c678bc4fSBill Paul.Cd "device miibus"
46c678bc4fSBill Paul.Cd "device lge"
4786e3186eSTom Rhodes.Ed
4886e3186eSTom Rhodes.Pp
4916d78bb8STom RhodesAlternatively, to load the driver as a
5016d78bb8STom Rhodesmodule at boot time, place the following line in
5186e3186eSTom Rhodes.Xr loader.conf 5 :
5286e3186eSTom Rhodes.Bd -literal -offset indent
5386e3186eSTom Rhodesif_lge_load="YES"
5486e3186eSTom Rhodes.Ed
55c678bc4fSBill Paul.Sh DESCRIPTION
56c678bc4fSBill PaulThe
57c678bc4fSBill Paul.Nm
58c678bc4fSBill Pauldriver provides support for various NICs based on the Level 1 LXT1001
59a0f1044fSChristian BruefferNetCellerator Gigabit Ethernet controller chip.
60c678bc4fSBill Paul.Pp
6187f3d8beSChristian BruefferThe LXT1001 supports fiber PHYs and also a GMII port for use with
6287f3d8beSChristian Brueffer10/100/1000 copper PHYs, however there are currently no NICs on the
6387f3d8beSChristian Brueffermarket that use this feature.
6487f3d8beSChristian Brueffer.Pp
65c678bc4fSBill PaulThe LXT1001 supports TCP/IP checksum offload for receive and
66c678bc4fSBill PaulVLAN-based filtering as well as a 64-bit multicast hash filter.
67c678bc4fSBill PaulIt also supports jumbo frames, which can be configured
68c678bc4fSBill Paulvia the interface MTU setting.
69c678bc4fSBill PaulSelecting an MTU larger than 1500 bytes with the
70c678bc4fSBill Paul.Xr ifconfig 8
71c678bc4fSBill Paulutility configures the adapter to receive and transmit jumbo frames.
72c92a454eSBill PaulUsing jumbo frames can greatly improve performance for certain tasks,
73c678bc4fSBill Paulsuch as file transfers and data streaming.
74c678bc4fSBill Paul.Pp
75c678bc4fSBill PaulThe
76c678bc4fSBill Paul.Nm
77c678bc4fSBill Pauldriver supports the following media types:
78e8b02a42SRuslan Ermilov.Bl -tag -width ".Cm 1000baseSX"
79c678bc4fSBill Paul.It Cm autoselect
80c678bc4fSBill PaulEnable autoselection of the media type and options.
81c678bc4fSBill PaulThe user can manually override
82c678bc4fSBill Paulthe autoselected mode by adding media options to
83c678bc4fSBill Paul.Xr rc.conf 5 .
84c678bc4fSBill Paul.It Cm 1000baseSX
856120025fSRuslan ErmilovSet 1000baseSX operation over fiber optic cable.
866120025fSRuslan ErmilovBoth
87c678bc4fSBill Paul.Cm full-duplex
88c678bc4fSBill Pauland
89c678bc4fSBill Paul.Cm half-duplex
90c678bc4fSBill Paulmodes are supported.
91c678bc4fSBill Paul.El
92c678bc4fSBill Paul.Pp
93c678bc4fSBill PaulThe
94c678bc4fSBill Paul.Nm
95c678bc4fSBill Pauldriver supports the following media options:
96e8b02a42SRuslan Ermilov.Bl -tag -width ".Cm full-duplex"
97c678bc4fSBill Paul.It Cm full-duplex
98c678bc4fSBill PaulForce full duplex operation.
99c678bc4fSBill Paul.It Cm half-duplex
100c678bc4fSBill PaulForce half duplex operation.
101c678bc4fSBill Paul.El
102c678bc4fSBill Paul.Pp
103c678bc4fSBill PaulFor more information on configuring this device, see
104c678bc4fSBill Paul.Xr ifconfig 8 .
105a0f1044fSChristian Brueffer.Sh HARDWARE
106a0f1044fSChristian BruefferAdapters supported by the
107a0f1044fSChristian Brueffer.Nm
108a0f1044fSChristian Bruefferdriver include:
109a0f1044fSChristian Brueffer.Pp
110a0f1044fSChristian Brueffer.Bl -bullet -compact
111a0f1044fSChristian Brueffer.It
112a0f1044fSChristian BruefferSMC TigerCard 1000 (SMC9462SX)
113a0f1044fSChristian Brueffer.It
114a0f1044fSChristian BruefferD-Link DGE-500SX
115a0f1044fSChristian Brueffer.El
116c678bc4fSBill Paul.Sh DIAGNOSTICS
117c678bc4fSBill Paul.Bl -diag
118c678bc4fSBill Paul.It "lge%d: couldn't map memory"
119c678bc4fSBill PaulA fatal initialization error has occurred.
120c678bc4fSBill Paul.It "lge%d: couldn't map ports"
121c678bc4fSBill PaulA fatal initialization error has occurred.
122c678bc4fSBill Paul.It "lge%d: couldn't map interrupt"
123c678bc4fSBill PaulA fatal initialization error has occurred.
124c678bc4fSBill Paul.It "lge%d: no memory for softc struct!"
125c678bc4fSBill PaulThe driver failed to allocate memory for per-device instance information
126c678bc4fSBill Paulduring initialization.
127c678bc4fSBill Paul.It "lge%d: failed to enable memory mapping!"
128c678bc4fSBill PaulThe driver failed to initialize PCI shared memory mapping.
129c678bc4fSBill PaulThis might
130c678bc4fSBill Paulhappen if the card is not in a bus-master slot.
131c678bc4fSBill Paul.It "lge%d: no memory for jumbo buffers!"
132c678bc4fSBill PaulThe driver failed to allocate memory for jumbo frames during
133c678bc4fSBill Paulinitialization.
134c678bc4fSBill Paul.It "lge%d: watchdog timeout"
135c678bc4fSBill PaulThe device has stopped responding to the network, or there is a problem with
136c678bc4fSBill Paulthe network connection (cable).
137c678bc4fSBill Paul.El
138c678bc4fSBill Paul.Sh SEE ALSO
139c678bc4fSBill Paul.Xr arp 4 ,
140130b84f5SChristian Brueffer.Xr miibus 4 ,
141c678bc4fSBill Paul.Xr netintro 4 ,
142c678bc4fSBill Paul.Xr ng_ether 4 ,
143c678bc4fSBill Paul.Xr ifconfig 8
144c678bc4fSBill Paul.Rs
145c678bc4fSBill Paul.%T Level 1 LXT1001 Programming Manual
1466120025fSRuslan Ermilov.%O http://www.FreeBSD.org/~wpaul/Level1/LXT1001SRM.pdf
147c678bc4fSBill Paul.Re
148c678bc4fSBill Paul.Sh HISTORY
149c678bc4fSBill PaulThe
150c678bc4fSBill Paul.Nm
151c678bc4fSBill Pauldevice driver first appeared in
15286f47875SSheldon Hearn.Fx 4.4 .
153c678bc4fSBill Paul.Sh AUTHORS
154c678bc4fSBill PaulThe
155c678bc4fSBill Paul.Nm
156c678bc4fSBill Pauldriver was written by
157c678bc4fSBill Paul.An Bill Paul Aq william.paul@windriver.com .
158