CR: Kernel IPC Curriculum — Implementation

Implementation Plan

Step 1: Create Directory Structure

mkdir -p pages/education/kernel/ipc/
mkdir -p partials/education/kernel/ipc/

Step 2: Create Curriculum Index

Create pages/education/kernel/ipc/index.adoc following the established education pattern from pages/education/systems/bash/index.adoc:

  • .lead paragraph

  • Dennis Ritchie philosophy quote

  • "Why IPC Matters" motivation table

  • Curriculum table with 4 xref’d modules + 5 future placeholders

  • 4-level mastery path (week/month progression)

  • Syscall quick reference with code examples

  • Strace patterns for debugging

  • Practice method with real exercises

  • Related resources

Step 3: Create 4 Deep-Dive Partials

Each partial covers one IPC domain in depth:

  1. partials/education/kernel/ipc/tmpfs-runtime-dir.adoc — mm/shmem.c, VFS permissions, socket inode creation, memory model

  2. partials/education/kernel/ipc/unix-sockets.adoc — socket types, SCM_RIGHTS fd passing, zero-copy architecture, kernel source map

  3. partials/education/kernel/ipc/credential-passing.adoc — SO_PEERCRED vs SCM_CREDENTIALS, task_struct, struct cred, D-Bus security

  4. partials/education/kernel/ipc/environment-discovery.adoc — fork()/execve() propagation, tmux update-environment filtering, live workaround pattern

Step 4: Create 4 Page Wrappers

Each page is a shell that includes its corresponding partial:

  1. pages/education/kernel/ipc/tmpfs-runtime-dir.adoc

  2. pages/education/kernel/ipc/unix-sockets.adoc

  3. pages/education/kernel/ipc/credential-passing.adoc

  4. pages/education/kernel/ipc/environment-discovery.adoc

Step 5: Update Navigation

Replace flat IPC & Environment Variables entry in partials/nav/education.adoc with hierarchical 5-entry nav under "IPC (Inter-Process Communication)".

Step 6: Update Cross-References

  • Update xref in partials/projects/tmux-quantum/field-notes.adoc from deleted flat page to new ipc/index.adoc

  • Add "Hands-On Deep Dives" section to pages/education/kernel/index.adoc with xref to IPC curriculum

Step 7: Delete Monolithic Files

  • pages/education/kernel/ipc-environment-variables.adoc

  • partials/education/kernel/ipc-environment-variables.adoc