SleelaDoc API
HTML documentation for the SLeeLa standard library (/lib)
Home › Packages › operating-system

Package operating-system

This package contains 91 source unit(s) defining 102 class(es) / struct(s). Each unit below lists its fields (the values it stores) and methods (the actions it performs), with a plain explanation of each.

distro-source #sleela 2.5 (lib/operating-system/distro-source.sleela)

Source class

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
hasSubmodulesint hasSubmodulesNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
dirForString dirFor(String layer)No description in source.
referenceSheetString referenceSheet()No description in source.

Fetch class

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
srcSource srcNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
cloneCommandString cloneCommand(String destDir)No description in source.
probeint probe()No description in source.

DistroSourceDemo class

Methods — the actions this unit can perform.

MethodSignatureWhat it does
bannervoid banner(String t)No description in source.
mainvoid main()No description in source.

linux-creator #sleela 2.5 (lib/operating-system/examples/linux/linux-creator.sleela)

Model struct

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

LinuxCreator class

Methods — the actions this unit can perform.

MethodSignatureWhat it does
linuxModel linux(String name, String version)No description in source.
identityString identity(Model m)No description in source.
readyToCompileboolean readyToCompile(Model m)---- readiness gate: URLs + settings present before compile ---------
packageRepoString packageRepo(Model m)No description in source.
kernelSrcString kernelSrc(Model m)No description in source.
configHeaderString configHeader(Model m)---- emitted artifacts (what the OS Creator writes) -----------------
baseDriversString baseDrivers(Model m)No description in source.
downloadsString downloads(Model m)No description in source.
settingsString settings(Model m)No description in source.
compatString compat(Model m)No description in source.
bannervoid banner(String t)No description in source.
mainvoid main()No description in source.

machine-build #sleela 2.5 (lib/operating-system/machine-build.sleela)

Part struct

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Machine struct

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
memModulesint memModulesNo description in source.

MachineBuilder class

Methods — the actions this unit can perform.

MethodSignatureWhat it does
intToStrString intToStr(int v)No description in source.
partPart part(String cls, String vendor, String model, String spec, int sizeUnits)No description in source.
ddrPart ddr(String vendor, String gen, int capacityMb)DDR module: sizeUnits = capacity in MB. spec = generation name.
ssdPart ssd(String vendor, String model, String iface, int capacityGb)SSD: sizeUnits = capacity in GB. spec = interface name.
hddPart hdd(String vendor, String model, int capacityGb)HDD: sizeUnits = capacity in GB. spec = "RPM/iface".
uefiPart uefi(String vendor, String product)No description in source.
usbControllerPart usbController(String vendor, String gen, int ports)No description in source.
gpuPart gpu(String vendor, String model, int vramMb)No description in source.
machineMachine machine(String name)No description in source.
totalMemMbint totalMemMb(Machine m)Total installed memory (MB) across modules.
memoryWordsint memoryWords(Machine m)VM memory words from installed MB at the machine's word width.
bootBlocksint bootBlocks(Machine m)VM block count from the boot device's GB capacity at 4096-byte blocks.
bannervoid banner(String title)No description in source.
printPartvoid printPart(Machine m, String label, Part p)No description in source.
mainvoid main()No description in source.

macos-creator #sleela 2.5 (lib/operating-system/examples/macos/macos-creator.sleela)

Model struct

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

MacosCreator class

Methods — the actions this unit can perform.

MethodSignatureWhat it does
macosModel macos(String name, String version)No description in source.
identityString identity(Model m)No description in source.
readyToCompileboolean readyToCompile(Model m)No description in source.
packageRepoString packageRepo(Model m)No description in source.
kernelSrcString kernelSrc(Model m)No description in source.
configHeaderString configHeader(Model m)No description in source.
baseDriversString baseDrivers(Model m)No description in source.
downloadsString downloads(Model m)No description in source.
settingsString settings(Model m)No description in source.
compatString compat(Model m)macOS has no FS interpreter; it runs Windows (Wine) and Linux (Lima VM) guests; Rosetta 2 translates x86-64 within the macOS world.
bannervoid banner(String t)No description in source.
mainvoid main()No description in source.

os-build #sleela 2.5 (lib/operating-system/os-build.sleela)

OsModel struct

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

OsBuilder class

Methods — the actions this unit can perform.

MethodSignatureWhat it does
intToStrString intToStr(int v)No description in source.
shapeOsModel shape(String name, String version, String family)OOD extrapolation: fill an OsModel with a shape's defaults, then refine.
identityString identity(OsModel m)No description in source.
emitConfigHeaderString emitConfigHeader(OsModel m)--- C backend: the generated configuration header -------------------
emitOsImageString emitOsImage(OsModel m)--- C++ backend: the OsImage that composes the boot chain -----------
emitIsoRecipeString emitIsoRecipe(OsModel m)--- ISO backend: the xorriso build recipe ---------------------------
emitInstallerString emitInstaller(OsModel m)--- Installer backend: the per-shape installer ----------------------
lowerString lower(String shape)No description in source.
bannervoid banner(String title)No description in source.
mainvoid main()No description in source.

os-creator #sleela 2.5 (lib/operating-system/os-creator/os-creator.sleela)

Os struct

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

OsCreatorDemo class

Methods — the actions this unit can perform.

MethodSignatureWhat it does
linuxOs linux(String name, String version)No description in source.
identityString identity(Os o)No description in source.
bannervoid banner(String t)No description in source.
printLayoutvoid printLayout(Os o)The /os-development layout OS Creator(TM) writes.
osLoaderCString osLoaderC(Os o)A representative emitted piece: the OS loader (PID 1) C surface.
osLoaderCppString osLoaderCpp(Os o)No description in source.
makefileTargetString makefileTarget(Os o)No description in source.
regenSourceString regenSource(Os o)No description in source.
mainvoid main()No description in source.

os-generate #sleela 2.5 (lib/operating-system/os-generate.sleela)

Upstream class

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
referenceSheetString referenceSheet()No description in source.
fetchScriptString fetchScript()The opt-in shallow fetch script written into the tree.

OsModel struct

No public fields or methods detected (the unit may be a facade or a pure contract).

OsGenerator class

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
rootString rootoutput root
manifestString manifest"bytes path" index
fileCountint fileCountNo description in source.
upstreamUpstream upstreamfield dispatch (1.11)

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String outputRoot)No description in source.
makeDirint makeDir(String rel)No description in source.
writeFileint writeFile(String rel, String contents)Write one file relative to root; records bytes in the manifest.
identityString identity(OsModel m)No description in source.
linuxOsModel linux(String name, String version, String arch, String kernelVer)No description in source.
resolveKernelString resolveKernel(String sel)Resolve a requested Linux kernel selection to a concrete version (compact mirror of SLKernelCatalog.resolveLinux). "" / "default" -> the LTS default.
execTranslateHeaderString execTranslateHeader(OsModel m)The foreign-executable (cross-OS) policy header for the Linux shape: a Linux image can run Windows .exe via binfmt_misc + Wine, and cross-arch ELF via QEMU-user. Compact mirror of SLExecutableTranslator for the Linux host.
compatLoaderCString compatLoaderC(OsModel m)The foreign-executable compatibility loader for the Linux shape: load the OS components (binfmt_misc + Wine/Darling/QEMU + guest libraries) so this Linux OS runs Windows .exe and macOS executables. Compact mirror of SLCompatLoaderEmitter for the Linux host (runs Windows + macOS guests).
compatConfString compatConf(OsModel m)No description in source.
baseDriversTableCString baseDriversTableC(OsModel m)The minimum-boot base-driver series table for the Linux shape, plugging into os/base_drivers.h. Compact mirror of SLBaseDriverEmitter for Linux.
downloadsConfString downloadsConf(OsModel m)The resolved download URLs for the Linux build, by phase (compile|iso). Mirror of SLDownloadSet.downloadManifest for the Linux shape.
supportUrlsConfString supportUrlsConf(OsModel m)The support-URL table: for each component, the prioritized mirrors tried if the primary 404s (authoritative -> official-mirror -> college/edu -> archive). Compact mirror of SLSupportDownloader for the Linux build.
fetchResilientShString fetchResilientSh(OsModel m)The resilient fetch script: each component tries its mirrors in priority order and falls through on 404/failure to the next. Mirror of SLDownloadSet.supportFetchScript (compile phase).
fetchDownloadsShString fetchDownloadsSh(OsModel m)The opt-in fetch script for the related downloads (compile-phase sources).
osConfString osConf(OsModel m)The global settings header + the kernel command line settings file.
cmdlineConfString cmdlineConf(OsModel m)No description in source.
baseDriversConfString baseDriversConf(OsModel m)No description in source.
swapConfString swapConf(OsModel m)Swap configuration for the Linux shape: a zstd-compressed swap at 1.0x RAM with a conservative swappiness. Mirror of SLSwapConfig.emitLinux (file kind here; a builder can switch to zram/zswap via SLSwapConfig).
filesystemsConfString filesystemsConf(OsModel m)The filesystem (file-table) type note for the Linux shape: the chosen root filesystem plus the catalogue of still-used table types a builder can pick.
execTypesHeaderString execTypesHeader(OsModel m)The executable file-type table for Linux (compact mirror of SLExecutableTypes.emitExecTypesHeader for the Linux shape).
configHeaderString configHeader(OsModel m)---- the emitted Linux-level sources --------------------------------
bootUnitString bootUnit(OsModel m)No description in source.
osImageString osImage(OsModel m)No description in source.
osLoaderCString osLoaderC(OsModel m)No description in source.
isoRecipeString isoRecipe(OsModel m)No description in source.
makefileString makefile(OsModel m)No description in source.
buildShString buildSh(OsModel m)No description in source.
generatevoid generate(OsModel m)---- materialise the whole tree -------------------------------------
paramString param(String envName, String fallback)Read a build parameter from the environment, or fall back to a default.
mainvoid main()No description in source.

os-sensitivity-fetch #sleela 2.5 (lib/operating-system/os-sensitivity-fetch.sleela)

OsSensitivityFetch class

Methods — the actions this unit can perform.

MethodSignatureWhat it does
paramString param(String name, String fallback)No description in source.
mainvoid main()No description in source.

os-theme-demo #sleela 2.5 (lib/operating-system/os-theme-demo.sleela)

OsThemeDemo class

Methods — the actions this unit can perform.

MethodSignatureWhat it does
printThemevoid printTheme(SLDesktopTheme t)No description in source.
mainvoid main()No description in source.

SLArchitectureSet #sleela 2.5 (lib/operating-system/SLArchitectureSet.sleela)

SLArchitectureSet class

Defines SLArchitectureSet — the set of target CPU architectures an OS being constructed is built for. A modern distribution is multi-arch: the same OS composition is realised for amd64, arm64, and others. This class holds a primary architecture plus a manifest of additional targets, so the ISO builder can emit one image per architecture from a single model. It composes SLOSArchitecture (one entry per target) and records the primary target the single-ISO path uses when the caller does not ask for every arch. Family: operating-system. Pure design model; no native bridge calls.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
primarySLOSArchitecture primaryNo description in source.
targetsString targetsnewline-separated package-arch labels
countint countNo description in source.
configuredint configuredNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(SLOSArchitecture primaryArch)No description in source.
configureLabelvoid configureLabel(String arch)Convenience: configure directly from a package-arch label.
addTargetvoid addTarget(String arch)Add another target architecture by label.
primaryArchSLOSArchitecture primaryArch()No description in source.
targetManifestString targetManifest()No description in source.
targetCountint targetCount()No description in source.
isMultiArchboolean isMultiArch()No description in source.

SLBaseDriverEmitter #sleela 2.5 (lib/operating-system/os-creator/SLBaseDriverEmitter.sleela)

SLBaseDriverEmitter class

Defines SLBaseDriverEmitter — the OS Creator(TM) emitter for the minimum-boot BASE DRIVER series. Given an SLOSModel (its SLBaseDriverSeries and SLDriverSource), it emits the generated driver-table source that plugs into the hand-written /os/base_drivers.{h,c,cpp}: a base_drivers_table.c defining the ordered sleela_driver[] series (bus, storage, display, keyboard, mouse, usb, audio) with each driver's phase (boot|early) and origin, the host-family accessor, and the series count. It also emits a base-drivers.conf describing the series and the driver-source policy (unknown-source + foreign/cross-OS bridge). This is the OS Creator realisation of SLBaseDriverSeries + SLDriverSource: the design model names the drivers and the policy; this emitter writes the table the kernel brings up at boot. It mirrors SLOSLoaderEmitter. Family: operating-system. OS Creator(TM) piece emitter; consumes SLOSModel's base-driver series + driver policy, fills SLOSPiece.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
emitSLOSPiece emit(SLOSModel m)No description in source.
rowString row(String cls, String name, boolean boot)A C row with the series' default (boot-origin in-tree) phase derived from canBoot for the bus; the rest use rowPhase.
rowPhaseString rowPhase(String cls, String name, String phase)No description in source.
cppRowString cppRow(String cls, String name, String phase)No description in source.
cEscapeString cEscape(String s)Driver names here contain no quotes/backslashes, but keep the escape honest.
unknownAllowedboolean unknownAllowed(SLDriverSource pol)No description in source.
foreignAllowedboolean foreignAllowed(SLDriverSource pol)No description in source.
boolLitString boolLit(boolean b)No description in source.

SLBaseDriverSeries #sleela 2.5 (lib/operating-system/SLBaseDriverSeries.sleela)

SLBaseDriverSeries class

Defines SLBaseDriverSeries — the minimum-boot driver series an OS needs to come up: the irreducible set of device drivers that must be present (built into the kernel or in the initramfs) for first bootup, plus the early input/console drivers a user needs at the console. It names, per class, the motherboard/chipset bus, the storage controller (so the kernel can reach the root filesystem), the input devices (keyboard, mouse), the display/console, USB host, and audio, and marks which are REQUIRED for boot vs. merely early-available. In the firmware -> boot -> kernel -> userspace -> desktop model this refines the kernel's driver node for the earliest phase: the "can we even boot and interact" set, distinct from the fuller SLDriverSet. SLOSModel composes one; the OS Creator's SLBaseDriverEmitter turns it into real driver-table C/C++. Family: operating-system. Pure design model; the series is consumed by the kernel/initramfs emitters. No native bridge calls.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
configuredint configuredNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
forShapevoid forShape(SLOSShape shape)Seed the minimum-boot series for a shape. The bus + storage + console + keyboard are REQUIRED at boot; USB and mouse are early-available; audio is non-boot. Driver names reflect each family's real early drivers.
setBusvoid setBus(String n, boolean boot)---- Setters -------------------------------------------------------
setStoragevoid setStorage(String n, boolean boot)No description in source.
setKeyboardvoid setKeyboard(String n, boolean boot)No description in source.
setMousevoid setMouse(String n, boolean boot)No description in source.
setDisplayvoid setDisplay(String n, boolean boot)No description in source.
setUsbvoid setUsb(String n, boolean boot)No description in source.
setAudiovoid setAudio(String n, boolean boot)No description in source.
bint b(boolean x)No description in source.
canBootboolean canBoot()---- Validity ------------------------------------------------------ A series can boot only with the irreducible trio: a bus to enumerate hardware, a storage controller to reach the rootfs, and a keyboard for the console. Display is strongly expected; audio/mouse/usb are not required.
bootRequiredCountint bootRequiredCount()Count of boot-required drivers present.
seriesManifestString seriesManifest()---- Manifest ------------------------------------------------------ Newline "class name boot" lines (boot = boot|early) for the emitters.
lineString line(String acc, String cls, String name, int boot)No description in source.
busString bus()Accessors for the emitters.
storageString storage()No description in source.
keyboardString keyboard()No description in source.
mouseString mouse()No description in source.
displayString display()No description in source.
usbString usb()No description in source.
audioString audio()No description in source.

SLBIOSEmitter #sleela 2.5 (lib/operating-system/os-creator/SLBIOSEmitter.sleela)

SLBIOSEmitter class

Defines SLBIOSEmitter — the OS Creator(TM) emitter for the legacy BIOS / Compatibility Support Module piece. Given an SLOSModel it produces the C and C++ source for a legacy boot path: a C entry that reads the Master Boot Record, loads the first-stage boot sector, and jumps to it, plus a bios.cfg recording whether the CSM is enabled for this build. On UEFI-only builds the piece is still emitted as a documented, inert fallback so the project can target legacy hardware when CSM is turned on. This is piece #2 of the chain (the legacy sibling of UEFI). Output is String concatenation on OP_ADD; no new VM opcode is used. Family: operating-system. OS Creator(TM) piece emitter; consumes SLOSModel, fills SLOSPiece.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
emitSLOSPiece emit(SLOSModel m)No description in source.
boolLitString boolLit(boolean b)No description in source.

SLBootLoaderEmitter #sleela 2.5 (lib/operating-system/os-creator/SLBootLoaderEmitter.sleela)

SLBootLoaderEmitter class

Defines SLBootLoaderEmitter — the OS Creator(TM) emitter for the boot-loader piece. Given an SLOSModel it produces the C and C++ source for a boot loader shaped like the model's loader (GRUB for Linux, BOOTMGR for Windows, boot.efi for macOS): it reads its own configuration, presents a boot menu, selects the default entry, and hands off to the kernel loader. It also emits a loader.conf menu file (grub.cfg / BCD / com.apple.Boot- style) carrying the entry, the kernel command line, and the timeout. This is piece #3 of the chain. Output is String concatenation on OP_ADD. Family: operating-system. OS Creator(TM) piece emitter; consumes SLOSModel, fills SLOSPiece.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
emitSLOSPiece emit(SLOSModel m)No description in source.
loaderMenuString loaderMenu(String loader, SLOSModel m)No description in source.

SLBootloaderSpec #sleela 2.5 (lib/operating-system/SLBootloaderSpec.sleela)

SLBootloaderSpec class

Defines SLBootloaderSpec — the firmware/boot layer of an OS being constructed. It records how the target OS is handed control by firmware and reaches its kernel: the firmware interface (UEFI or legacy BIOS), the boot loader used (GRUB for Linux shapes, BOOTMGR for Windows shapes, boot.efi for macOS shapes), whether Secure Boot is required, and the EFI System Partition layout. It also carries the initramfs/initrd decision for shapes that stage an early userspace before the root filesystem is mounted. In the firmware -> boot -> kernel -> userspace -> desktop model, this is the node between firmware and kernel. The ISO builder writes the ESP, installs the loader, and points it at the kernel the SLKernelSpec names. Family: operating-system. Pure design model; no native bridge calls.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
firmwareString firmware"UEFI" or "BIOS"
loaderString loader"GRUB" / "BOOTMGR" / "boot.efi" / "systemd-boot"
secureBootint secureBoot1 require Secure Boot
useInitramfsint useInitramfs1 stage an initramfs/initrd early userspace
espLabelString espLabelEFI System Partition volume label
timeoutString timeoutmenu timeout, as a string ("5")
configuredint configuredNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String fw, String bootLoader)No description in source.
forShapevoid forShape(SLOSShape shape)Default boot style for a shape (UEFI everywhere on modern hardware).
requireSecureBootvoid requireSecureBoot(boolean on)No description in source.
setTimeoutvoid setTimeout(String seconds)No description in source.
menuTimeoutString menuTimeout()No description in source.
isUefiboolean isUefi()No description in source.
loaderNameString loaderName()No description in source.
firmwareNameString firmwareName()No description in source.
stagesInitramfsboolean stagesInitramfs()No description in source.
isCompleteboolean isComplete()A boot layer is complete when it names a firmware and a loader.

SLCEmitter #sleela 2.5 (lib/operating-system/SLCEmitter.sleela)

SLCEmitter class

