安裝指南

本指南將協助您完成 Gthulhu 和 Qumun 的安裝與設定。

系統需求

硬體需求

• CPU: x86_64 架構處理器
• 記憶體: 至少 4GB RAM
• 儲存空間: 至少 10GB 可用空間

軟體需求

核心版本需求

Linux 核心 6.12+ 且支援 sched_ext 是必要條件。請確認您的核心版本符合需求。

必要套件

套件	版本需求	用途
Go	1.22+	使用者空間調度器開發
LLVM/Clang	17+	BPF 程式編譯
libbpf	最新版本	BPF 程式庫
make	-	建置工具
git	-	版本控制

針對不同發行版的安裝方式

請根據您的 Linux 發行版選擇以下詳細安裝說明。

Ubuntu 25.04

為了節省各位的時間，我們直接跳過編譯 kernel 與安裝 kernel 的過程，使用直接支援 sched_ext 的 Ubuntu 25.04。

驗證核心支援

# 檢查核心版本
uname -r

# 檢查 sched_ext 支援
grep -r "CONFIG_SCHED_CLASS_EXT" /boot/config-$(uname -r) || \
cat /proc/config.gz | gunzip | grep "CONFIG_SCHED_CLASS_EXT"

# 檢查 BPF 支援
grep -r "CONFIG_BPF" /boot/config-$(uname -r) | head -5

安裝相依套件

sudo apt-get update
sudo apt-get install --yes bsdutils
sudo apt-get install --yes build-essential
sudo apt-get install --yes pkgconf
sudo apt-get install --yes llvm-17 clang-17 clang-format-17
sudo apt-get install --yes libbpf-dev libelf-dev libzstd-dev zlib1g-dev
sudo apt-get install --yes virtme-ng
sudo apt-get install --yes gcc-multilib
sudo apt-get install --yes systemtap-sdt-dev
sudo apt-get install --yes python3 python3-pip ninja-build
sudo apt-get install --yes libseccomp-dev protobuf-compiler
sudo apt-get install --yes meson cmake

設定 Clang

for tool in "clang" "clang-format" "llc" "llvm-strip"
do
  sudo rm -f /usr/bin/$tool
  sudo ln -s /usr/bin/$tool-17 /usr/bin/$tool
done

openSUSE Tumbleweed

openSUSE Tumbleweed 提供滾動更新，並支援 kernel 6.12+ 及 sched_ext。

驗證核心支援

# 檢查核心版本
uname -r

# 檢查 sched_ext 支援
grep -r "CONFIG_SCHED_CLASS_EXT" /boot/config-$(uname -r) || \
cat /proc/config.gz | gunzip | grep "CONFIG_SCHED_CLASS_EXT"

# 檢查 BPF 支援
grep -r "CONFIG_BPF" /boot/config-$(uname -r) | head -5

安裝相依套件

# 更新套件庫
sudo zypper refresh

# 安裝建置工具與編譯器
sudo zypper install -y gcc make cmake meson ninja pkg-config

# 安裝 LLVM/Clang 18+（最低需求：17）
sudo zypper install -y llvm18 clang18 clang18-devel

# 安裝開發函式庫
sudo zypper install -y libbpf-devel libelf-devel libzstd-devel zlib-devel

# 安裝額外的建置相依套件
sudo zypper install -y systemtap-sdt-devel libseccomp-devel jq protobuf-devel

# 安裝靜態函式庫以進行靜態連結
sudo zypper install -y zlib-devel-static libzstd-devel-static

設定 Clang

for tool in "clang" "clang-format" "llc" "llvm-strip"
do
  sudo rm -f /usr/bin/$tool
  sudo ln -s /usr/bin/$tool-18 /usr/bin/$tool
done

CachyOS (kernel 6.17.5-1-cachyos)

驗證核心支援

# 檢查核心版本（應為 6.12+）
uname -r

# 檢查 sched_ext 支援
zcat /proc/config.gz | grep "CONFIG_SCHED_CLASS_EXT"

# 檢查 BPF 支援
zcat /proc/config.gz | grep "CONFIG_BPF" | head -5

預期輸出應顯示：

CONFIG_SCHED_CLASS_EXT=y
CONFIG_BPF=y
CONFIG_BPF_SYSCALL=y
CONFIG_BPF_JIT=y
CONFIG_BPF_JIT_ALWAYS_ON=y
CONFIG_BPF_JIT_DEFAULT_ON=y

安裝相依套件

# 更新系統
sudo pacman -Syu

# 安裝基礎開發工具
sudo pacman -S --needed base-devel

# 安裝 LLVM/Clang 工具鏈（最低需求：17）
sudo pacman -S --needed llvm clang

# 安裝 BPF 與開發函式庫
sudo pacman -S --needed libbpf libelf zstd

# 安裝建置工具
sudo pacman -S --needed pkgconf meson cmake ninja

# 安裝額外相依套件
sudo pacman -S --needed systemtap python python-pip jq libseccomp protobuf

安裝靜態函式庫

CachyOS 套件預設僅包含動態函式庫。Gthulhu 的靜態連結需要靜態函式庫：

zstd 靜態函式庫：

cd /tmp
wget https://github.com/facebook/zstd/releases/download/v1.5.7/zstd-1.5.7.tar.gz
tar xf zstd-1.5.7.tar.gz
cd zstd-1.5.7
make lib-release
sudo cp lib/libzstd.a /usr/lib/

zlib 靜態函式庫：

cd /tmp
wget https://zlib.net/zlib-1.3.1.tar.gz
tar xf zlib-1.3.1.tar.gz
cd zlib-1.3.1
./configure --static
make
sudo cp libz.a /usr/lib/

安裝 Go

在編譯 Gthulhu 之前，請先安裝 Golang（需求版本：1.22+）：

wget https://go.dev/dl/go1.24.2.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.24.2.linux-amd64.tar.gz

​ 新增以下內容至 ~/.profile：

export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export PATH=$GOROOT/bin:$GOPATH/bin:$PATH

​ 新增後，記得使用 source ~/.profile 讓變更的內容生效。

安裝 Rust

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env

編譯 Gthulhu

安裝完必要套件後，複製並編譯 Gthulhu：

git clone https://github.com/Gthulhu/Gthulhu.git
cd Gthulhu
make dep
git submodule init
git submodule sync
git submodule update
cd scx
cargo build --release -p scx_rustland
cd ..
cd libbpfgo
make
cd ..
make

​ 編譯完成後，Gthulhu 理應能順利執行在你的系統上： ​ ​ 我們可以觀察 Gthulhu 的輸出得知目前已有多少任務是透過 Gthulhu 進行調度的。

常見問題排解

​

問題一：ERROR: Program 'clang' not found or not executable

​ 如果你在執行 meson setup build --prefix ~ 命令時遇到該問題，可以嘗試以下命令：

sudo update-alternatives --install /usr/bin/clang clang /usr/bin/clang-17 100
sudo update-alternatives --install /usr/bin/llvm-strip llvm-strip /usr/bin/llvm-strip-17 100

下一步

安裝完成後，您可以：

• 📖 閱讀 工作原理 了解調度器運作機制
• 🎯 查看 專案目標 了解設計理念
• 🔧 參考 API 文檔 進行客製化開發

---

安裝完成

恭喜！您已成功安裝 Gthulhu 調度器。如果遇到任何問題，請查看 常見問題 或在 GitHub 提交 Issue。