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