Defines SLCEmitter — the C backend of the OS-construction family. Given a configured SLOSModel, it emits C source text that bootstraps the designed OS: a generated os_config.h header carrying the model's identity, shape, kernel command line and boot parameters as #defines, and an os_boot.c early-boot translation unit whose os_early_init() stages the bootloader, mounts the root filesystem, loads the built-in drivers, and starts PID 1 (the service manager the model names). This is the "compiling the Sleela produces C" half of the pipeline: the OS is described once in SLeeLa (the SL* model classes), and this emitter lowers that object model to portable C the native toolchain compiles toward the ISO. All output is ordinary String concatenation on OP_ADD; no new VM opcode is used. Family: operating-system. Consumes SLOSModel and its composed specs.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
intToStrString intToStr(int v)No description in source.
emitConfigHeaderString emitConfigHeader(SLOSModel m)Emit the generated configuration header for the model.
emitBootUnitString emitBootUnit(SLOSModel m)Emit the early-boot C translation unit for the model.
emitBuiltinDriverCallsString emitBuiltinDriverCalls(SLOSModel m)Walk the driver manifest and emit a load_driver() call for each built-in.
containsBuiltinboolean containsBuiltin(String line)---- Small text helpers (manifest lines are "name binding") -------------
driverNameString driverName(String line)No description in source.
strLenint strLen(String s)String primitives wrap the shared native text intrinsics (same contract as lib/cpu/SLCompilerDriver): SLeeLa Strings are Java-style, length+substring.
substrString substr(String s, int a, int b)No description in source.
charAtString charAt(String s, int i)No description in source.
endsWithboolean endsWith(String s, String suf)No description in source.

SLClock #sleela 2.5 (lib/operating-system/SLClock.sleela)

SLClock class

Defines SLClock — the host system clock, as seen from the OS family. It surfaces wall-clock and monotonic time through the VM's time built-ins (timeUtcMillis / timeMonotonicNanos / timeHttpDate), which read the real OS clock (QueryPerformanceCounter + system time on Windows, clock_gettime on POSIX). SLClock belongs to /lib/os because time is an operating-system service; it reuses the time substrate rather than duplicating it. Family: operating-system. Native VM/OS work crosses the explicit time/`os*` SLVM bridge.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
monoStartint monoStartmonotonic reference captured at reset (nanoseconds)

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
nowMillisint nowMillis()Milliseconds since the Unix epoch (UTC wall-clock).
monotonicNanosint monotonicNanos()Monotonic nanoseconds (never goes backward; for durations).
httpDateString httpDate()An RFC 1123 HTTP date string for "now".
locationString location()The host's configured time-zone location.
resetvoid reset()Start a monotonic stopwatch.
elapsedNanosint elapsedNanos()Elapsed nanoseconds since reset().
elapsedMillisint elapsedMillis()Elapsed whole milliseconds since reset().

SLCompatLayer #sleela 2.5 (lib/operating-system/SLCompatLayer.sleela)

SLCompatLayer class

Defines SLCompatLayer — one HOST->GUEST compatibility layer: the

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
hostString hostthe OS doing the running: "Linux"/"Windows"/"macOS"
guestString guestthe OS whose executables we run: "Linux"/"Windows"/"macOS"
loadedint loaded1 once the layer's components are loaded

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String hostOs, String guestOs)No description in source.
normalizeString normalize(String s)No description in source.
hostNameString hostName()No description in source.
guestNameString guestName()No description in source.
isNativeboolean isNative()Same host and guest need no layer (native execution).
runtimeString runtime()---- Which components this host->guest layer requires --------------- runtime(): the primary translation runtime/container for this pair.
fsInterpreterString fsInterpreter()fsInterpreter(): the filesystem-level interpreter facility, when the host has one (only Linux's binfmt_misc). Empty elsewhere.
libraryPackageString libraryPackage()libraryPackage(): the shared-library set the guest's executables link against, which the layer must provide so a library + executable both load.
componentManifestString componentManifest()The ordered component manifest: "<name> <kind>" per line. Kinds: interpreter (FS-level), runtime (translation layer), library (guest libs).
guestLibTokenString guestLibToken()No description in source.
componentCountint componentCount()Number of components this layer loads (interpreter? + runtime + libraries).
loadint load(String runtimePath)---- Load / unload lifecycle ---------------------------------------- load(): bring the layer's components up. On a Linux host this registers the binfmt_misc interpreter (binding the runtime), then marks the layer loaded; elsewhere it marks the container runtime ready. Returns a result code: 0 ok, -1 unsupported (no path for this pair), -2 a required component is absent on the host. Idempotent.
unloadint unload()unload(): tear the layer down. On Linux unregister the binfmt_misc rule; elsewhere drop the ready flag. Returns 0 ok. Idempotent.
isLoadedboolean isLoaded()No description in source.
presentboolean present(String runtimePath)present(runtimePath): is the layer's primary runtime installed on the host right now? (A pre-flight a GUI runs before offering to load it.)
handleString handle(String exePath)---- Handling a foreign executable (or library + executable) -------- handle(exePath): how the loaded layer runs a guest executable. With a registered FS interpreter the file runs directly (the kernel routes it); otherwise it is launched through the runtime. "" if the layer is not loaded.
handlePairString handlePair(String libPath, String exePath)handlePair(libPath, exePath): run an executable that depends on a guest library. The library is made resolvable to the runtime (its loader search path), then the executable is handled. Returned as the composed command.
libEnvString libEnv(String libDir)The environment prefix that adds a guest library dir to the runtime's search path (WINEDLLPATH for Wine, LD_LIBRARY_PATH for ELF, etc.).
binfmtNameString binfmtName()---- binfmt_misc helpers (Linux FS interpreter) ---------------------
binfmtRegisterString binfmtRegister(String interp)No description in source.
guestExtString guestExt()No description in source.
summaryString summary()---- A human/log summary --------------------------------------------

SLCompatLoaderEmitter #sleela 2.5 (lib/operating-system/os-creator/SLCompatLoaderEmitter.sleela)

SLCompatLoaderEmitter class

Defines SLCompatLoaderEmitter — the OS Creator(TM) emitter for the foreign-executable COMPATIBILITY piece. Given an SLOSModel whose SLCompatSet declares guest families to support, it produces the C and C++ source for a "compat loader" userspace component that loads and unloads the OS components needed to run each guest's executables (the kernel binfmt_misc interpreter registration, the translation runtime — Wine/QEMU/WSL/Rosetta/Darling — and the guest shared libraries), and dispatches a foreign executable (or a library + executable) to the right runtime. It emits a compat.conf listing each supported "host runs guest" route and its components. This is the OS Creator realisation of lib/operating-system/SLCompatLayer + SLCompatSet: the design model names the components; this emitter writes the actual loader that registers/handles them in the generated OS. It mirrors SLOSLoaderEmitter. Family: operating-system. OS Creator(TM) piece emitter; consumes SLOSModel's SLCompatSet, fills SLOSPiece.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
emitSLOSPiece emit(SLOSModel m)No description in source.
emitLoadFnString emitLoadFn(SLCompatSet cs)One load block per supported guest route.
loadLineString loadLine(SLCompatSet cs, String guest)No description in source.
emitUnloadFnString emitUnloadFn(SLCompatSet cs)No description in source.
unloadLineString unloadLine(SLCompatSet cs, String guest)No description in source.
emitHandleFnString emitHandleFn()No description in source.
routeInitsString routeInits(SLCompatSet cs)C++ route initialisers, one brace-init per supported guest.
addRouteString addRoute(String acc, SLCompatSet cs, String guest)No description in source.
routeConfString routeConf(SLCompatSet cs, String guest)One "route = ..." conf line per supported guest, built directly from the compat set (no string char-walking needed — the set is the source of truth).

SLCompatSet #sleela 2.5 (lib/operating-system/SLCompatSet.sleela)

SLCompatSet class

Defines SLCompatSet — the compatibility layer of an OS being constructed: the set of foreign-OS execution capabilities the built OS ships, so it can run guest executables (and their libraries) from other OS families. In the firmware -> boot -> kernel -> userspace -> desktop model this is a userspace capability node; SLOSModel composes one, and the OS Creator's SLCompatLoaderEmitter turns it into real OS components. The set is keyed by the OS's own shape (its host family) and records which guest families it supports running, each realised by an SLCompatLayer (binfmt_misc + Wine/QEMU/WSL/Rosetta/Darling + the guest libraries). A Linux variant that wants to run Windows .exe adds the "Windows" guest; forShape() seeds the common defaults for the host family. Family: operating-system. Composes SLCompatLayer (up to three guests). Pure design model for composition/validity; the layers' own load/unload cross the os* bridge.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
hostString hostthe built OS's own family
linuxGuestSLCompatLayer linuxGuestUp to three guest layers (Linux/Windows/macOS). Fixed slots keep the model array-free; an unused slot has an empty guest.
windowsGuestSLCompatLayer windowsGuestNo description in source.
macGuestSLCompatLayer macGuestNo description in source.
hasLinuxint hasLinuxNo description in source.
hasWindowsint hasWindowsNo description in source.
hasMacint hasMacNo description in source.
configuredint configuredNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String hostFamily)No description in source.
normString norm(String s)No description in source.
forShapevoid forShape(SLOSShape shape)Seed the common foreign-exec defaults for the host family. A Linux build ships Windows (Wine) + macOS (Darling) support; a Windows build ships Linux (WSL2); a macOS build ships Windows (Wine) + Linux (Lima). Refine with support()/drop() afterward.
supportvoid support(String guestFamily)Add support for running a guest family's executables on this OS.
dropvoid drop(String guestFamily)Remove a previously added guest.
supportsboolean supports(String guestFamily)No description in source.
layerForSLCompatLayer layerFor(String guestFamily)The layer object for a guest family (null if not supported). Lets a caller load/unload/handle through it.
guestCountint guestCount()No description in source.
hasAnyboolean hasAny()No description in source.
hostNameString hostName()No description in source.
compatManifestString compatManifest()A newline manifest "<host> runs <guest> via <runtime>" per supported guest, for the generated config and for logs.
addString add(String acc, String line)No description in source.

SLConfigSet #sleela 2.5 (lib/operating-system/SLConfigSet.sleela)

SLConfigSet class

Defines SLConfigSet — the assorted and specific CONFIGURATION

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
PHASE_COMPILEstatic final int PHASE_COMPILE = 0Phase: when the config file must be present.
PHASE_ISOstatic final int PHASE_ISO = 1No description in source.
wantOsConfint wantOsConfWell-known settings files: 1 if required, with their path/format fixed. config/os.conf (global settings) compile
wantSwapint wantSwapconfig/swap.conf (paging) iso
wantFilesystemsint wantFilesystemsconfig/filesystems.txt(file-table choices) compile
wantBaseDriversint wantBaseDriverskernel/base-drivers/base-drivers.conf compile
wantServicesint wantServicesuserspace/os-loader/services.conf iso
wantCompatint wantCompatuserspace/compat-loader/compat.conf iso
wantCmdlineint wantCmdlineconfig/cmdline.conf (kernel command line) compile
wantDownloadsint wantDownloadsconfig/downloads.conf (resolved URLs) compile
configuredint configuredNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
forModelvoid forModel(boolean hasCompat)Seed from a model's shape/compat: a desktop/server always wants os.conf, swap, filesystems, base-drivers, services, cmdline, downloads; the compat config is wanted only when the model ships foreign-exec routes.
addExtraint addExtra(String path, String format, int phase)Add a developer config file: target path, format ("conf"/"ini"/"json"/ "yaml"/"xml"/"text"), and the phase it is needed. Up to four.
configManifestString configManifest()---- The checklist -------------------------------------------------- A newline manifest "<path> <format> <phase> required|optional" of every settings file the build expects.
rowString row(String acc, String path, String fmt, String phase, int want)No description in source.
rowExtraString rowExtra(String acc, String rec)No description in source.
compilePhaseCountint compilePhaseCount()Count of required compile-phase / iso-phase settings files.
isoPhaseCountint isoPhaseCount()No description in source.
readyForCompileboolean readyForCompile()---- Phase gates ---------------------------------------------------- Before COMPILE: the irreducible settings — a global os.conf, the kernel command line, the filesystem choice, and the base-driver policy — must be declared wanted. Before ISO: additionally the service manifest.
readyForIsoboolean readyForIso()No description in source.
compileFilesPresentint compileFilesPresent(String root)---- Presence check (host) ------------------------------------------ allPresent(root): are the required compile-phase settings files actually on disk under `root`? A pre-flight the Creator runs before compiling. Returns 1 if every required compile file exists, else 0 (missing one is honest, not faked). Only checks the well-known fixed slots (extras are developer-owned).
emitOsConfString emitOsConf(String osName, String osVersion, String shape, String arch)---- Default content for the global settings file ------------------- os.conf aggregates the top-level knobs; the per-layer files are emitted by their own layers. This gives the build one authoritative settings header.

SLCppEmitter #sleela 2.5 (lib/operating-system/SLCppEmitter.sleela)

SLCppEmitter class

Defines SLCppEmitter — the C++ backend of the OS-construction family. Given a configured SLOSModel, it emits C++ source text that models the designed OS as objects: an OsImage class whose constructor records the model's identity, shape, kernel and boot parameters, and whose assemble() method composes the boot chain (bootloader -> kernel -> rootfs -> drivers -> services -> optional desktop) in the firmware->boot->kernel->userspace-> desktop order. The C++ output pairs with SLCEmitter's C output; a build can use whichever surface the native toolchain prefers. This is the "compiling the Sleela produces C++" half of the pipeline. All output is ordinary String concatenation on OP_ADD; no new VM opcode is used. Family: operating-system. Consumes SLOSModel and its composed specs.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
intToStrString intToStr(int v)No description in source.
emitOsImageString emitOsImage(SLOSModel m)Emit the OsImage C++ translation unit for the model.
emitServiceVectorString emitServiceVector(SLOSModel m)Emit the service vector initialiser from the model's unit manifest.
firstTokenString firstToken(String line)The token before the first space on a "name mode" line.
strLenint strLen(String s)String primitives wrap the shared native text intrinsics.
substrString substr(String s, int a, int b)No description in source.
charAtString charAt(String s, int i)No description in source.

SLDDRCatalog #sleela 2.5 (lib/operating-system/memory-ddr/SLDDRCatalog.sleela)

SLDDRCatalog class

Defines SLDDRCatalog — a by-name factory for DDR memory modules from the major DRAM manufacturers. The DRAM industry is dominated by a small, finite set of makers (Samsung, SK Hynix, Micron, plus module assemblers such as Kingston, Corsair, G.Skill, Crucial, Mushkin), so a machine description can request a module by manufacturer name and get a representative, correctly-specified SLDDRModule back. The catalogue returns configured SLDDRModule instances; the caller may refine capacity, ECC, and speed afterward. Representative part numbers are used for identity; exact SKUs vary by capacity/speed bin. Family: operating-system. Produces SLDDRModule.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
ddr5SLDDRModule ddr5(String manufacturer, int capacityMb)Return a DDR5 module from a named manufacturer at a given capacity (MB).
ddr4SLDDRModule ddr4(String manufacturer, int capacityMb)Return a DDR4 module from a named manufacturer at a given capacity (MB).
moduleSLDDRModule module(String manufacturer, String genName, int capacityMb, boolean ecc)Build a module of any generation by name from any manufacturer.
knownboolean known(String manufacturer)Is this one of the recognised DRAM manufacturers?
ddr5PartString ddr5Part(String mfr)---- Representative part numbers per manufacturer ----------------------
ddr4PartString ddr4Part(String mfr)No description in source.
genPartString genPart(String mfr, String genName)No description in source.

SLDDRModule #sleela 2.5 (lib/operating-system/memory-ddr/SLDDRModule.sleela)

SLDDRModule class extends SLHardwareComponent

Defines SLDDRModule — a named DDR SDRAM memory module (a DIMM or SO-DIMM). It extends SLHardwareComponent and models the finite catalogue of DDR generations (DDR, DDR2, DDR3, DDR4, DDR5) by name, with the per- generation specification a machine description needs: generation ordinal, data rate (MT/s), module standard (e.g. "PC5-44800"), supply voltage (millivolts), bus width, and capacity. A module is requested by manufacturer + part and a generation preset, then composed into an SLMachine as its main memory. Generations and their canonical voltages/data-rate ranges follow the JEDEC DDR family (see memory-ddr/SPECIFICATION.md). Values are design metadata the machine builder reads; the actual backing store is the VM's SLRAM. Family: operating-system. Extends SLHardwareComponent.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
GEN_DDRstatic final int GEN_DDR = 1Generation ordinals.
GEN_DDR2static final int GEN_DDR2 = 2No description in source.
GEN_DDR3static final int GEN_DDR3 = 3No description in source.
GEN_DDR4static final int GEN_DDR4 = 4No description in source.
GEN_DDR5static final int GEN_DDR5 = 5No description in source.
generationint generationGEN_*
standardString standardJEDEC module standard, e.g. "PC5-44800"
dataRateMtpsint dataRateMtpstransfer rate in MT/s
voltageMvint voltageMvsupply voltage in millivolts
busWidthBitsint busWidthBitsdata bus width (64 non-ECC, 72 ECC)
capacityMbint capacityMbmodule capacity in megabytes
eccSupportedint eccSupported1 if the module carries ECC

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String manufacturer, String part, int gen)Configure a module from a manufacturer, part, and generation preset. The preset fills the generation's canonical voltage and a representative speed; capacity and ECC are set by the caller afterward (or via sized()).
configureByNamevoid configureByName(String manufacturer, String part, String genName)Convenience: configure by generation name ("DDR".."DDR5").
sizedvoid sized(int megabytes, boolean ecc)Refine capacity (MB) and bus width; ECC uses a 72-bit bus.
setDataRatevoid setDataRate(int mtps)Override the data rate for an overclock/XMP/EXPO profile.
generationOrdinalint generationOrdinal()No description in source.
generationNameString generationName()No description in source.
moduleStandardString moduleStandard()No description in source.
dataRateint dataRate()No description in source.
voltageMillivoltsint voltageMillivolts()No description in source.
busWidthint busWidth()No description in source.
capacityMegabytesint capacityMegabytes()No description in source.
hasEccboolean hasEcc()No description in source.
peakBandwidthMBpsint peakBandwidthMBps()Peak transfer bandwidth in MB/s: data rate * (bus width in bytes).
wordsForWidthint wordsForWidth(int wordBits)The number of VM memory words this module backs, given a word width in bits — the figure SLMachineModel hands to SLRAM.

SLDesktopLoaderEmitter #sleela 2.5 (lib/operating-system/os-creator/SLDesktopLoaderEmitter.sleela)

SLDesktopLoaderEmitter class

Defines SLDesktopLoaderEmitter — the OS Creator(TM) emitter for the desktop GUI loader piece. Given an SLOSModel with a desktop it produces the C and C++ source for the stage that starts the display server / compositor (Wayland / DWM / WindowServer), the login/greeter, and the session shell (GNOME Shell / Explorer / Aqua). It emits a session.conf recording the display server, greeter, session shell, and widget toolkit. This is piece #7 of the chain (the topmost, optional layer). On a server / headless edition OS Creator(TM) does not request this piece at all; this emitter is only invoked when SLDesktopSpec.hasDesktop() is true. Family: operating-system. OS Creator(TM) piece emitter; consumes SLOSModel, fills SLOSPiece.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
emitSLOSPiece emit(SLOSModel m)No description in source.

SLDesktopSpec #sleela 2.5 (lib/operating-system/SLDesktopSpec.sleela)

SLDesktopSpec class

Defines SLDesktopSpec — the desktop/session layer of an OS being constructed: the graphics stack, display server/compositor, session shell, and widget toolkit that sit on top of the kernel and system services. The three shapes present their native stacks — GNOME Shell on a Wayland compositor for Linux, Explorer/DWM for Windows, Aqua on WindowServer for macOS — but the layer is explicitly OPTIONAL: a server edition composes an OS with no desktop at all. In the firmware -> boot -> kernel -> userspace -> desktop model, this is the topmost node. The design principle it encodes is that the desktop is NOT the operating system: it is a replaceable stack above Linux/NT/XNU and the userspace services, so it can be swapped (GNOME for KDE/Xfce) or omitted. Family: operating-system. Pure design model; no native bridge calls.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
enabledint enabled1 if the OS has a desktop at all (0 = server/headless)
displayServerString displayServer"Wayland" / "DWM" / "WindowServer"
sessionShellString sessionShell"GNOME Shell" / "Explorer" / "Aqua"
toolkitString toolkit"GTK" / "Win32/WinUI" / "AppKit"
displayManagerString displayManagerlogin/greeter
appearanceSLDesktopTheme appearancethe desktop appearance/theme (null on a headless edition)
configuredint configuredNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
headlessvoid headless()No description in source.
configurevoid configure(String server, String shell, String kit, String greeter)No description in source.
forShapevoid forShape(SLOSShape shape)Seed the native desktop stack for a shape, including its default theme.
applyThemevoid applyTheme(SLDesktopTheme t)No description in source.
themeSLDesktopTheme theme()The desktop theme, or null when headless / not yet seeded.
hasThemeboolean hasTheme()No description in source.
useAlternatevoid useAlternate(String shell, String kit)Swap the Linux desktop for an alternate (the desktop is replaceable).
hasDesktopboolean hasDesktop()No description in source.
serverString server()No description in source.
shellString shell()No description in source.
widgetToolkitString widgetToolkit()No description in source.
greeterString greeter()No description in source.

