Skip to content

Latest commit

 

History

History
380 lines (336 loc) · 34 KB

README.md

File metadata and controls

380 lines (336 loc) · 34 KB

kernel-notes

对着 Linux 内核真实源码整理的子系统笔记。内核版本:Linux 6.6 LTS(v6.6.160)。结构体、函数、行号都对照这个版本;本机观测数字来自不同机器,文中会标明 sampled on 6.12 或 sampled on 6.8。

源码不放在本仓库,请自行对照:

目录

笔记 说明
process-management/ 进程管理(大章):总览与 CLONE_*、task_struct、PID/pidns、fork/clone、内核线程、exec、exit/回收、上下文切换入口、信号、观测清单。调度选人算法(EEVDF)见 scheduler。
locks-and-ds/ 同步原语与内核数据结构(大章):读内核够用的 C、list_head/hlist、树与映射容器、atomic/refcount、spinlock、mutex/rwsem/seqlock、等待队列与 completion、futex 的 WAIT/WAKE、RCU、lockdep 与踩坑。面向 C 新手补嵌入式链表与宏。
cgroup/ 控制组(大章):cgroup v2 core 与对象模型、层次接口、fork/exit 挂钩与 cgroup ns、cpu/cpuset、memory、io/pids/freezer、PSI/rstat、本机观测,以及 /sys/fs/cgroup/ 目录走读与 memory.stat↔/proc/meminfo 对账。完整调度/MM/块层另章。
scheduler/ 调度(大章):调度类链、rq/cfs_rq/sched_entity、EEVDF、入队与唤醒、负载均衡、NUMA balancing 闭环、cgroup cpu 衔接、RT/DL 边界、观测与性能分析配方。
memory-management/ 内存管理(大章):物理页与 zone、buddy、SLUB、vmalloc、mm/VMA 与页表、缺页、页缓存、THP/hugetlb、回收与 OOM、KVM 二维页表与 mmu_notifier、balloon/FPR/热插拔、本机 /proc 观测与症状剧本。cgroup charge 与完整 VFS 另章。
interrupts/ 中断(大章):x86-64 IDT 入口、APIC/MSI 向量、genirq 对象与层次域、向量矩阵、注册与流控、分配失败、softirq/tasklet、工作队列与 irq_work、定时器、KVM irqfd/posted interrupt、观测与性能配方。
syscalls/ 系统调用(大章):x86-64 entry_SYSCALL_64、x64_sys_call 分派、SYSCALL_WORK_* 与退出循环、copy_*_user、vDSO/vvar、ia32 入口、-ERESTART*、seccomp/ptrace 挂钩面、观测与开销配方。IDT 与信号投递另章。
vfs/ 虚拟文件系统(大章):dentry / inode / file、路径查找、fd 与 open/close、读写与页缓存交接、splice/sendfile、mmap、挂载与传播、dcache/icache、文件锁与 inotify/fanotify、tmpfs 走读、proc/sysfs/debugfs、观测与性能配方。页缓存和回写的内存侧见 memory-management。
ipc/ 本地 IPC 与多路复用(大章):select/poll 的 poll_table、epoll 的对象与 epoll_ctl / epoll_wait、LT/ET/ONESHOT/EXCLUSIVE、pipe 的创建和读写唤醒、eventfd/signalfd/timerfd、AF_UNIX 就绪与 SysV/POSIX mqueue 薄写、观测与配方。futex 见 locks-and-ds,inotify 见 vfs,sk_buff 与完整收发见 networking。
networking/ 网络栈(大章):sk_buff、socket/sock、net_device 与 NAPI、收发包与 qdisc、IPv4 路由与邻居、TCP/UDP、AF_UNIX 收发、netns 里的 veth/bridge、netfilter 挂钩、客户机 virtio-net、宿主机 tap/vhost_net、多队列与 RPS/XPS、观测与配方。epoll 见 ipc,softirq 见 interrupts,struct net 的创建见 containerization。XDP 程序见 ebpf。
ebpf/ eBPF(大章):bpf(2) 装载、bpf_insn 与 JIT、verifier、map、BTF/CO-RE、bpf_link(kprobe / tracepoint / raw tp / fentry 的 BPF 侧)、XDP、tc/cgroup/sock/netfilter BPF、helper 与 tail call、bpffs、bpftool/libbpf、观测与配方。ftrace 环、TRACE_EVENT 与 kprobe 断点见 tracing。seccomp cBPF 见 containerization 与 syscalls。
tracing/ 追踪(大章):ftrace 环缓冲与 tracefs、动态 ftrace(ftrace_ops、register_ftrace_direct)、function / function_graph、TRACE_EVENT 与探针链、event filter/trigger、register_kprobe 与优化 trampoline、kprobe_events、uprobe 薄写、观测与配方。BPF attach 与 ctx 见 ebpf。
block-io/ 块层与 IO(大章):bio / request、blk-mq、none / mq-deadline / kyber / bfq、多队列亲和、ioprio 与 cgroup io、回写与 fsync、Direct IO、io_uring、NVMe 与 virtio-blk 走读、错误与超时、观测与性能配方。页缓存回写的内存侧见 memory-management,cgroup 文件见 cgroup。
containerization/ 容器化(大章):八种命名空间与 nsproxy、pivot_root、user ns 映射、net ns(veth/bridge 细节见 networking)、容器里的 cgroup、overlayfs、FUSE、runc v1.5.2 创建路径、seccomp/能力/LSM 边界、观测与坑。PID 分配见 process-management,控制器见 cgroup,挂载传播见 vfs。
init-modules-wq/ 内核初始化、模块与工作队列(大章):start_kernel 到 pid 1 与 initcall、finit_module → load_module → do_init_module、cmwq 的 pool / pwq / worker。工作队列和中断线程、softirq、irq_work 怎么选见 interrupts。
ondisk-fs-iomap/ 盘上文件系统与 iomap(选修):ext4 / XFS 的盘上结构、buffer_head 与 iomap 的分界、缓冲读写与回写、Direct IO、delalloc / unwritten、jbd2 与 XFS CIL、fsync。页缓存见 memory-management,bio 见 block-io。
dma-iommu/ DMA 地址、IOMMU 与 SWIOTLB(选修):dma_addr_t、direct / SWIOTLB、IOMMU domain 与页表、dma-iommu、VFIO 边界、fault 与观测。bio 见 block-io,网卡 ring 见 networking,CPU 页表见 memory-management。
kvm-virtio/ KVM 与 virtio(选修):/dev/kvm、KVM_RUN、VMX 进入退出、vCPU 线程与 HLT、virtqueue、virtio-blk 请求、vhost。EPT 见 memory-management,virtio-net 见 networking,IRTE 见 interrupts。

