How remzi-arpacidusseau/ostep-projects works
Project type and purpose
• This is a monorepo of small, standalone C/Linux and xv6 kernel projects used in an operating‑systems course.
• It groups exercises into categories: initial C utilities, processes/scheduling, virtual-memory, concurrency, file‐systems, distributed systems, and xv6 kernel hacking.
File structure
• Top‐level folders fall into:
• initial‑* (simple C programs + tests)
• concurrency‑* (multi‐threaded or multi‐process C exercises)
• filesystems‑* (FS checker, UFS implementation, etc.)
• scheduling‑xv6‑lottery, vm‑xv6‑intro, concurrency‑xv6‑threads, initial‑xv6 (xv6 kernel assignments)
• processes‑shell (shell implementation)
• tester (common testing framework)
• INSTALL-xv6.md, README.md (meta info)
• Each subproject directory typically contains source files, a README or CONTEST file, test scripts, and test data.
README for additional insights
• The root README outlines categories and links to each subproject.
• Projects use gcc/Makefiles on Linux, and in some xv6 assignments use cross‐compilers and QEMU.
• The tester directory provides a harness to run each project’s tests.
Elements
• Clear labels: category names, subproject names, environments, tester
• Rectangles for code modules
• Diamonds for decision points or test harness