SLDesktopTheme #sleela 2.5 (lib/operating-system/SLDesktopTheme.sleela)

SLDesktopTheme class

Defines SLDesktopTheme — the appearance a constructed OS's

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
idString idtheme identity
labelString labelNo description in source.
backgroundString backgroundrole colors (shared vocabulary with the editor palettes + SleelaUI accent)
foregroundString foregroundNo description in source.
accentString accentNo description in source.
gtkThemeString gtkThemedesktop asset identifiers (bytes come from the desktop-loader warehouse)
iconSetString iconSetNo description in source.
cursorString cursorNo description in source.
wallpaperString wallpaperNo description in source.
configuredint configuredNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String themeId, String themeLabel,Full configuration.
slickBlackvoid slickBlack()---- Presets (mirror os/sleela_os_theme.c) --------------------------- The SleelaUI-aligned matte-dark default.
whitevoid white()The White Edition look, aligned with ubuntu-white (Ubuntu-orange accent).
linuxDefaultvoid linuxDefault()Per-shape native defaults.
windowsDefaultvoid windowsDefault()No description in source.
macosDefaultvoid macosDefault()No description in source.
forShapevoid forShape(SLOSShape shape)Seed the native-default theme for a shape (mirrors the other forShape seeds).
selectvoid select(String themeId)Choose a theme by id; unknown ids fall back to the Linux default.
themeIdString themeId()---- Accessors -------------------------------------------------------
nameString name()No description in source.
bgString bg()No description in source.
fgString fg()No description in source.
accentColorString accentColor()No description in source.
gtkString gtk()No description in source.
iconsString icons()No description in source.
cursorThemeString cursorTheme()No description in source.
wallpaperIdString wallpaperId()No description in source.
assetComponentString assetComponent()No description in source.
appearanceSheetString appearanceSheet()No description in source.

SLDirectory #sleela 2.5 (lib/operating-system/SLDirectory.sleela)

SLDirectory class

Defines SLDirectory — a host directory handle. Create, test, and remove directories, and move/rename them, through the VM's `os*` built-ins (CreateDirectory/RemoveDirectory/MoveFileEx on Windows; mkdir/rmdir/rename on POSIX). The current working directory is also reached here, since it is a directory-scoped concept. Family: operating-system. Native VM/OS work crosses the explicit `os*` SLVM bridge.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
pathString pathNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String p)No description in source.
nameString name()No description in source.
existsboolean exists()No description in source.
createboolean create()Create this directory (succeeds if it already exists).
removeboolean remove()Remove this directory (must be empty on POSIX/Windows).
renameToboolean renameTo(String newPath)Rename/move; on success the handle tracks the new path.
enterboolean enter()Make this directory the process' current working directory.
currentString current()The process' current working directory (static-style convenience).
tempString temp()The system temporary directory.

SLDistroFetch #sleela 2.5 (lib/operating-system/SLDistroFetch.sleela)

SLDistroFetch class

Defines SLDistroFetch — the OPT-IN downloader that materialises

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
MODE_SHALLOWstatic final int MODE_SHALLOW = 0Fetch depth/mode tags. --depth 1 --single-branch (default)
MODE_FULLstatic final int MODE_FULL = 1full history
MODE_RECURSEstatic final int MODE_RECURSE = 2full + --recurse-submodules
srcSLDistroSource srcthe reference (field; wired by configure())
modeint modeNo description in source.
lastExitint lastExitexit code of the most recent fetch (-1 if none run)

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
useSourcevoid useSource(SLDistroSource source)Point at a specific reference instead of the default.
setModevoid setMode(int m)No description in source.
sourceSLDistroSource source()No description in source.
cloneCommandString cloneCommand(String destDir)Build the git clone command that fetch(root) will run, without running it. Exposed so a tool can show or log the exact command (dry run).
pinCommandString pinCommand(String destDir)After a shallow clone, check out the pinned commit when the full history is present (shallow clones can only pin the branch tip; a FULL/RECURSE clone can hard-pin). Returns the checkout command, or "" when pinning is not meaningful for the chosen mode.
fetchint fetch(String destRoot, boolean force)The opt-in fetch. Creates destRoot, clones the distro into destRoot/<repo>, optionally pins the commit, and returns the git exit code (0 == success). force==false and an existing destination short-circuits to 0 so a re-run does not re-download.
fetchShallowint fetchShallow(String destRoot)Convenience: shallow fetch (the safe default for the large distro).
fetchCompleteint fetchComplete(String destRoot)Convenience: full fetch with submodules (a complete working tree).
lastExitCodeint lastExitCode()No description in source.
succeededboolean succeeded()No description in source.
probeint probe()Verify the upstream is reachable without downloading it (git ls-remote). Returns 0 when the branch is resolvable. Cheap pre-flight for a GUI.

SLDistroSource #sleela 2.5 (lib/operating-system/SLDistroSource.sleela)

SLDistroSource class

Defines SLDistroSource — the zero-payload REFERENCE to the

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
nameString nameUpstream identity.
ownerString ownerNo description in source.
repoString repoNo description in source.
urlString urlhttps clone URL
branchString branchdefault branch
pinnedCommitString pinnedCommitexact revision for reproducible fetches
hasSubmodulesint hasSubmodules1 if the distro uses git submodules (needs --recurse)

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()Configure with the known Ubuntu.Determinant distro reference. The pinned commit is the current main tip; callers may repin with pin(commit).
pinvoid pin(String commit)Repin to a specific revision (keeps fetches reproducible).
identityString identity()No description in source.
cloneUrlString cloneUrl()No description in source.
defaultBranchString defaultBranch()No description in source.
commitString commit()No description in source.
usesSubmodulesboolean usesSubmodules()No description in source.
shortCommitString shortCommit()First 10 chars of the pinned commit, for human-readable identity. The core value model has no substring, so this is derived by comparison-free display of the full commit when short form is unavailable; callers that need the exact value use commit().
dirForString dirFor(String layer)---- OS-part directory map ------------------------------------------ The directories in the distro that carry each OS layer. A caller resolves a layer name to its upstream path; dirFor returns "" for an unknown layer. These mirror the distro's top-level tree (firmware/boot/kernel/userspace/ desktop plus the installer and filesystem tooling).
providesLayerboolean providesLayer(String layer)No description in source.
downloadabilityNoteString downloadabilityNote(String part)downloadabilityNote(part): per-part answer to "can this be downloaded?".
needsSubmoduleForCompleteboolean needsSubmoduleForComplete()Whether a complete working tree needs the submodule fetched too.
referenceSheetString referenceSheet()A newline-separated reference sheet a tool or README can print.

SLDownloadSet #sleela 2.5 (lib/operating-system/SLDownloadSet.sleela)

SLDownloadSet class

Defines SLDownloadSet — the set of URLs for the related downloads

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
PHASE_COMPILEstatic final int PHASE_COMPILE = 0Phase tags: when a download must be present. before compiling the OS (sources/toolchain)
PHASE_ISOstatic final int PHASE_ISO = 1before authoring the ISO (rootfs payloads)
extraCountint extraCountNo description in source.
supportSLSupportDownloader supportThe resilient fallback downloader: when a primary URL 404s, it supplies prioritized support/mirror URLs (authoritative -> official -> college -> archive). This is the OS-document hook for the support downloader module.
configuredint configuredNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
supportDownloaderSLSupportDownloader supportDownloader()The composed support downloader (for the OS document to reach).
forShapevoid forShape(SLOSShape shape)Seed the per-shape default download URLs. These are the canonical upstreams a build of that family pulls from; a developer overrides any of them.
setPackageRepovoid setPackageRepo(String url)---- Setters --------------------------------------------------------
setKernelSrcvoid setKernelSrc(String url)No description in source.
setFirmwareSrcvoid setFirmwareSrc(String url)No description in source.
setRuntimeWinevoid setRuntimeWine(String url)No description in source.
setRuntimeQemuvoid setRuntimeQemu(String url)No description in source.
setUpstreamDistrovoid setUpstreamDistro(String url)No description in source.
addExtraint addExtra(String kind, String url, int phase)Add a developer download: kind label, URL, and phase (0 compile / 1 iso). Up to four extras are held.
readyForCompileboolean readyForCompile()---- Validity ------------------------------------------------------- Before COMPILE: a package repo + kernel source must be known (you cannot build an OS without where its base and kernel come from).
readyForIsoboolean readyForIso()Before ISO: additionally the firmware source must be known (the ESP/loader needs firmware), and every required slot resolved.
downloadManifestString downloadManifest()---- Manifest + fetch ----------------------------------------------- A newline manifest "<kind> <phase> <url>" of every known download.
rowString row(String acc, String kind, String phase, String url)No description in source.
rowExtraString rowExtra(String acc, String rec)An extra record "kind|url|phase" -> "kind phase url".
fetchScriptString fetchScript(int phase)A POSIX fetch script that retrieves the phase's downloads. Honest: it uses the right tool per URL scheme (git clone for .git, curl otherwise) and is a separate, explicit step — never run during compile automatically.
fetchLineString fetchLine(int wantPhase, int rowPhase, String kind, String url)No description in source.
phaseNameString phaseName(int phase)No description in source.
supportFetchScriptString supportFetchScript(int phase)---- Resilient fetch via the support downloader --------------------- supportFetchScript(phase): like fetchScript, but each component is fetched through the support downloader's 404-tolerant fallback loop (primary -> official mirror -> college/edu mirror -> archive). This is what a build should run so a single 404 does not break it.
supportManifestString supportManifest()The support URL table for the manifest/report (every kind, every tier).

SLDriverLoaderEmitter #sleela 2.5 (lib/operating-system/os-creator/SLDriverLoaderEmitter.sleela)

SLDriverLoaderEmitter class

Defines SLDriverLoaderEmitter — the OS Creator(TM) emitter for the driver-loader piece. Given an SLOSModel it walks the model's driver manifest (SLDriverSet) and produces the C and C++ source for the stage the kernel runs to bring up devices: it probes the bus, loads every built-in driver first (storage must be present before the rootfs mounts), then loads module drivers on demand. It emits a drivers.conf listing each driver and its binding (builtin|module). This is piece #5 of the chain. The emitted C contains one load_driver() call per driver, ordered built-ins first, generated from the model's manifest. Family: operating-system. OS Creator(TM) piece emitter; consumes SLOSModel, fills SLOSPiece.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
emitSLOSPiece emit(SLOSModel m)No description in source.
emitLoadCallsString emitLoadCalls(String manifest, String binding, int errCode)One load_driver() call per manifest line whose binding matches, with the given error code on failure.
driverListString driverList(String manifest, String binding)A comma-separated C++ initializer list of driver names with the binding.
lineNameString lineName(String line)"name binding" -> name (token before the space).
lineBindingString lineBinding(String line)"name binding" -> binding (token after the space).
strLenint strLen(String s)No description in source.
substrString substr(String s, int a, int b)No description in source.
charAtString charAt(String s, int i)No description in source.
intToStrString intToStr(int v)No description in source.

SLDriverSet #sleela 2.5 (lib/operating-system/SLDriverSet.sleela)

SLDriverSet class

Defines SLDriverSet — the device-driver layer of an OS being constructed: the drivers the kernel loads to abstract real hardware (storage controllers, network interfaces, display/GPU, input, USB, audio). It records each driver's name and binding model — built into the kernel image, or loaded as a module after boot — so the kernel-config and initramfs steps know which drivers must be present before the root filesystem can be mounted. In the firmware -> boot -> kernel -> userspace -> desktop model, drivers hang off the kernel node: storage and bus drivers in particular must be available early (built-in or in the initramfs) for the kernel to reach the rootfs. Family: operating-system. Pure design model; no native bridge calls.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
driversString driversnewline-separated "name binding" lines (binding: builtin|module)
countint countNo description in source.
builtinCountint builtinCountNo description in source.
configuredint configuredNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
addvoid add(String name, String binding)No description in source.
builtinvoid builtin(String name)A driver that must be present before the rootfs mounts -> built-in.
modulevoid module(String name)A driver loaded on demand after boot -> module.
forShapevoid forShape(SLOSShape shape)Seed the baseline driver set for a shape. Storage/bus/input are built in; GPU/audio/extra network are modules.
driverManifestString driverManifest()No description in source.
driverCountint driverCount()No description in source.
builtinDriverCountint builtinDriverCount()No description in source.
canReachRootfsboolean canReachRootfs()The kernel can reach a rootfs only if at least one storage driver is built in.

SLDriverSource #sleela 2.5 (lib/operating-system/SLDriverSource.sleela)

SLDriverSource class

Defines SLDriverSource — the provenance and trust policy for a

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
ORIGIN_INTREEstatic final int ORIGIN_INTREE = 0Origin tags. shipped with the OS
ORIGIN_VENDORstatic final int ORIGIN_VENDOR = 1signed by a trusted vendor
ORIGIN_UNKNOWNstatic final int ORIGIN_UNKNOWN = 2unsigned / out-of-tree
ORIGIN_FOREIGNstatic final int ORIGIN_FOREIGN = 3written for another OS family
hostString hostthe OS loading the driver
unknownPolicyString unknownPolicyPolicy per origin: "enforce" (signature required), "permissive" (load with a taint warning), or "off" (refuse). Defaults are safe. for ORIGIN_UNKNOWN
foreignPolicyString foreignPolicyfor ORIGIN_FOREIGN
configuredint configuredNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String hostFamily)No description in source.
normString norm(String s)No description in source.
allowUnknownvoid allowUnknown(boolean on)Developer stance: allow unknown-source drivers (load unsigned with a taint).
allowForeignvoid allowForeign(boolean on)Allow foreign-OS drivers where a bridge exists ("bridge"), or refuse ("off").
originNameString originName(int origin)---- Origin naming --------------------------------------------------
admitint admit(int origin, String guestFamily, String deviceClass)---- May a driver of this origin (from guestFamily, if foreign) load? --- Returns a result code: 0 = load (clean), 1 = load with taint (unsigned), 2 = load via a foreign bridge, -1 = refused by policy, -2 = no bridge exists for this foreign driver (unsupported). guestFamily matters only for ORIGIN_FOREIGN.
bridgeForString bridgeFor(String guestFamily, String deviceClass)---- The cross-OS driver bridge ------------------------------------ bridgeFor(guestFamily, deviceClass): the mechanism that adapts a driver from guestFamily to run on this host for a device class, or "none". The honest real cases: - Linux host, Windows NETWORK driver (NDIS) -> NDISwrapper. - Linux host, Windows filesystem/UDF -> a usermode (FUSE) shim. - a VM path can host the foreign driver INSIDE its own OS (device passthrough). Kernel-mode graphics/storage/audio foreign drivers have no in-kernel bridge.
foreignSupportedboolean foreignSupported(String guestFamily, String deviceClass)Can this host use a foreign driver from guestFamily for a device class?
verifySignatureint verifySignature(String path, String trustedKeyring)---- Verification (host) ------------------------------------------- verifySignature(path, trustedKeyring): does the driver file carry a signature from the trusted keyring? Best-effort over the host bridge; a missing tool/keyring reports unverified (0), never a false "trusted". Returns 1 trusted, 0 unverified/unsigned.
policySummaryString policySummary()---- Config / summary ----------------------------------------------
admitTextString admitText(int code)The admit decision as text, for logs and the generated config.

SLEnvironment #sleela 2.5 (lib/operating-system/SLEnvironment.sleela)

SLEnvironment class

Defines SLEnvironment — read/write access to the host process environment (environment variables) and a few well-known entries. Reads go through osGetEnv and writes through osSetEnv, which call the real host API (GetEnvironmentVariable/SetEnvironmentVariable on Windows, getenv/setenv on POSIX). A variable that is unset reads back as the empty string. Family: operating-system. Native VM/OS work crosses the explicit `os*` SLVM bridge.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
readsint readsNo description in source.
writesint writesNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
getString get(String key)Read a variable; "" when unset. Tracks a read count for observability.
getOrDefaultString getOrDefault(String key, String fallback)Read with a fallback used when the variable is unset (empty).
hasboolean has(String key)True when the variable is present (non-empty).
setboolean set(String key, String value)Set (overwrite) a variable; returns true on success.
pathString path()Common entries, resolved per-OS by the host (PATH, HOME/USERPROFILE, ...).
homeString home()No description in source.
shellString shell()No description in source.
readCountint readCount()No description in source.
writeCountint writeCount()No description in source.

SLEventSignal #sleela 2.5 (lib/operating-system/SLEventSignal.sleela)

SLEventSignal class

Defines SLEventSignal — delivery of an OS termination request to a running child process. The portable action a developer needs across OSes is "ask this process to stop": on POSIX that is kill(SIGTERM), on Windows it is TerminateProcess — both reached through osKill. SLEventSignal pairs that request with the SLProcess handle model so a supervisor written in SLeeLa can stop the children it spawned. Full per-signal control (SIGINT/SIGHUP/ custom numbers) belongs to the OS-specific flavor classes. Family: operating-system. Native VM/OS work crosses the explicit `os*` SLVM bridge.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
deliveredint deliveredNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
terminateboolean terminate(int processHandle)Ask the process behind the given handle to terminate (SIGTERM / TerminateProcess). Returns true if the request was accepted.
terminateProcessboolean terminateProcess(SLProcess p)Convenience: terminate the process wrapped by an SLProcess.
deliveredCountint deliveredCount()No description in source.

SLExecutableTranslator #sleela 2.5 (lib/operating-system/SLExecutableTranslator.sleela)

SLExecutableTranslator class

Defines SLExecutableTranslator — the policy and mechanism for

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
hostString hostthe host OS running the file: "Linux" / "Windows" / "macOS"

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String hostShape)No description in source.
configureForHostvoid configureForHost()No description in source.
hostNameString hostName()No description in source.
worldOfString worldOf(String ext)---- The foreign "world" a file type belongs to --------------------- worldOf(ext): the executable world an extension/type comes from, so the translator can pick the right layer. "" = a bare (no-ext) binary, treated as native to whatever host it sits on.
isForeignboolean isForeign(String ext)isForeign(ext): does running this type on the host require translation?
translatorForString translatorFor(String ext)---- Which translator applies, and how ------------------------------ translatorFor(ext): the name of the layer that runs this foreign type on the host, or "" when the type is native (no translation needed). The names are the real-world facilities a builder would install.
kindString kind(String ext)kind(ext): the TRANSLATION KIND for the host+type: "native" (runs direct), "binfmt" (an FS-level interpreter can be registered), or "container" (a user-space compat layer / VM houses the execution).
hasFsInterpreterboolean hasFsInterpreter()Does the host provide a filesystem-level interpreter facility at all?
binfmtLineString binfmtLine(String ext, String interpreter)---- Registration: make a foreign type runnable --------------------- binfmtLine(ext, interpreter): the binfmt_misc registration string that binds a foreign type to an interpreter at the filesystem level. Written to /proc/sys/fs/binfmt_misc/register (or a systemd-binfmt .conf) on Linux. Form: ":name:extension|magic:::interpreter:flags".
stripDotString stripDot(String ext)No description in source.
registerCommandString registerCommand(String ext, String interpreter)The host command that registers a foreign type so the FS/compat layer runs it. On Linux this appends a binfmt_misc rule; elsewhere it is advisory text naming the container to install (there is no FS-level register there).
runCommandString runCommand(String path, String ext, String interpreter)runCommand(path, ext, interpreter): how the host actually launches a foreign file. With a registered FS interpreter it runs directly; otherwise it is invoked through the named container/compat layer.
registerint register(String ext, String interpreter)---- Host actions (cross the os* bridge) ---------------------------- register(ext, interpreter): on Linux, attempt the binfmt_misc registration (requires the facility mounted and privilege); returns the exit code (0 ok). On other hosts there is no FS-level register, so it reports -1 (the builder must install the named container). Never fakes success.
runnableNowboolean runnableNow(String ext, String interpreterPath)runnableNow(ext, interpreterPath): best-effort check that the host can run this foreign type right now — the interpreter/container binary is present.
emitTranslatorHeaderString emitTranslatorHeader()---- Generated C/C++ note ------------------------------------------- A short header documenting the host's foreign-exec policy for the generated OS, so the working C/CPP set records which translators the image expects.
bitString bit(boolean b)No description in source.

