Uyanide/dotfiles
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
bb56ae15982418ad30f6bc01a47f22bb0cf984d9
dotfiles/memo/lfs.md

16 KiB
Raw Blame History

记录一些在安装 LFS 时踩的一些坑和其他值得一提的事情.

Important

本文中的 LFS 仅指代 12.4 SysV 和 13.0 Systemd 版本.

LFS

以下内容按照对应章节划分:

2.6. Setting the $LFS Variable and the Umask

$LFS 变量很重要! 建议写到 Host 的 /root/.bash_profile 或 /etc/profile.d/... 或类似作用的配置文件里防止忘记设置.

3. Packages and Patches

强烈建议通过镜像站下载打包好的所有源代码和 patch, 否则某些源服务器的下载速度即便在非受限的网络环境也很感人.

4.5. About SBUs

SBU 只提供大概的预期耗时范围, 误差是很大的, 尤其对于 BLFS 书中的一些编译时间很长的包 (如 Qt, WebKitGtk, Firefox) 来说.

5. Compiling a Cross-Toolchain

targo

从这一章开始将会手动编译大量的包, 其中有不少操作是重复的, 例如 tar -xf, cd, rm -rf 等, 为此可以写一个小脚本节省时间:

#!/bin/bash

set -euo pipefail

[ -z "${1:-}" ] && {
    echo "Usage: $0 <tarball>"
    exit 1
}

tarball=$(realpath "$1")

dir=$(tar -tf "$tarball" | sed -e 's/^\.\///' | cut -d/ -f1 | sort -u)

if [ "$(echo "$dir" | wc -l)" -ne 1 ]; then
    echo "Error: Tarball must contain a single top-level directory."
    exit 1
fi

cleanup() {
    echo "Cleaning up..."
    cd ..
    if [[ -z "$dir" || "$dir" == "/" || "$dir" == "." ]]; then
        echo "Error: Unsafe directory for cleanup: $dir"
        exit 1
    fi
    rm -rf "$dir"
}

trap cleanup EXIT INT TERM
tar -xvf "$tarball"

if [ ! -d "$dir" ]; then
    echo "Error: Failed to extract directory: $dir"
    exit 1
fi

cd "$dir"

echo "Spawning shell. Type 'exit' to finish and cleanup."

bash

它的作用是解压一个只含有一个顶层目录的 tarball, cd 进入解压后得到的目录, 生成一个 shell, 并在这个 shell 退出时清理先前解压得到的文件.

tmpfs

先在目标位置挂载 tmpfs 再解压文件. 编译期间会进行高频的硬盘 IO, 将此过程放到内存上可以减少硬盘损耗也可以稍稍加速. 不过有几点需要注意:

  • 部分包(不在少数)的部分测试会依赖文件系统特性. 如 Python-3.14.3 的 test_file 测试, 如果构建目录为 tmpfs, 则会因为缓冲区大小与预期不符而出现 AssertionError 断言错误, 而缓冲区大小由底层文件系统的块大小决定, 因此 tmpfs 的环境差异会导致测试失败.

  • OOM. 多核编译本就需要耗费大量内存, 例如 Gentoo 手册中建议为每个 job 预留至少 2 GiB 内存, 而复杂的包的构建目录体积也会随着构建过程膨胀, 二者共同作用更显内存紧张. 倘若真的触及上限, 如果有 swap 则会使用到硬盘, 这和使用 tmpfs 最初的目的相背; 如果触发 OOM Killer 更是会直接导致编译失败. 因此编译大包时还是建议老老实实用硬盘.

  • tmpfs 的环境差异也会导致少数包在 configure 阶段就出现问题. 这属于少数特例, 不过多说明主要是忘了具体是哪个包了:/

