0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

RTL8127用DKMSドライバを手直しして安定的にビルド出来るようにした話

0
Posted at

前書き

RTL8127がカーネルドライバに組み込まれたのは6.16系から

安価で低発熱なRealtek製RTL8127ですが、Linuxだと6.16より前のカーネルではDKMSドライバをインストールする必要があります。
6.16からr8169にRTL8127系チップのサポートが始まり、カーネル7.0以降でSFP+版チップ(細かくチップ型番を言うとRTL8127ATFのこと)にも対応しているようです。

Debian13では

カーネル6.12系であるDebian13では、DKMSドライバを当てる必要があります。
しかしRealtekのドライバには悪名高いクソ仕様があります。
今回はその悪名高いクソ仕様と格闘して解決した話です。

そも論

Realtek公式サイトからドライバを落とすのが微妙にクソゲー

あまり他人の悪口書きたかないんですが、これだけは言わせてほしい。
Realtekのドライバを公式サイトからダウンロードするのに、一々reCAPTCHA入れて一時ダウンロードリンク生成してそこからダウンロードさせるのやめろよ、と。
当たり前ですが、 CLIしかないインスタンスでこれを突破するのは無理 なので、GUIを備えたクライアントを用意してそこからDLしてscpなりrsyncなりで飛ばすことになります (クソポイント1)

Realtek公式サイトからDLしたDKMSドライバを手直しするのが微妙にクソゲー

さて、DLできたドライバですが、そのまますぐインストール出来る訳ではありません。
何故って(少なくとも2026年05月04日にDLしたDKMSドライバ11.016.00では)、

  • 解凍したドライバにdkms.confがそもそも無い(クソポイント2)
  • 解凍した中身のパーミッションが狂っている(クソポイント3)
  • 解凍した中身のMakefileの記述が『今動いているカーネルバージョンにしか対応していない』ので、手直ししないと OSカーネル更新時にビルドは通るけど再起動後にエラーを吐いてロードされない(クソポイント4)

KOTY(Kuso-code Of The Year)かよ。
という訳で手直しして、これをちゃんとOSカーネル更新の度にきちんとビルドされるようにしていきます。

手直し

./dkms.confの作成

まず最初に、前述したように dkms.confが不在 ですので、これを作っていきます。

/usr/src/r8127-11.016.00/dkms.conf
PACKAGE_NAME="r8127"
PACKAGE_VERSION="11.016.00"
# CLEAN="make -C /lib/modules/$kernelver/build M=/usr/src/r8127-11.016.00/src clean"
CLEAN="make -C /lib/modules/$kernelver/build M=$dkms_tree/$PACKAGE_NAME/$PACKAGE_VERSION/build/src clean"
# MAKE[0]="make -j1 -C /lib/modules/$kernelver/build M=/usr/src/r8127-11.016.00/src modules"
MAKE[0]="make -j1 -C /lib/modules/$kernelver/build M=$dkms_tree/$PACKAGE_NAME/$PACKAGE_VERSION/build/src KVER=$kernelver modules"
BUILT_MODULE_NAME[0]="r8127"
BUILT_MODULE_LOCATION[0]="src/"
DEST_MODULE_LOCATION[0]="/kernel/driver/net/ethernet/realtek"
AUTOINSTALL="yes"
BUILD_EXCLUSIVE_KERNEL_MAX="6.15"

大体こんな感じ。

./Makefile

この行を……

/usr/src/r8127-11.016.00/Makefile
KFLAG := 2$(shell uname -r | sed -ne 's/^2\.[4]\..*/4/p')x

こうじゃ!

/usr/src/r8127-11.016.00/Makefile
KVER    ?= $(shell uname -r)
KFLAG   := 2$(shell echo $(KVER) | sed -ne 's/^2\.[4]\..*/4/p')x

./src/Makefile

132行目のelseより下の行に、以下の通り挿入します。

/usr/src/r8127-11.016.00/src/Makefile

	# 追加
	KVER	?= $(shell uname -r)
	KFLAG	:= 2$(shell echo $(KVER) | sed -ne 's/^2\.[4]..*/4/p')x
	# 追加ここまで

	# 従前
	# BASEDIR := /lib/modules/$(shell uname -r)
	# KERNELDIR ?= $(BASEDIR)/build
	# 従前ここまで

	# 修正案
	BASEDIR		:= /lib/modules/$(KVER)
	KERNELDIR	?= $(BASEDIR)/build
	# 修正案ここまで

./src/Makefile_linux24x

正直RTL8127をLinux2.4のカーネルで動かそうという狂気を持った人は居ないはずなので割愛します(居ないよね?)