SLExecutableTypes #sleela 2.5 (lib/operating-system/SLExecutableTypes.sleela)

SLExecutableTypes class

Defines SLExecutableTypes — the per-OS policy for which FILE

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
shapeString shape"Linux" / "Windows" / "macOS"

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String shapeName)No description in source.
configureForHostvoid configureForHost()Configure from the real host OS the VM runs on.
nameString name()No description in source.
isWindowsboolean isWindows()No description in source.
isMacboolean isMac()No description in source.
isLinuxboolean isLinux()No description in source.
isExecutableboolean isExecutable(String ext)---- Executability policy by file type ------------------------------ isExecutable(ext): does this extension name an executable file type on the configured shape? ext includes the dot (".exe"); "" means "no extension", which is the common case for ELF/Mach-O binaries on POSIX.
executableTypesString executableTypes()The newline-separated list of executable types for this shape (for a table or a generated header). On Windows this doubles as the PATHEXT seed.
pathextString pathext()The Windows PATHEXT value a shell uses to resolve a bare command name. Empty on POSIX, where executability is the mode bit, not the extension.
mechanismString mechanism()How a file becomes executable on this shape (human-readable mechanism).
usesExecBitboolean usesExecBit()Whether this shape uses the POSIX exec-bit model at all.
markExecutableint markExecutable(String path)---- Host actions (cross the os* bridge) ---------------------------- markExecutable(path): make a real file runnable on the host. On POSIX this runs chmod +x and returns its exit code (0 ok). On Windows there is no exec bit — executability is governed by extension/PATHEXT — so it is a no-op that reports success. Only meaningful when the configured shape is the host.
isHostExecutableboolean isHostExecutable(String path, String ext)isHostExecutable(path, ext): best-effort check that a real path is runnable on the host now. On POSIX: exist + (executable extension OR the exec bit is set, probed via `test -x`); on Windows: exist + executable extension.
emitExecTypesHeaderString emitExecTypesHeader()---- Generated C/C++ table ------------------------------------------ Emit a C header declaring this shape's executable file-type table, for the working C/CPP set the OS generator writes. A loader uses it to decide whether a file is a candidate executable.
emitTableRowsString emitTableRows()One C string literal per executable extension for this shape.
bitString bit(boolean b)No description in source.

SLFile #sleela 2.5 (lib/operating-system/SLFile.sleela)

SLFile class

Defines SLFile — a single named file on the host filesystem. It pairs the path with metadata queries (exists/size) and namespace operations (delete/rename) that cross to the real OS through the VM's `os*` built-ins. Byte-level content I/O is left to the file I/O built-ins (openFile/read/ write/close); SLFile is the path-oriented handle a developer passes around. Family: operating-system. Native VM/OS work crosses the explicit `os*` SLVM bridge.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
pathString pathNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String p)No description in source.
nameString name()No description in source.
existsboolean exists()No description in source.
isRegularboolean isRegular()No description in source.
sizeint size()No description in source.
deleteboolean delete()Remove this file; returns true on success.
renameToboolean renameTo(String newPath)Rename/move this file; on success the handle tracks the new path.

SLFileSystem #sleela 2.5 (lib/operating-system/SLFileSystem.sleela)

SLFileSystem class

Defines SLFileSystem — host filesystem metadata and operations: existence/type/size queries, directory creation, removal, and rename/move. These map to the real OS calls through the VM (GetFileAttributes/ CreateDirectory/MoveFileEx on Windows; stat/mkdir/rmdir/unlink/rename on POSIX). File CONTENT read/write stays with the existing file I/O built-ins (openFile/read/write/close); this class is the metadata + namespace layer. Family: operating-system. Native VM/OS work crosses the explicit `os*` SLVM bridge.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
opsint opsNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
existsboolean exists(String path)No description in source.
isDirboolean isDir(String path)No description in source.
isFileboolean isFile(String path)No description in source.
sizeint size(String path)Size in bytes, or -1 if the path does not exist / is not a regular file.
makeDirboolean makeDir(String path)Create a directory (succeeds if it already exists). Returns true on success.
removeboolean remove(String path)Remove a file or an empty directory. Returns true on success.
renameboolean rename(String from, String to)Rename/move a path. Returns true on success.
moveboolean move(String from, String to)Move is rename across directories (same host primitive).
operationCountint operationCount()No description in source.

SLFilesystemCatalog #sleela 2.5 (lib/operating-system/SLFilesystemCatalog.sleela)

SLFilesystemCatalog class

Defines SLFilesystemCatalog — the catalogue of filesystem (file table) types still in use, with the real properties a builder needs to choose one: the family (FAT / NTFS / ext / Apple / Unix / network / pseudo / optical), journaling, case sensitivity, the native OS, a typical maximum file size, and whether it is bootable as a root filesystem. It covers the FAT lineage (FAT12/16/32, exFAT, vFAT), Windows (NTFS, ReFS), Linux (ext2/3/4, XFS, Btrfs, F2FS, JFS, ReiserFS), cross-platform (ZFS), Apple (APFS, HFS+), classic Unix (UFS), optical/removable (ISO9660, UDF), compressed/pseudo (SquashFS, tmpfs, swap), and network (NFS, SMB/CIFS). It answers "is <fs> a known table type?", "which OS owns it?", "can it root a boot?", "does it journal?", and returns a mkfs-style tool name — so the OS model's SLFilesystemLayout and the installer can pick and format correctly. Family: operating-system. Pure design/catalogue model; no native bridge calls.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
isKnownboolean isKnown(String fs)Canonical, lowercase filesystem identifiers this catalogue knows.
familyString family(String fs)The family a filesystem belongs to, or "unknown".
nativeOsString nativeOs(String fs)The OS that natively owns/defaults to this filesystem.
journalingboolean journaling(String fs)Does it journal (crash-consistent metadata)? FAT and classic HFS do not.
copyOnWriteboolean copyOnWrite(String fs)Copy-on-write (snapshotting) filesystems.
caseSensitivityString caseSensitivity(String fs)Case sensitivity of file names by default.
maxFileSizeString maxFileSize(String fs)A typical maximum single-file size, as human text (real per-fs limits).
rootableboolean rootable(String fs)Can this filesystem hold a bootable root? (optical/pseudo/network cannot serve as a general writable root; FAT/EFI can host an ESP but not a Linux root.) True for the mainstream rootable filesystems.
efiSystemPartitionboolean efiSystemPartition(String fs)Suitable for the EFI System Partition (must be FAT).
mkfsToolString mkfsTool(String fs)The mkfs-style tool that formats this filesystem.
useCaseString useCase(String fs)A one-line use-case note for a GUI/menu.
defaultRootForString defaultRootFor(String shapeName)The default root filesystem for an OS shape (what forShape would pick).
rootChoicesForString rootChoicesFor(String shapeName)A newline menu of the catalogue's rootable choices for a shape, for a GUI.
describeString describe(String fs)A compact spec line a tool can print for one filesystem.
ynString yn(boolean b)No description in source.

SLFilesystemLayout #sleela 2.5 (lib/operating-system/SLFilesystemLayout.sleela)

SLFilesystemLayout class

Defines SLFilesystemLayout — the root-filesystem namespace of an OS being constructed. It records the on-disk filesystem format (ext4 / NTFS / APFS), the mount hierarchy, and the directory tree the installed system presents: the FHS roots for Linux shapes (/etc,/usr,/var,/home,/proc,/sys, /tmp,/boot), the Windows directory world (C:\Windows, Program Files, Users, ProgramData) for Windows shapes, and the Apple layout (/System,/Library, /Applications,/Users) for macOS shapes. In the firmware -> boot -> kernel -> userspace -> desktop model, this is the installed root filesystem the early userspace mounts. Directories are accumulated into a portable, newline-separated manifest the ISO builder reads to assemble the rootfs tree (the debootstrap-style compositional assembly the OS lineage uses). Family: operating-system. Pure design model; no native bridge calls.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
formatString format"ext4" / "NTFS" / "APFS"
separatorString separatorpath separator for this layout
treeString treenewline-separated directory manifest
dirCountint dirCountNo description in source.
configuredint configuredNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String fsFormat, String sep)No description in source.
addDirvoid addDir(String path)Add one directory to the manifest.
forShapevoid forShape(SLOSShape shape)Seed the standard directory tree for a shape.
fsFormatString fsFormat()No description in source.
manifestString manifest()No description in source.
directoryCountint directoryCount()No description in source.
isCompleteboolean isComplete()A layout must declare at least a system root and a user-data root.

SLHardDisk #sleela 2.5 (lib/operating-system/hdd/SLHardDisk.sleela)

SLHardDisk class extends SLHardwareComponent

Defines SLHardDisk — a named rotational hard disk drive. It extends SLHardwareComponent and models the finite catalogue of HDD variants by the dimensions that distinguish them: form factor (3.5" / 2.5"), spindle speed (5400 / 7200 / 10000 / 15000 RPM), host interface (SATA III / SAS), recording technology (CMR vs SMR), cache size, capacity, and representative sustained transfer rate. A machine description requests an HDD by manufacturer + model and composes it as a bulk/boot storage device. Like SLSSD it is a storage device whose capacity-in-blocks maps onto the VM block store; media kind is rotational so SLMachineModel marks it MEDIA_HDD. Family: operating-system. Extends SLHardwareComponent.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
IF_SATA3static final int IF_SATA3 = 0Interface ordinals. 6 Gb/s
IF_SASstatic final int IF_SAS = 112 Gb/s enterprise
REC_CMRstatic final int REC_CMR = 0Recording technology. conventional (preferred)
REC_SMRstatic final int REC_SMR = 1shingled (higher density, slower random writes)
ifaceint ifaceIF_*
formFactorString formFactor"3.5\"" / "2.5\""
rpmint rpmspindle speed
recordingint recordingREC_*
cacheMbint cacheMbDRAM cache
capacityGbint capacityGbNo description in source.
sustainedMBpsint sustainedMBpsrepresentative sustained transfer rate
blockBytesint blockByteslogical block size

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String manufacturer, String partName, int interfaceKind, int rpmSpeed, int capacityGigabytes)No description in source.
setRecordingvoid setRecording(int tech)No description in source.
setCachevoid setCache(int megabytes)No description in source.
setFormFactorvoid setFormFactor(String ff)No description in source.
setSustainedvoid setSustained(int mbps)No description in source.
isSasboolean isSas()No description in source.
isSmrboolean isSmr()No description in source.
interfaceNameString interfaceName()No description in source.
recordingNameString recordingName()No description in source.
formString form()No description in source.
spindleRpmint spindleRpm()No description in source.
cacheMegabytesint cacheMegabytes()No description in source.
capacityGigabytesint capacityGigabytes()No description in source.
transferMBpsint transferMBps()No description in source.
blockSizeint blockSize()No description in source.
capacityBlocksint capacityBlocks()No description in source.

SLHardDiskCatalog #sleela 2.5 (lib/operating-system/hdd/SLHardDiskCatalog.sleela)

SLHardDiskCatalog class

Defines SLHardDiskCatalog — a by-name factory for rotational hard disks from the surviving HDD manufacturers. The spinning-disk market has consolidated to a finite set — Seagate, Western Digital, and Toshiba — so a machine description can request bulk storage by maker and model name and get a representative, correctly-specified SLHardDisk back. Representative family names (Seagate IronWolf/Exos, WD Red/Gold, Toshiba MG/N300) stand in for identity; exact capacity/RPM bins vary by SKU. Family: operating-system. Produces SLHardDisk.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
sata7200SLHardDisk sata7200(String manufacturer, int capacityGb)A 7200 RPM SATA desktop/NAS drive from a named manufacturer.
enterpriseSLHardDisk enterprise(String manufacturer, int capacityGb)A 7200 RPM SAS enterprise drive from a named manufacturer.
performanceSLHardDisk performance(String manufacturer, int rpm, int capacityGb)A high-RPM (10k/15k) SAS performance drive.
knownboolean known(String manufacturer)No description in source.
desktopPartString desktopPart(String mfr)No description in source.
enterprisePartString enterprisePart(String mfr)No description in source.

SLHardwareComponent #sleela 2.5 (lib/operating-system/SLHardwareComponent.sleela)

SLHardwareComponent class

Defines SLHardwareComponent — the common base of every named hardware part in the OS-construction family (RAM/DDR modules, SSDs, hard disks, USB devices, UEFI firmware, video cards). It carries the identity every part shares: a manufacturer, a model/part name, a device class, and a configured flag, plus a human identity line. Concrete device classes extend it and add their class-specific specification fields. The point of the family is name-addressable parts: because the real world has a finite catalogue of device types (DDR..DDR5, SATA/NVMe SSDs, USB 1.1..4, UEFI revisions, GPU families), each is a named SLeeLa class a machine description can request by manufacturer + model, compose into an SLMachine, and run on the Sleela VM. Family: operating-system. Base of the hardware-component hierarchy.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
CLASS_MEMORYstatic final int CLASS_MEMORY = 0Device-class ordinals (what kind of part this is).
CLASS_SSDstatic final int CLASS_SSD = 1No description in source.
CLASS_HDDstatic final int CLASS_HDD = 2No description in source.
CLASS_USBstatic final int CLASS_USB = 3No description in source.
CLASS_UEFIstatic final int CLASS_UEFI = 4No description in source.
CLASS_VIDEOstatic final int CLASS_VIDEO = 5No description in source.
CLASS_CPUstatic final int CLASS_CPU = 6No description in source.
CLASS_MAINBOARDstatic final int CLASS_MAINBOARD = 7No description in source.
vendorString vendormanufacturer, e.g. "Samsung", "NVIDIA"
modelString modelmodel / part name, e.g. "M378A2K43DB1", "GeForce RTX 4090"
deviceClassint deviceClassone of CLASS_*
configuredint configuredNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configureComponentvoid configureComponent(String manufacturer, String partName, int cls)No description in source.
manufacturerString manufacturer()No description in source.
partNameString partName()No description in source.
componentClassint componentClass()No description in source.
isConfiguredboolean isConfigured()No description in source.
classNameString className()No description in source.
identityString identity()A short identity line shared by every part, e.g. "ssd Samsung 990 PRO".

SLHardwareRegistry #sleela 2.5 (lib/operating-system/SLHardwareRegistry.sleela)

SLHardwareRegistry class

Defines SLHardwareRegistry — the single by-name front door to the whole hardware-component catalogue. It composes every per-family catalogue (SLDDRCatalog, SLSSDCatalog, SLHardDiskCatalog, SLUSBCatalog, and the UEFI and video-card factories) so a machine description can request any part by its class, manufacturer, and model/generation name through one object and receive a correctly-specified component. This is what makes the parts "name-addressable": because the real catalogue of device types is finite, the registry exposes memory(), ssd(), hdd(), usb(), uefi(), and video() lookups keyed on manufacturer + variant name. Family: operating-system. Composes the per-family catalogues; produces SLHardwareComponent subclasses.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
ddrSLDDRCatalog ddrNo description in source.
ssdsSLSSDCatalog ssdsNo description in source.
hddsSLHardDiskCatalog hddsNo description in source.
usbSLUSBCatalog usbNo description in source.
gpusSLVideoCardCatalog gpusNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
memorySLDDRModule memory(String manufacturer, String generation, int capacityMb)---- Memory ------------------------------------------------------------ A DDR module by manufacturer, generation name ("DDR".."DDR5"), capacity MB.
eccMemorySLDDRModule eccMemory(String manufacturer, String generation, int capacityMb)No description in source.
ssdSLSSD ssd(String manufacturer, String iface, int capacityGb)---- Solid-state storage ----------------------------------------------- An SSD by manufacturer, interface name ("SATA"/"PCIe3"/"PCIe4"/"PCIe5"), GB.
hddSLHardDisk hdd(String manufacturer, int rpm, int capacityGb)---- Rotational storage ------------------------------------------------
usbControllerSLUSBDevice usbController(String vendor, String generation, int ports)---- USB --------------------------------------------------------------- A USB host controller by vendor + generation name.
usbFlashSLUSBDevice usbFlash(String vendor, String model, String generation)No description in source.
uefiSLUEFIFirmware uefi(String vendor)---- UEFI firmware -----------------------------------------------------
videoSLVideoCard video(String vendor, String model, int vramMb)---- Video card --------------------------------------------------------
memoryCatalogSLDDRCatalog memoryCatalog()Catalogue accessors for callers that want the richer per-family API.
ssdCatalogSLSSDCatalog ssdCatalog()No description in source.
hddCatalogSLHardDiskCatalog hddCatalog()No description in source.
usbCatalogSLUSBCatalog usbCatalog()No description in source.
videoCatalogSLVideoCardCatalog videoCatalog()No description in source.

SLInstallerGenerator #sleela 2.5 (lib/operating-system/SLInstallerGenerator.sleela)

SLInstallerGenerator class

Defines SLInstallerGenerator — the stage that writes an installer for a built OS, in the idiom of the OS's shape. For a Linux shape it emits a POSIX shell installer (partition + format to the model's rootfs, mount, unpack the ISO's rootfs, install GRUB); for a Windows shape a PowerShell installer (format NTFS, apply the image, install BOOTMGR to the ESP); for a macOS shape a shell installer targeting an APFS container with boot.efi. Each installer also offers a VM path (QEMU) to boot the ISO read-only for verification before touching a real disk — the control-plane-not-duplication stance of the OS lineage's installer. The installer is the per-OS-type counterpart the request calls for: one is generated for each of the three main OS shapes, selected from the model. Family: operating-system. Consumes SLOSModel; produces an SLOSArtifact (KIND_SCRIPT).

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
configuredint configuredNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
generateSLOSArtifact generate(SLOSModel m)Generate the installer that matches the model's shape.
linuxInstallerSLOSArtifact linuxInstaller(SLOSModel m)---- Linux: POSIX shell installer --------------------------------------
windowsInstallerSLOSArtifact windowsInstaller(SLOSModel m)---- Windows: PowerShell installer -------------------------------------
macInstallerSLOSArtifact macInstaller(SLOSModel m)---- macOS: APFS shell installer ---------------------------------------
vmBranchPosixString vmBranchPosix(SLOSModel m)The shared --vm (QEMU) branch for POSIX installers: boot the ISO read-only.
isoFileNameString isoFileName(SLOSModel m)No description in source.

SLISOBuilder #sleela 2.5 (lib/operating-system/SLISOBuilder.sleela)

SLISOBuilder class

Defines SLISOBuilder — the stage that turns a compiled SLOSModel into a bootable ISO image descriptor. It assembles the root filesystem from the model's directory layout and package seed (the debootstrap-style compositional assembly), lays down the EFI System Partition and installs the bootloader the model names, compiles the emitted C/C++ early-boot sources into the image, and emits the ISO build recipe (an mkisofs/xorriso invocation with the right volume label, boot catalog, and EFI image) as a script artifact. The result is an SLOSArtifact of KIND_ISO describing the final image plus the exact commands that produce it. It calls the established ISO contract rather than inventing a competing one: the recipe drives xorriso/mkisofs the same way the OS lineage's gen-iso.sh does, so the SLeeLa model becomes a real .iso through the existing toolchain. Family: operating-system. Consumes SLOSModel + SLOSCompiler; produces an SLOSArtifact.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
stagingRootString stagingRootwhere the rootfs is assembled
configuredint configuredNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
stageAtvoid stageAt(String dir)No description in source.
buildSLOSArtifact build(SLOSModel m, SLOSCompiler compiler)Build the ISO descriptor + recipe for a model that was already compiled by the given SLOSCompiler (so the C/C++ artifacts exist to be built in).
emitMkdirsString emitMkdirs(SLOSModel m)---- Recipe fragments --------------------------------------------------- One `mkdir -p` per directory in the model's filesystem manifest.
emitPackageInstallString emitPackageInstall(SLOSModel m)One package-install line per entry in the model's package manifest.
normalizeString normalize(String path)Turn a Windows-style path into a POSIX staging subpath so the recipe is uniform (the ISO is authored on a POSIX builder regardless of shape).
replaceBackslashString replaceBackslash(String s)No description in source.
volumeLabelString volumeLabel(SLOSModel m)No description in source.
isoFileNameString isoFileName(SLOSModel m)No description in source.
strLenint strLen(String s)String primitives wrap the shared native text intrinsics.
substrString substr(String s, int a, int b)No description in source.
charAtString charAt(String s, int i)No description in source.

