nt-lite/code/user/tests/process_builder_smoke/process_builder_smoke.c

// Userspace process-builder smoke test for inert construction inputs and child bootstrap vectors.

#include <ntlite/syscall.h>
#include <ntlite/path.h>
#include <ntlite/process_loader.h>
#include <stdint.h>
#include <stddef.h>
#include <string.h>

#define TEST_STARTUP_EVENT_TAG 0x50425445u
#define TEST_STARTUP_WORD 0x31503550u

// Exits without relying on a hosted runtime.
static void exit_now(int code) {
    for (;;) SysExitProcess(code);
}

// Compares one native string view with a C string.
static int view_equals_cstr(SYS_STRING_VIEW view, const char* text) {
    size_t length = strlen(text);
    return view.Length == length && (!length || memcmp(view.Data, text, length) == 0);
}

// Detects the child instance through the diagnostic command line.
static int is_child(void) {
    SYS_PEB* peb = SysGetPeb();
    static const char marker[] = "process-builder-child";
    return peb && peb->CommandLine.Length == sizeof(marker) - 1u &&
           memcmp(peb->CommandLine.Data, marker, sizeof(marker) - 1u) == 0;
}

// Verifies the serialized generic argv/envp vectors and opaque startup data.
static void verify_child_bootstrap(void) {
    uint32_t count = 0;
    SYS_STRING_VIEW entry;
    if (NtlGetProcessArgumentCount(&count) != NTLSTATUS_SUCCESS || count != 3u) exit_now(20);
    if (NtlGetProcessArgument(0, &entry) != NTLSTATUS_SUCCESS ||
        !view_equals_cstr(entry, "process_builder_smoke")) exit_now(21);
    if (NtlGetProcessArgument(1, &entry) != NTLSTATUS_SUCCESS ||
        !view_equals_cstr(entry, "vector-child")) exit_now(22);
    if (NtlGetProcessArgument(2, &entry) != NTLSTATUS_SUCCESS ||
        !view_equals_cstr(entry, "arg two")) exit_now(23);

    if (NtlGetProcessEnvironmentCount(&count) != NTLSTATUS_SUCCESS || count != 2u) exit_now(24);
    if (NtlGetProcessEnvironment(0, &entry) != NTLSTATUS_SUCCESS ||
        !view_equals_cstr(entry, "P5_TEST=builder")) exit_now(25);
    if (NtlGetProcessEnvironment(1, &entry) != NTLSTATUS_SUCCESS ||
        !view_equals_cstr(entry, "EMPTY=")) exit_now(26);

    uint32_t startupWord = 0;
    size_t startupSize = 0;
    if (NtlGetProcessStartupData(&startupWord, sizeof(startupWord), &startupSize) != NTLSTATUS_SUCCESS ||
        startupSize != sizeof(startupWord) || startupWord != TEST_STARTUP_WORD)
        exit_now(27);
}

// Runs the child half and signals the inherited parent event after validation.
static void run_child(void) {
    SYS_HANDLE event = SysGetStartupCapability(TEST_STARTUP_EVENT_TAG);
    if (event == SYS_HANDLE_INVALID) exit_now(10);
    verify_child_bootstrap();
    if (SysSignalEvent(event) != NTLSTATUS_SUCCESS) exit_now(11);
    exit_now(0);
}

// Runs the parent half through the reusable userspace process builder wrapper.
static int run_parent(void) {
    SYS_PEB* peb = SysGetPeb();
    if (!peb || peb->Magic != SYS_PEB_MAGIC || peb->Version != SYS_ENV_VERSION)
        return 1;

    SYS_HANDLE imageFile = SYS_HANDLE_INVALID;
    KSTATUS status = NtlOpenFile(peb->ImagePath,
                                 SYS_FILE_ACCESS_READ | SYS_FILE_ACCESS_QUERY,
                                 SYS_FILE_OPEN_EXISTING,
                                 SYS_FILE_FLAG_NONE,
                                 &imageFile);
    if (!KSUCCESS(status)) return 2;

    SYS_HANDLE event = SYS_HANDLE_INVALID;
    status = SysCreateEvent(0, 0, &event);
    if (!KSUCCESS(status)) {
        (void)SysCloseHandle(imageFile);
        return 3;
    }

    NTL_PROCESS_STARTUP_CAPABILITY startupCapability;
    memset(&startupCapability, 0, sizeof(startupCapability));
    startupCapability.Tag = TEST_STARTUP_EVENT_TAG;
    startupCapability.SourceHandle = event;
    startupCapability.DesiredRights = SYS_EVENT_RIGHT_SIGNAL | SYS_RIGHT_QUERY;
    startupCapability.DuplicateFlags = SYS_DUPLICATE_HANDLE_FLAG_NONE;

    SYS_STRING_VIEW arguments[] = {
        SYS_SV_LITERAL("process_builder_smoke"),
        SYS_SV_LITERAL("vector-child"),
        SYS_SV_LITERAL("arg two")
    };
    SYS_STRING_VIEW environment[] = {
        SYS_SV_LITERAL("P5_TEST=builder"),
        SYS_SV_LITERAL("EMPTY=")
    };
    uint32_t startupWord = TEST_STARTUP_WORD;
    SYS_HANDLE child = SYS_HANDLE_INVALID;

    NTL_CREATE_SYSTEM_PROCESS_REQUEST request;
    memset(&request, 0, sizeof(request));
    request.Size = sizeof(request);
    request.Flags = NTL_PROCESS_LOAD_FLAG_NONE;
    request.ImageFile = imageFile;
    request.Path = peb->ImagePath;
    request.CommandLine = SYS_SV_LITERAL("process-builder-child");
    request.SecurityContext = SYS_SECURITY_CONTEXT_CURRENT;
    request.ResolveModuleName = NtlResolveSystemModuleName;
    request.StartupCapabilities = &startupCapability;
    request.StartupCapabilityCount = 1u;
    request.Arguments.Entries = arguments;
    request.Arguments.Count = (uint32_t)(sizeof(arguments) / sizeof(arguments[0]));
    request.Environment.Entries = environment;
    request.Environment.Count = (uint32_t)(sizeof(environment) / sizeof(environment[0]));
    request.StartupData = &startupWord;
    request.StartupDataSize = sizeof(startupWord);
    request.ProcessHandleOut = &child;
    status = NtlCreateSystemProcess(&request);
    (void)SysCloseHandle(imageFile);
    if (!KSUCCESS(status)) {
        (void)SysCloseHandle(event);
        return 4;
    }

    status = SysWait(event, SYS_WAIT_FLAG_NONE);
    if (!KSUCCESS(status)) {
        (void)SysKillProcess(child, (int32_t)NTLSTATUS_PROCESS_KILLED);
        (void)SysCloseHandle(child);
        (void)SysCloseHandle(event);
        return 5;
    }
    status = SysWait(child, SYS_WAIT_FLAG_NONE);
    if (!KSUCCESS(status)) {
        (void)SysCloseHandle(child);
        (void)SysCloseHandle(event);
        return 6;
    }

    int32_t exitCode = -1;
    status = SysGetProcessExitCode(child, &exitCode);
    (void)SysCloseHandle(child);
    (void)SysCloseHandle(event);
    if (!KSUCCESS(status) || exitCode != 0) return 7;
    return 0;
}

// Exercises generic userspace process construction in parent and child roles.
int main(void) {
    if (is_child()) run_child();
    return run_parent();
}