Skip to content

Latest commit

 

History

History

cgroup

README.md

cgroup(控制组)大章

内核版本: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 统一层次。


目录

  1. 总览与边界
  2. 核心对象
  3. 层次与控制接口
  4. 与进程生命周期的挂钩
  5. cpu / cpuset
  6. memory
  7. io / pids / 其它控制器
  8. PSI 与 rstat
  9. 观测清单
  10. 目录走读:怎么读 /sys/fs/cgroup/
  11. 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 方法论

demo

  • 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

本机样本(sampled on 6.8)

项 值
挂载 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。