SLKernelCatalog #sleela 2.5 (lib/operating-system/SLKernelCatalog.sleela)

SLKernelCatalog class

Defines SLKernelCatalog — the catalogue of selectable kernels and kernel VERSIONS for the three OS families, so an OS being constructed can request a SPECIFIC kernel version rather than only the shape default: - Linux : the Linux kernel, selectable by series (e.g. 6.6 LTS, 6.12, 6.18, "latest"), resolved to a concrete version string. - Windows: the NT kernel for Windows 10 and later (NT 10.0 build families: 10, 11, Server 2019/2022/2025). - macOS : the XNU/Darwin kernel, selectable by macOS release (Ventura/ Sonoma/Sequoia -> Darwin 22/23/24). It validates a requested selection (is this a kernel version this catalogue knows for the family?), returns the resolved version string and kernel name, and supplies the family default. SLKernelSpec composes against it so a model can do kernelSpec().selectVersion(catalog, "Linux", "6.6 LTS"). Family: operating-system. Pure design/catalogue model; no native bridge calls.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
kernelNameString kernelName(String family)The kernel NAME for a family label.
defaultVersionString defaultVersion(String family)The family DEFAULT version (what forShape would pick).
resolveLinuxString resolveLinux(String sel)---- Selection: resolve a requested version to a concrete one ------- resolveLinux(sel): map a Linux selection to a concrete kernel version. Accepts a named series or an explicit x.y.z (returned as-is).
resolveWindowsString resolveWindows(String sel)resolveWindows(sel): Windows 10+ only. Maps an edition/name to its NT 10.0 build. Pre-10 selections resolve to "" (unsupported here).
resolveMacString resolveMac(String sel)resolveMac(sel): macOS release name or Darwin version -> Darwin version.
resolveString resolve(String family, String sel)resolve(family, sel): the family-dispatched resolver. Returns "" when the selection is not valid for the family (e.g. a pre-10 Windows request).
isSupportedboolean isSupported(String family, String sel)isSupported(family, sel): true when resolve() yields a concrete version.
selectionsForString selectionsFor(String family)A newline-separated menu of named selections for a family (for a GUI).
startsWith10boolean startsWith10(String nt)Windows-10+ guard: an explicit NT build is accepted only when it is NT 10.x.
prefix10boolean prefix10(String nt)True for the exact NT-10 builds the catalogue resolves to.

SLKernelLoaderEmitter #sleela 2.5 (lib/operating-system/os-creator/SLKernelLoaderEmitter.sleela)

SLKernelLoaderEmitter class

Defines SLKernelLoaderEmitter — the OS Creator(TM) emitter for the kernel-loader piece. Given an SLOSModel it produces the C and C++ source for the stage that the boot loader hands control to: it loads the kernel image (the family the SLKernelSpec names: Linux / NT / XNU), optionally unpacks an initramfs, applies the kernel command line, and jumps to the kernel entry point. It emits a kernel-loader.conf recording the kernel name/version, command line, and whether an initramfs is staged. This is piece #4 of the chain. Output is String concatenation on OP_ADD. Family: operating-system. OS Creator(TM) piece emitter; consumes SLOSModel, fills SLOSPiece.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
emitSLOSPiece emit(SLOSModel m)No description in source.
boolLitString boolLit(boolean b)No description in source.

SLKernelSpec #sleela 2.5 (lib/operating-system/SLKernelSpec.sleela)

SLKernelSpec class

Defines SLKernelSpec — the kernel layer of an OS being constructed. It names the kernel the target OS boots (an NT-style, a Linux-style, or an XNU/Darwin-style kernel), its version, the subsystems it must provide (process management, memory management, scheduling, networking, filesystems, drivers, security primitives), and the kernel command line handed to it at boot. In the firmware -> boot -> kernel -> userspace -> desktop model, this is the kernel node. The C/C++ emitters turn a configured SLKernelSpec into the kernel-config and command-line artifacts the ISO build consumes; where a real upstream kernel is used (the common case) the spec records which kernel and configuration to assemble rather than re-implementing one. SCOPE NOTE: this models the kernel's COMPOSITION contract, not a from-scratch kernel implementation. Compare lib/cpu/SLGuestKernelBuilder, which compiles a small custom teaching kernel on a simulated CPU. Family: operating-system. Pure design model; no native bridge calls.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
kernelNameString kernelName"NT", "Linux", "XNU"
versionString versione.g. "6.18.27"
cmdlineString cmdlinekernel boot parameters
processMgmtint processMgmtSubsystem toggles (1 = required, 0 = omitted).
memoryMgmtint memoryMgmtNo description in source.
schedulerint schedulerNo description in source.
networkingint networkingNo description in source.
filesystemsint filesystemsNo description in source.
driversint driversNo description in source.
securityint securityNo description in source.
preemptibleint preemptiblepreemptible kernel
configuredint configuredNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String name, String ver)Baseline: a full-featured, preemptible kernel with every core subsystem.
forShapevoid forShape(SLOSShape shape)Pick the kernel family that matches a shape, with a sensible version.
selectVersionboolean selectVersion(SLKernelCatalog catalog, String family, String selection)Request a SPECIFIC kernel version via SLKernelCatalog. `family` is "Linux"/"Windows"/"macOS" and `selection` is a named series/edition ("6.6 LTS", "11", "Sonoma", "latest", "default") or an explicit version. Returns true when the selection is supported for the family; on success the kernel name and resolved version are applied, otherwise the spec is left unchanged. Windows requests below Windows 10 are unsupported (return false).
setCmdlinevoid setCmdline(String line)No description in source.
appendCmdlinevoid appendCmdline(String arg)No description in source.
requireSecurityvoid requireSecurity(boolean on)No description in source.
nameString name()No description in source.
kernelVersionString kernelVersion()No description in source.
commandLineString commandLine()No description in source.
subsystemCountint subsystemCount()Count of enabled core subsystems (used by the model's validity check).
isBootableboolean isBootable()A kernel is bootable only if it provides the three irreducible subsystems.

SLLinuxOS #sleela 2.5 (lib/operating-system/SLLinuxOS.sleela)

SLLinuxOS class

Defines SLLinuxOS — the Linux-specific flavor of the OS family. It composes the general `os*` built-ins into Linux idioms: /bin/sh command execution, XDG and HOME/PATH environment entries, the Filesystem Hierarchy Standard directories (/etc, /proc, /sys, /tmp, /var), and reading kernel/ distro facts out of /proc and /etc. Underneath it is genuine POSIX — posix_spawn/waitpid, getenv/setenv, stat, getcwd — on the real kernel. Guard: methods are meaningful only when osPlatform()=="Linux"; isHost() lets a program check first. Family: operating-system. Native VM/OS work crosses the explicit `os*` SLVM bridge.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
isHostboolean isHost()True when the running host is actually Linux.
shint sh(String command)---- Shell / processes -------------------------------------------------- Run a command through /bin/sh (osRun uses /bin/sh -c on POSIX).
startShSLProcess startSh(String command)Start a background command; returns an SLProcess to wait()/kill().
waitForint waitFor(int processHandle)Reap a daemon-style child by handle.
homeString home()---- Environment (HOME/PATH/XDG/SHELL) ---------------------------------
pathString path()No description in source.
shellString shell()No description in source.
xdgConfigHomeString xdgConfigHome()No description in source.
xdgRuntimeDirString xdgRuntimeDir()No description in source.
etcString etc()---- Filesystem Hierarchy Standard roots -------------------------------
procString proc()No description in source.
sysString sys()No description in source.
tmpString tmp()No description in source.
varString var()No description in source.
kernelCmdlineString kernelCmdline()---- Kernel / distro facts (read real files via file I/O built-ins) ----- The kernel command line exposed by procfs; "" if unreadable.
osReleaseString osRelease()The os-release metadata (distro name/version); "" if unreadable.
procExistsboolean procExists(int pid)True if a /proc entry exists for the given pid.
readSmallFileString readSmallFile(String path)Read a small text file through the shared file I/O built-ins. Handles are VM-local; returns the first chunk of content, or "" on failure.
hostNameString hostName()No description in source.
userNameString userName()No description in source.

SLLinuxOSModel #sleela 2.5 (lib/operating-system/SLLinuxOSModel.sleela)

SLLinuxOSModel class extends SLOSModel

Defines SLLinuxOSModel — a preset that extends SLOSModel and extrapolates it into a Linux-shaped operating system: a Linux kernel, UEFI+GRUB boot with an initramfs, an ext4 root under the Filesystem Hierarchy Standard, a systemd service set, a Debian-style base package seed, and a GNOME-on-Wayland desktop. It is the OOD realisation of "assume the shape of Linux" and the model the OS projects in this lineage (an Ubuntu-derived distribution) start from. After build(), refine any layer through the inherited accessors — e.g. swap the desktop with desktopSpec().useAlternate(...), or add packages with packageSet().add(...). Call asServer() for a headless server edition. Family: operating-system. Extends SLOSModel.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
buildvoid build(String name, String ver)Build a Linux-shaped model with the given product name/version on amd64.
buildMultiArchvoid buildMultiArch(String name, String ver)Build a multi-arch Linux model (adds arm64 to the primary amd64 target).

SLMachineBuilder #sleela 2.5 (lib/operating-system/SLMachineBuilder.sleela)

SLMachineBuilder class

Defines SLMachineBuilder — the stage that turns a named-parts SLMachineModel into a RUNNING machine on the Sleela VM. It reads the model's components (DDR memory, SSD/HDD boot device, UEFI firmware, CPU identity), sizes the VM's main memory and block store from the real part capacities, and composes the lib/cpu stack — SLRAM + SLHardDrive + SLCPU wired into an SLMachine — so that the Sleela source describing the hardware, once compiled and run, produces an actual machine the VM boots and executes programs on. This is the operational meaning of "use those Sleela source files in a Sleela source document, compile it, and run that result to produce a Machine on the Sleela VM process": the named parts are the description; building composes the emulated machine; running it executes a program (or boots an SLOSModel-shaped guest) on the Sleela CPU. Family: operating-system. Consumes SLMachineModel; composes lib/cpu (SLMachine, SLRAM, SLHardDrive, SLCPU, SLInstructionSet).

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
machineSLMachine machinethe composed lib/cpu machine
builtint builtNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
buildSLMachine build(SLMachineModel m)Compose a runnable Sleela-VM machine from the named-parts model. Returns the lib/cpu SLMachine, hardware built and ready to boot. Returns null if the model is not runnable (missing memory / boot device / firmware).
buildBootAndRunint buildBootAndRun(SLMachineModel m, int rounds)Build, boot the Sleela class-driven OS, and run the built-in demo program (compute 2+3, write a char, exit) on the composed machine. Returns the OS run result. This proves the described hardware actually executes code.
buildAndRunSourceint buildAndRunSource(SLMachineModel m, int langId, String sourcePath, String programName)Build the machine, then compile and run a program FROM SOURCE in any supported language on it (0 Sleela, 1 C, 2 C++, 3 Java), reduced to the Sleela opcode substrate. Returns the program's result. This is the path a Sleela source document uses: describe the machine with named parts, then run a program on the machine the description produced.
buildAndBootGuestint buildAndBootGuest(SLMachineModel m, String kernelSourcePath, int kernelLang,Build the machine, then boot a Linux-style guest whose kernel is compiled from source on it, for a bounded instruction budget. Returns the guest instruction count executed. This connects the named-hardware machine to an SLOSModel-shaped guest OS (Linux shape) running on the Sleela VM.
builtMachineSLMachine builtMachine()No description in source.
buildCountint buildCount()No description in source.

SLMachineModel #sleela 2.5 (lib/operating-system/SLMachineModel.sleela)

SLMachineModel class

Defines SLMachineModel — the OOD aggregate of a physical machine described by its NAMED hardware parts. Where SLOSModel describes the operating system (software layers), SLMachineModel describes the computer it runs on: a CPU identity, one or more DDR memory modules, a primary storage device (SSD or HDD), the UEFI firmware, a USB host controller, and an optional video card. Each part is a named SLHardwareComponent requested from SLHardwareRegistry, so a machine is specified the way a build sheet is — "Samsung DDR5 32 GB, Samsung 990 PRO 2 TB, AMI Aptio UEFI, NVIDIA RTX 4090". A completed SLMachineModel is the input to SLMachineBuilder, which composes these parts into a runnable machine on the Sleela VM and (optionally) boots an SLOSModel on it. Family: operating-system. Composes SLHardwareRegistry parts; consumed by SLMachineBuilder.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
machineNameString machineNameNo description in source.
cpuVendorString cpuVendorCPU identity (the processor itself is modeled by lib/cpu/SLCPU at build).
cpuModelString cpuModelNo description in source.
cpuCoresint cpuCoresNo description in source.
wordBitsint wordBitsNo description in source.
clockMhzint clockMhzNo description in source.
memorySLDDRModule memoryNamed parts. main memory module (represents the populated set)
memoryModulesint memoryModuleshow many identical modules are installed
ssdSLSSD ssdprimary SSD, or null
hddSLHardDisk hddprimary HDD, or null
firmwareSLUEFIFirmware firmwareplatform firmware
usbSLUSBDevice usbUSB host controller
videoSLVideoCard videodisplay adapter, or null (headless)
configuredint configuredNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String name)No description in source.
cpuvoid cpu(String vendor, String model, int cores, int bits, int mhz)---- CPU ---------------------------------------------------------------
installMemoryvoid installMemory(SLDDRModule module, int count)---- Named parts (set from a registry lookup) --------------------------
installSsdvoid installSsd(SLSSD drive)No description in source.
installHddvoid installHdd(SLHardDisk disk)No description in source.
installFirmwarevoid installFirmware(SLUEFIFirmware fw)No description in source.
installUsbvoid installUsb(SLUSBDevice controller)No description in source.
installVideovoid installVideo(SLVideoCard card)No description in source.
nameString name()---- Accessors ---------------------------------------------------------
processorVendorString processorVendor()No description in source.
processorModelString processorModel()No description in source.
coresint cores()No description in source.
bitsint bits()No description in source.
mhzint mhz()No description in source.
memoryModuleSLDDRModule memoryModule()No description in source.
moduleCountint moduleCount()No description in source.
primarySsdSLSSD primarySsd()No description in source.
primaryHddSLHardDisk primaryHdd()No description in source.
uefiFirmwareSLUEFIFirmware uefiFirmware()No description in source.
usbControllerSLUSBDevice usbController()No description in source.
videoCardSLVideoCard videoCard()No description in source.
hasVideoboolean hasVideo()No description in source.
bootsFromSsdboolean bootsFromSsd()No description in source.
totalMemoryMbint totalMemoryMb()Total installed memory in MB across all modules.
bootCapacityBlocksint bootCapacityBlocks()The boot storage device's capacity in VM blocks (SSD preferred over HDD).
bootBlockBytesint bootBlockBytes()No description in source.
bootMediaKindint bootMediaKind()Media kind for lib/cpu/SLHardDrive: 1 solid-state, 0 rotational.
isRunnableboolean isRunnable()A machine is runnable when it has memory, a boot device, and firmware.
identityString identity()A build-sheet identity line.

SLMacOS #sleela 2.5 (lib/operating-system/SLMacOS.sleela)

SLMacOS class

Defines SLMacOS — the macOS-specific flavor of the OS family. It composes the general `os*` built-ins into macOS idioms: /bin/sh and `open` command execution, the Apple directory layout (~/Library, /Applications, /System, /Volumes), Homebrew prefixes, and `defaults`/`sw_vers`-style queries run as commands. Underneath it is genuine POSIX on Darwin — posix_spawn/waitpid, getenv/setenv, stat — plus Apple's libSystem. Guard: methods are meaningful only when osPlatform()=="macOS"; isHost() lets a program check first. Family: operating-system. Native VM/OS work crosses the explicit `os*` SLVM bridge.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
isHostboolean isHost()True when the running host is actually macOS.
shint sh(String command)---- Shell / Apple tools ----------------------------------------------- Run a command through /bin/sh.
openWithint openWith(String target)Open a file/URL/app with the default handler via the `open(1)` tool.
launchAppint launchApp(String appName)Launch a .app bundle by name, e.g. "Safari".
startShSLProcess startSh(String command)Start a background command; returns an SLProcess.
homeString home()---- Apple directory layout --------------------------------------------
libraryString library()No description in source.
appSupportString appSupport()No description in source.
preferencesString preferences()No description in source.
applicationsString applications()No description in source.
systemString system()No description in source.
volumesString volumes()No description in source.
brewPrefixString brewPrefix()Homebrew prefix: Apple Silicon uses /opt/homebrew, Intel uses /usr/local.
productVersionint productVersion()---- System facts via Apple CLIs --------------------------------------- Run `sw_vers` to print the macOS product version to the console.
readDefaultint readDefault(String domain, String key)Read a defaults domain key, e.g. domain "NSGlobalDomain", key "AppleLocale".
existsboolean exists(String path)---- Filesystem / identity (through the real OS) ------------------------
tempDirString tempDir()honours TMPDIR
hostNameString hostName()No description in source.
userNameString userName()No description in source.

SLMacOSModel #sleela 2.5 (lib/operating-system/SLMacOSModel.sleela)

SLMacOSModel class extends SLOSModel

Defines SLMacOSModel — a preset that extends SLOSModel and extrapolates it into a macOS-shaped operating system: an XNU/Darwin-style kernel, UEFI+boot.efi boot, an APFS root under the Apple directory layout (/System, /Library, /Applications, /Users), a launchd service set, a libSystem/CoreServices base package seed, and the Aqua/WindowServer desktop. It is the OOD realisation of "assume the shape of macOS". After build(), refine any layer through the inherited accessors. macOS shapes default to arm64 (Apple silicon) with x86_64 available as an added target. Family: operating-system. Extends SLOSModel.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
buildvoid build(String name, String ver)Build a macOS-shaped model with the given product name/version on arm64.
buildUniversalvoid buildUniversal(String name, String ver)Build a universal macOS model (adds the x86_64 target alongside arm64).

SLOperatingSystem #sleela 2.5 (lib/operating-system/SLOperatingSystem.sleela)

SLOperatingSystem class

Defines SLOperatingSystem — the capstone facade of the /lib/os family. It is the single object a developer reaches for to talk to the host operating system from SLeeLa source: identity (which OS, hostname, user), the environment, the working directory, and process execution. Every method bottoms out in an `os*` SLVM built-in that makes the GENUINE host System API call — Win32 on Windows, POSIX on Linux, POSIX+Apple on macOS — so the same SLeeLa program drives the real OS on whichever platform runs it. This is the general, cross-OS surface. The OS-specific flavor classes (SLWindowsOS / SLLinuxOS / SLMacOS) build on these same built-ins to expose features idiomatic to each platform. Family: operating-system. Native VM/OS work crosses the explicit `os*` SLVM bridge.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
CAP_MEMORYstatic final int CAP_MEMORY = 0Capability ordinals (mirror SLPlatformCapability in the VM).
CAP_FILE_IOstatic final int CAP_FILE_IO = 1No description in source.
CAP_NETWORKstatic final int CAP_NETWORK = 2No description in source.
CAP_THREADSstatic final int CAP_THREADS = 3No description in source.
CAP_LIBRARYstatic final int CAP_LIBRARY = 4No description in source.
CAP_TERMINALstatic final int CAP_TERMINAL= 5No description in source.
CAP_PATHSstatic final int CAP_PATHS = 6No description in source.
CAP_PROCESSstatic final int CAP_PROCESS = 7No description in source.
CAP_IPCstatic final int CAP_IPC = 8No description in source.
CAP_TIMEstatic final int CAP_TIME = 9No description in source.
nameString namehuman label chosen by the caller
openedint openedNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String label)No description in source.
openvoid open()No description in source.
closevoid close()No description in source.
activeboolean active()No description in source.
platformString platform()---- Identity ----------------------------------------------------------- The host OS name as reported by the VM: "Windows", "Linux", or "macOS".
isWindowsboolean isWindows()No description in source.
isLinuxboolean isLinux()No description in source.
isMacboolean isMac()No description in source.
hostNameString hostName()No description in source.
userNameString userName()No description in source.
processIdint processId()No description in source.
supportsboolean supports(int capability)True if the host advertises a capability class (process/ipc/network/...).
getEnvString getEnv(String key)---- Environment --------------------------------------------------------
setEnvboolean setEnv(String key, String value)No description in source.
currentDirString currentDir()---- Working directory --------------------------------------------------
changeDirboolean changeDir(String path)No description in source.
tempDirString tempDir()No description in source.
runint run(String command)---- Process execution -------------------------------------------------- Run a shell command synchronously; returns its exit code (0 == success).
runOkboolean runOk(String command)True if the command ran and exited 0.
equalsStringboolean equalsString(String a, String b)String equality helper (SLeeLa compares value by ==, but keep intent clear).