パーミッションの変更

そのままだとパーミッションが狂っている(少なくとも手元環境では盛大に狂った)ので、これを直します。

root@TestSV:~# ls -l /usr/src/
drwxr-xr-x 3 root root  7 11月  6 11:02 r8127-11.016.00

root@TestSV:~# ls -l /usr/src/r8127-11.016.00/
-rw-r--r-- 1 root root 1890 11月  6 10:54 Makefile
-rw-r--r-- 1 root root 4249  1月 28  2026 README
-rwxr-xr-x 1 root root 2469  1月 28  2026 autorun.sh
-rw-r--r-- 1 root root  398 11月  6 10:26 dkms.conf
drwxr-xr-x 2 root root   46 11月 10 05:15 src

root@TestSV:~# ls -l /usr/src/r8127-11.016.00/src/
-rw-r--r-- 1 root root    6148 11月  6 11:01 Makefile
-rw-r--r-- 1 root root    2430 11月  6 11:05 Makefile_linux24x
-rw-r--r-- 1 root root       0 11月 10 05:15 Module.symvers
-rw-r--r-- 1 root root      37 11月 10 05:15 modules.order
-rw-r--r-- 1 root root   98184  1月 28  2026 r8127.h
-rw-r--r-- 1 root root 4938576 11月 10 05:15 r8127.ko
-rw-r--r-- 1 root root     205  5月 19 16:52 r8127.mod
-rw-r--r-- 1 root root    6875 11月  6 09:58 r8127.mod.c
-rw-r--r-- 1 root root  157904 11月 10 05:15 r8127.mod.o
-rw-r--r-- 1 root root 4739416 11月 10 05:15 r8127.o
-rw-r--r-- 1 root root   15750  1月 28  2026 r8127_dash.c
-rw-r--r-- 1 root root    6451  1月 28  2026 r8127_dash.h
-rw-r--r-- 1 root root  515728 11月 10 05:15 r8127_dash.o
-rw-r--r-- 1 root root   14593  1月 28  2026 r8127_fiber.c
-rw-r--r-- 1 root root    2335  1月 28  2026 r8127_fiber.h
-rw-r--r-- 1 root root  433640 11月 10 05:15 r8127_fiber.o
-rw-r--r-- 1 root root    8750  1月 28  2026 r8127_firmware.c
-rw-r--r-- 1 root root    2470  1月 28  2026 r8127_firmware.h
-rw-r--r-- 1 root root  770924  1月 28  2026 r8127_n.c
-rw-r--r-- 1 root root 2800688 11月 10 05:15 r8127_n.o
-rw-r--r-- 1 root root   30963  1月 28  2026 r8127_ptp.c
-rw-r--r-- 1 root root    6257  1月 28  2026 r8127_ptp.h
-rw-r--r-- 1 root root    3644  1月 28  2026 r8127_realwow.h
-rw-r--r-- 1 root root   18848  1月 28  2026 r8127_rss.c
-rw-r--r-- 1 root root    3154  1月 28  2026 r8127_rss.h
-rw-r--r-- 1 root root    7956  1月 28  2026 rtl_eeprom.c
-rw-r--r-- 1 root root    2410  1月 28  2026 rtl_eeprom.h
-rw-r--r-- 1 root root  442104 11月 10 05:15 rtl_eeprom.o
-rw-r--r-- 1 root root   11377  1月 28  2026 rtltool.c
-rw-r--r-- 1 root root    2734  1月 28  2026 rtltool.h
-rw-r--r-- 1 root root  438312 11月 10 05:15 rtltool.o

ざっとこんな感じです。

インストール

あとは普通のdkmsドライバとしてインストールするだけです(少なくともこれで私の環境では全台通っている)。

後書き

RTL8127をどう使っているか

  • PCIe Gen4 x1またはPCIe Gen3 x4(リンク自体はx2っぽい)なのをPCIe Gen3 x1で主に使ってます
  • X520の方がドライバ安定なんですが、如何せん発熱で死ぬ
    RTL8127は低発熱
  • ストレージ側でキャッシュ使い切ったら180〜400MB/sとかなので特に不便はしてない

RTL8127のここがダメ

  • DKMS版Linuxドライバの出来が……
  • Geminiくんと壁打ちして漸く、カーネルバージョンアップの度に手動ビルドしないと通らない謎現象を終わらせることができた
  • Debian14ではLinux7.2ベースになるという話があるらしいので、そうなるとインボックスドライバで動くことになるからDKMSドライバは御役御免の気がする。どうなるんだろう?????
    まあその頃には25GbEに転向してる気もするけど
0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?