进程管理子章节

文件 内容
README.md 章节目录与未覆盖说明
01-overview.md 总览与边界
02-task-struct.md 任务抽象:task_struct
03-pid-namespaces.md PID 与命名空间
04-fork-clone.md 创建路径:fork / clone / clone3 / vfork
05-kernel-threads.md 内核线程与特殊任务
06-exec.md 地址空间交接:exec
07-exit-reap.md 退出、僵尸与回收
08-context-switch.md 上下文切换(进程管理视角)
09-signals.md 信号与进程
10-observability.md 观测与调试清单

旧链接 process-management.md 仍保留为跳转说明。

同步原语与内核数据结构子章节

文件 内容
README.md 章节目录、与进程章边界、阅读顺序
01-c-primer.md 读内核够用的 C(含 container_of)
02-list.md list_head / hlist
03-trees-maps.md rbtree / xarray / maple / idr / hashtable
04-atomics-refcount.md atomic 与 refcount_t
05-spinlock.md 自旋锁与 IRQ 变体
06-sleepable-locks.md mutex / rwsem / seqlock
08-wait-queue-and-completion.md 等待队列与 completion(读序在可睡眠锁之后、futex 之前)
09-futex.md futex 的 WAIT/WAKE 与哈希桶(读序在等待队列之后、RCU 之前)
07-rcu.md RCU 与 tasks RCU 衔接(文件名仍是 07)
08-observability.md lockdep、lock_stat、踩坑清单(现文件名 08,读序最后)