SLOSArchitecture #sleela 2.5 (lib/operating-system/SLOSArchitecture.sleela)

SLOSArchitecture class

Defines SLOSArchitecture — the target CPU architecture an OS being constructed is built for. It records the architecture triple (e.g. "x86_64-unknown-linux-gnu"), the package-architecture label used by the distribution tooling (amd64/arm64/...), the machine word width, and endianness. The ISO builder and C/C++ emitters read these to pick the right toolchain target and bootloader image. The supported architecture set mirrors the real OS projects in this lineage: amd64, arm64, armhf, ppc64el, s390x, riscv64 — the officially supported package architectures of a modern Linux distribution — plus x86 for legacy targets. A given SLOSModel composes one or more SLOSArchitecture entries (a multi-arch build) through SLArchitectureSet. Family: operating-system. Pure design model; no native bridge calls.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
tripleString tripleLLVM-style target triple
packageArchString packageArchdistro package arch label (amd64/arm64/...)
wordBitsint wordBits32 or 64
littleEndianint littleEndian1 little, 0 big
configuredint configuredNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
amd64void amd64()---- Presets ------------------------------------------------------------
arm64void arm64()No description in source.
armhfvoid armhf()No description in source.
ppc64elvoid ppc64el()No description in source.
s390xvoid s390x()No description in source.
riscv64void riscv64()No description in source.
x86void x86()No description in source.
configurevoid configure(String arch)Choose by package-arch label; defaults to amd64.
retargetForShapevoid retargetForShape(SLOSShape shape)Re-triple for a non-Linux shape so the triple reflects the target OS.
targetTripleString targetTriple()No description in source.
archString arch()No description in source.
bitsint bits()No description in source.
isLittleEndianboolean isLittleEndian()No description in source.

SLOSArtifact #sleela 2.5 (lib/operating-system/SLOSArtifact.sleela)

SLOSArtifact class

Defines SLOSArtifact — a single named build artifact produced by the OS-construction pipeline: a generated source file (os_config.h, os_boot.c, os_image.cpp), an installer script, a manifest, or the final bootable ISO descriptor. It carries a logical output path, a kind tag, and the artifact's text contents (for source/scripts/manifests) or a descriptor (for the ISO). SLOSCompiler, SLISOBuilder, and SLInstallerGenerator each produce these; SLOSBuildReport collects them. This is a flat value object (no self-reference): callers hold artifacts in their own fields or feed them to SLOSBuildReport, which accumulates a printable index without needing a dynamic array. Family: operating-system. Produced by SLOSCompiler, SLISOBuilder, SLInstallerGenerator.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
KIND_C_HEADERstatic final int KIND_C_HEADER = 0Kind tags.
KIND_C_SOURCEstatic final int KIND_C_SOURCE = 1No description in source.
KIND_CPP_SOURCEstatic final int KIND_CPP_SOURCE = 2No description in source.
KIND_SCRIPTstatic final int KIND_SCRIPT = 3No description in source.
KIND_ISOstatic final int KIND_ISO = 4No description in source.
KIND_MANIFESTstatic final int KIND_MANIFEST = 5No description in source.
pathString pathlogical output path
kindint kindone of KIND_*
contentsString contentstext (source/script/manifest) or ISO descriptor

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String outPath, int artifactKind, String text)No description in source.
outputPathString outputPath()No description in source.
artifactKindint artifactKind()No description in source.
textString text()No description in source.
byteCountint byteCount()No description in source.
kindNameString kindName()No description in source.

SLOSBuildReport #sleela 2.5 (lib/operating-system/SLOSBuildReport.sleela)

SLOSBuildReport class

Defines SLOSBuildReport — the running record of an OS build. As SLOSCompiler, SLISOBuilder, and SLInstallerGenerator produce SLOSArtifacts, each is recorded here with its path, kind, and byte size, building a printable index of everything the pipeline emitted. It also tracks the model identity the build started from and an overall success flag, so a caller can print one summary and know exactly which files to persist. The index is a newline-separated manifest ("kind size path"); no dynamic array is needed. This mirrors the honest, enumerable-output style the rest of the library favours. Family: operating-system. Collects SLOSArtifact; summarises an SLOSModel build.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
identityString identitythe model identity this build is for
indexString indexnewline-separated "kind size path" lines
artifactCountint artifactCountNo description in source.
okint ok1 if the build completed without a failure

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String modelIdentity)No description in source.
recordvoid record(SLOSArtifact a)Record one produced artifact.
failvoid fail()Mark the build as failed (e.g. an unbuildable model).
succeededboolean succeeded()No description in source.
countint count()No description in source.
artifactIndexString artifactIndex()No description in source.
modelIdentityString modelIdentity()No description in source.
summaryString summary()A one-line human summary.
intToStrString intToStr(int v)No description in source.

SLOSCompiler #sleela 2.5 (lib/operating-system/SLOSCompiler.sleela)

SLOSCompiler class

Defines SLOSCompiler — the front door of the OS-construction pipeline. It takes a configured SLOSModel (an OS designed by OOD) and compiles it to the C and C++ sources that realise the OS: it validates the model is buildable, runs SLCEmitter to produce os_config.h + os_boot.c, runs SLCppEmitter to produce os_image.cpp, and records each result as an SLOSArtifact in an SLOSBuildReport. Its output is the exact set of C/C++ files the native toolchain then compiles on the way to the ISO. This is the operational meaning of "compiling and running the Sleela files produces the C and C++ code for the OS": the SLeeLa object model IS the OS description, and this class lowers it to portable native source. It composes SLISOBuilder (the next stage) and SLInstallerGenerator (per-OS installers) so one call can carry a model all the way from object model to installable ISO. Family: operating-system. Consumes SLOSModel; composes SLCEmitter, SLCppEmitter, SLOSArtifact, SLOSBuildReport, SLISOBuilder, SLInstallerGenerator.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
cEmitSLCEmitter cEmitNo description in source.
cppEmitSLCppEmitter cppEmitNo description in source.
reportSLOSBuildReport reportNo description in source.
configHeaderSLOSArtifact configHeaderThe artifacts of the most recent compile (held for the caller to persist).
bootUnitSLOSArtifact bootUnitNo description in source.
osImageSLOSArtifact osImageNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
compileSLOSBuildReport compile(SLOSModel m)Compile a model to C and C++. Returns the build report (succeeded() is false if the model is not buildable). Artifacts are reachable via the header()/boot()/image() accessors afterward.
compileToIsoSLOSBuildReport compileToIso(SLOSModel m)Compile the model, then build its ISO and generate its installer in one call. The returned report indexes every artifact across all three stages.
headerSLOSArtifact header()---- Accessors to the most recent compile's artifacts -------------------
bootSLOSArtifact boot()No description in source.
imageSLOSArtifact image()No description in source.
lastReportSLOSBuildReport lastReport()No description in source.

SLOSCreator #sleela 2.5 (lib/operating-system/os-creator/SLOSCreator.sleela)

SLOSCreator class

Defines SLOSCreator — the OS Creator(TM) provider: the single

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
uefiSLUEFIEmitter uefiNo description in source.
biosSLBIOSEmitter biosNo description in source.
bootLoaderSLBootLoaderEmitter bootLoaderNo description in source.
kernelLoaderSLKernelLoaderEmitter kernelLoaderNo description in source.
driverLoaderSLDriverLoaderEmitter driverLoaderNo description in source.
osLoaderSLOSLoaderEmitter osLoaderNo description in source.
desktopLoaderSLDesktopLoaderEmitter desktopLoaderNo description in source.
compatLoaderSLCompatLoaderEmitter compatLoaderNo description in source.
baseDriverEmitSLBaseDriverEmitter baseDriverEmitNo description in source.
cEmitSLCEmitter cEmitNo description in source.
cppEmitSLCppEmitter cppEmitNo description in source.
toolchainSLToolchainEmitter toolchainNo description in source.
dropperSLSourceDropper dropperNo description in source.
treeSLOSDevTree treeNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
createSLOSBuildReport create(SLOSModel m, String root)The OS Creator(TM) provider entry point. Materialise a complete /os-development tree at `root` for the given model. Returns a build report indexing every file written. If the model is not buildable, the report is marked failed and nothing is written.
downloadsConfString downloadsConf(SLOSModel m)The resolved download URLs for the model, as a conf header + the set's manifest ("<kind> <phase> <url>" lines from SLDownloadSet).
planString plan(SLOSModel m)plan() returns a human description of what create() would write, without touching the filesystem — useful for a dry run.
writePiecevoid writePiece(SLOSPiece p, SLOSBuildReport report)Write a piece and record each of its files in the report.
recordWritevoid recordWrite(SLOSBuildReport report, String path, int bytes)Record a direct writeFile result in the report when the write succeeded.
sourceArtifactSLOSArtifact sourceArtifact(String path)Build a lightweight artifact handle for the report index.
devTreeSLOSDevTree devTree()No description in source.

SLOSDevTree #sleela 2.5 (lib/operating-system/os-creator/SLOSDevTree.sleela)

SLOSDevTree class

Defines SLOSDevTree — the on-disk /os-development directory that OS Creator(TM) materialises. It owns the real filesystem side of the provider: it creates the directory layout with the osMakeDir bridge and writes every file (piece source, config, README, toolchain, manifest) through the openFile/write/close content built-ins. It also accumulates a MANIFEST.md index of everything written so the result is self-describing. Every write is a GENUINE host filesystem write across the explicit VM/OS bridge; nothing is in-memory only. A fresh SLOSDevTree is rooted at a caller- chosen path (conventionally "/os-development"), creates the standard subtree, and then accepts files relative to that root. Family: operating-system. Writes via the os*/file I/O bridge; records a manifest.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
rootString rootabsolute output root, e.g. "/os-development"
manifestString manifestnewline-separated "bytes path" index
fileCountint fileCountNo description in source.
configuredint configuredNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String outputRoot)No description in source.
layoutint layout(boolean withDesktop)Create the standard /os-development subtree. Returns 1 on success. Existing directories are tolerated (osMakeDir is idempotent-friendly in the bridge).
makeDirint makeDir(String rel)Make one directory relative to the root (relative "" makes the root itself).
writeFileint writeFile(String rel, String contents)Write one file relative to the root, creating/truncating it. Records the write in the manifest. Returns the byte count written (-1 on failure).
writePiecevoid writePiece(SLOSPiece p)Write every file an SLOSPiece carries into the piece's subtree.
recordFilevoid recordFile(String rel, int bytes)No description in source.
writeManifestint writeManifest(String identityLine)Finalise the tree: write MANIFEST.md listing everything produced.
outputRootString outputRoot()No description in source.
filesWrittenint filesWritten()No description in source.
fileIndexString fileIndex()No description in source.
intToStrString intToStr(int v)No description in source.

SLOSLoaderEmitter #sleela 2.5 (lib/operating-system/os-creator/SLOSLoaderEmitter.sleela)

SLOSLoaderEmitter class

Defines SLOSLoaderEmitter — the OS Creator(TM) emitter for the OS-loader piece: PID 1 and the service manager. Given an SLOSModel it produces the C and C++ source for the first user-space process the kernel starts, which brings up the model's service manager (systemd / Service Control Manager / launchd) and the services the SLServiceSet enables, then (on a desktop edition) starts the display stack. It emits a services.conf listing each unit and its mode (boot|ondemand). This is piece #6 of the chain (userspace services). The emitted C starts the named manager and iterates the model's boot-time units. Family: operating-system. OS Creator(TM) piece emitter; consumes SLOSModel, fills SLOSPiece.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
emitSLOSPiece emit(SLOSModel m)No description in source.
emitServiceStartsString emitServiceStarts(String units)One start_service() call per boot-mode unit in the manifest.
bootUnitListString bootUnitList(String units)No description in source.
nameOfString nameOf(String line)No description in source.
modeOfString modeOf(String line)No description in source.
strLenint strLen(String s)No description in source.
substrString substr(String s, int a, int b)No description in source.
charAtString charAt(String s, int i)No description in source.
boolLitString boolLit(boolean b)No description in source.

SLOSModel #sleela 2.5 (lib/operating-system/SLOSModel.sleela)

SLOSModel class

Defines SLOSModel — the root aggregate of the OS-construction

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
osNameString osNameproduct name, e.g. "Determinant"
editionString edition"Desktop" / "Server"
versionString versionproduct version
shapeSLOSShape shapeNo description in source.
archesSLArchitectureSet archesNo description in source.
bootSLBootloaderSpec bootNo description in source.
kernelSLKernelSpec kernelNo description in source.
filesystemSLFilesystemLayout filesystemNo description in source.
swapSLSwapConfig swapswap/paging kind + quality
baseDriversSLBaseDriverSeries baseDriversminimum-boot driver series
driverSourceSLDriverSource driverSourcedriver provenance/trust + cross-OS bridge
driversSLDriverSet driversNo description in source.
packagesSLPackageSet packagesNo description in source.
servicesSLServiceSet servicesNo description in source.
desktopSLDesktopSpec desktopNo description in source.
compatSLCompatSet compatforeign-OS execution capability (optional layer)
downloadsSLDownloadSet downloadsURLs for related downloads (pre-compile / pre-ISO)
configFilesSLConfigSet configFilesthe settings files that must be present pre-build
configuredint configuredNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String name, String ver)Begin a model with a product name and version. Layers are created empty; call shape(...) to populate them with a family's defaults.
shapeAsvoid shapeAs(String family, String primaryArch)OOD extrapolation: take the shape of a named family ("Linux"/"Windows"/ "macOS") on a primary architecture, filling every layer with that family's defaults. Refine any layer afterwards by reaching its spec object.
asServervoid asServer()Mark this as a server edition: drop the desktop layer.
osShapeSLOSShape osShape()---- Accessors for the layers (for refinement and emission) -------------
architecturesSLArchitectureSet architectures()No description in source.
bootloaderSLBootloaderSpec bootloader()No description in source.
kernelSpecSLKernelSpec kernelSpec()No description in source.
layoutSLFilesystemLayout layout()No description in source.
swapConfigSLSwapConfig swapConfig()No description in source.
baseDriverSeriesSLBaseDriverSeries baseDriverSeries()No description in source.
driverPolicySLDriverSource driverPolicy()No description in source.
driverSetSLDriverSet driverSet()No description in source.
fsCatalogSLFilesystemCatalog fsCatalog()The filesystem (file-table) type catalogue — a fresh reference helper for choosing/validating a filesystem format (FAT/NTFS/ext4/APFS/...).
packageSetSLPackageSet packageSet()No description in source.
serviceSetSLServiceSet serviceSet()No description in source.
desktopSpecSLDesktopSpec desktopSpec()No description in source.
compatSetSLCompatSet compatSet()No description in source.
downloadSetSLDownloadSet downloadSet()No description in source.
configSetSLConfigSet configSet()No description in source.
nameString name()No description in source.
osVersionString osVersion()No description in source.
osEditionString osEdition()No description in source.
isBuildableboolean isBuildable()---- Validity: can this model be built into a bootable OS? -------------- Every irreducible layer must be present and self-consistent.
readyToCompileboolean readyToCompile()---- Pre-build readiness: downloads + settings in place ----------------- Before the OS is COMPILED, the model must be buildable AND the related download URLs and the required settings files for the compile phase must be declared. This is the gate the OS Creator checks before emitting/compiling.
readyForIsoboolean readyForIso()Before the final ISO conversion, additionally the ISO-phase downloads (firmware, runtime payloads) and settings (services, swap) must be ready.
identityString identity()A short, human-readable identity line for logs and ISO volume labels.

SLOSNativeSubsystem #sleela 2.5 (lib/operating-system/SLOSNativeSubsystem.sleela)

SLOSNativeSubsystem class

Defines SLOSNativeSubsystem -- the SLeeLa-facing handle to the

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
libraryString librarythe static library the /os subsystem builds to
configuredint configuredNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
libraryNameString libraryName()No description in source.
headerForString headerFor(String capability)---- Capability -> native header map ---------------------------------- headerFor(capability): the C ABI header backing a capability, or "" if the capability is not one this subsystem provides. Capabilities: download, manipulate, ideology, security, aggregate (plus shape, base-drivers).
providesboolean provides(String capability)No description in source.
theSLeeLaString theSLeeLa(String capability)theSLeeLa(capability): the lib/os SLeeLa class that USES this native capability across the os* bridge, so the two halves are paired.
capabilityCountint capabilityCount()Number of executive capabilities backed by the native subsystem.
contractSheetString contractSheet()A newline-separated contract sheet a tool or README can print.

SLOSPiece #sleela 2.5 (lib/operating-system/os-creator/SLOSPiece.sleela)

SLOSPiece class

Defines SLOSPiece — one emitted piece of an OS produced by OS Creator(TM). A piece is a named unit of the firmware -> boot -> kernel -> userspace -> desktop chain (UEFI, BIOS, Boot Loader, Kernel Loader, Driver Loader, OS Loader, Desktop GUI Loader, or the OS itself) together with the files that realise it: its C source, its C++ source, its configuration file, and a short README. SLOSCreator produces one SLOSPiece per piece and hands them to SLOSDevTree to be written under /os-development. This is a flat value object; the per-piece emitters fill it and SLOSDevTree writes it. Each piece knows its own subdirectory and base file name so the tree layout is derived, not hard-coded in the writer. Family: operating-system. Produced by the OS Creator(TM) piece emitters.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
nameString namehuman name, e.g. "Boot Loader"
directoryString directorytree-relative dir, e.g. "boot/loader"
baseNameString baseNamefile stem, e.g. "bootloader"
cSourceString cSourcethe .c surface
cppSourceString cppSourcethe .cpp surface
configNameString configNameconfig file name, e.g. "loader.conf"
configTextString configTextconfig file contents
readmeString readmeper-piece README.md contents
configuredint configuredNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String pieceName, String dir, String stem)No description in source.
setCvoid setC(String src)No description in source.
setCppvoid setCpp(String src)No description in source.
setConfigvoid setConfig(String fileName, String text)No description in source.
setReadmevoid setReadme(String text)No description in source.
cPathString cPath()---- Derived file paths (relative to the dev-tree root) -----------------
cppPathString cppPath()No description in source.
configPathString configPath()No description in source.
readmePathString readmePath()No description in source.
pieceNameString pieceName()---- Accessors ----------------------------------------------------------
dirString dir()No description in source.
cString c()No description in source.
cppString cpp()No description in source.
configString config()No description in source.
configFileString configFile()No description in source.
readmeTextString readmeText()No description in source.
hasConfigboolean hasConfig()No description in source.
hasReadmeboolean hasReadme()No description in source.

SLOSSensitivityFetch #sleela 2.5 (lib/operating-system/SLOSSensitivityFetch.sleela)

SLOSSensitivityFetch class

Defines SLOSSensitivityFetch -- the OPT-IN, per-user downloader

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
MODE_SHALLOWstatic final int MODE_SHALLOW = 0Fetch depth/mode tags. --depth 1 --single-branch (default)
MODE_FULLstatic final int MODE_FULL = 1full history
srcSLOSSensitivitySource srcthe reference (field; wired by configure())
modeint modeNo description in source.
lastExitint lastExitexit code of the most recent fetch (-1 if none run)

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
useSourcevoid useSource(SLOSSensitivitySource source)Point at a specific reference instead of the default.
setModevoid setMode(int m)No description in source.
sourceSLOSSensitivitySource source()No description in source.
cloneCommandString cloneCommand(String destDir)Build the git clone command that fetch(root) will run, without running it. Exposed so a tool can show or log the exact command (dry run).
pinCommandString pinCommand(String destDir)After a FULL clone, hard-pin the reference commit (shallow clones can only pin the branch tip). Returns the checkout command, or "" for shallow mode.
fetchint fetch(String destRoot, boolean force)The opt-in fetch. Creates destRoot, clones the warehouse into destRoot/<repo>, optionally pins the commit, and returns the git exit code (0 == success). force==false and an existing destination short-circuits to 0 so a re-run does not re-download.
fetchShallowint fetchShallow(String destRoot)Convenience: shallow fetch (the safe default).
fetchCompleteint fetchComplete(String destRoot)Convenience: full fetch pinned to the reference commit.
lastExitCodeint lastExitCode()No description in source.
succeededboolean succeeded()No description in source.
probeint probe()Verify the warehouse is reachable without downloading it (git ls-remote). Returns 0 when the branch is resolvable. Cheap pre-flight for a GUI.
shapePathString shapePath(String destRoot, String shape)After a fetch into destRoot, the on-disk path to a chosen shape's folder ("Linux"/"Windows"/"macOS"), e.g. destRoot/OS.Sensitivity.III/linux. Returns "" for an unknown shape.
componentPathString componentPath(String destRoot, String shape, String component)After a fetch, the on-disk path to a (shape, component) C/C++ folder, e.g. destRoot/OS.Sensitivity.III/linux/os-core. "" if shape/component bad. This routes through SLOSSensitivitySource.shapeComponentDir, so it honors the per-shape layout: windows/compat-loader (Wine), windows/reactos, macos/os-core (XNU), macos/puredarwin, macos/frameworks, macos/compat-loader.
descriptorPathString descriptorPath(String destRoot)After a fetch, the on-disk path to the machine-readable shapes.json shape descriptor at the warehouse root. The OSCreator runnable reads this to resolve shapes/components/refs/licenses/build-entries deterministically.

