始める前に — 60 秒の事前確認

• カードの PCI アドレスを知っておいてください — lspci -D を実行してメモしてください（例：0000:21:00.0）。特定のカードを対象にする場合に必要で、後で検証する方法でもあります。
• 起動時に 1 回だけブートローダエントリを編集する方法を知っておいてください — それが脱出手段です。ブートローダの編集画面でパラメータを削除すれば、手術なしで純正の状態で 1 回起動できます。
• 現在のカーネルコマンドラインを保存してください（cat /proc/cmdline）。オフラインでも参照できる場所に保存し、正確に復元できるようにしてください。
• 複数 GPU の場合は、all より明示的な PCI ターゲットを優先してください — 対象とするカードを指定し、残りには触れないでください。
• 最初の再起動ではコンソールまたは物理アクセスを用意してください — 下記のドキュメント記載の失敗モードは、リモートでいじるのではなく、電源を切ることで対処します。

必要なもの

• 対応カード（GA102 / GA103 / GA104 / GA106）— 互換性リストをご覧ください。
• Arch、Debian/Ubuntu、Fedora/RHEL 系列の Linux ディストリビューション — make install は /etc/os-release から自動検出します。その他のディストリビューションでは、下記の明示的なビルドターゲットを使ってください。
• NVIDIA 純正ドライバ（未改変）。このモジュールの要点は、ドライバに手を付けないことです。
• sudo アクセス。ビルドは固定された NVIDIA/CachyOS の入力を HTTPS 経由でダウンロードし、その SHA-256 ハッシュを検証します。ファームウェアはビルドディレクトリ内でローカルに生成されます。

ステップ 1 — クローンとインストール

注意：クローンは現在のデフォルトブランチを取得します。このガイドのレビュー対象 commit（af28cbb）より新しい場合があります。

git clone https://github.com/Zagitta/gpu-unlock
cd gpu-unlock
make install

make install はディストリビューションを検出し、適切なインストーラを選びます。明示的なバリエーションは次の通りです。

make install-arch   # makepkg -sif
make install-deb    # apt-get build-dep, dpkg-buildpackage, apt-get install
make install-rpm    # dnf builddep, rpmbuild, dnf install

make arch、make deb、make rpm は、インストールせずにパッケージをビルドします（Debian と RPM のパッケージは build/deb と build/rpm に配置されます）。インストールではモジュールとそのファームウェアが initramfs に入ります — mkinitcpio の場合、ドロップインにより gpu_unlock が MODULES の中で nvidia の直前に配置され、ディスプレイ出力用カードが空白になる時間ができるだけ短くなります。initramfs-tools と dracut にも同等のドロップインがあります。イメージはインストール時に再ビルドされます。

ステップ 2 — カーネルコマンドラインでオプトインする

どのカードをアンロックするか指示しない限り、モジュールは不活性です。既存のオプションを保持したまま、gpu_unlock.targets=all をカーネルコマンドラインに追加してください。

• GRUB（Debian/Ubuntu/Mint）：/etc/default/grub の GRUB_CMDLINE_LINUX_DEFAULT 内に追加し、sudo update-grub を実行してください。
• GRUB（Arch/CachyOS）：同じ編集を行い、sudo grub-mkconfig -o /boot/grub/grub.cfg を実行してください。
• Fedora/RHEL：sudo grubby --update-kernel=ALL --args="gpu_unlock.targets=all" を実行してください。
• systemd-boot：ブートエントリの options 行に追加してください（bootctl status で場所が表示されます）。
• UKI / 生成されたエントリ：/etc/kernel/cmdline に追加し、ブートイメージを再生成してください（例：mkinitcpio UKI の場合は sudo mkinitcpio -P）。

all の代わりに、lspci -D が表示する完全な PCI アドレスで特定のカードを指定できます。

gpu_unlock.targets=all                            # every unbound GA102/103/104/106 card
gpu_unlock.targets=0000:21:00.0                   # only this card
gpu_unlock.targets=0000:21:00.0,0000:22:00.0      # comma-separated list

アドレスは GPU の番号付けやディスプレイの役割とは独立しています。GA102/GA103/GA104/GA106 カードでないもの — all とアドレスの混在を含みます — はログに記録され、無視されます。アンロックには、カードの枚数にかかわらず合計で約 1 秒かかります。各カードは個別に処理され、すでにバインドされているか電源が落ちているカードはスキップされます。

ステップ 3 — 再起動と検証

再起動し、カーネルログを確認してください。

journalctl -k -b | grep gpu_unlock
lspci -nnk -s 0000:21:00.0   # your card's address

次に、普段の FP16/BF16 ワークロードや GEMM ベンチマークを実行して比較してください。知っておく価値のある動作がいくつかあります。

• ディスプレイ出力用カードも動作します。そのコンソールフレームバッファはアンロック中も動作し続け、リセットの直前に取り除かれます。画面はリセットから nvidia-drm が引き継ぐまで空白になります — ドライバが少し後に行うことと同じです。
• 起動後にモジュールを手動で読み込んでも何も起こりません。NVIDIA ドライバがすでにバインドしたカードに対しては無効です。タイミングこそがこの手法のすべてです。
• メモリへのサスペンドではセレクタがリセットされます（カードの電源が切れるため）。そのためモジュールは、レジューム（復帰）時に起動時のカードを再アンロックします。ドライバがそれらを復帰させる直前です — レジュームには約 1 秒長くかかると見込んでください。これは gpu_unlock.resume=0 で無効にできます。ハイバネーションは対象外です。
• 複数カード、ディスプレイ、VM の構成が動作すると報告されています — ユーザー報告は、1 台のマシンに最大 4 枚のカードと、vfio-pci で VM にパススルーされたカードをカバーしています。

ロールバック — すべてを元に戻す方法

尊重すべき失敗モードが 1 つあります。カード上で動作するファームウェアが決して止まらない場合、モジュールはそれをログに記録し、そのファームウェアがまだ使っている可能性のある DMA バッファを、次の電源オフまで意図的に保持します。再試行する前に電源を切ってください — いじり続けないでください。

ライセンスと来歴

カーネルモジュールとローカルパッケージングは GPL-2.0-only です。生成されたペイロードは、固定された CMP リファレンスに由来します。NVIDIA ファームウェアは独自の条件の下にあります — 帰属表示についてはプロジェクトの firmware/NOTICE.md と licenses/ ディレクトリをご覧ください。役に立った場合は、プロジェクトページに作者を支援する方法へのリンクがあります。