How trungnt2910/lxmonika works
Project type and purpose
• This is a multi‐component, system‐level compatibility layer for Windows that implements Linux‐style syscalls and execution environments (“Just Monika”).
• It consists of two kernel‐mode drivers (lxmonika and mxss), a stub library (lxstub), a command‐line/service tool (monika), plus a sample host and demo (mxss/monix & mxss/mxhost).
• The goal is to let user‐mode Linux‐style processes call into Windows via a custom driver, manage that driver, and host Linux binaries.
File structure
Top‐level solution (lxmonika.sln)
• lxmonika/ → Windows kernel‐mode driver (monika.sys)
– include/ → public driver API headers
– include_private/ → driver internals (modules, logger, OS abstractions)
– src/ → driver entry, dispatch, context, providers, reality (syscall translations)
– lxmonika.vcxproj & INF, RC, PROPS, TARGETS → build & installer
• lxstub/ → user‐mode stub DLL that Linux binaries link against
– include/ → stub API (lxss.h, pico.h)
– src/ → thin shim forwarding calls to the kernel driver
– lxstub.vcxproj → build project
• monika/ → management utility (CLI + Windows service)
– include/, src/ → commands (install, uninstall, exec), parameters, registry, service logic
– monika.vcxproj, RC → build project & resources
• mxss/ → second subsystem with its own driver and host
– mxss/ → MXSS driver (structure similar to lxmonika)
– monix/ → sample Linux “hello” application & build script
– mxhost/ → host launcher for Linux binaries
README for additional insights
• While minimal, the monika README confirms the “Just Monika” branding and directs contributors to Discord.
• Each subfolder has its own README describing build or purpose (e.g., mxss/README.md).
Detailed coverage
• Be exhaustive: list both public include directories and private internals.
• Four projects and their interactions.
• External dependencies only if they exist (none beyond Windows kernel and standard C++).