代码结构
仓库布局与内核源码地图 · 口径(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,821 | 19.2% | ext4(12 文件)、jbd2、VFS、dcache、page_cache、bio/buffer、procfs/sysfs/debugfs/tracefs/tmpfs、pipe、xattr、inotify、locks、io_uring、elf |
| arch/ | 48,812 | 13.4% | riscv64 / x86_64 / aarch64:boot、trap、mm(page_fault)、cpu、uaccess、intc、SBI/MSR/寄存器 |
| syscall/ | 41,083 | 11.3% | 系统调用分发表与实现(胶囊边界:校验/翻译用户指针,uaccess_safe 类型化 copy_in/out) |
| drivers/ | 25,436 | 7.0% | virtio(blk/net/gpu/input,queue + PCI 传输层)、blkdev、intc、pci、gpu/drm、input、timer |
| ipc/ | 21,758 | 6.0% | binder(14,144 行,最大单文件)、access_token、SysV sem/msg/shm、POSIX MQ |
| net/ | 20,857 | 5.7% | SkBuff、eth、arp、ipv4/ipv6、icmp、udp、tcp(5,250 行)、unix(4,372 行)、netlink、raw |
| sync/ | 19,843 | 5.5% | 自旋锁/休眠锁/futex(含 PI)、CpuLocal(D-7)、类型化锁键(D-11) |
| mm/ | 19,432 | 5.3% | memblock、buddy、slab、small_alloc、page fault、VMA、页缓存协作、kswapd、rmap |
| dfx/ | 19,395 | 5.3% | syscost、kallsyms、debugfs、taskdump、watchdog、memwatch、ledger(诊断层,单独统计 unsafe) |
| process/ | 17,709 | 4.9% | 任务结构、fork/exit、信号、wait、pid、cgroup |
| sched/ | 17,291 | 4.7% | GRQ、fair/rt/deadline 调度类、wakewatch、调度事件普查/heal |
| tests/ | 15,241 | 4.2% | 76 个 guest 内测试文件(make test 宿主) |
| 其他(interrupt/timer/io_uring/perf/security/module + 顶层 .rs) | 23,463 | 6.4% | 中断子系统、定时器轮、io_uring 雏形、perf 计数、LSM/capability、模块桩、init/panic/console 等 13 个顶层文件 |
| trace/ | 3,795 | 1.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.rs69 个 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)。