xref: /freebsd/share/man/man4/lge.4 (revision a0f1044f23c9c7d8aa0e1eecf53ecbcd0b554f9d)
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.\"
34a0f1044fSChristian Brueffer.Dd August 24, 2004
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
41c678bc4fSBill Paul.Cd "device miibus"
42c678bc4fSBill Paul.Cd "device lge"
43c678bc4fSBill Paul.Sh DESCRIPTION
44c678bc4fSBill PaulThe
45c678bc4fSBill Paul.Nm
46c678bc4fSBill Pauldriver provides support for various NICs based on the Level 1 LXT1001
47a0f1044fSChristian BruefferNetCellerator Gigabit Ethernet controller chip.
48c678bc4fSBill Paul.Pp
49c678bc4fSBill PaulThe LXT1001 supports TCP/IP checksum offload for receive and
50c678bc4fSBill PaulVLAN-based filtering as well as a 64-bit multicast hash filter.
51c678bc4fSBill PaulIt also supports jumbo frames, which can be configured
52c678bc4fSBill Paulvia the interface MTU setting.
53c678bc4fSBill PaulSelecting an MTU larger than 1500 bytes with the
54c678bc4fSBill Paul.Xr ifconfig 8
55c678bc4fSBill Paulutility configures the adapter to receive and transmit jumbo frames.
56c92a454eSBill PaulUsing jumbo frames can greatly improve performance for certain tasks,
57c678bc4fSBill Paulsuch as file transfers and data streaming.
58c678bc4fSBill Paul.Pp
59c678bc4fSBill PaulThe
60c678bc4fSBill Paul.Nm
61c678bc4fSBill Pauldriver supports the following media types:
62e8b02a42SRuslan Ermilov.Bl -tag -width ".Cm 1000baseSX"
63c678bc4fSBill Paul.It Cm autoselect
64c678bc4fSBill PaulEnable autoselection of the media type and options.
65c678bc4fSBill PaulThe user can manually override
66c678bc4fSBill Paulthe autoselected mode by adding media options to
67c678bc4fSBill Paul.Xr rc.conf 5 .
68c678bc4fSBill Paul.It Cm 1000baseSX
696120025fSRuslan ErmilovSet 1000baseSX operation over fiber optic cable.
706120025fSRuslan ErmilovBoth
71c678bc4fSBill Paul.Cm full-duplex
72c678bc4fSBill Pauland
73c678bc4fSBill Paul.Cm half-duplex
74c678bc4fSBill Paulmodes are supported.
75c678bc4fSBill Paul.El
76c678bc4fSBill Paul.Pp
77c678bc4fSBill PaulThe
78c678bc4fSBill Paul.Nm
79c678bc4fSBill Pauldriver supports the following media options:
80e8b02a42SRuslan Ermilov.Bl -tag -width ".Cm full-duplex"
81c678bc4fSBill Paul.It Cm full-duplex
82c678bc4fSBill PaulForce full duplex operation.
83c678bc4fSBill Paul.It Cm half-duplex
84c678bc4fSBill PaulForce half duplex operation.
85c678bc4fSBill Paul.El
86c678bc4fSBill Paul.Pp
87c678bc4fSBill PaulFor more information on configuring this device, see
88c678bc4fSBill Paul.Xr ifconfig 8 .
89a0f1044fSChristian Brueffer.Sh HARDWARE
90a0f1044fSChristian BruefferAdapters supported by the
91a0f1044fSChristian Brueffer.Nm
92a0f1044fSChristian Bruefferdriver include:
93a0f1044fSChristian Brueffer.Pp
94a0f1044fSChristian Brueffer.Bl -bullet -compact
95a0f1044fSChristian Brueffer.It
96a0f1044fSChristian BruefferSMC TigerCard 1000 (SMC9462SX)
97a0f1044fSChristian Brueffer.It
98a0f1044fSChristian BruefferD-Link DGE-500SX
99a0f1044fSChristian Brueffer.El
100a0f1044fSChristian Brueffer.Pp
101a0f1044fSChristian BruefferThese NICs are capable of 1000Mbps speeds over fiber optic cable.
102a0f1044fSChristian BruefferThe LXT1001 also supports a GMII port for use with 10/100/1000 copper
103a0f1044fSChristian BruefferPHYs, however there aren't currently any NICs on the market that use
104a0f1044fSChristian Bruefferthis feature.
105c678bc4fSBill Paul.Sh DIAGNOSTICS
106c678bc4fSBill Paul.Bl -diag
107c678bc4fSBill Paul.It "lge%d: couldn't map memory"
108c678bc4fSBill PaulA fatal initialization error has occurred.
109c678bc4fSBill Paul.It "lge%d: couldn't map ports"
110c678bc4fSBill PaulA fatal initialization error has occurred.
111c678bc4fSBill Paul.It "lge%d: couldn't map interrupt"
112c678bc4fSBill PaulA fatal initialization error has occurred.
113c678bc4fSBill Paul.It "lge%d: no memory for softc struct!"
114c678bc4fSBill PaulThe driver failed to allocate memory for per-device instance information
115c678bc4fSBill Paulduring initialization.
116c678bc4fSBill Paul.It "lge%d: failed to enable memory mapping!"
117c678bc4fSBill PaulThe driver failed to initialize PCI shared memory mapping.
118c678bc4fSBill PaulThis might
119c678bc4fSBill Paulhappen if the card is not in a bus-master slot.
120c678bc4fSBill Paul.It "lge%d: no memory for jumbo buffers!"
121c678bc4fSBill PaulThe driver failed to allocate memory for jumbo frames during
122c678bc4fSBill Paulinitialization.
123c678bc4fSBill Paul.It "lge%d: watchdog timeout"
124c678bc4fSBill PaulThe device has stopped responding to the network, or there is a problem with
125c678bc4fSBill Paulthe network connection (cable).
126c678bc4fSBill Paul.El
127c678bc4fSBill Paul.Sh SEE ALSO
128c678bc4fSBill Paul.Xr arp 4 ,
129130b84f5SChristian Brueffer.Xr miibus 4 ,
130c678bc4fSBill Paul.Xr netintro 4 ,
131c678bc4fSBill Paul.Xr ng_ether 4 ,
132c678bc4fSBill Paul.Xr ifconfig 8
133c678bc4fSBill Paul.Rs
134c678bc4fSBill Paul.%T Level 1 LXT1001 Programming Manual
1356120025fSRuslan Ermilov.%O http://www.FreeBSD.org/~wpaul/Level1/LXT1001SRM.pdf
136c678bc4fSBill Paul.Re
137c678bc4fSBill Paul.Sh HISTORY
138c678bc4fSBill PaulThe
139c678bc4fSBill Paul.Nm
140c678bc4fSBill Pauldevice driver first appeared in
14186f47875SSheldon Hearn.Fx 4.4 .
142c678bc4fSBill Paul.Sh AUTHORS
143c678bc4fSBill PaulThe
144c678bc4fSBill Paul.Nm
145c678bc4fSBill Pauldriver was written by
146c678bc4fSBill Paul.An Bill Paul Aq william.paul@windriver.com .
147