84 lines
3.2 KiB
C
84 lines
3.2 KiB
C
// Native userspace process-loader declarations.
|
|
|
|
#pragma once
|
|
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
#include <ntlite/handle.h>
|
|
#include <ntlite/status.h>
|
|
#include <ntlite/string_view.h>
|
|
#include <ntlite/pe_loader.h>
|
|
#include <ntlite/module_loader.h>
|
|
|
|
#define NTL_PROCESS_LOAD_FLAG_NONE 0x00000000u
|
|
#define NTL_PROCESS_STARTUP_DATA_MAX 1024u
|
|
|
|
// Describes one source capability to duplicate into a constructing child.
|
|
typedef struct NTL_PROCESS_STARTUP_CAPABILITY {
|
|
uint32_t Tag;
|
|
SYS_HANDLE SourceHandle;
|
|
SYS_RIGHTS DesiredRights;
|
|
uint32_t DuplicateFlags;
|
|
} NTL_PROCESS_STARTUP_CAPABILITY;
|
|
|
|
// Creates and starts one PE32+ process entirely through the userspace image loader.
|
|
typedef struct NTL_CREATE_PROCESS_AT_REQUEST {
|
|
uint32_t Size;
|
|
uint32_t Flags;
|
|
SYS_HANDLE RootHandle;
|
|
SYS_STRING_VIEW Path;
|
|
SYS_STRING_VIEW CommandLine;
|
|
// Empty inherits the caller's userspace CWD; non-empty is normalized as a native resource path.
|
|
SYS_STRING_VIEW CurrentDirectory;
|
|
SYS_HANDLE SecurityContext;
|
|
SYS_HANDLE ModuleRootHandle;
|
|
SYS_STRING_VIEW ModuleDirectory;
|
|
NTL_MODULE_NAME_RESOLVER ResolveModuleName;
|
|
void* ResolveContext;
|
|
const NTL_PROCESS_STARTUP_CAPABILITY* StartupCapabilities;
|
|
uint32_t StartupCapabilityCount;
|
|
// Optional opaque userspace bootstrap data copied into the child's read-only loader block.
|
|
const void* StartupData;
|
|
size_t StartupDataSize;
|
|
SYS_HANDLE* ProcessHandleOut;
|
|
} NTL_CREATE_PROCESS_AT_REQUEST;
|
|
|
|
// Creates one process beneath the globally published /SystemRoot volume. Path remains a
|
|
// canonical volume-relative native path; RSSRV is used only to obtain the volume capability.
|
|
typedef struct NTL_CREATE_SYSTEM_PROCESS_REQUEST {
|
|
uint32_t Size;
|
|
uint32_t Flags;
|
|
// Optional pre-opened executable file. When supplied, Path is diagnostic/PEB identity only.
|
|
SYS_HANDLE ImageFile;
|
|
SYS_STRING_VIEW Path;
|
|
SYS_STRING_VIEW CommandLine;
|
|
// Empty inherits the caller's userspace CWD; non-empty is normalized as a native resource path.
|
|
SYS_STRING_VIEW CurrentDirectory;
|
|
SYS_HANDLE SecurityContext;
|
|
NTL_MODULE_NAME_RESOLVER ResolveModuleName;
|
|
void* ResolveContext;
|
|
const NTL_PROCESS_STARTUP_CAPABILITY* StartupCapabilities;
|
|
uint32_t StartupCapabilityCount;
|
|
// Optional opaque userspace bootstrap data copied into the child's read-only loader block.
|
|
const void* StartupData;
|
|
size_t StartupDataSize;
|
|
SYS_HANDLE* ProcessHandleOut;
|
|
} NTL_CREATE_SYSTEM_PROCESS_REQUEST;
|
|
|
|
#if defined(NTL_SYSCALL_STATIC)
|
|
#define NTL_PROCESS_LOADER_API
|
|
#elif defined(NTL_SYSCALL_BUILD)
|
|
#define NTL_PROCESS_LOADER_API __declspec(dllexport)
|
|
#else
|
|
#define NTL_PROCESS_LOADER_API
|
|
#endif
|
|
|
|
NTL_PROCESS_LOADER_API KSTATUS NtlCreateProcessAt(const NTL_CREATE_PROCESS_AT_REQUEST* request);
|
|
NTL_PROCESS_LOADER_API KSTATUS NtlCreateSystemProcess(const NTL_CREATE_SYSTEM_PROCESS_REQUEST* request);
|
|
// Copies the optional opaque startup data supplied by the userspace process builder.
|
|
NTL_PROCESS_LOADER_API KSTATUS NtlGetProcessStartupData(void* buffer,
|
|
size_t bufferSize,
|
|
size_t* sizeOut);
|
|
|
|
#undef NTL_PROCESS_LOADER_API
|