cgroup 子章节

文件 内容
README.md 章节目录、阅读顺序、与其它章边界
01-overview.md 总览与边界(v2 默认)
02-core-objects.md cgroup / css / css_set / subsys
03-hierarchy-control.md subtree_control、迁移、委托
04-lifecycle-hooks.md fork/exit 挂钩、CLONE_INTO_CGROUP、cgroup ns
05-cpu-cpuset.md cpu / cpuset 控制器
06-memory.md memory 控制器与 charge 直觉
07-io-pids-misc.md io / pids / freezer / 其它
08-psi-rstat.md PSI 与 rstat
09-observability.md 观测与本机实测
10-directory-walkthrough.md /sys/fs/cgroup/ 目录走读:v2 判定、cgroup.procs 迁移、slice/service/scope 与 userspace mkdir、控制器逐层收窄、dying cgroup
11-memory-stat-vs-meminfo.md 根 memory.stat 对账 /proc/meminfo:用户态为何能对上、内核态为何对不上(__GFP_ACCOUNT、root/内核线程 bypass、计数更新点)、rstat 抖动
demos/ 02/03 只读走读与对账;04/05 默认 DRY-RUN,CG_WRITE=1 才建 cg-demo-* 并写限额(sampled on 6.8)

调度子章节

文件 内容
README.md 章节目录、阅读顺序、边界
01-overview.md 总览与调度类链
02-core-objects.md rq / cfs_rq / sched_entity / task_group
03-eevdf.md EEVDF 选人
04-enqueue-wakeup.md 入队出队与 ttwu
05-load-balance.md PELT 与负载均衡
05b-numa-balancing.md NUMA balancing 闭环:扫描、hint fault、迁页、首选节点(读序在负载均衡之后、观测之前)
06-other-classes.md RT / DL / idle / stop
07-cgroup-cpu.md 与 cgroup cpu 衔接
08-observability.md 观测与本机实测
09-perf-analysis.md 性能分析配方
demos/ 只读采集脚本、一次 MEASURED 抓取样本(sampled on 6.12)、两个 bpftrace RECIPE(未跑)

内存管理子章节

文件 内容
README.md 章节目录、阅读顺序、与 cgroup/调度/VFS 边界
00-life-of-malloc.md 从 malloc 到 VMA、缺页、buddy 的入口叙事
01-overview.md 物理线与虚拟线、总图
02-physical-layout.md page / folio / node / zone / buddy / sparsemem / memblock
03-00-page-alloc.md 页分配:调用链、GFP/scope、水位、PCP、释放合并、慢路径、高阶与 compaction、mempolicy、CMA。
04-slab.md SLUB 与 kmem_cache、page frag
05-vmalloc-and-kernel-va.md vmalloc、highmem、kmap_local、VMAP_STACK
06-mm-and-vma.md mm_struct、VMA、页表、TLB、rmap、overcommit
07-page-fault.md 缺页:匿名、文件、COW、userfaultfd、hwpoison
08-page-cache-and-writeback.md 页缓存、脏页、shmem
09-thp-and-hugetlb.md THP、hugetlb 预留、HVO
10-00-reclaim.md 回收:scan_control、经典 LRU、MGLRU 设计与路径、对照与开关、zswap、OOM、mlock、迁移。
11-kvm-memory.md EPT/NPT、memslot、TDP MMU、mmu_notifier、HMM
12-balloon-fpr-and-overcommit.md balloon、FPR、KSM、virtio-mem、内存热插拔
13-observability.md 本机 /proc、pagemap、DAMON、shrinker debugfs
14-perf-and-dev-practice.md 按症状排障、page_owner
demos/ 用户态 maps/smaps_rollup 与 minor fault 示例(写笔记时本机编过跑过);kmod_slab_cache.c 只提供源码,不 insmod

中断子章节

