Display fixes for UTM/Mac black screen issue:
- Remove MULTIBOOT_HEADER_TAG_FRAMEBUFFER from multiboot2 header (was required,
requesting text mode depth=0 which confused GRUB on some platforms)
- Add COM1 serial port (0x3F8) output alongside debugcon for UTM serial capture
- Change VGA background from black to dark blue for diagnostics
- Add early canary write to 0xB8000 ('COS' in magenta) before subsystem init
- print_hex now outputs to both debugcon and COM1
New ls command and SYS_READDIR syscall:
- SYS_READDIR (10): reads directory entries via VFS
- VFS root listing: vfs_readdir handles '/' by iterating mount table
- apps/ls: lists CWD contents, appends '/' for directories
- apps/libc/syscalls.h: readdir() wrapper
- Created env.c/h: key=value store with ENV_MAX_VARS=32 entries per
process. Supports get, set, unset, and copy operations.
- Added env_block_t and cwd[128] fields to process_t struct.
- process_create() initializes CWD=/ by default.
- Fork inherits environment via memcpy of the entire process_t.
- Added SYS_GETENV (8) and SYS_SETENV (9) system calls.
- Created env-test user app that verifies: CWD default, set/get,
and inheritance across fork.
- Updated kernel.c to launch 'sh' as init process (for next task).
- Updated README.md to check off environment variables task.
Tested: env-test reads CWD=/, sets TEST=hello, reads it back,
forks child which inherits TEST=hello. All verified via QEMU.
- Added paging_clone_directory_from(): deep-copies user-space pages so
parent and child have independent memory. Kernel pages are shared.
- Fixed process_fork() to accept registers_t* for accurate child state,
and to clone from the parent's page directory (not the kernel's).
- Refactored process_exit() to properly context-switch to next process
using new process_switch_to_user assembly stub (loads full registers_t
and performs iret), instead of halting unconditionally.
- Fixed sys_waitpid() to use proper blocking: marks process BLOCKED,
invokes scheduler, and resumes with exit code when child dies.
- Added SYSCALL_SWITCHED mechanism to prevent syscall_handler from
clobbering the next process's EAX after a context switch.
- Created fork-test user app that validates fork + waitpid.
- Added docs/fork.md with architecture documentation.
Tested: fork-test creates child, both print messages, parent waits for
child exit (code 7), parent reaps and exits (code 0). hello-world also
verified to still work correctly after the process_exit refactor.
Add complete user-mode process support:
- TSS (tss.c/h): Task State Segment for Ring 3->0 transitions, installed
as GDT entry 5 (selector 0x28). ESP0 updated per-process for kernel
stack switching.
- Process management (process.c/h): Process table with up to 64 processes.
process_create() clones kernel page directory, maps user code at
0x08048000 and user stack at 0xBFFFF000, copies flat binary code.
Round-robin scheduler via schedule_tick() modifies the interrupt frame
in-place for zero-copy context switching.
- System calls (syscall.c/h): INT 0x80 dispatcher with 8 syscalls:
SYS_EXIT, SYS_WRITE (to debug port + VGA), SYS_READ, SYS_FORK,
SYS_GETPID, SYS_YIELD, SYS_WAITPID, SYS_EXEC. IDT gate at 0x80
uses DPL=3 (flags 0xEE) so user code can invoke it.
- Assembly stubs (interrupts.S): isr128 for INT 0x80, tss_flush for
loading the Task Register, enter_usermode for initial iret to Ring 3.
- Paging extensions (paging.c/h): paging_clone_directory() to create
per-process page directories, paging_map_page_in() for mapping into
non-active directories, paging_switch_directory() for CR3 switching.
- GDT expanded from 5 to 6 entries to accommodate TSS descriptor.
gdt_set_gate() exposed in header for TSS initialization.
- ISR handler routes timer IRQ (32) to scheduler and INT 0x80 to
syscall dispatcher. Exception handler now prints EIP/CS/ERR for
debugging.
- Kernel boots a test user program that writes 'Hello from Ring 3!'
via SYS_WRITE and exits with code 42 via SYS_EXIT. Verified working
in QEMU.
Context switching approach: Timer/syscall interrupts save all registers
via the ISR stub. schedule_tick() copies saved_regs between PCBs and
overwrites the interrupt frame, so the existing iret restores the next
process's state without separate switch assembly.
