LGE(4)

💖 LGE(4) — the Level 1 LXT1001 NetCellerator PCI Gigabit Ethernet adapter driver 💖

okay so this is a page from the Kernel Interfaces Manual, and bestie, we're about to get deep into some vintage gigabit networking. buckle up 🎀

---

✨ NAME ✨

lge — the driver for the Level 1 LXT1001 NetCellerator PCI Gigabit Ethernet adapter. yes that's the whole name. it's giving 2001 energy and honestly? iconic. 👑

---

🦋 SYNOPSIS 🦋

so if you wanna bake this driver into the kernel (main character move), you drop these lines into your kernel configuration file:

device miibus
device lge

or, alternatively, if you'd rather load it as a module at boot time (lowkey easier, no cap), you put this line in loader.conf(5):

if_lge_load="YES"

that's it. that's the whole vibe check. ✨

---

🌸 DESCRIPTION 🌸

okay so the lge driver provides support for various NICs based on the Level 1 LXT1001 NetCellerator Gigabit Ethernet controller chip. that's the whole point of it. slay. 💅

the LXT1001 supports fiber PHYs and also a GMII port for use with 10/100/1000 copper PHYs — however, there are currently no NICs on the market that use this feature. so it's giving "we built the door but nobody's walking through it" 😭. still, the facts are the facts.

the LXT1001 supports:

• TCP/IP checksum offload for receive
• VLAN-based filtering
• a 64-bit multicast hash filter
• jumbo frames 🔥

jumbo frames can be configured via the interface MTU setting, fr fr. if you select an MTU larger than 1500 bytes with the ifconfig(8) utility, that configures the adapter to receive and transmit jumbo frames. and using jumbo frames can greatly improve performance for certain tasks — like file transfers and data streaming. it's giving glow-up. 🦋

💜 the media types, bestie

the lge driver supports the following media types:

• autoselect — enable autoselection of the media type and options. and yes, you can manually override the autoselected mode by adding media options to rc.conf(5). you're in charge, queen. 👑
• 1000baseSX — set 1000baseSX operation over fiber optic cable. both full-duplex and half-duplex modes are supported. fiber forever. ✨

🎀 the media options

the lge driver supports the following media options:

• full-duplex — force full duplex operation
• half-duplex — force half duplex operation

for more information on configuring this device, see ifconfig(8). iykyk. 💫

---

⭐ HARDWARE ⭐

adapters supported by the lge driver include:

• SMC TigerCard 1000 (SMC9462SX)
• D-Link DGE-500SX

only two icons on this list, and honestly? they ate. 🫶

---

💀 DIAGNOSTICS 💀

okay so when stuff goes wrong, here's what the driver screams at you, and what it means:

• lge%d: couldn't map memory — a fatal initialization error has occurred. like, fatal fatal. 😭
• lge%d: couldn't map ports — a fatal initialization error has occurred.
• lge%d: couldn't map interrupt — a fatal initialization error has occurred.
• lge%d: no memory for softc struct! — the driver failed to allocate memory for per-device instance information during initialization. rough.
• lge%d: failed to enable memory mapping! — the driver failed to initialize PCI shared memory mapping. this might happen if the card is not in a bus-master slot. check your slot, bestie. 🙈
• lge%d: no memory for jumbo buffers! — the driver failed to allocate memory for jumbo frames during initialization. no jumbo for you. 🍓
• lge%d: watchdog timeout — the device has stopped responding to the network, or there is a problem with the network connection (cable). unplug it, plug it back in, you know the drill. 🔌

ngl, several of these are fatal, and the manpage means it. don't sleep on them.

---

🌈 SEE ALSO 🌈

• arp(4)
• miibus(4)
• netintro(4)
• ng_ether(4)
• ifconfig(8)

and also, for the truly devoted:

Level 1 LXT1001 Programming Manual, https://www.FreeBSD.org/~wpaul/Level1/LXT1001SRM.pdf — yes, be the person who actually reads the PDF. main character energy. 📚✨

---

🧚 HISTORY 🧚

the lge device driver first appeared in FreeBSD 4.4. vintage. antique. still serving. 💜

---

💅 AUTHORS 💅

the lge driver was written by Bill Paul <william.paul@windriver.com>. thank you Bill, king. 🫡

---

okay that's the whole page, bestie, no cap 🫶 this one's from the Debian edition, dated July 16, 2005 — a true classic, and honestly it's giving retro-chic. now go configure your MTU and slay. 💖✨🎀