文件 内容
README.md 章节目录、阅读顺序、与调度/锁/内存的边界
01-overview.md 总览:设备到 softirq 的总图
02-x86-entry.md IDT、common_interrupt、中断栈、irqentry_enter
03-apic-and-vectors.md LAPIC、IO-APIC、MSI/MSI-X、256 向量
04-genirq-objects.md irq_desc、irq_data、irq_chip、irq_domain、irqaction
05-irqdomain-hierarchy-and-matrix.md 向量域、中断重映射、irq_matrix
06-request-and-flow.md request_threaded_irq、流控、亲和、热插拔
07-irq-alloc-failure.md 向量与 IRTE 分配失败
08-softirq-tasklet.md softirq、ksoftirqd、tasklet
09-deferred-work-choice.md 工作队列、中断线程、irq_work
10-timers.md 时间轮、hrtimer、NO_HZ、LAPIC 定时器
11-kvm-irq-virt.md 客户机 LAPIC、irqfd、posted interrupt
12-observability.md /proc、debugfs、tracepoint、irqbalance
13-perf-analysis.md 风暴、softirq 饱和、亲和与配方

系统调用子章节

文件 内容
README.md 章节目录、阅读顺序、与中断/信号/容器/内存的边界
01-overview.md ABI、pt_regs、总图
02-x86-entry.md entry_SYSCALL_64、pcpu_hot.top_of_stack、SYSRET
03-dispatch-and-define.md x64_sys_call、SYSCALL_DEFINE、getpid
04-enter-exit-work.md SYSCALL_WORK_* 与 exit_to_user_mode_loop
05-usercopy.md copy_*_user、SMAP、extable
06-vdso-and-vvar.md [vdso] / [vvar]、vdso_data
07-compat.md int $0x80、sysenter、TS_COMPAT
08-restart.md -ERESTART* 与 restart_block
09-hooks.md seccomp、ptrace、tracepoint、user dispatch
10-observability.md maps、/proc/<pid>/syscall、tracepoint
11-perf-analysis.md vDSO 与陷入的采样、strace/PTI 配方

VFS 子章节