通用建议 (同样适用于其他书如 BLFS)

  1. 通常来说, 应该 (或者说请务必) 在编译和安装一个包后完全删除它的目录, 仅有少数例外:

    • linux (保留构建树可以缩短重新构建耗时, 或至少保留 .config 便于复原配置)
    • blfs-bootscripts (对于 blfs-sysv)
    • blfs-systemd-units (对于 blfs-systemd)

    注意一些需要多次编译的包, 例如 gcc, 也应该在每次编译与安装后完全删除目录.

  2. 通常来说, 建议将所有相关的 tarball 和 patch 下载在同一个目录中, 并且将 tarball 也解压在这个目录中. 如果目录层级与该默认情况不一致的话必须修改 LFS 书中提供的命令中对应的相对路径.

  3. 如果和我一样使用 UEFI 引导, 那么大概率将会在安装 GRUB 时第一次接触 BLFS. 和 LFS 不同, BLFS 中大多数包都是可选的, 具体安装什么由依赖关系决定. 一个包可能会依赖其他包, 这些依赖分为三个层级:

    • Required 是必要的依赖;
    • Recommended 通常建议当成 Required 看待, 因为书中大多数情况会假设读者会装这些包, 如果决定不装必须明确其功能与影响, 也可能需要相应地调整书中给出的命令, 不能无脑 CV;
    • Optional: 酌情安装, 很多时候是文档或测试相关的依赖.

  4. 如果想要的包在 LFS 和 BLFS 包中都没有, 例如 fish、libglvnd、flatpak 等, 不妨先检查 GLFS 和 SLFS 或同系列的其他书中是否有涉及, 如果有的话将节约很多学习和试错成本.

    另外也可以看其他发行版是怎么打包这些软件的, 例如 Archlinux 官方构建仓库中的 PKGBUILD 能为构建流程提供很多参考.

7.4. Entering the Chroot Environment

完全按照 LFS 书中的 chroot 步骤编写一个小脚本:

#!/bin/bash

[ -z "$LFS" ] && exit 1

set -euo pipefail

# mount virtual file systems

mkdir -pv "$LFS"/{dev,proc,sys,run}

mountpoint -q "$LFS"/dev || mount -v --bind /dev "$LFS"/dev

mountpoint -q "$LFS"/dev/pts || mount -vt devpts devpts -o gid=5,mode=0620 $LFS/dev/pts
mountpoint -q "$LFS"/proc || mount -vt proc proc "$LFS"/proc
mountpoint -q "$LFS"/sys || mount -vt sysfs sysfs "$LFS"/sys
mountpoint -q "$LFS"/run || mount -vt tmpfs tmpfs "$LFS"/run

if [ -h "$LFS"/dev/shm ]; then
    install -v -d -m 1777 "${LFS}$(realpath /dev/shm)"
else
    mount -vt tmpfs -o nosuid,nodev tmpfs "$LFS"/dev/shm
fi

# cleanup (defer)

cleanup() {
    echo "Cleaning up..."
    mountpoint -q "$LFS"/dev/shm && umount "$LFS"/dev/shm || true
    umount "$LFS"/dev/pts || true
    umount "$LFS"/{sys,proc,run,dev} || true
}
trap cleanup EXIT INT TERM

# chroot

chroot "$LFS" /usr/bin/env -i \
    HOME=/root \
    TERM="$TERM" \
    PS1='(lfs chroot) \u:\w\$ ' \
    PATH=/usr/local/bin:/usr/bin:/usr/sbin \
    MAKEFLAGS="-j$(nproc)" \
    TESTSUITEFLAGS="-j$(nproc)" \
    /bin/bash --login

它的作用是自动挂载一系列虚拟文件系统, 并在退出 chroot 时自动清理.

自动挂载, 自动chroot, 自动清理, 如果手动安装过 archlinux 或 Gentoo 的话可能会很快联想到 arch-install-scripts 提供的 arch-chroot 脚本. 但此处并不推荐用此方法偷懒, 原因有三:

  • arch-chroot 挂载 /dev 的方式为 mount -t devtmpfs 而非 mount --bind, 这会导致 /dev/fd 等核心软链接消失从而诱发很多问题, 例如交叉编译的工具链完全不可用.

  • 默认 offline mode 不会像 LFS 书里那样用 env -i 构造最小环境, 这会对环境隔离造成影响. 同时 arch-chroot 也没有设置 MAKEFLAGS, TESTSUITEFLAGS 等环境变量, chroot后需要在别处设置.

  • arch-chroot 会将 Host 的 /run 通过绑定的方式挂载, 这也会对环境隔离造成影响.

