代码结构

仓库布局与内核源码地图 · 口径(main 2e5667a6b,2026-11-16 复点,git ls-files + wc -l):kernel/ 626 文件 · 398,905 行(Rust 392,245);kernel/src 456 文件 · 369,486 行

§1内核源码地图(kernel/src/)

目录行数占比内容
fs/69,82119.2%ext4(12 文件)、jbd2、VFS、dcache、page_cache、bio/buffer、procfs/sysfs/debugfs/tracefs/tmpfs、pipe、xattr、inotify、locks、io_uring、elf
arch/48,81213.4%riscv64 / x86_64 / aarch64:boot、trap、mm(page_fault)、cpu、uaccess、intc、SBI/MSR/寄存器
syscall/41,08311.3%系统调用分发表与实现(胶囊边界:校验/翻译用户指针,uaccess_safe 类型化 copy_in/out)
drivers/25,4367.0%virtio(blk/net/gpu/input,queue + PCI 传输层)、blkdev、intc、pci、gpu/drm、input、timer
ipc/21,7586.0%binder(14,144 行,最大单文件)、access_token、SysV sem/msg/shm、POSIX MQ
net/20,8575.7%SkBuff、eth、arp、ipv4/ipv6、icmp、udp、tcp(5,250 行)、unix(4,372 行)、netlink、raw
sync/19,8435.5%自旋锁/休眠锁/futex(含 PI)、CpuLocal(D-7)、类型化锁键(D-11)
mm/19,4325.3%memblock、buddy、slab、small_alloc、page fault、VMA、页缓存协作、kswapd、rmap
dfx/19,3955.3%syscost、kallsyms、debugfs、taskdump、watchdog、memwatch、ledger(诊断层,单独统计 unsafe)
process/17,7094.9%任务结构、fork/exit、信号、wait、pid、cgroup
sched/17,2914.7%GRQ、fair/rt/deadline 调度类、wakewatch、调度事件普查/heal
tests/15,2414.2%76 个 guest 内测试文件(make test 宿主)
其他(interrupt/timer/io_uring/perf/security/module + 顶层 .rs)23,4636.4%中断子系统、定时器轮、io_uring 雏形、perf 计数、LSM/capability、模块桩、init/panic/console 等 13 个顶层文件
trace/3,7951.0%统一 trace-event 框架:事件侧 + tracefs 文件侧(69 事件/17 组)
verify/(kernel/verify,不在 kernel/src 合计内)28,216——形式验证 crate:157 Kani harness、1104 proptests、4 SPIN 模型、Miri/loom 镜像

§2分层与 unsafe 治理

docs/architecture/kernel-layers.md 定义最长前缀匹配的分层:未匹配的文件默认落最安全桶。

  • Framework 层(arch/mm 原语/interrupt/virtio 核心/trace/perf):允许 unsafe,逐块要求 // SAFETY: 注释(覆盖 3,207/5,009 = 64%)。
  • service 层:目标 100% forbid(unsafe_code) —— 已 47 个文件编译期禁止,另 56 个已无 unsafe;首个具名收缩目标 syscall/io.rs 69 个 unsafe token 已清零(typed entries + uaccess_safe)。
  • syscall 边界 = 胶囊边界:入口统一校验并翻译用户指针;uaccess_safe.rs 提供类型化 copy_in/copy_out。
  • unsafe 行占比 7.1%(双口径 14.0%);trace 模块整体禁 unsafe。

§3仓库顶层布局

Rux/
├── kernel/       # 内核源码(上表)
├── userspace/    # mrsh、toybox、linux-ltp、probes/(tarball+extract.sh)、fio、geekbench、lmbench、stress
├── test/         # guest 侧 C 探针源码(pbench.c 等)+ 套件目录(ubuntu-gnome、ltpscan、stressng…)
├── scripts/      # 宿主侧:extract-probes.sh、test/(run.sh、run-x86-ub.sh、oh-boot.sh…)
├── toolchain/    # 自建 musl 交叉工具链(build-musl.sh、riscv64-rux-linux-musl/、x86_64 sysroot tarball)
├── build/        # 构建/配置工具(build/Makefile、menuconfig.sh、current-platform.sh)
├── work/         # 运行期产物(gnome-x86.img、rootfs、pbench 盘)
├── docs/         # 文档中心:guides/ architecture/ development/ test/ progress/
├── AGENTS.md     # 绑定性开发工作流(事实贡献指南)
├── Kernel.toml   # 内核配置 → kernel/src/config.rs
└── Makefile      # 顶层入口(转发 build/Makefile)
探针 tarball 政策:guest 测试用例源码只以 userspace/probes/probes.tar.gz + extract.sh 归档;make user/make test 经 scripts/extract-probes.sh 幂等恢复,仓库不跟踪散的 guest C 源文件。

§4语言构成

内核本体 100% Rust(no_std,除必要的平台汇编);用户态探针为 C(musl 交叉编译);仓库语言统计以 git ls-files 口径为准(vendored 的 toybox 标注 linguist-vendored)。