文件 内容
README.md 章节目录、阅读顺序、与内存章 / 块层 / 容器化章的边界
01-overview.md 系统调用到 VFS、具体文件系统、页缓存、块层
02-core-objects.md super_block、inode、dentry、file 与四张 ops
03-path-lookup.md path_openat、RCU-walk、dcache、挂载点、符号链接
04-fd-and-open.md files_struct、fdtable、open/close、struct file 引用
05-read-write.md read_iter / write_iter、kiocb、缓冲 IO 与 Direct IO
05b-splice-and-zerocopy.md splice / sendfile / copy_file_range 与管道槽(读序在读写之后、mmap 之前)
06-mmap-and-file.md f_op->mmap、vm_operations_struct、filemap_fault
07-mount-and-ns.md vfsmount、新挂载 API、shared/slave/private/unbindable
08-dcache-icache.md dentry/inode LRU、shrinker、负 dentry
09-locks-and-notify.md flock、POSIX 锁、lease、inotify、fanotify
10-tmpfs-walkthrough.md tmpfs 上 open→read→write→fsync
11-pseudo-fs.md procfs、sysfs/kernfs、debugfs
12-observability.md /proc/sys/fs/*、slab 名、tracepoint
13-perf-analysis.md 路径查找、dcache、fsync、DIO 的配方

本地 IPC 与多路复用子章节

文件 内容
README.md 章节目录、阅读顺序、与锁 / VFS / 进程 / 块层的边界
01-overview.md 总览与选型
02-poll-select.md select / poll 与 poll_table
03-epoll-objects.md eventpoll / epitem / eppoll_entry
04-epoll-ctl-and-callback.md epoll_ctl 与 ep_poll_callback
05-epoll-wait-and-modes.md epoll_wait 与 LT / ET / ONESHOT / EXCLUSIVE
06-pipe.md pipe 创建与读写唤醒
07-eventfd-signalfd-timerfd.md eventfd / signalfd / timerfd
08-unix-and-sysv.md AF_UNIX 就绪,SysV 与 POSIX mqueue
09-observability.md fdinfo、epoll 与 pipe 的 sysctl
10-perf-analysis.md 少量 fd、漏读、惊群、小写多醒

网络栈子章节

文件 内容
README.md 章节目录、阅读顺序、与 ipc / containerization / interrupts / ebpf 的边界
01-overview.md socket 到网卡的总图,云上多一跳 virtqueue
02-sk-buff.md sk_buff、skb_shared_info、clone/copy、校验和与 GSO
03-socket-and-sock.md socket / sock / sock_common、proto 与 proto_ops
04-netdev-and-napi.md net_device、NAPI、softnet_data、RPS 挂钩
05-rx-path.md GRO、netif_receive_skb、ip_rcv
06-tx-path-and-qdisc.md dev_queue_xmit、Qdisc、BQL、XPS 挂钩
07-ipv4-route-neigh.md fib、dst_entry、邻居与 ARP
08-tcp.md tcp_sock、收发主路径、cubic
09-udp.md udp_sendmsg / udp_recvmsg、哈希表
10-af-unix.md UNIX 流与数据报的 send/recv、SCM_RIGHTS
11-netns-veth-bridge.md veth 转发、bridge rx_handler
12-netfilter-hooks.md NF_INET_* 与 nf_hook_ops
13-virtio-net-guest.md 客户机 virtio-net 队列与 NAPI
14-virtio-net-host-vhost.md tap 与 vhost_net;vhost-user 只点名
15-mq-rps-xps-affinity.md 多队列、RPS/RFS、XPS、IRQ 亲和
16-observability.md /proc/net、ss、ethtool、RECIPE
17-perf-analysis.md softirq、qdisc、重传、virtio 单队列

eBPF 子章节

文件 内容
README.md 章节目录、阅读顺序、与 tracing / networking / syscalls / containerization 的边界
01-overview.md cBPF 与 eBPF、装载总图、覆盖边界
02-prog-and-insn.md bpf_insn、bpf_prog、解释器与 JIT
03-verifier.md bpf_check、do_check、剪枝、helper 白名单
04-maps.md array / hash / percpu / lpm / map-in-map
05-btf-and-ctx.md BTF、程序类型的 ctx、CO-RE
06-attach-and-link.md bpf_link、kprobe / tracepoint / raw tp / fentry
07-xdp.md xdp_buff、generic/driver/offload、AF_XDP
08-tc-cgroup-sock.md tcx、cls_bpf、cgroup-bpf、sockops、netfilter
09-helpers-and-sync.md helper、RCU、tail call
10-bpf-syscall-and-fs.md bpf(2) 命令、权限、bpffs
11-tooling.md libbpf、bpftool、bpftrace、perf
12-observability.md sysctl、fdinfo、verifier log
13-perf-analysis.md 拒载、map 争用、XDP 丢包、attach 开销

追踪子章节

文件 内容
README.md 章节目录、阅读顺序、与 ebpf / scheduler 的边界
01-overview.md probe 到环到 tracefs;与 perf / eBPF 的分工
02-ring-buffer.md trace_buffer、reserve/commit、reader 页、overwrite
03-tracefs-and-array.md trace_array、instances、current_tracer、buffer_size_kb
04-dynamic-ftrace.md ftrace_ops、filter、trampoline、register_ftrace_direct
05-function-and-graph.md function 与 function_graph、shadow stack
06-tracepoint-and-TRACE_EVENT.md TRACE_EVENT、static_call、event 文件
07-event-filter-trigger.md filter、trigger;hist / synth 薄写
08-kprobes-core.md register_kprobe、int3、优化 trampoline
09-kprobe-events.md kprobe_events 与参数抓取
10-uprobe.md uprobe_events、inode+offset
11-observability.md /sys/kernel/tracing 与本机采样
12-perf-analysis.md 开销、丢事件、选型与 RECIPE

块层与 IO 子章节

文件 内容
README.md 章节目录、阅读顺序、与 VFS / 内存 / cgroup / 中断的边界
01-overview.md VFS 到 bio、request、调度器、驱动的总图
02-bio-and-bvec.md struct bio、bio_vec、拆分合并、submit_bio
03-request-and-blk-mq.md struct request、request_queue、硬件队列、tag、blk_mq_ops
04-sched-none.md none:没有 elevator 的派发
05-sched-mq-deadline.md mq-deadline
06-sched-kyber.md kyber
07-sched-bfq.md BFQ
08-multiqueue-affinity.md 软件/硬件队列、CPU 映射、IRQ 亲和
09-ioprio-and-cgroup-io.md ioprio,以及 cgroup io 交到 blk-cgroup
10-writeback-and-fsync.md 回写到 bio,fsync 到设备 flush
11-direct-io.md O_DIRECT:iov_iter 到 bio
12-io-uring.md 环、SQE/CQE、固定缓冲、poll、uring_cmd,对照经典 AIO
13-nvme-walkthrough.md NVMe PCI:nvme_queue_rq 到完成 IRQ
14-virtio-blk-walkthrough.md virtio-blk:virtio_queue_rq 到 virtblk_done
15-errors-timeout-retry.md blk_status_t、超时、failfast
16-observability.md /sys/block/*/stat、blktrace、io_uring fdinfo
17-perf-analysis.md 队列深度、延迟、调度器与 io_uring 的配方

