Skip to content

88plug/r8152-plus

Repository files navigation

r8152-plus — the 88plug/r8152-plus fork of wget/realtek-r8152-linux: the out-of-tree Realtek RTL8152/RTL8153/RTL8156/RTL8157 USB Ethernet driver, hardened with fixes and features mined from the upstream issue/PR graveyard and from the wider r8152 fork ecosystem, plus a self-installing DKMS package so the module rebuilds itself on every kernel upgrade.

What's different from upstream, with the full list → R8152_PLUS.md. Every change is scoped to a single theme and kept small enough to cherry-pick — if you maintain the upstream project or another r8152 fork, the commit history is a port candidate list, not a monolithic diff.

r8152 — Realtek USB Ethernet Linux Driver

Out-of-tree Linux kernel module for Realtek RTL8152/RTL8153/RTL8156/RTL8157-based USB Ethernet adapters (10/100/1000M, 2.5G, and 5G), covering the community-maintained kernel compatibility shim for kernels from 2.6.12 through current mainline.

Install

The fastest path is DKMS — the module rebuilds itself automatically on every kernel upgrade:

sudo apt install dkms          # or your distro's dkms package
git clone https://github.com/88plug/r8152-plus.git /usr/src/r8152-2.21.4
sudo dkms add -m r8152 -v 2.21.4
sudo dkms build -m r8152 -v 2.21.4
sudo dkms install -m r8152 -v 2.21.4
sudo modprobe -r r8152 2>/dev/null; sudo modprobe r8152

To build and install without DKMS instead:

git clone https://github.com/88plug/r8152-plus.git
cd r8152-plus
make modules
sudo make install
sudo make install_rules   # udev rules for device auto-configuration

Kernel build tools and headers matching your running kernel are required (e.g. linux-headers-$(uname -r) on Debian/Ubuntu).

Configuration and usage

See ReadMe.txt for the full set of build-time options (S5 Wake-on-LAN, CONFIG_CTAP_SHORT, SKIP_SKB_MARK_NOT_ON_LIST_COMPAT) and runtime ethtool examples (speed negotiation up to 10G, ring parameters, flow control, tunables).

License

GPL-2.0, see LICENSE. Copyright retained per the original Realtek source.

About

r8152-plus: a community plus fork of the Realtek r8152 USB Ethernet driver -- 21 maintainer-grade fixes & features mined from the upstream issue/PR graveyard and the wider r8152 fork ecosystem, plus self-installing DKMS. Built on upstream v2.21.4.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages