First Service Extractions

Stand up a ring-3 console service endpoint. Why it matters: Phase 52 is only meaningful if the console becomes a real userspace service with its own endpoint and registration path instead of remaining a kernel-only concept. Focus on `program_main` and `console_server` in `userspace/console_server/src/main.rs` while you trace the snippet.

fn program_main(_args: &[&str]) -> i32 {
    syscall_lib::write_str(STDOUT_FILENO, "console_server: starting\n");

    // Phase 52 transitional: skip framebuffer_mmap because it calls
    // try_yield_console which suppresses ALL kernel framebuffer text output
    // (login prompt, shell, everything).  The kernel's fb console still
    // handles sys_write rendering.  The userspace console_server runs as an
    // IPC-only service: CONSOLE_WRITE payloads are echoed to stdout which
    // the kernel renders to both serial and framebuffer.
    //
    // Full framebuffer takeover will be enabled in a later phase when
    // sys_write(STDOUT) is routed through IPC to this service.

    // 1. Create an IPC endpoint.
    let ep_handle = syscall_lib::create_endpoint();
    if ep_handle == u64::MAX {
        syscall_lib::write_str(STDOUT_FILENO, "console_server: create_endpoint failed\n");
        return 1;
    }
    let ep_handle = ep_handle as u32;

    // 2. Register as "console" service (takes over from kernel entry).
    let ret = syscall_lib::ipc_register_service(ep_handle, "console");
    if ret == u64::MAX {

View on GitHub

Move keyboard IRQ service ownership to ring 3. Why it matters: This is the first completed hardware-facing service extraction in Phase 52: IRQ-driven keyboard delivery no longer depends on a kernel-resident kbd_server_task. Focus on `program_main` and `kbd_server_task` in `userspace/kbd_server/src/main.rs` while you trace the snippet.

fn program_main(_args: &[&str]) -> i32 {
    syscall_lib::write_str(STDOUT_FILENO, "kbd_server: starting\n");

    // 1. Create an IPC endpoint.
    let ep_handle = syscall_lib::create_endpoint();
    if ep_handle == u64::MAX {
        syscall_lib::write_str(STDOUT_FILENO, "kbd_server: failed to create endpoint\n");
        return 1;
    }
    let ep_handle = ep_handle as u32;

    // 2. Register as "kbd" in the service registry.
    let ret = syscall_lib::ipc_register_service(ep_handle, "kbd");
    if ret == u64::MAX {
        syscall_lib::write_str(STDOUT_FILENO, "kbd_server: failed to register 'kbd'\n");
        return 1;
    }

    // 3. Create an IRQ1 notification.
    let notif_cap = syscall_lib::create_irq_notification(1);
    if notif_cap == u64::MAX {
        syscall_lib::write_str(
            STDOUT_FILENO,
            "kbd_server: failed to create IRQ1 notification\n",

View on GitHub

Bridge keyboard IPC back into the existing stdin path. Why it matters: Existing userspace still reads stdin through the traditional TTY path, so Phase 52 needs a bridge from the new keyboard IPC service back into the shared kernel line discipline. Focus on `program_main` and `sys_push_raw_input` in `userspace/stdin_feeder/src/main.rs` while you trace the snippet.

fn program_main(_args: &[&str]) -> i32 {
    syscall_lib::write_str(STDOUT_FILENO, "stdin_feeder: starting\n");

    // Look up the "kbd" service to obtain an endpoint capability.
    // Retry with short sleeps because the service manager starts us as soon
    // as kbd_server is forked, which is before it has registered its IPC
    // endpoint.
    let kbd_handle = {
        let mut h = u64::MAX;
        for _ in 0..50 {
            h = syscall_lib::ipc_lookup_service("kbd");
            if h != u64::MAX {
                break;
            }
            syscall_lib::nanosleep(20_000_000); // 20 ms
        }
        if h == u64::MAX {
            syscall_lib::write_str(STDOUT_FILENO, "stdin_feeder: failed to lookup 'kbd'\n");
            return 1;
        }
        h as u32
    };

    syscall_lib::write_str(STDOUT_FILENO, "stdin_feeder: ready\n");

View on GitHub