容器化子章节

文件 内容
README.md 章节目录、阅读顺序、与进程/cgroup/VFS 的边界
01-overview.md 进程 → namespace → cgroup → 根文件系统 → 网络
02-namespaces.md nsproxy、八个 CLONE_NEW*、unshare/setns、/proc/<pid>/ns
03-mount-ns-pivot-root.md mount ns 复制与 pivot_root
04-pid-user-uts-ipc-time-ns.md pid/uts/ipc/time;user ns 的 uid/gid 映射
05-net-ns.md struct net、设备进 ns;veth/bridge/CNI 只点到
06-cgroup-in-containers.md 创建时挂 cgroup、CLONE_INTO_CGROUP、委托
07-overlayfs.md lower/upper/work/merged、copy-up、whiteout、opaque
08-fuse.md fuse_req、请求队列、守护进程
09-runc-create-path.md runc v1.5.2:nsexec 三阶段、cgroup Apply、pivot_root、exec
10-seccomp-caps-lsm.md seccomp、能力、LSM 边界
11-observability.md lsns、nsfs、cgroup、overlay 参数、fusectl
12-perf-and-pitfalls.md copy-up 放大、user ns 映射、cgroup v1/v2、FUSE 延迟

内核初始化、模块与工作队列子章节

文件 内容
README.md 章节目录、阅读顺序、与中断 / 进程 / 调度的边界
01-overview.md 启动、装模块、cmwq 三条线
02-start-kernel.md start_kernel:调度、workqueue_init_early、开中断
03-rest-init-and-pid1.md pid 1、kthreadd、kernel_execve
04-initcalls.md early 与 pure…late,initcall_debug
05-module-objects.md struct module、状态、mod_mem_type
06-module-load.md finit_module → load_module → do_init_module
07-module-unload.md delete_module、refcnt、依赖链表
08-kmod-request.md __request_module 与 call_modprobe
09-cmwq-objects.md work_struct、pool、pwq、worker
10-cmwq-queue-and-flags.md 入队、WQ_*、schedule_work → system_percpu_wq
11-observability.md /proc/modules、sysfs、tracepoint。RECIPE
12-perf-analysis.md 装载失败、积压、rescuer、watchdog。RECIPE
demos/ demo 01 源码写完,默认不 insmod(待真机验证)

盘上文件系统与 iomap 子章节

