UniversalisOS Stub Registry

Purpose: Track all stub implementations in the codebase for future identification and removal.

Marker Convention: UOS-STUB-<TRACK>-<TASK> (e.g., UOS-STUB-T8-1.2h)

Search Command:

grep -rn "UOS-STUB" kernel/src/ --include="*.c" --include="*.cpp" --include="*.h"

Active Stubs

UOS-STUB-T8-1.2h — POSIX Process Management

Location: kernel/src/core/abi/uos_posix_abi.cpp
Functions: task_fork(), task_waitpid()
Reason: POSIX fork/waitpid not yet implemented for musl personality
Added: 2026-07-12 (T8-1.2g wiring)
Remove when: T8-1.2h implements proper POSIX process management
Status: ACTIVE

UOS-STUB-T8-1.2b — POSIX ABI Memory Management Declarations

Location: kernel/src/core/mm.h
Functions: mm_mmap(), mm_munmap(), mm_mprotect(), mm_madvise(), mm_mremap()
Reason: Declarations added for POSIX_SVC_* syscalls; implementations exist in mm.cpp but were not previously declared
Added: 2026-07-12 (canonical commands fix)
Remove when: T8-2.1 implements proper page-table-backed MM functions
Status: ACTIVE

Pre-existing Stubs (Not Tracked Here)

The following stubs exist in the codebase but were not added by recent work:

kernel/src/arch/armv7/uos_cmm.cpp — PSP init stub (D-1.3)
kernel/src/arch/riscv/guest_loader.cpp — ELF parsing not implemented
kernel/src/arch/aarch64/apple/main_apple.c — SMP, hypervisor, platform driver stubs
kernel/src/platform/drivers/driver.cpp — Various interrupt handler stubs
kernel/src/platform/drivers/usb.h — x86 legacy handoff stub

These are documented in their respective files and are not part of the UOS-STUB tracking system.

How to Add a New Stub

Use the marker convention: UOS-STUB-<TRACK>-<TASK>
Add a comment block with:
- Marker
- Reason
- Date added
- Removal condition
Add an entry to this registry
Use the marker in any runtime messages: [UOS-STUB-<TRACK>-<TASK>]

Example:

/* ============================================================================
 * UOS-STUB: example_function
 * ----------------------------------------------------------------------------
 * Marker: UOS-STUB-T9-1.1
 * Reason: Example reason for the stub
 * Added: 2026-07-12
 * Remove when: T9-1.1 implements the real function
 * ==========================================================================*/
void example_function(void) {
    uart_puts("[UOS-STUB-T9-1.1] example_function: not implemented\n");
}

How to Remove a Stub

Implement the real function
Remove the stub code
Remove the entry from this registry

Verify no references to the marker remain:

grep -rn "UOS-STUB-<TRACK>-<TASK>" kernel/src/

Verification

To verify all stubs are properly marked:

# Find all stub markers
grep -rn "UOS-STUB" kernel/src/ --include="*.c" --include="*.cpp" --include="*.h"

# Find unmarked stubs (should return nothing)
grep -rn "not implemented\|stub" kernel/src/ --include="*.c" --include="*.cpp" --include="*.h" | grep -v "UOS-STUB"

3.1 KiB Raw Blame History