SLOSSensitivitySource #sleela 2.5 (lib/operating-system/SLOSSensitivitySource.sleela)

SLOSSensitivitySource class

Defines SLOSSensitivitySource -- the zero-payload REFERENCE to

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
nameString nameWarehouse identity.
ownerString ownerNo description in source.
repoString repoNo description in source.
urlString urlhttps clone URL
branchString branchdefault branch
pinnedCommitString pinnedCommitexact revision for reproducible fetches

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()Configure with the known OS.Sensitivity.III warehouse reference. The pinned commit is the current main tip; callers may repin with pin(commit).
descriptorFileString descriptorFile()The machine-readable shape descriptor at the warehouse root. The OSCreator runnable reads this (after fetch) to resolve shapes, component paths, pinned upstream refs, licenses, and build entry points without hard-coding.
descriptorPathString descriptorPath(String destRoot)On-disk path to the descriptor after a fetch into destRoot.
pinvoid pin(String commit)Repin to a specific revision (keeps fetches reproducible).
identityString identity()No description in source.
cloneUrlString cloneUrl()No description in source.
defaultBranchString defaultBranch()No description in source.
commitString commit()No description in source.
shapeDirString shapeDir(String shape)---- OS shapes ------------------------------------------------------- The three top-level folders, one per operating-system shape. shapeDir returns the warehouse folder for a shape, or "" for an unknown shape. The accepted shape names mirror SLOSShape ("Linux"/"Windows"/"macOS") and their lower-case folder forms.
providesShapeboolean providesShape(String shape)No description in source.
componentDirString componentDir(String component)---- Per-component directory map ------------------------------------- The per-shape subdirectory that carries each OS component's C/C++, in the firmware -> boot -> kernel -> userspace -> desktop order the OS boots. A caller resolves (shape, component) to a full warehouse path. componentDir returns "" for an unknown component; dirFor composes shape + component.
providesComponentboolean providesComponent(String component)No description in source.
shapeComponentDirString shapeComponentDir(String shape, String component)No description in source.
providesShapeComponentboolean providesShapeComponent(String shape, String component)No description in source.
dirForString dirFor(String shape, String component)dirFor(shape, component): the warehouse path "<shape>/<component>", or "" if either the shape or the component is unknown.
downloadabilityNoteString downloadabilityNote(String part)---- Downloadability notes ------------------------------------------ What a fetch retrieves. The warehouse uses NO Git LFS, so a normal clone needs no `git lfs` step; its C/C++ is plain git objects.
referenceSheetString referenceSheet()A newline-separated reference sheet a tool or README can print.

SLOSShape #sleela 2.5 (lib/operating-system/SLOSShape.sleela)

SLOSShape class

Defines SLOSShape — the design-time "shape" an OS being

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
SHAPE_LINUXstatic final int SHAPE_LINUX = 0Canonical shape ordinals.
SHAPE_WINDOWSstatic final int SHAPE_WINDOWS = 1No description in source.
SHAPE_MACOSstatic final int SHAPE_MACOS = 2No description in source.
shapeint shapeone of SHAPE_*
labelString label"Linux" / "Windows" / "macOS"
configuredint configuredNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
linuxvoid linux()---- Construction -------------------------------------------------------
windowsvoid windows()No description in source.
macosvoid macos()No description in source.
configurevoid configure(String name)Choose by name; defaults to Linux for an unrecognised label.
isLinuxboolean isLinux()No description in source.
isWindowsboolean isWindows()No description in source.
isMacboolean isMac()No description in source.
ordinalint ordinal()No description in source.
nameString name()No description in source.
pathSeparatorString pathSeparator()---- Per-family defaults the composed specs read ----------------------- The path separator convention for this shape.
listSeparatorString listSeparator()The PATH-list separator convention for this shape.
initManagerString initManager()The name of the first user-space process / service manager.
bootStyleString bootStyle()The default firmware/boot style for this shape.
rootFilesystemString rootFilesystem()The default root-filesystem format for this shape.
desktopSessionString desktopSession()The default desktop/session shell for this shape.
systemRootString systemRoot()The conventional system-root directory for this shape.
executableExtensionString executableExtension()The conventional installed-executable extension for this shape.

SLPackageSet #sleela 2.5 (lib/operating-system/SLPackageSet.sleela)

SLPackageSet class

Defines SLPackageSet — the userland composition of an OS being constructed: the seed of packages (the base system plus layered software) that is installed into the root filesystem. This is the compositional heart of the design — "the desktop is not the kernel, and the kernel is not the distribution": each package is an independently versioned unit, and the OS is their assembled whole. It mirrors the debootstrap-style model the OS lineage uses: a base seed is laid down first, then desktop / toolchain / service packages are layered on top. Packages are accumulated into a newline-separated manifest the ISO builder consumes to populate the rootfs. Family: operating-system. Pure design model; no native bridge calls.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
manifestString manifestnewline-separated "name version" lines
countint countNo description in source.
configuredint configuredNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
addvoid add(String name, String version)Add a package with an explicit version.
addLatestvoid addLatest(String name)Add a package at an unpinned/"latest" version.
baseSeedForShapevoid baseSeedForShape(SLOSShape shape)Seed the base-system packages a shape needs before any layering.
packagesString packages()No description in source.
packageCountint packageCount()No description in source.
isEmptyboolean isEmpty()No description in source.

SLPath #sleela 2.5 (lib/operating-system/SLPath.sleela)

SLPath class

Defines SLPath — path construction and inspection that is aware of the host's path conventions. The separator differs per OS ('\' on Windows, '/' on POSIX), so SLPath asks the VM which platform it is on (osPlatform) and joins/normalizes accordingly. This is a pure-SLeeLa helper layered on the one OS fact it needs — the platform — so developers write portable path code once. Family: operating-system. Reads the host platform via the `os*` SLVM bridge.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
valueString valueNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String p)No description in source.
textString text()No description in source.
separatorString separator()The host path separator: "\\" on Windows, "/" elsewhere.
listSeparatorString listSeparator()The host entry (PATH) separator: ";" on Windows, ":" elsewhere.
joinString join(String child)Join a child segment onto this path using the host separator; returns the combined path text.
appendString append(String child)Append in place and return the new path text.
joinListString joinList(String a, String b)Build a PATH-style list string from two entries using the host list separator (";" on Windows, ":" elsewhere).
existsboolean exists()True when this path exists on the host filesystem.

SLPermissions #sleela 2.5 (lib/operating-system/SLPermissions.sleela)

SLPermissions class

Defines SLPermissions — a portable view of a filesystem entry's access permissions. The permission MODEL differs sharply between POSIX (owner/group/other read/write/execute bits) and Windows (ACL-based), so this class presents the common, portable questions — can the current process read/write/execute a path, and does the path exist — and leaves the full native ACL/mode surface to the OS-specific flavor classes. Existence and type come from the real OS via `os*`; the read/write/execute view is modeled from existence + platform until finer-grained access checks are added to the VM. Family: operating-system. Native VM/OS work crosses the explicit `os*` SLVM bridge.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
pathString pathNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String p)No description in source.
existsboolean exists()No description in source.
readableboolean readable()Portable access questions. Existence is authoritative (from the host); the finer read/write/execute distinctions are conservatively derived here and refined by SLWindowsOS / SLLinuxOS / SLMacOS where the native model allows.
writableboolean writable()No description in source.
executableboolean executable()No description in source.
posixModelboolean posixModel()Whether the host uses the POSIX mode-bit model (vs. Windows ACLs).

SLProcess #sleela 2.5 (lib/operating-system/SLProcess.sleela)

SLProcess class

Defines SLProcess — a host operating-system process launched from SLeeLa source. It wraps the VM's process built-ins: osRun (synchronous), osSpawn (background), osWait (reap + exit code), osKill (terminate), and osProcessClose (release). Underneath, the VM calls CreateProcess + Wait* on Windows and posix_spawn + waitpid on Linux/macOS; the spawned child is a VM-local handle, never a raw PID, keeping the bounded-handle safety model. Lifecycle: configure(command) -> start() (async) or runSync(); then wait() for the exit code, or kill() to terminate. A handle is single-use: wait() and close() both release it. Family: operating-system. Native VM/OS work crosses the explicit `os*` SLVM bridge.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
STATE_NEWstatic final int STATE_NEW = 0No description in source.
STATE_RUNNINGstatic final int STATE_RUNNING = 1No description in source.
STATE_EXITEDstatic final int STATE_EXITED = 2No description in source.
STATE_FAILEDstatic final int STATE_FAILED = 3No description in source.
commandString commandNo description in source.
handleint handleVM-local process handle (-1 = none)
stateint stateNo description in source.
exitCodeint exitCodeNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String cmd)No description in source.
runSyncint runSync()Run synchronously: block until the process exits, recording the exit code. Returns the exit code (0 == success).
startboolean start()Start the process in the background. Returns true if it launched. After a successful start the process is RUNNING and must be reaped with wait() (or released with close()).
waitint wait()Block for a started process and collect its exit code; releases the handle.
killboolean kill()Terminate a running process and release its handle (reaping it), so a kill-only path does not leak a VM process-table slot. After kill() the process is FAILED and the handle is gone.
closevoid close()Release a started-but-unwaited process without blocking.
runningboolean running()No description in source.
succeededboolean succeeded()No description in source.
statusint status()No description in source.
processStateint processState()No description in source.

SLServiceSet #sleela 2.5 (lib/operating-system/SLServiceSet.sleela)

SLServiceSet class

Defines SLServiceSet — the system-service layer of an OS being constructed: the set of services the init/service manager (systemd on Linux shapes, the Service Control Manager on Windows shapes, launchd on macOS shapes) brings up after the kernel hands off to user space. It records the name of the manager and the enabled services (device management, networking, logging, login/session, time sync), each marked as a boot-time or on-demand unit. In the firmware -> boot -> kernel -> userspace -> desktop model, this is the userspace-services node (PID 1 and the units it starts). The emitters turn the enabled set into the per-manager unit/registry artifacts the ISO carries. Family: operating-system. Pure design model; no native bridge calls.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
managerString manager"systemd" / "ServiceControlManager" / "launchd"
unitsString unitsnewline-separated "name mode" lines (mode: boot|ondemand)
countint countNo description in source.
configuredint configuredNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String svcManager)No description in source.
addUnitvoid addUnit(String name, String mode)No description in source.
enableAtBootvoid enableAtBoot(String name)No description in source.
enableOnDemandvoid enableOnDemand(String name)No description in source.
forShapevoid forShape(SLOSShape shape)Seed the baseline services a shape brings up, under its own manager.
serviceManagerString serviceManager()No description in source.
unitManifestString unitManifest()No description in source.
serviceCountint serviceCount()No description in source.
hasServicesboolean hasServices()No description in source.

SLSourceDropper #sleela 2.5 (lib/operating-system/os-creator/SLSourceDropper.sleela)

SLSourceDropper class

Defines SLSourceDropper — the OS Creator(TM) stage that places the SLeeLa SOURCE that produced an /os-development tree into that tree, so the output is self-reproducing: a reader of /os-development can see both the generated C/C++ and the SLeeLa model + creator source that generated it. It writes a src/sleela/os-model.sleela recreation of the model's construction calls and a src/README.md explaining the provenance and how to regenerate. The dropper does not read the live library files (the VM does not expose the repository tree to a running program); instead it reconstructs the minimal, runnable SLeeLa that rebuilds the same model, which is the honest, portable form of "the source that made this". Family: operating-system. OS Creator(TM) stage; writes into the dev tree via SLOSDevTree.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
dropvoid drop(SLOSModel m, SLOSDevTree tree)Drop the reconstructable SLeeLa source and a provenance README into the tree.
modelSourceString modelSource(SLOSModel m)A minimal, runnable SLeeLa program that reconstructs this model and re-runs OS Creator(TM) to regenerate the tree.
provenanceString provenance(SLOSModel m)No description in source.

SLSSD #sleela 2.5 (lib/operating-system/ssd/SLSSD.sleela)

SLSSD class extends SLHardwareComponent

Defines SLSSD — a named solid-state drive. It extends SLHardwareComponent and models the finite catalogue of SSD variants by the dimensions that actually distinguish them: host interface (SATA III, NVMe/PCIe 3.0/4.0/5.0), form factor (2.5", M.2 2280, U.2, add-in card), NAND type (SLC/MLC/TLC/QLC), capacity, and representative sequential read/write throughput. A machine description requests an SSD by manufacturer + model (or a preset) and composes it as a boot/storage device. It is a storage device: capacity-in-blocks maps onto the VM's block store the same way SLHardDisk and lib/cpu/SLHardDrive do, so a named SSD can be the emulated machine's boot disk. Family: operating-system. Extends SLHardwareComponent.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
IF_SATA3static final int IF_SATA3 = 0Interface ordinals. 6 Gb/s
IF_NVME_PCIE3static final int IF_NVME_PCIE3 = 1No description in source.
IF_NVME_PCIE4static final int IF_NVME_PCIE4 = 2No description in source.
IF_NVME_PCIE5static final int IF_NVME_PCIE5 = 3No description in source.
NAND_SLCstatic final int NAND_SLC = 1NAND cell types.
NAND_MLCstatic final int NAND_MLC = 2No description in source.
NAND_TLCstatic final int NAND_TLC = 3No description in source.
NAND_QLCstatic final int NAND_QLC = 4No description in source.
ifaceint ifaceIF_*
formFactorString formFactor"2.5\"", "M.2 2280", "U.2", "AIC"
nandint nandNAND_*
capacityGbint capacityGbNo description in source.
seqReadMBpsint seqReadMBpsrepresentative sequential read
seqWriteMBpsint seqWriteMBpsrepresentative sequential write
blockBytesint blockByteslogical block size (typically 512 or 4096)

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String manufacturer, String partName, int interfaceKind, int capacityGigabytes)Configure from manufacturer, model, interface, and capacity. The interface preset fills representative throughput and form factor; refine afterward.
configureByNamevoid configureByName(String manufacturer, String partName, String ifName, int capacityGb)Configure by interface name ("SATA", "PCIe3", "PCIe4", "PCIe5").
setNandvoid setNand(int cellType)No description in source.
setFormFactorvoid setFormFactor(String ff)No description in source.
setThroughputvoid setThroughput(int readMBps, int writeMBps)No description in source.
isNvmeboolean isNvme()No description in source.
interfaceNameString interfaceName()No description in source.
nandNameString nandName()No description in source.
formString form()No description in source.
capacityGigabytesint capacityGigabytes()No description in source.
readMBpsint readMBps()No description in source.
writeMBpsint writeMBps()No description in source.
blockSizeint blockSize()No description in source.
capacityBlocksint capacityBlocks()Capacity as VM block count for the given block size — what SLMachineModel hands the block store when this SSD is the boot disk.

SLSSDCatalog #sleela 2.5 (lib/operating-system/ssd/SLSSDCatalog.sleela)

SLSSDCatalog class

Defines SLSSDCatalog — a by-name factory for solid-state drives from the major SSD manufacturers (Samsung, Western Digital, SK Hynix, Crucial/Micron, Kingston, Seagate, Intel/Solidigm, Corsair, Sabrent). It returns representative, correctly-specified SLSSD instances for well-known families so a machine description can request storage by maker and model name rather than by raw specification. Representative model names are used for identity; exact capacities and speeds vary by SKU and can be refined on the returned SLSSD. Family: operating-system. Produces SLSSD.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
nvme4SLSSD nvme4(String manufacturer, int capacityGb)A flagship NVMe PCIe 4.0 drive from a named manufacturer.
nvme5SLSSD nvme5(String manufacturer, int capacityGb)A flagship NVMe PCIe 5.0 drive from a named manufacturer.
sataSLSSD sata(String manufacturer, int capacityGb)A SATA III 2.5" drive from a named manufacturer.
driveSLSSD drive(String manufacturer, String ifName, int capacityGb)Build an SSD by interface name from any manufacturer.
knownboolean known(String manufacturer)No description in source.
nvme5PartString nvme5Part(String mfr)---- Representative model names ----------------------------------------
nvmePartString nvmePart(String mfr)No description in source.
sataPartString sataPart(String mfr)No description in source.
partForString partFor(String mfr, String ifName)No description in source.

SLSupportDownloader #sleela 2.5 (lib/operating-system/SLSupportDownloader.sleela)

SLSupportDownloader class

Defines SLSupportDownloader — the resilient fallback downloader

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
PRIO_AUTHORITATIVEstatic final int PRIO_AUTHORITATIVE = 0Priority ordinals (lower = tried first; by likelihood of a final/edu ref).
PRIO_OFFICIAL_MIRRORstatic final int PRIO_OFFICIAL_MIRROR = 1No description in source.
PRIO_COLLEGEstatic final int PRIO_COLLEGE = 2No description in source.
PRIO_ARCHIVEstatic final int PRIO_ARCHIVE = 3No description in source.
configuredint configuredNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
kernelPrimaryString kernelPrimary()Linux kernel source mirrors.
kernelSupportString kernelSupport(int prio)No description in source.
packagePrimaryString packagePrimary()Ubuntu/Debian package archive mirrors.
packageSupportString packageSupport(int prio)No description in source.
firmwarePrimaryString firmwarePrimary()linux-firmware source mirrors.
firmwareSupportString firmwareSupport(int prio)No description in source.
upstreamPrimaryString upstreamPrimary()The upstream Determinant distro mirrors.
upstreamSupportString upstreamSupport(int prio)No description in source.
winePrimaryString winePrimary()Wine runtime mirrors.
wineSupportString wineSupport(int prio)No description in source.
qemuPrimaryString qemuPrimary()QEMU runtime mirrors.
qemuSupportString qemuSupport(int prio)No description in source.
supportUrlString supportUrl(String kind, int prio)---- Generic access by kind ---------------------------------------- supportUrl(kind, prio): the support URL for a kind at a priority, or "" when the kind is unknown. kind is one of: kernel/package/firmware/upstream/ wine/qemu.
knownKindboolean knownKind(String kind)No description in source.
priorityNameString priorityName(int prio)No description in source.
rankedListString rankedList(String kind)The ranked list "<priority> <url>" for a kind (primary first, archive last).
addString add(String acc, String line)No description in source.
fetchWithFallbackString fetchWithFallback(String kind, String dest)---- 404-tolerant fetch -------------------------------------------- fetchWithFallback(kind, dest): emit a POSIX shell block that tries each support URL in priority order, continuing past a 404/failure to the next, and stops at the first success. Git kinds use `git clone`, others `curl`.
isGitKindboolean isGitKind(String kind)No description in source.
firstReachableString firstReachable(String kind)---- Host-side resolution (reachability) ---------------------------- firstReachable(kind): return the highest-priority support URL that answers now (HTTP HEAD / git ls-remote), or "" if none respond. Probes via osRun.
reachableboolean reachable(String kind, String url)No description in source.
readyboolean ready()No description in source.

SLSwapConfig #sleela 2.5 (lib/operating-system/SLSwapConfig.sleela)

SLSwapConfig class

