How mesmatmm/cs306-spring2025 works
Project type and purpose
• This is not a customer-facing application but an educational “lab repository” for an Operating Systems course (CS306). It contains three major modules:
• Assembly X8086 exercises (Labs 1–5, Info, More Examples)
• Multithreading in C (Labs 6–9)
• Multithreading in Java (Labs 10–12)
• The README spells out the learning objectives: assembly instructions and memory models, POSIX threads in C, and Java concurrency primitives.
File structure
• Top-level: README.md, .gitattributes, an “Info” folder, “More Examples – Assembly”, and individual Lab directories (Lab 01…Lab 11, plus PDFs/MDs of exercises).
• Each Lab NN folder groups source files (.asm, .c, .java) and supporting docs (MD/PDF).
• No build scripts or CI configs—each module is operated with its own toolchain (Emu8086, GCC + pthreads, JDK).
README for additional insights
• The outline shows a progression: Learn X8086 assembly, then C threads (Lab 6–9), then Java threads (Lab 10–12).
a. Main components
• Code Repository (Git)
• Assembly Module
– Source files (.asm)
– Emulator: Emu8086
• C Threads Module
– Source files (.c)
– Compiler/Linker: GCC with –pthread
– POSIX Threads Library
• Java Threads Module
– Source files (.java)
– Compiler/Runtime: javac, java
– Concurrency Frameworks: Thread, Runnable, ExecutorService, Locks, Atomics
• Documentation
– Lab specs (MD/PDF)
– Info sheets on CMP, Flags, Jumps
b. Relationships and interactions
• The student (or instructor) clones the Git repo → picks a lab module → invokes the relevant toolchain (Emu8086 / GCC / javac) → runs the executable or emulator.
• Each module is independent: no cross-module code sharing.
• The README orchestrates navigation: it points to each component.
c. Architectural patterns & design principles
• Modular structure by topic and language
• Clear separation of concerns: assembly vs C vs Java
• Self-contained labs with code + documentation
d. Key technologies/frameworks
• Emu8086 for X8086 assembly simulation
• GCC + POSIX Threads for C labs
• Java JDK concurrency APIs for Java labs
• Markdown/PDF for documentation