另外再多说一嘴, 将 $LFS/dev/pts 挂载为全新的 devpts 会导致 TTY 上下文丢失, 进而导致非 root 用户执行 su 时遇到 su: must be run from a terminal 错误. 有两个解决方向:

  • 使用 mount --bind 挂载 $LFS/dev/pts 从而保留 TTY 上下文.

  • 在 chroot 后使用 script 命令或 tmux 等终端复用器重新创建 TTY 上下文.

8.66. GRUB

对于 UEFI 引导的系统, 此时需要跳转 BLFS 安装 GRUB.为避免过早地陷入依赖地狱, 建议仅按照顺序安装以下包:

  1. efivar
  2. Popt
  3. efibootmgr
  4. GRUB for EFI

这对于引导系统来说已经足够用了. 如果需要的话可以之后再补上文档等其他附加依赖重新构建安装.

10.2. Creating the /etc/fstab File

可以使用 arch-install-scripts 提供的 genfstab 生成 /etc/fstab 作为起点, 但仍需手动检查.

Important

SysV 版本的 LFS 需要在 /etc/fstab 中指定一系列虚拟文件系统, 如果不这样做的话这些目录将不会自动挂载, 导致无法启动.

10.3. Linux

Building the linux kernel for the first time is one of the most challenging tasks in LFS.

确实如此. 对此我可以总结出几点建议:

  • initramfs

    LFS 本书并未涉及这部分内容, 而现代成熟发行版几乎无一例外都使用 initramfs 进行引导. 有无 initramfs 对内核配置的影响是巨大的, 例如:

    • 挂载 RootFS 所需驱动如 CONFIG_EXT4_FS, CONFIG_BTRFS_FS 必须内置, 否则即使 Bootloader 认识 RootFS, 内核也不认识;

    • 在 RootFS 可用之前就请求固件的内核模块在没有 initramfs 时需要编译为模块或将固件也嵌入内核中.

    如果不急于验收的话可以暂时搁置 LFS 本书的后续章节, 先推进 BLFS 直到 About Initramfs 了解相关内容后再回来构建内核. 不过我其实更推荐使用 Dracut 构建 initramfs, 比起 BLFS 书中的脚本要省心不少.

  • 内核版本

    内核版本其实并没有那么重要. 更新内核版本几乎不会对系统造成什么兼容性问题 (除了树外模块如 NVIDIA 专有驱动, 之后会细说). 使用和 Host 相同版本的驱动可以很方便地复用配置, 当前 Host 加载的模块信息也能为内核配置提供参考.

  • 复刻并裁剪现有配置

    如果将要使用正在构建的 LFS 系统的机器和 Host 完全相同, 并且内核版本相同或相近, 可以将 Host 现在运行的内核的配置文件搬过来, 同时根据当前 Host 加载的内核模块进行裁剪, 这将极大地减小配置难度以及缩短构建耗时.

    在 Host 上运行:

    # 进入内核源码目录
cd /path/to/lfs/sources/linux-x.x.x

# 导出当前内核配置 (如果 Host 有 /proc/config.gz)
zcat /proc/config.gz > .config

    在 chroot 环境中运行:

    # 进入内核源码目录
cd /path/to/lfs/sources/linux-x.x.x

# 裁剪配置
make localmodconfig

    如果内核版本不一致, make localmodconfig 时会出现一些交互选项, 建议全部保持默认, 或使用 make olddefconfig 来自动处理.

    在此之后, 仍建议 (或者说请务必) 按照 LFS 书中的指示检查和调整配置选项.

  • NVIDIA

    NVIDIA 专有驱动的安装指引在 GLFS 中有详细说明. 但其依赖众多, 其中包括很多 BLFS 和 GLFS 中的软件包. 因此不必心急, 可以先按需安装 BLFS 中的其他包, 等到需要 Mesa 作为依赖时再去 GLFS 中安装 NVIDIA 驱动, 这将会轻松不少.

    关于其对内核配置的影响, 总结出来有以下两点:

    • 禁用 nouveau. 除非显卡型号过于老旧, 否则不推荐使用内核中的 nouveau 驱动, 对应配置选项如 CONFIG_DRM_NOUVEAU CONFIG_FB_NVIDIA 等可留空. GLFS NVIDIA-590.48.01 页面页脚有提到

      NVIDIA's kernel modules will fail to compile with TTY support unless a graphics driver is included in the kernel. Nouveau is used here, though alternate graphics drivers may also work.

      但我并未遇到此问题, 留待后续验证.

    • 树外模块高度依赖内核版本, 例如 NVIDIA-590.48.01 在 Linux-6.19.6 环境下无法编译, 这主要是由于 Linux 内核不稳定的内部 API. 解决方法很粗暴, 等 NVIDIA 更新适配新内核, 或者自己打补丁. 补丁可以在其他发行版的软件包构建仓库中找到, 例如 Archlinux 的 nvidia-utils 仓库.