Defines SLSwapConfig — the swap (paging) configuration of an OS being constructed: the swap KIND and its QUALITY. The kind is how the OS provides backing store for paged-out memory — a swap file, a swap partition, a compressed RAM device (zram), a compressed in-RAM cache in front of a backing device (zswap), the Windows page file (pagefile.sys), the macOS dynamic swap files, or none. The quality is the tunable set that governs how aggressively and how well swap is used: the size (absolute or a RAM multiple), the swappiness (0..100 reclaim aggressiveness), the compression algorithm and level for zram/zswap, and the swap priority. It validates a chosen kind for a shape, seeds a sensible default per family, and emits the artifacts a builder needs: a Linux fstab/zram line and sysctl (vm.swappiness), or the Windows/macOS equivalent note. SLOSModel composes one; the OS generator/creator can write it as a real swap setup component. Family: operating-system. Design model; emit* produce config text. No native bridge calls.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
kindString kind"file" / "partition" / "zram" / "zswap" / "pagefile" / "dynamic" / "none"
hostString hostthe OS family this swap belongs to
sizeMbint sizeMbswap size in MB (0 = auto / RAM-relative)
ramMultipleTenthsint ramMultipleTenthssize as a multiple of RAM, in tenths (e.g. 10 = 1.0x RAM); 0 = use sizeMb
swappinessint swappiness0..100 reclaim aggressiveness (Linux vm.swappiness)
compAlgoString compAlgocompression algorithm for zram/zswap ("lzo","lz4","zstd"), else ""
compLevelint compLevelcompression quality/level (algorithm-dependent), 0 = default
priorityint priorityswap priority (higher = preferred); -1 = default
configuredint configuredNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String swapKind, int sizeMegabytes, int swappinessValue)Configure explicitly. compAlgo/compLevel apply only to zram/zswap.
normString norm(String k)No description in source.
clamp0to100int clamp0to100(int v)No description in source.
forShapevoid forShape(SLOSShape shape)Seed the family default: Linux a swap file at 1.0x RAM, swappiness 60; Windows a system-managed pagefile; macOS dynamic swap files.
setSizeMbvoid setSizeMb(int mb)---- Quality tuning ------------------------------------------------- Size the swap as an absolute MB amount, or as a multiple of RAM (tenths: 5 = 0.5x, 10 = 1.0x, 20 = 2.0x). Setting one clears the other.
setSizeRamMultiplevoid setSizeRamMultiple(int tenths)No description in source.
setSwappinessvoid setSwappiness(int v)No description in source.
setPriorityvoid setPriority(int p)No description in source.
setCompressionvoid setCompression(String algo, int level)Compression (zram/zswap only). algo in {lzo,lz4,lz4hc,zstd}; level is the algorithm's quality knob (e.g. zstd 1..22). Ignored for non-compressed kinds.
isCompressedboolean isCompressed()No description in source.
isValidboolean isValid()---- Validity ------------------------------------------------------- A compressed kind must name a compression algorithm; a sized file/partition must have either an MB size or a RAM multiple; "none" is always valid.
validForShapeboolean validForShape(SLOSShape shape)Is this kind valid for the host family? zram/zswap/file/partition are Linux; pagefile is Windows; dynamic is macOS; none is universal.
swapKindString swapKind()---- Accessors ------------------------------------------------------
swapSizeMbint swapSizeMb()No description in source.
swappinessValueint swappinessValue()No description in source.
compressionString compression()No description in source.
compressionLevelint compressionLevel()No description in source.
sizeTextString sizeText()A human size description.
tenthsString tenths(int t)No description in source.
emitLinuxString emitLinux()---- Emission ------------------------------------------------------- The Linux fstab entry (file/partition) or the systemd/zram-generator line (zram), plus a vm.swappiness sysctl. Empty for kind "none".
prioOptString prioOpt()No description in source.
algoOrDefaultString algoOrDefault()No description in source.
emitForShapeString emitForShape(SLOSShape shape)The per-shape swap note the generator/creator records.
summaryString summary()A compact summary line.

SLToolchainEmitter #sleela 2.5 (lib/operating-system/os-creator/SLToolchainEmitter.sleela)

SLToolchainEmitter class

Defines SLToolchainEmitter — the OS Creator(TM) emitter for the build tooling placed into /os-development. Given an SLOSModel it produces a top-level Makefile that compiles every emitted piece (firmware, loaders, OS) with cc/c++ and then invokes the ISO recipe, plus a build.sh (POSIX, for Linux/macOS shapes) and a build.ps1 (PowerShell, for the Windows shape) that drive the Makefile. The emitted toolchain turns the written C/C++ into the OS and the bootable ISO. This is the "place the compilation tools (make, build) into /os-development" requirement: running them builds the OS top-down from the generated sources. Output is String concatenation on OP_ADD. Family: operating-system. OS Creator(TM) emitter; consumes SLOSModel.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
intToStrString intToStr(int v)No description in source.
emitMakefileString emitMakefile(SLOSModel m, boolean withDesktop)The top-level Makefile that builds all pieces and authors the ISO.
emitBuildShString emitBuildSh(SLOSModel m)POSIX build driver (Linux / macOS shapes).
emitBuildPs1String emitBuildPs1(SLOSModel m)PowerShell build driver (Windows shape).
emitOsConfString emitOsConf(SLOSModel m)The global os.conf config carrying the model identity.
isoNameString isoName(SLOSModel m)No description in source.

SLUEFIEmitter #sleela 2.5 (lib/operating-system/os-creator/SLUEFIEmitter.sleela)

SLUEFIEmitter class

Defines SLUEFIEmitter — the OS Creator(TM) emitter for the UEFI firmware piece. Given an SLOSModel it produces the C and C++ source for a UEFI application entry point that initialises boot services, locates the EFI System Partition, and chain-loads the model's boot loader, plus a uefi.conf recording the firmware vendor, UEFI revision, Secure Boot, and ESP label. The result is written to /os-development/firmware/uefi. This is piece #1 of the firmware -> boot -> kernel -> userspace -> desktop chain. Output is String concatenation on OP_ADD; no new VM opcode is used. Family: operating-system. OS Creator(TM) piece emitter; consumes SLOSModel, fills SLOSPiece.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
emitSLOSPiece emit(SLOSModel m)No description in source.
loaderImageString loaderImage(String loader)Map a loader name to its EFI image filename.
boolLitString boolLit(boolean b)No description in source.

SLUEFIFirmware #sleela 2.5 (lib/operating-system/uefi/SLUEFIFirmware.sleela)

SLUEFIFirmware class extends SLHardwareComponent

Defines SLUEFIFirmware — a named UEFI platform firmware. It extends SLHardwareComponent and models the finite set of UEFI implementations and their relevant attributes: the firmware vendor (AMI Aptio, Insyde InsydeH2O, Phoenix SecureCore, the open-source TianoCore/EDK II, and coreboot+Tianocore payloads), the UEFI specification revision it implements, Secure Boot capability, the Compatibility Support Module (legacy BIOS) option, the boot-services/runtime-services split, and the EFI System Partition it reads. A machine description selects a firmware and composes it as the part that hands control to a bootloader. This is the hardware/firmware counterpart to the OS-side SLBootloaderSpec: the firmware is what runs first and loads the loader named there. Family: operating-system. Extends SLHardwareComponent.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
specRevisionString specRevisionUEFI spec revision, e.g. "2.10"
secureBootint secureBoot1 if Secure Boot is supported
csmint csm1 if a Compatibility Support Module (legacy BIOS) exists
bootServicesint bootServices1 if boot services present (always, modeled)
runtimeServicesint runtimeServices1 if runtime services present
espLabelString espLabelEFI System Partition label it reads
configured2int configured2No description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String vendor, String product, String revision)No description in source.
amivoid ami()Named presets for the common firmware vendors.
insydevoid insyde()No description in source.
phoenixvoid phoenix()No description in source.
tianocorevoid tianocore()No description in source.
corebootvoid coreboot()No description in source.
configureByVendorvoid configureByVendor(String vendor)Choose by vendor name; defaults to TianoCore (the reference/open firmware).
enableSecureBootvoid enableSecureBoot(boolean on)No description in source.
enableCsmvoid enableCsm(boolean on)No description in source.
uefiRevisionString uefiRevision()No description in source.
supportsSecureBootboolean supportsSecureBoot()No description in source.
hasCsmboolean hasCsm()No description in source.
hasRuntimeServicesboolean hasRuntimeServices()No description in source.
espString esp()No description in source.
canLaunchboolean canLaunch(String loaderName)True if this firmware can hand off to the given OS-side bootloader name. Modeled: UEFI firmware can launch any EFI loader; a legacy loader needs CSM.

SLUSBCatalog #sleela 2.5 (lib/operating-system/usb/SLUSBCatalog.sleela)

SLUSBCatalog class

Defines SLUSBCatalog — a by-name factory for USB host controllers and devices. USB host-controller silicon comes from a finite set of vendors (Intel, AMD, ASMedia, VIA, Renesas, Texas Instruments, Fresco Logic), and the catalogue returns representative, correctly-specified SLUSBDevice instances — a root/host controller for the machine, or a class device (keyboard/mouse HID, mass-storage key, hub) to attach to it. Family: operating-system. Produces SLUSBDevice.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
controllerSLUSBDevice controller(String vendor, String genName, int ports)A USB host controller (root hub) from a named vendor at a generation.
hubSLUSBDevice hub(String vendor, String genName, int ports)A USB hub from a named vendor.
hidSLUSBDevice hid(String vendor, String part)A HID device (keyboard/mouse), typically USB 2.0 Type-A.
flashDriveSLUSBDevice flashDrive(String vendor, String part, String genName)A mass-storage flash drive at a given generation.
knownControllerboolean knownController(String vendor)No description in source.
controllerPartString controllerPart(String vendor)No description in source.

SLUSBDevice #sleela 2.5 (lib/operating-system/usb/SLUSBDevice.sleela)

SLUSBDevice class extends SLHardwareComponent

Defines SLUSBDevice — a named Universal Serial Bus device or controller. It extends SLHardwareComponent and models the finite USB specification generations by name (USB 1.1, 2.0, 3.2 Gen 1/Gen 2/Gen 2x2, USB4) together with the attributes a machine description needs: signalling rate, connector type (A / B / C / Micro), device class (HID, mass storage, hub, audio, video), and whether the port can deliver USB Power Delivery. A machine description requests a controller/device by generation and class and attaches it to the machine's USB tree. Family: operating-system. Extends SLHardwareComponent.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
USB_1_1static final int USB_1_1 = 0Specification-generation ordinals. Full Speed, 12 Mb/s
USB_2_0static final int USB_2_0 = 1High Speed, 480 Mb/s
USB_3_2G1static final int USB_3_2G1 = 25 Gb/s (formerly USB 3.0)
USB_3_2G2static final int USB_3_2G2 = 310 Gb/s (formerly USB 3.1)
USB_3_2G2X2static final int USB_3_2G2X2 = 420 Gb/s
USB4static final int USB4 = 540 Gb/s
UC_HIDstatic final int UC_HID = 1Device-class ordinals (USB class codes, abbreviated set).
UC_MASSstatic final int UC_MASS = 2No description in source.
UC_HUBstatic final int UC_HUB = 3No description in source.
UC_AUDIOstatic final int UC_AUDIO = 4No description in source.
UC_VIDEOstatic final int UC_VIDEO = 5No description in source.
UC_CONTROLLERstatic final int UC_CONTROLLER = 6host controller / root hub
generationint generationUSB_*
usbClassint usbClassUC_*
rateMbpsint rateMbpssignalling rate in Mb/s
connectorString connector"Type-A" / "Type-B" / "Type-C" / "Micro-B"
powerDeliveryint powerDelivery1 if USB-PD capable
maxPortsint maxPortsfor hubs/controllers

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String manufacturer, String partName, int gen, int cls)No description in source.
configureByNamevoid configureByName(String manufacturer, String partName, String genName, int cls)Configure by generation name ("USB1.1","USB2.0","USB3.2G1","USB3.2G2","USB3.2G2x2","USB4").
setConnectorvoid setConnector(String c)No description in source.
setPortsvoid setPorts(int ports)No description in source.
generationNameString generationName()No description in source.
usbClassNameString usbClassName()No description in source.
signallingRateMbpsint signallingRateMbps()No description in source.
connectorTypeString connectorType()No description in source.
hasPowerDeliveryboolean hasPowerDelivery()No description in source.
portCountint portCount()No description in source.
isControllerboolean isController()No description in source.

SLVideoCard #sleela 2.5 (lib/operating-system/video-cards/SLVideoCard.sleela)

SLVideoCard class extends SLHardwareComponent

Defines SLVideoCard — a named graphics card (GPU). It extends SLHardwareComponent and models the finite set of GPU variants by the attributes a machine description needs: the GPU vendor (NVIDIA, AMD, Intel) and architecture family, the board interface (PCIe generation and lane count), video memory size and type (GDDR6/GDDR6X/GDDR7/HBM), display outputs (HDMI/DisplayPort counts), board power (watts), and the APIs it advertises (Vulkan, OpenGL, Direct3D, compute). A machine description requests a card by vendor + model and composes it as the display adapter. Family: operating-system. Extends SLHardwareComponent.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
GPU_NVIDIAstatic final int GPU_NVIDIA = 0GPU vendor ordinals.
GPU_AMDstatic final int GPU_AMD = 1No description in source.
GPU_INTELstatic final int GPU_INTEL = 2No description in source.
VRAM_GDDR6static final int VRAM_GDDR6 = 0Video-memory type ordinals.
VRAM_GDDR6Xstatic final int VRAM_GDDR6X = 1No description in source.
VRAM_GDDR7static final int VRAM_GDDR7 = 2No description in source.
VRAM_HBMstatic final int VRAM_HBM = 3No description in source.
gpuVendorint gpuVendorGPU_*
architectureString architecturee.g. "Ada Lovelace", "RDNA 3", "Xe-HPG"
pcieGenint pcieGenPCIe generation (3,4,5)
pcieLanesint pcieLanestypically 16
vramMbint vramMbvideo memory in MB
vramTypeint vramTypeVRAM_*
hdmiPortsint hdmiPortsNo description in source.
displayPortsint displayPortsNo description in source.
boardPowerWint boardPowerWtypical board power (TGP) in watts
vulkanint vulkan1 if Vulkan supported
direct3dint direct3d1 if Direct3D 12 supported

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String vendorName, String partName, int vendorOrdinal, int vramMegabytes)No description in source.
configureByVendorvoid configureByVendor(String vendorName, String partName, int vramMb)Configure by vendor name ("NVIDIA"/"AMD"/"Intel").
setArchitecturevoid setArchitecture(String arch)No description in source.
setPcievoid setPcie(int gen, int lanes)No description in source.
setVramvoid setVram(int megabytes, int type)No description in source.
setOutputsvoid setOutputs(int hdmi, int dp)No description in source.
setBoardPowervoid setBoardPower(int watts)No description in source.
vendorNameString vendorName()No description in source.
architectureNameString architectureName()No description in source.
pcieGenerationint pcieGeneration()No description in source.
lanesint lanes()No description in source.
vramMegabytesint vramMegabytes()No description in source.
vramTypeNameString vramTypeName()No description in source.
outputsTotalint outputsTotal()No description in source.
boardPowerint boardPower()No description in source.
supportsVulkanboolean supportsVulkan()No description in source.
supportsDirect3Dboolean supportsDirect3D()No description in source.

SLVideoCardCatalog #sleela 2.5 (lib/operating-system/video-cards/SLVideoCardCatalog.sleela)

SLVideoCardCatalog class

Defines SLVideoCardCatalog — a by-name factory for graphics cards. Discrete-GPU silicon comes from a finite set of vendors — NVIDIA (GeForce/RTX), AMD (Radeon RX), and Intel (Arc) — with board partners (ASUS, MSI, Gigabyte, Sapphire, PowerColor, Zotac) shipping the same GPUs. The catalogue returns representative, correctly-specified SLVideoCard instances for well-known models so a machine description can request a display adapter by name. Representative model names stand in for identity; VRAM and clocks vary by SKU and board partner and can be refined on the returned SLVideoCard. Family: operating-system. Produces SLVideoCard.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
geforceSLVideoCard geforce(String model, int vramMb)A GeForce/RTX card by model, e.g. geforce("RTX 4090", 24576).
radeonSLVideoCard radeon(String model, int vramMb)A Radeon RX card by model, e.g. radeon("RX 7900 XTX", 24576).
arcSLVideoCard arc(String model, int vramMb)An Intel Arc card by model, e.g. arc("A770", 16384).
cardSLVideoCard card(String vendor, String model, int vramMb)Build any card by vendor + model name.
knownVendorboolean knownVendor(String vendor)No description in source.
knownBoardPartnerboolean knownBoardPartner(String partner)Board partners that ship these GPUs (for identity/branding).
nvPowerint nvPower(String model)No description in source.

SLWindowsOS #sleela 2.5 (lib/operating-system/SLWindowsOS.sleela)

SLWindowsOS class

Defines SLWindowsOS — the Windows-specific flavor of the OS family. It composes the general `os*` built-ins into idioms a Windows developer expects: cmd.exe/PowerShell invocation, Windows environment entries (USERPROFILE, APPDATA, COMSPEC, SystemRoot), backslash paths and drive letters, and Windows directory conventions. Every call still runs on the genuine Win32 System API underneath (CreateProcess, GetEnvironmentVariable, GetCurrentDirectory, ...), so this class is a thin, honest Windows face over the same cross-OS SLVM bridge. Guard: methods are meaningful only when osPlatform()=="Windows"; isHost() lets a program check before using Windows-specific behavior. Family: operating-system. Native VM/OS work crosses the explicit `os*` SLVM bridge.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
isHostboolean isHost()True when the running host is actually Windows.
cmdint cmd(String commandLine)---- Shells ------------------------------------------------------------- Run a command through cmd.exe (osRun already routes through cmd.exe on Windows). Returns the exit code.
powershellint powershell(String script)Run a command through PowerShell. Returns the exit code.
startCmdSLProcess startCmd(String commandLine)Start a background command via the process bridge; returns an SLProcess.
userProfileString userProfile()---- Windows environment entries ---------------------------------------
appDataString appData()No description in source.
localAppDataString localAppData()No description in source.
systemRootString systemRoot()No description in source.
programFilesString programFiles()No description in source.
comSpecString comSpec()path to cmd.exe
computerNameString computerName()No description in source.
separatorString separator()---- Paths (backslash world) -------------------------------------------
joinString join(String base, String child)No description in source.
onDriveString onDrive(String driveLetter, String rest)Build a drive-rooted path, e.g. drive 'C' -> "C:\\...".
existsboolean exists(String path)---- Filesystem / identity (through the real OS) ------------------------
makeDirboolean makeDir(String path)No description in source.
tempDirString tempDir()honours TMP/TEMP via GetTempPath
hostNameString hostName()No description in source.
userNameString userName()No description in source.

SLWindowsOSModel #sleela 2.5 (lib/operating-system/SLWindowsOSModel.sleela)

SLWindowsOSModel class extends SLOSModel

Defines SLWindowsOSModel — a preset that extends SLOSModel and extrapolates it into a Windows-shaped operating system: an NT-style kernel, UEFI+BOOTMGR boot (no initramfs), an NTFS root under the Windows directory world (C:\Windows, Program Files, Users, ProgramData), a Service Control Manager service set, a Win32 base package seed, and the Explorer/DWM desktop. It is the OOD realisation of "assume the shape of Windows". After build(), refine any layer through the inherited accessors. Windows shapes conventionally ship a desktop; asServer() still yields a valid headless server edition. Family: operating-system. Extends SLOSModel.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
buildvoid build(String name, String ver)Build a Windows-shaped model with the given product name/version on amd64.
buildMultiArchvoid buildMultiArch(String name, String ver)Build a multi-arch Windows model (adds arm64 to the primary amd64 target).

windows-creator #sleela 2.5 (lib/operating-system/examples/windows/windows-creator.sleela)

Model struct

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

WindowsCreator class

Methods — the actions this unit can perform.

MethodSignatureWhat it does
windowsModel windows(String name, String version)No description in source.
identityString identity(Model m)No description in source.
readyToCompileboolean readyToCompile(Model m)No description in source.
packageRepoString packageRepo(Model m)No description in source.
kernelSrcString kernelSrc(Model m)No description in source.
configHeaderString configHeader(Model m)No description in source.
baseDriversString baseDrivers(Model m)No description in source.
downloadsString downloads(Model m)No description in source.
settingsString settings(Model m)No description in source.
compatString compat(Model m)Windows has no FS-level interpreter; it runs a Linux guest via WSL2.
bannervoid banner(String t)No description in source.
mainvoid main()No description in source.