内核版本:v6.6.160(stable 6.6 LTS,tag 提交
0aebf2870d53,「Linux 6.6.160」)。下文路径、函数、行号、结构体字段都对照该版本源码核对。 在线对照:elixir.bootlin.com — linux/v6.6.160 权威用户接口文档:Documentation/admin-guide/cgroup-v2.rst(目录编号 1–6、P、D、R)
一句话:cgroup 把进程挂到一棵树上,core 管树与迁移,controllers 沿树记账/限流;本笔记默认 cgroup v2 统一层次。
- 总览与边界
- 核心对象
- 层次与控制接口
- 与进程生命周期的挂钩
- cpu / cpuset
- memory
- io / pids / 其它控制器
- PSI 与 rstat
- 观测清单
- 目录走读:怎么读
/sys/fs/cgroup/ memory.stat对账/proc/meminfo
01 总览 → 02 核心对象 → 03 层次接口 → 04 生命周期挂钩
↓
06 memory(最重控制器)→ 05 cpu/cpuset
↓
07 io/pids/misc → 08 PSI/rstat → 09 观测 → 10 目录走读 → 11 stat 对账
初学(或"拿到一台新机器想看懂这棵树")可以从 10 目录走读切入,再回头读 02/03。11 只依赖 06 和 08,可独立读。
先对象后接口:不懂 css_set 就看不懂 fork 时挂到哪。memory 提前于 cpu:限流语义(high/max/OOM)更「看得见」,且和后续 MM 章衔接。
| 本章覆盖 | 留给其它章 |
|---|---|
| cgroup core、v2 接口、各控制器挂钩点 | 完整 EEVDF 选人(scheduler/) |
mem_cgroup charge / limit 直觉 |
页回收、LRU、kswapd 深挖(memory-management/) |
io 控制器 → blk-cgroup 入口 |
blk-mq / elevator 内部 |
| cgroup namespace | 完整 pidns / mountns(见 process-management/03) |
| 树的目录结构与 systemd slice 命名 | systemd 单元语义(systemd-cgls、unit 依赖) |
memory.stat 与 meminfo 的对账 |
完整 /proc/meminfo 各字段、SLUB/vmalloc 内部(memory-management/) |
freezer v2 与 JOBCTL_TRAP_FREEZE 衔接 |
完整信号/作业控制(进程章 09) |
| PSI / rstat 读法 | 完整 perf/ftrace 方法论 |
- demos/README.md:
02_tree_walk.sh/03_stat_vs_meminfo.sh:只读,对应第 10、11 章04_memory_pids_limit.sh/05_cpu_throttle.sh:默认 DRY-RUN,CG_WRITE=1才建cg-demo-*并写限额,退出时清理- 全部在 cgroup v2 / 6.8 机器上实测过(sampled on 6.8),输出记在 demos/README
| 项 | 值 |
|---|---|
| 挂载 | cgroup2 on /sys/fs/cgroup ... nsdelegate,memory_recursiveprot |
根 cgroup.controllers |
cpuset cpu io memory hugetlb pids rdma misc |
根 cgroup.subtree_control |
cpuset cpu io memory pids |
| 非 systemd 的子组 | aegis / aegisMonitor / aegisRtap0(cpu.max=9500 100000) |
nr_descendants / nr_dying_descendants |
125 / 147 |
64M memory.max 下限流 |
OOM kill,memory.peak=64MB,oom_kill=1 |
cpu.max=20000 100000 忙等 3s |
0.61s CPU,nr_throttled=30/31 |
刻意薄写或不写:
- cgroup v1 多树全面手册(仅对照)
- 完整
mem_cgroup回收与 writeback 域 - 完整 cpu 带宽实现与 EEVDF 互动
- 编排层(systemd / Docker / K8s 策略)
下一章建议:调度(EEVDF)或内存管理——两者都会大量碰到本章的 cpu/memory 挂钩。
笔记生成对照源码:Linux v6.6.160。