10.4. Using GRUB to Set Up the Boot Process

有两处需要指定分区:

  • 通过 root= 参数传递给内核的 RootFS 分区位置. 强烈建议使用 PARTUUID 而非 /dev/sdXN 这类不稳定的设备路径. 如果已经配置 initramfs, 则也可以使用文件系统 UUID 指定根分区.

  • 使用 search 指定的 /boot 所在分区位置. 强烈建议使用文件系统 UUID 即 --fs-uuid 而非 (hdM, N) 这类易受磁盘枚举顺序影响的设备记法.

Note

UUID 和 PARTUUID 可以通过 lsblk -o NAME,FSTYPE,UUID,PARTUUID 查看.

BLFS

绝大多数的建议都已在 LFS 部分提及, 这里只做少数补充:

阅读顺序

BLFS 并不像 LFS 那样有线性的章节顺序, 但仍建议先顺序阅读直到 After LFS Configuration Issues 章节结束再按自己的需要安装各种包.

About Firmware

一个偷懒的方法是把 Host 的 /lib/firmware 目录复制到 LFS 的对应目录下:

cp -av /lib/firmware $LFS/lib/

其中 -a 选项会保留符号链接和文件权限等信息.

Mesa

如果计划安装 NVIDIA 专有驱动, 则建议先去 GLFS 安装完成后再去 GLFS 中的 Mesa 页面 继续安装, 或者至少应先安装 libglvnd 再安装 Mesa. 这么做的原因在 GLFS 相关页面 有详细说明.

此处记录我使用 Intel iGPU (i915) 和 NVIDIA dGPU (NVIDIA 专有驱动) 的混合显卡系统时的 Mesa 构建参数:

meson setup build                   \
  --prefix=$XORG_PREFIX             \
  --buildtype=release               \
  -D platforms=x11,wayland          \
  -D gallium-drivers=iris,llvmpipe  \
  -D vulkan-drivers=intel,swrast    \
  -D valgrind=disabled              \
  -D video-codecs=all               \
  -D libunwind=disabled             \
  -D glvnd=enabled

其中:

  • -D gallium-drivers=iris,llvmpipe:
    • iris 用于较新的 (Gen 8 及更新) Intel 显卡. 与之对应的有 crocus (适用于 Gen 4 到 Gen 7.5) 和 i915 (更老). 注意此处的 i915 用户态驱动和内核中的 i915 模块是不同的东西；
    • 启用 llvmpipe 用于 OpenGL 上下文中的软件渲染以防万一.
  • -D vulkan-drivers=intel,swrast:
    • 启用 Intel iGPU 的 Vulkan 支持；
    • 启用 Vulkan 上下文中的软件渲染驱动“软件光栅化器” swrast 以防万一. 注意这里的 swrast 实际指 lavapipe, 和被废弃的 gallium swrast 驱动是不同的东西.
  • -D glvnd=enabled: 启用 GLVND 支持.

Better targo

上文中有提供一个用于简化构建流程的脚本, 本仓库中还有一个功能更丰富的版本 xgo, 使用 Python 编写, 适合在 BLFS 中使用.

LFS btw

🤓
SysV btw
一周目 (LFS-12.4-SysV)
Systemd btw
二周目 (LFS-13.0-Systemd)
Reference in New Issue View Git Blame Copy Permalink