文件 内容
README.md 章节目录、阅读顺序、与 VFS / 内存 / 块层的边界
01-overview.md 盘上 FS 的职责;buffer_head 与 iomap 的分界
02-ondisk-layout.md superblock、inode、extent / B+tree、位图与分配组
03-buffer-head.md block_write_begin、get_block_t
04-iomap-model.md struct iomap、iomap_ops、iomap_iter
05-buffered-io.md iomap_file_buffered_write、folio 子块状态、readahead
06-writeback.md iomap_writepages 组 bio;ext4 仍走 ext4_writepages
07-direct-io.md iomap_dio_rw、对齐、同步 / 异步完成
08-delalloc-unwritten.md 延迟分配、unwritten 转换、fallocate / punch hole
09-ext4-jbd2.md jbd2 handle / commit / checkpoint;ext4 哪些路径用 iomap
10-xfs-log.md CIL、log item,和 jbd2 的差异
11-fsync-crash.md vfs_fsync_range → ->fsync、flush/FUA、rename 边界
12-observability.md tracepoint、filefrag、回写 / 日志 / fsync 的配方。RECIPE
demos/ demo 01 默认 DRY-RUN,自建 loop 上看 extent(待真机验证)

DMA 地址、IOMMU 与 SWIOTLB 子章节

文件 内容
README.md 章节目录、阅读顺序、与块层 / 网络 / 内存 / 中断的边界
01-overview.md VA、PA、DMA 地址;direct、bounce、IOMMU 怎样组合
02-dma-address.md coherent 与 streaming、所有权、屏障、dma_map_sg 的返回值
03-dma-api-dispatch.md dma_map_ops、dma_go_direct、两套 mask
04-direct-dma.md phys_to_dma 与 bounce 条件
05-swiotlb.md 池、slot、拷贝、池耗尽
06-sg-and-iova.md orig_nents 与 mapped nents;IOVA 与 bio 的接缝
07-iommu-core.md domain、group、ACS、IOVA 分配器
08-page-tables.md iommu_map、VT-d PTE 与 IOTLB、SMMU 差异
09-dma-iommu.md iommu_dma_ops、identity / DMA / DMA-FQ
10-vfio-boundary.md VFIO type1 与 iommufd 的映射留在内核
11-fault-and-isolation.md fault 上报路径、越界、ACS
12-observability.md tracepoint、debugfs、sysfs。RECIPE
demos/ demo 01 只读盘点(待真机验证)。02–05 只有计划

KVM 与 virtio 子章节

文件 内容
README.md 章节目录、阅读顺序、与内存 / 中断 / 网络 / 块层的边界
01-overview.md QEMU、KVM、客户机驱动、virtio、vhost 的职责
02-userspace-api.md /dev/kvm、VM fd、vCPU fd、memslot、kvm_run
03-kvm-run.md KVM_RUN 到 x86 vcpu_run
04-vm-entry-exit.md VMX 进入与退出;SVM 只点差异
05-vcpu-schedule.md HLT、halt poll、阻塞与 steal
06-guest-memory.md GVA/GPA/HVA/HPA 接到取指和 PIO
07-irq-clock.md irqfd、APICv/posted interrupt 的条件、pvclock
08-pio-mmio-notify.md 内核处理与用户态退出、ioeventfd、irqfd
09-virtio-negotiate.md feature 与 status;modern virtio-pci
10-virtqueue.md split / packed、屏障、kick
11-virtio-blk.md 客户机 blk-mq 到 virtqueue,再到后端边界
12-vhost.md 内核 vhost 队列、worker、split 描述符
13-reset-migration.md reset、在途请求、dirty log
14-observability.md exit、调度、通知分层。RECIPE
demos/ demo 01 可编译(KVM_RUN 成功路径待真机验证)。02–05 只有计划

约定

  • 讲原理落到文件路径、函数名、结构体;行号对应注明的内核版本。
  • 大章要求:关键结构体成员中文注释、每节关键函数表、关键路径中文注释摘录。
  • 观测命令只作参考,默认不在生产机上跑。
  • 还没贴实测的 RECIPE、以及 demos 里没跑通的条目,记在 REAL-MACHINE-TEST-BACKLOG.md。那是给 code agent 按 ID 领取、补真机验证的工作单,不是教程正文。