Package operating-system
distro-source #sleela 2.5 (lib/operating-system/distro-source.sleela)
Source class
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
hasSubmodules | int hasSubmodules | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
dirFor | String dirFor(String layer) | No description in source. |
referenceSheet | String referenceSheet() | No description in source. |
Fetch class
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
src | Source src | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
cloneCommand | String cloneCommand(String destDir) | No description in source. |
probe | int probe() | No description in source. |
DistroSourceDemo class
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
banner | void banner(String t) | No description in source. |
main | void main() | No description in source. |
linux-creator #sleela 2.5 (lib/operating-system/examples/linux/linux-creator.sleela)
Model struct
LinuxCreator class
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
linux | Model linux(String name, String version) | No description in source. |
identity | String identity(Model m) | No description in source. |
readyToCompile | boolean readyToCompile(Model m) | ---- readiness gate: URLs + settings present before compile --------- |
packageRepo | String packageRepo(Model m) | No description in source. |
kernelSrc | String kernelSrc(Model m) | No description in source. |
configHeader | String configHeader(Model m) | ---- emitted artifacts (what the OS Creator writes) ----------------- |
baseDrivers | String baseDrivers(Model m) | No description in source. |
downloads | String downloads(Model m) | No description in source. |
settings | String settings(Model m) | No description in source. |
compat | String compat(Model m) | No description in source. |
banner | void banner(String t) | No description in source. |
main | void main() | No description in source. |
machine-build #sleela 2.5 (lib/operating-system/machine-build.sleela)
Part struct
Machine struct
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
memModules | int memModules | No description in source. |
MachineBuilder class
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
intToStr | String intToStr(int v) | No description in source. |
part | Part part(String cls, String vendor, String model, String spec, int sizeUnits) | No description in source. |
ddr | Part ddr(String vendor, String gen, int capacityMb) | DDR module: sizeUnits = capacity in MB. spec = generation name. |
ssd | Part ssd(String vendor, String model, String iface, int capacityGb) | SSD: sizeUnits = capacity in GB. spec = interface name. |
hdd | Part hdd(String vendor, String model, int capacityGb) | HDD: sizeUnits = capacity in GB. spec = "RPM/iface". |
uefi | Part uefi(String vendor, String product) | No description in source. |
usbController | Part usbController(String vendor, String gen, int ports) | No description in source. |
gpu | Part gpu(String vendor, String model, int vramMb) | No description in source. |
machine | Machine machine(String name) | No description in source. |
totalMemMb | int totalMemMb(Machine m) | Total installed memory (MB) across modules. |
memoryWords | int memoryWords(Machine m) | VM memory words from installed MB at the machine's word width. |
bootBlocks | int bootBlocks(Machine m) | VM block count from the boot device's GB capacity at 4096-byte blocks. |
banner | void banner(String title) | No description in source. |
printPart | void printPart(Machine m, String label, Part p) | No description in source. |
main | void main() | No description in source. |
macos-creator #sleela 2.5 (lib/operating-system/examples/macos/macos-creator.sleela)
Model struct
MacosCreator class
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
macos | Model macos(String name, String version) | No description in source. |
identity | String identity(Model m) | No description in source. |
readyToCompile | boolean readyToCompile(Model m) | No description in source. |
packageRepo | String packageRepo(Model m) | No description in source. |
kernelSrc | String kernelSrc(Model m) | No description in source. |
configHeader | String configHeader(Model m) | No description in source. |
baseDrivers | String baseDrivers(Model m) | No description in source. |
downloads | String downloads(Model m) | No description in source. |
settings | String settings(Model m) | No description in source. |
compat | String 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. |
banner | void banner(String t) | No description in source. |
main | void main() | No description in source. |
os-build #sleela 2.5 (lib/operating-system/os-build.sleela)
OsModel struct
OsBuilder class
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
intToStr | String intToStr(int v) | No description in source. |
shape | OsModel shape(String name, String version, String family) | OOD extrapolation: fill an OsModel with a shape's defaults, then refine. |
identity | String identity(OsModel m) | No description in source. |
emitConfigHeader | String emitConfigHeader(OsModel m) | --- C backend: the generated configuration header ------------------- |
emitOsImage | String emitOsImage(OsModel m) | --- C++ backend: the OsImage that composes the boot chain ----------- |
emitIsoRecipe | String emitIsoRecipe(OsModel m) | --- ISO backend: the xorriso build recipe --------------------------- |
emitInstaller | String emitInstaller(OsModel m) | --- Installer backend: the per-shape installer ---------------------- |
lower | String lower(String shape) | No description in source. |
banner | void banner(String title) | No description in source. |
main | void main() | No description in source. |
os-creator #sleela 2.5 (lib/operating-system/os-creator/os-creator.sleela)
Os struct
OsCreatorDemo class
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
linux | Os linux(String name, String version) | No description in source. |
identity | String identity(Os o) | No description in source. |
banner | void banner(String t) | No description in source. |
printLayout | void printLayout(Os o) | The /os-development layout OS Creator(TM) writes. |
osLoaderC | String osLoaderC(Os o) | A representative emitted piece: the OS loader (PID 1) C surface. |
osLoaderCpp | String osLoaderCpp(Os o) | No description in source. |
makefileTarget | String makefileTarget(Os o) | No description in source. |
regenSource | String regenSource(Os o) | No description in source. |
main | void main() | No description in source. |
os-generate #sleela 2.5 (lib/operating-system/os-generate.sleela)
Upstream class
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
referenceSheet | String referenceSheet() | No description in source. |
fetchScript | String 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.
| Field | Declaration | What it holds |
|---|---|---|
root | String root | output root |
manifest | String manifest | "bytes path" index |
fileCount | int fileCount | No description in source. |
upstream | Upstream upstream | field dispatch (1.11) |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String outputRoot) | No description in source. |
makeDir | int makeDir(String rel) | No description in source. |
writeFile | int writeFile(String rel, String contents) | Write one file relative to root; records bytes in the manifest. |
identity | String identity(OsModel m) | No description in source. |
linux | OsModel linux(String name, String version, String arch, String kernelVer) | No description in source. |
resolveKernel | String resolveKernel(String sel) | Resolve a requested Linux kernel selection to a concrete version (compact mirror of SLKernelCatalog.resolveLinux). "" / "default" -> the LTS default. |
execTranslateHeader | String 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. |
compatLoaderC | String 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). |
compatConf | String compatConf(OsModel m) | No description in source. |
baseDriversTableC | String 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. |
downloadsConf | String downloadsConf(OsModel m) | The resolved download URLs for the Linux build, by phase (compile|iso). Mirror of SLDownloadSet.downloadManifest for the Linux shape. |
supportUrlsConf | String 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. |
fetchResilientSh | String 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). |
fetchDownloadsSh | String fetchDownloadsSh(OsModel m) | The opt-in fetch script for the related downloads (compile-phase sources). |
osConf | String osConf(OsModel m) | The global settings header + the kernel command line settings file. |
cmdlineConf | String cmdlineConf(OsModel m) | No description in source. |
baseDriversConf | String baseDriversConf(OsModel m) | No description in source. |
swapConf | String 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). |
filesystemsConf | String 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. |
execTypesHeader | String execTypesHeader(OsModel m) | The executable file-type table for Linux (compact mirror of SLExecutableTypes.emitExecTypesHeader for the Linux shape). |
configHeader | String configHeader(OsModel m) | ---- the emitted Linux-level sources -------------------------------- |
bootUnit | String bootUnit(OsModel m) | No description in source. |
osImage | String osImage(OsModel m) | No description in source. |
osLoaderC | String osLoaderC(OsModel m) | No description in source. |
isoRecipe | String isoRecipe(OsModel m) | No description in source. |
makefile | String makefile(OsModel m) | No description in source. |
buildSh | String buildSh(OsModel m) | No description in source. |
generate | void generate(OsModel m) | ---- materialise the whole tree ------------------------------------- |
param | String param(String envName, String fallback) | Read a build parameter from the environment, or fall back to a default. |
main | void 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.
| Method | Signature | What it does |
|---|---|---|
param | String param(String name, String fallback) | No description in source. |
main | void 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.
| Method | Signature | What it does |
|---|---|---|
printTheme | void printTheme(SLDesktopTheme t) | No description in source. |
main | void 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
primary | SLOSArchitecture primary | No description in source. |
targets | String targets | newline-separated package-arch labels |
count | int count | No description in source. |
configured | int configured | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(SLOSArchitecture primaryArch) | No description in source. |
configureLabel | void configureLabel(String arch) | Convenience: configure directly from a package-arch label. |
addTarget | void addTarget(String arch) | Add another target architecture by label. |
primaryArch | SLOSArchitecture primaryArch() | No description in source. |
targetManifest | String targetManifest() | No description in source. |
targetCount | int targetCount() | No description in source. |
isMultiArch | boolean 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.
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
emit | SLOSPiece emit(SLOSModel m) | No description in source. |
row | String 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. |
rowPhase | String rowPhase(String cls, String name, String phase) | No description in source. |
cppRow | String cppRow(String cls, String name, String phase) | No description in source. |
cEscape | String cEscape(String s) | Driver names here contain no quotes/backslashes, but keep the escape honest. |
unknownAllowed | boolean unknownAllowed(SLDriverSource pol) | No description in source. |
foreignAllowed | boolean foreignAllowed(SLDriverSource pol) | No description in source. |
boolLit | String 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
configured | int configured | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
forShape | void 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. |
setBus | void setBus(String n, boolean boot) | ---- Setters ------------------------------------------------------- |
setStorage | void setStorage(String n, boolean boot) | No description in source. |
setKeyboard | void setKeyboard(String n, boolean boot) | No description in source. |
setMouse | void setMouse(String n, boolean boot) | No description in source. |
setDisplay | void setDisplay(String n, boolean boot) | No description in source. |
setUsb | void setUsb(String n, boolean boot) | No description in source. |
setAudio | void setAudio(String n, boolean boot) | No description in source. |
b | int b(boolean x) | No description in source. |
canBoot | boolean 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. |
bootRequiredCount | int bootRequiredCount() | Count of boot-required drivers present. |
seriesManifest | String seriesManifest() | ---- Manifest ------------------------------------------------------ Newline "class name boot" lines (boot = boot|early) for the emitters. |
line | String line(String acc, String cls, String name, int boot) | No description in source. |
bus | String bus() | Accessors for the emitters. |
storage | String storage() | No description in source. |
keyboard | String keyboard() | No description in source. |
mouse | String mouse() | No description in source. |
display | String display() | No description in source. |
usb | String usb() | No description in source. |
audio | String 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.
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
emit | SLOSPiece emit(SLOSModel m) | No description in source. |
boolLit | String 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.
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
emit | SLOSPiece emit(SLOSModel m) | No description in source. |
loaderMenu | String 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
firmware | String firmware | "UEFI" or "BIOS" |
loader | String loader | "GRUB" / "BOOTMGR" / "boot.efi" / "systemd-boot" |
secureBoot | int secureBoot | 1 require Secure Boot |
useInitramfs | int useInitramfs | 1 stage an initramfs/initrd early userspace |
espLabel | String espLabel | EFI System Partition volume label |
timeout | String timeout | menu timeout, as a string ("5") |
configured | int configured | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String fw, String bootLoader) | No description in source. |
forShape | void forShape(SLOSShape shape) | Default boot style for a shape (UEFI everywhere on modern hardware). |
requireSecureBoot | void requireSecureBoot(boolean on) | No description in source. |
setTimeout | void setTimeout(String seconds) | No description in source. |
menuTimeout | String menuTimeout() | No description in source. |
isUefi | boolean isUefi() | No description in source. |
loaderName | String loaderName() | No description in source. |
firmwareName | String firmwareName() | No description in source. |
stagesInitramfs | boolean stagesInitramfs() | No description in source. |
isComplete | boolean 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.
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
intToStr | String intToStr(int v) | No description in source. |
emitConfigHeader | String emitConfigHeader(SLOSModel m) | Emit the generated configuration header for the model. |
emitBootUnit | String emitBootUnit(SLOSModel m) | Emit the early-boot C translation unit for the model. |
emitBuiltinDriverCalls | String emitBuiltinDriverCalls(SLOSModel m) | Walk the driver manifest and emit a load_driver() call for each built-in. |
containsBuiltin | boolean containsBuiltin(String line) | ---- Small text helpers (manifest lines are "name binding") ------------- |
driverName | String driverName(String line) | No description in source. |
strLen | int strLen(String s) | String primitives wrap the shared native text intrinsics (same contract as lib/cpu/SLCompilerDriver): SLeeLa Strings are Java-style, length+substring. |
substr | String substr(String s, int a, int b) | No description in source. |
charAt | String charAt(String s, int i) | No description in source. |
endsWith | boolean 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
monoStart | int monoStart | monotonic reference captured at reset (nanoseconds) |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
nowMillis | int nowMillis() | Milliseconds since the Unix epoch (UTC wall-clock). |
monotonicNanos | int monotonicNanos() | Monotonic nanoseconds (never goes backward; for durations). |
httpDate | String httpDate() | An RFC 1123 HTTP date string for "now". |
location | String location() | The host's configured time-zone location. |
reset | void reset() | Start a monotonic stopwatch. |
elapsedNanos | int elapsedNanos() | Elapsed nanoseconds since reset(). |
elapsedMillis | int 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
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
host | String host | the OS doing the running: "Linux"/"Windows"/"macOS" |
guest | String guest | the OS whose executables we run: "Linux"/"Windows"/"macOS" |
loaded | int loaded | 1 once the layer's components are loaded |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String hostOs, String guestOs) | No description in source. |
normalize | String normalize(String s) | No description in source. |
hostName | String hostName() | No description in source. |
guestName | String guestName() | No description in source. |
isNative | boolean isNative() | Same host and guest need no layer (native execution). |
runtime | String runtime() | ---- Which components this host->guest layer requires --------------- runtime(): the primary translation runtime/container for this pair. |
fsInterpreter | String fsInterpreter() | fsInterpreter(): the filesystem-level interpreter facility, when the host has one (only Linux's binfmt_misc). Empty elsewhere. |
libraryPackage | String libraryPackage() | libraryPackage(): the shared-library set the guest's executables link against, which the layer must provide so a library + executable both load. |
componentManifest | String componentManifest() | The ordered component manifest: "<name> <kind>" per line. Kinds: interpreter (FS-level), runtime (translation layer), library (guest libs). |
guestLibToken | String guestLibToken() | No description in source. |
componentCount | int componentCount() | Number of components this layer loads (interpreter? + runtime + libraries). |
load | int 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. |
unload | int unload() | unload(): tear the layer down. On Linux unregister the binfmt_misc rule; elsewhere drop the ready flag. Returns 0 ok. Idempotent. |
isLoaded | boolean isLoaded() | No description in source. |
present | boolean 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.) |
handle | String 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. |
handlePair | String 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. |
libEnv | String 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.). |
binfmtName | String binfmtName() | ---- binfmt_misc helpers (Linux FS interpreter) --------------------- |
binfmtRegister | String binfmtRegister(String interp) | No description in source. |
guestExt | String guestExt() | No description in source. |
summary | String 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.
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
emit | SLOSPiece emit(SLOSModel m) | No description in source. |
emitLoadFn | String emitLoadFn(SLCompatSet cs) | One load block per supported guest route. |
loadLine | String loadLine(SLCompatSet cs, String guest) | No description in source. |
emitUnloadFn | String emitUnloadFn(SLCompatSet cs) | No description in source. |
unloadLine | String unloadLine(SLCompatSet cs, String guest) | No description in source. |
emitHandleFn | String emitHandleFn() | No description in source. |
routeInits | String routeInits(SLCompatSet cs) | C++ route initialisers, one brace-init per supported guest. |
addRoute | String addRoute(String acc, SLCompatSet cs, String guest) | No description in source. |
routeConf | String 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
host | String host | the built OS's own family |
linuxGuest | SLCompatLayer linuxGuest | Up to three guest layers (Linux/Windows/macOS). Fixed slots keep the model array-free; an unused slot has an empty guest. |
windowsGuest | SLCompatLayer windowsGuest | No description in source. |
macGuest | SLCompatLayer macGuest | No description in source. |
hasLinux | int hasLinux | No description in source. |
hasWindows | int hasWindows | No description in source. |
hasMac | int hasMac | No description in source. |
configured | int configured | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String hostFamily) | No description in source. |
norm | String norm(String s) | No description in source. |
forShape | void 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. |
support | void support(String guestFamily) | Add support for running a guest family's executables on this OS. |
drop | void drop(String guestFamily) | Remove a previously added guest. |
supports | boolean supports(String guestFamily) | No description in source. |
layerFor | SLCompatLayer layerFor(String guestFamily) | The layer object for a guest family (null if not supported). Lets a caller load/unload/handle through it. |
guestCount | int guestCount() | No description in source. |
hasAny | boolean hasAny() | No description in source. |
hostName | String hostName() | No description in source. |
compatManifest | String compatManifest() | A newline manifest "<host> runs <guest> via <runtime>" per supported guest, for the generated config and for logs. |
add | String 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
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
PHASE_COMPILE | static final int PHASE_COMPILE = 0 | Phase: when the config file must be present. |
PHASE_ISO | static final int PHASE_ISO = 1 | No description in source. |
wantOsConf | int wantOsConf | Well-known settings files: 1 if required, with their path/format fixed. config/os.conf (global settings) compile |
wantSwap | int wantSwap | config/swap.conf (paging) iso |
wantFilesystems | int wantFilesystems | config/filesystems.txt(file-table choices) compile |
wantBaseDrivers | int wantBaseDrivers | kernel/base-drivers/base-drivers.conf compile |
wantServices | int wantServices | userspace/os-loader/services.conf iso |
wantCompat | int wantCompat | userspace/compat-loader/compat.conf iso |
wantCmdline | int wantCmdline | config/cmdline.conf (kernel command line) compile |
wantDownloads | int wantDownloads | config/downloads.conf (resolved URLs) compile |
configured | int configured | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
forModel | void 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. |
addExtra | int 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. |
configManifest | String configManifest() | ---- The checklist -------------------------------------------------- A newline manifest "<path> <format> <phase> required|optional" of every settings file the build expects. |
row | String row(String acc, String path, String fmt, String phase, int want) | No description in source. |
rowExtra | String rowExtra(String acc, String rec) | No description in source. |
compilePhaseCount | int compilePhaseCount() | Count of required compile-phase / iso-phase settings files. |
isoPhaseCount | int isoPhaseCount() | No description in source. |
readyForCompile | boolean 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. |
readyForIso | boolean readyForIso() | No description in source. |
compileFilesPresent | int 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). |
emitOsConf | String 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.
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
intToStr | String intToStr(int v) | No description in source. |
emitOsImage | String emitOsImage(SLOSModel m) | Emit the OsImage C++ translation unit for the model. |
emitServiceVector | String emitServiceVector(SLOSModel m) | Emit the service vector initialiser from the model's unit manifest. |
firstToken | String firstToken(String line) | The token before the first space on a "name mode" line. |
strLen | int strLen(String s) | String primitives wrap the shared native text intrinsics. |
substr | String substr(String s, int a, int b) | No description in source. |
charAt | String 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.
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
ddr5 | SLDDRModule ddr5(String manufacturer, int capacityMb) | Return a DDR5 module from a named manufacturer at a given capacity (MB). |
ddr4 | SLDDRModule ddr4(String manufacturer, int capacityMb) | Return a DDR4 module from a named manufacturer at a given capacity (MB). |
module | SLDDRModule module(String manufacturer, String genName, int capacityMb, boolean ecc) | Build a module of any generation by name from any manufacturer. |
known | boolean known(String manufacturer) | Is this one of the recognised DRAM manufacturers? |
ddr5Part | String ddr5Part(String mfr) | ---- Representative part numbers per manufacturer ---------------------- |
ddr4Part | String ddr4Part(String mfr) | No description in source. |
genPart | String 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
GEN_DDR | static final int GEN_DDR = 1 | Generation ordinals. |
GEN_DDR2 | static final int GEN_DDR2 = 2 | No description in source. |
GEN_DDR3 | static final int GEN_DDR3 = 3 | No description in source. |
GEN_DDR4 | static final int GEN_DDR4 = 4 | No description in source. |
GEN_DDR5 | static final int GEN_DDR5 = 5 | No description in source. |
generation | int generation | GEN_* |
standard | String standard | JEDEC module standard, e.g. "PC5-44800" |
dataRateMtps | int dataRateMtps | transfer rate in MT/s |
voltageMv | int voltageMv | supply voltage in millivolts |
busWidthBits | int busWidthBits | data bus width (64 non-ECC, 72 ECC) |
capacityMb | int capacityMb | module capacity in megabytes |
eccSupported | int eccSupported | 1 if the module carries ECC |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void 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()). |
configureByName | void configureByName(String manufacturer, String part, String genName) | Convenience: configure by generation name ("DDR".."DDR5"). |
sized | void sized(int megabytes, boolean ecc) | Refine capacity (MB) and bus width; ECC uses a 72-bit bus. |
setDataRate | void setDataRate(int mtps) | Override the data rate for an overclock/XMP/EXPO profile. |
generationOrdinal | int generationOrdinal() | No description in source. |
generationName | String generationName() | No description in source. |
moduleStandard | String moduleStandard() | No description in source. |
dataRate | int dataRate() | No description in source. |
voltageMillivolts | int voltageMillivolts() | No description in source. |
busWidth | int busWidth() | No description in source. |
capacityMegabytes | int capacityMegabytes() | No description in source. |
hasEcc | boolean hasEcc() | No description in source. |
peakBandwidthMBps | int peakBandwidthMBps() | Peak transfer bandwidth in MB/s: data rate * (bus width in bytes). |
wordsForWidth | int 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.
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
emit | SLOSPiece 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
enabled | int enabled | 1 if the OS has a desktop at all (0 = server/headless) |
displayServer | String displayServer | "Wayland" / "DWM" / "WindowServer" |
sessionShell | String sessionShell | "GNOME Shell" / "Explorer" / "Aqua" |
toolkit | String toolkit | "GTK" / "Win32/WinUI" / "AppKit" |
displayManager | String displayManager | login/greeter |
appearance | SLDesktopTheme appearance | the desktop appearance/theme (null on a headless edition) |
configured | int configured | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
headless | void headless() | No description in source. |
configure | void configure(String server, String shell, String kit, String greeter) | No description in source. |
forShape | void forShape(SLOSShape shape) | Seed the native desktop stack for a shape, including its default theme. |
applyTheme | void applyTheme(SLDesktopTheme t) | No description in source. |
theme | SLDesktopTheme theme() | The desktop theme, or null when headless / not yet seeded. |
hasTheme | boolean hasTheme() | No description in source. |
useAlternate | void useAlternate(String shell, String kit) | Swap the Linux desktop for an alternate (the desktop is replaceable). |
hasDesktop | boolean hasDesktop() | No description in source. |
server | String server() | No description in source. |
shell | String shell() | No description in source. |
widgetToolkit | String widgetToolkit() | No description in source. |
greeter | String greeter() | No description in source. |
SLDesktopTheme #sleela 2.5 (lib/operating-system/SLDesktopTheme.sleela)
SLDesktopTheme class
Defines SLDesktopTheme — the appearance a constructed OS's
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
id | String id | theme identity |
label | String label | No description in source. |
background | String background | role colors (shared vocabulary with the editor palettes + SleelaUI accent) |
foreground | String foreground | No description in source. |
accent | String accent | No description in source. |
gtkTheme | String gtkTheme | desktop asset identifiers (bytes come from the desktop-loader warehouse) |
iconSet | String iconSet | No description in source. |
cursor | String cursor | No description in source. |
wallpaper | String wallpaper | No description in source. |
configured | int configured | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String themeId, String themeLabel, | Full configuration. |
slickBlack | void slickBlack() | ---- Presets (mirror os/sleela_os_theme.c) --------------------------- The SleelaUI-aligned matte-dark default. |
white | void white() | The White Edition look, aligned with ubuntu-white (Ubuntu-orange accent). |
linuxDefault | void linuxDefault() | Per-shape native defaults. |
windowsDefault | void windowsDefault() | No description in source. |
macosDefault | void macosDefault() | No description in source. |
forShape | void forShape(SLOSShape shape) | Seed the native-default theme for a shape (mirrors the other forShape seeds). |
select | void select(String themeId) | Choose a theme by id; unknown ids fall back to the Linux default. |
themeId | String themeId() | ---- Accessors ------------------------------------------------------- |
name | String name() | No description in source. |
bg | String bg() | No description in source. |
fg | String fg() | No description in source. |
accentColor | String accentColor() | No description in source. |
gtk | String gtk() | No description in source. |
icons | String icons() | No description in source. |
cursorTheme | String cursorTheme() | No description in source. |
wallpaperId | String wallpaperId() | No description in source. |
assetComponent | String assetComponent() | No description in source. |
appearanceSheet | String 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
path | String path | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String p) | No description in source. |
name | String name() | No description in source. |
exists | boolean exists() | No description in source. |
create | boolean create() | Create this directory (succeeds if it already exists). |
remove | boolean remove() | Remove this directory (must be empty on POSIX/Windows). |
renameTo | boolean renameTo(String newPath) | Rename/move; on success the handle tracks the new path. |
enter | boolean enter() | Make this directory the process' current working directory. |
current | String current() | The process' current working directory (static-style convenience). |
temp | String temp() | The system temporary directory. |
SLDistroFetch #sleela 2.5 (lib/operating-system/SLDistroFetch.sleela)
SLDistroFetch class
Defines SLDistroFetch — the OPT-IN downloader that materialises
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
MODE_SHALLOW | static final int MODE_SHALLOW = 0 | Fetch depth/mode tags. --depth 1 --single-branch (default) |
MODE_FULL | static final int MODE_FULL = 1 | full history |
MODE_RECURSE | static final int MODE_RECURSE = 2 | full + --recurse-submodules |
src | SLDistroSource src | the reference (field; wired by configure()) |
mode | int mode | No description in source. |
lastExit | int lastExit | exit code of the most recent fetch (-1 if none run) |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
useSource | void useSource(SLDistroSource source) | Point at a specific reference instead of the default. |
setMode | void setMode(int m) | No description in source. |
source | SLDistroSource source() | No description in source. |
cloneCommand | String 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). |
pinCommand | String 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. |
fetch | int 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. |
fetchShallow | int fetchShallow(String destRoot) | Convenience: shallow fetch (the safe default for the large distro). |
fetchComplete | int fetchComplete(String destRoot) | Convenience: full fetch with submodules (a complete working tree). |
lastExitCode | int lastExitCode() | No description in source. |
succeeded | boolean succeeded() | No description in source. |
probe | int 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
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
name | String name | Upstream identity. |
owner | String owner | No description in source. |
repo | String repo | No description in source. |
url | String url | https clone URL |
branch | String branch | default branch |
pinnedCommit | String pinnedCommit | exact revision for reproducible fetches |
hasSubmodules | int hasSubmodules | 1 if the distro uses git submodules (needs --recurse) |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | Configure with the known Ubuntu.Determinant distro reference. The pinned commit is the current main tip; callers may repin with pin(commit). |
pin | void pin(String commit) | Repin to a specific revision (keeps fetches reproducible). |
identity | String identity() | No description in source. |
cloneUrl | String cloneUrl() | No description in source. |
defaultBranch | String defaultBranch() | No description in source. |
commit | String commit() | No description in source. |
usesSubmodules | boolean usesSubmodules() | No description in source. |
shortCommit | String 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(). |
dirFor | String 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). |
providesLayer | boolean providesLayer(String layer) | No description in source. |
downloadabilityNote | String downloadabilityNote(String part) | downloadabilityNote(part): per-part answer to "can this be downloaded?". |
needsSubmoduleForComplete | boolean needsSubmoduleForComplete() | Whether a complete working tree needs the submodule fetched too. |
referenceSheet | String 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
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
PHASE_COMPILE | static final int PHASE_COMPILE = 0 | Phase tags: when a download must be present. before compiling the OS (sources/toolchain) |
PHASE_ISO | static final int PHASE_ISO = 1 | before authoring the ISO (rootfs payloads) |
extraCount | int extraCount | No description in source. |
support | SLSupportDownloader support | The 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. |
configured | int configured | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
supportDownloader | SLSupportDownloader supportDownloader() | The composed support downloader (for the OS document to reach). |
forShape | void 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. |
setPackageRepo | void setPackageRepo(String url) | ---- Setters -------------------------------------------------------- |
setKernelSrc | void setKernelSrc(String url) | No description in source. |
setFirmwareSrc | void setFirmwareSrc(String url) | No description in source. |
setRuntimeWine | void setRuntimeWine(String url) | No description in source. |
setRuntimeQemu | void setRuntimeQemu(String url) | No description in source. |
setUpstreamDistro | void setUpstreamDistro(String url) | No description in source. |
addExtra | int 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. |
readyForCompile | boolean 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). |
readyForIso | boolean readyForIso() | Before ISO: additionally the firmware source must be known (the ESP/loader needs firmware), and every required slot resolved. |
downloadManifest | String downloadManifest() | ---- Manifest + fetch ----------------------------------------------- A newline manifest "<kind> <phase> <url>" of every known download. |
row | String row(String acc, String kind, String phase, String url) | No description in source. |
rowExtra | String rowExtra(String acc, String rec) | An extra record "kind|url|phase" -> "kind phase url". |
fetchScript | String 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. |
fetchLine | String fetchLine(int wantPhase, int rowPhase, String kind, String url) | No description in source. |
phaseName | String phaseName(int phase) | No description in source. |
supportFetchScript | String 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. |
supportManifest | String 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.
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
emit | SLOSPiece emit(SLOSModel m) | No description in source. |
emitLoadCalls | String emitLoadCalls(String manifest, String binding, int errCode) | One load_driver() call per manifest line whose binding matches, with the given error code on failure. |
driverList | String driverList(String manifest, String binding) | A comma-separated C++ initializer list of driver names with the binding. |
lineName | String lineName(String line) | "name binding" -> name (token before the space). |
lineBinding | String lineBinding(String line) | "name binding" -> binding (token after the space). |
strLen | int strLen(String s) | No description in source. |
substr | String substr(String s, int a, int b) | No description in source. |
charAt | String charAt(String s, int i) | No description in source. |
intToStr | String 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
drivers | String drivers | newline-separated "name binding" lines (binding: builtin|module) |
count | int count | No description in source. |
builtinCount | int builtinCount | No description in source. |
configured | int configured | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
add | void add(String name, String binding) | No description in source. |
builtin | void builtin(String name) | A driver that must be present before the rootfs mounts -> built-in. |
module | void module(String name) | A driver loaded on demand after boot -> module. |
forShape | void forShape(SLOSShape shape) | Seed the baseline driver set for a shape. Storage/bus/input are built in; GPU/audio/extra network are modules. |
driverManifest | String driverManifest() | No description in source. |
driverCount | int driverCount() | No description in source. |
builtinDriverCount | int builtinDriverCount() | No description in source. |
canReachRootfs | boolean 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
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
ORIGIN_INTREE | static final int ORIGIN_INTREE = 0 | Origin tags. shipped with the OS |
ORIGIN_VENDOR | static final int ORIGIN_VENDOR = 1 | signed by a trusted vendor |
ORIGIN_UNKNOWN | static final int ORIGIN_UNKNOWN = 2 | unsigned / out-of-tree |
ORIGIN_FOREIGN | static final int ORIGIN_FOREIGN = 3 | written for another OS family |
host | String host | the OS loading the driver |
unknownPolicy | String unknownPolicy | Policy per origin: "enforce" (signature required), "permissive" (load with a taint warning), or "off" (refuse). Defaults are safe. for ORIGIN_UNKNOWN |
foreignPolicy | String foreignPolicy | for ORIGIN_FOREIGN |
configured | int configured | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String hostFamily) | No description in source. |
norm | String norm(String s) | No description in source. |
allowUnknown | void allowUnknown(boolean on) | Developer stance: allow unknown-source drivers (load unsigned with a taint). |
allowForeign | void allowForeign(boolean on) | Allow foreign-OS drivers where a bridge exists ("bridge"), or refuse ("off"). |
originName | String originName(int origin) | ---- Origin naming -------------------------------------------------- |
admit | int 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. |
bridgeFor | String 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. |
foreignSupported | boolean foreignSupported(String guestFamily, String deviceClass) | Can this host use a foreign driver from guestFamily for a device class? |
verifySignature | int 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. |
policySummary | String policySummary() | ---- Config / summary ---------------------------------------------- |
admitText | String 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
reads | int reads | No description in source. |
writes | int writes | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
get | String get(String key) | Read a variable; "" when unset. Tracks a read count for observability. |
getOrDefault | String getOrDefault(String key, String fallback) | Read with a fallback used when the variable is unset (empty). |
has | boolean has(String key) | True when the variable is present (non-empty). |
set | boolean set(String key, String value) | Set (overwrite) a variable; returns true on success. |
path | String path() | Common entries, resolved per-OS by the host (PATH, HOME/USERPROFILE, ...). |
home | String home() | No description in source. |
shell | String shell() | No description in source. |
readCount | int readCount() | No description in source. |
writeCount | int 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
delivered | int delivered | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
terminate | boolean terminate(int processHandle) | Ask the process behind the given handle to terminate (SIGTERM / TerminateProcess). Returns true if the request was accepted. |
terminateProcess | boolean terminateProcess(SLProcess p) | Convenience: terminate the process wrapped by an SLProcess. |
deliveredCount | int deliveredCount() | No description in source. |
SLExecutableTranslator #sleela 2.5 (lib/operating-system/SLExecutableTranslator.sleela)
SLExecutableTranslator class
Defines SLExecutableTranslator — the policy and mechanism for
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
host | String host | the host OS running the file: "Linux" / "Windows" / "macOS" |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String hostShape) | No description in source. |
configureForHost | void configureForHost() | No description in source. |
hostName | String hostName() | No description in source. |
worldOf | String 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. |
isForeign | boolean isForeign(String ext) | isForeign(ext): does running this type on the host require translation? |
translatorFor | String 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. |
kind | String 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). |
hasFsInterpreter | boolean hasFsInterpreter() | Does the host provide a filesystem-level interpreter facility at all? |
binfmtLine | String 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". |
stripDot | String stripDot(String ext) | No description in source. |
registerCommand | String 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). |
runCommand | String 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. |
register | int 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. |
runnableNow | boolean 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. |
emitTranslatorHeader | String 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. |
bit | String 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
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
shape | String shape | "Linux" / "Windows" / "macOS" |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String shapeName) | No description in source. |
configureForHost | void configureForHost() | Configure from the real host OS the VM runs on. |
name | String name() | No description in source. |
isWindows | boolean isWindows() | No description in source. |
isMac | boolean isMac() | No description in source. |
isLinux | boolean isLinux() | No description in source. |
isExecutable | boolean 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. |
executableTypes | String 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. |
pathext | String 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. |
mechanism | String mechanism() | How a file becomes executable on this shape (human-readable mechanism). |
usesExecBit | boolean usesExecBit() | Whether this shape uses the POSIX exec-bit model at all. |
markExecutable | int 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. |
isHostExecutable | boolean 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. |
emitExecTypesHeader | String 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. |
emitTableRows | String emitTableRows() | One C string literal per executable extension for this shape. |
bit | String 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
path | String path | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String p) | No description in source. |
name | String name() | No description in source. |
exists | boolean exists() | No description in source. |
isRegular | boolean isRegular() | No description in source. |
size | int size() | No description in source. |
delete | boolean delete() | Remove this file; returns true on success. |
renameTo | boolean 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
ops | int ops | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
exists | boolean exists(String path) | No description in source. |
isDir | boolean isDir(String path) | No description in source. |
isFile | boolean isFile(String path) | No description in source. |
size | int size(String path) | Size in bytes, or -1 if the path does not exist / is not a regular file. |
makeDir | boolean makeDir(String path) | Create a directory (succeeds if it already exists). Returns true on success. |
remove | boolean remove(String path) | Remove a file or an empty directory. Returns true on success. |
rename | boolean rename(String from, String to) | Rename/move a path. Returns true on success. |
move | boolean move(String from, String to) | Move is rename across directories (same host primitive). |
operationCount | int 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.
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
isKnown | boolean isKnown(String fs) | Canonical, lowercase filesystem identifiers this catalogue knows. |
family | String family(String fs) | The family a filesystem belongs to, or "unknown". |
nativeOs | String nativeOs(String fs) | The OS that natively owns/defaults to this filesystem. |
journaling | boolean journaling(String fs) | Does it journal (crash-consistent metadata)? FAT and classic HFS do not. |
copyOnWrite | boolean copyOnWrite(String fs) | Copy-on-write (snapshotting) filesystems. |
caseSensitivity | String caseSensitivity(String fs) | Case sensitivity of file names by default. |
maxFileSize | String maxFileSize(String fs) | A typical maximum single-file size, as human text (real per-fs limits). |
rootable | boolean 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. |
efiSystemPartition | boolean efiSystemPartition(String fs) | Suitable for the EFI System Partition (must be FAT). |
mkfsTool | String mkfsTool(String fs) | The mkfs-style tool that formats this filesystem. |
useCase | String useCase(String fs) | A one-line use-case note for a GUI/menu. |
defaultRootFor | String defaultRootFor(String shapeName) | The default root filesystem for an OS shape (what forShape would pick). |
rootChoicesFor | String rootChoicesFor(String shapeName) | A newline menu of the catalogue's rootable choices for a shape, for a GUI. |
describe | String describe(String fs) | A compact spec line a tool can print for one filesystem. |
yn | String 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
format | String format | "ext4" / "NTFS" / "APFS" |
separator | String separator | path separator for this layout |
tree | String tree | newline-separated directory manifest |
dirCount | int dirCount | No description in source. |
configured | int configured | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String fsFormat, String sep) | No description in source. |
addDir | void addDir(String path) | Add one directory to the manifest. |
forShape | void forShape(SLOSShape shape) | Seed the standard directory tree for a shape. |
fsFormat | String fsFormat() | No description in source. |
manifest | String manifest() | No description in source. |
directoryCount | int directoryCount() | No description in source. |
isComplete | boolean 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
IF_SATA3 | static final int IF_SATA3 = 0 | Interface ordinals. 6 Gb/s |
IF_SAS | static final int IF_SAS = 1 | 12 Gb/s enterprise |
REC_CMR | static final int REC_CMR = 0 | Recording technology. conventional (preferred) |
REC_SMR | static final int REC_SMR = 1 | shingled (higher density, slower random writes) |
iface | int iface | IF_* |
formFactor | String formFactor | "3.5\"" / "2.5\"" |
rpm | int rpm | spindle speed |
recording | int recording | REC_* |
cacheMb | int cacheMb | DRAM cache |
capacityGb | int capacityGb | No description in source. |
sustainedMBps | int sustainedMBps | representative sustained transfer rate |
blockBytes | int blockBytes | logical block size |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String manufacturer, String partName, int interfaceKind, int rpmSpeed, int capacityGigabytes) | No description in source. |
setRecording | void setRecording(int tech) | No description in source. |
setCache | void setCache(int megabytes) | No description in source. |
setFormFactor | void setFormFactor(String ff) | No description in source. |
setSustained | void setSustained(int mbps) | No description in source. |
isSas | boolean isSas() | No description in source. |
isSmr | boolean isSmr() | No description in source. |
interfaceName | String interfaceName() | No description in source. |
recordingName | String recordingName() | No description in source. |
form | String form() | No description in source. |
spindleRpm | int spindleRpm() | No description in source. |
cacheMegabytes | int cacheMegabytes() | No description in source. |
capacityGigabytes | int capacityGigabytes() | No description in source. |
transferMBps | int transferMBps() | No description in source. |
blockSize | int blockSize() | No description in source. |
capacityBlocks | int 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.
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
sata7200 | SLHardDisk sata7200(String manufacturer, int capacityGb) | A 7200 RPM SATA desktop/NAS drive from a named manufacturer. |
enterprise | SLHardDisk enterprise(String manufacturer, int capacityGb) | A 7200 RPM SAS enterprise drive from a named manufacturer. |
performance | SLHardDisk performance(String manufacturer, int rpm, int capacityGb) | A high-RPM (10k/15k) SAS performance drive. |
known | boolean known(String manufacturer) | No description in source. |
desktopPart | String desktopPart(String mfr) | No description in source. |
enterprisePart | String 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
CLASS_MEMORY | static final int CLASS_MEMORY = 0 | Device-class ordinals (what kind of part this is). |
CLASS_SSD | static final int CLASS_SSD = 1 | No description in source. |
CLASS_HDD | static final int CLASS_HDD = 2 | No description in source. |
CLASS_USB | static final int CLASS_USB = 3 | No description in source. |
CLASS_UEFI | static final int CLASS_UEFI = 4 | No description in source. |
CLASS_VIDEO | static final int CLASS_VIDEO = 5 | No description in source. |
CLASS_CPU | static final int CLASS_CPU = 6 | No description in source. |
CLASS_MAINBOARD | static final int CLASS_MAINBOARD = 7 | No description in source. |
vendor | String vendor | manufacturer, e.g. "Samsung", "NVIDIA" |
model | String model | model / part name, e.g. "M378A2K43DB1", "GeForce RTX 4090" |
deviceClass | int deviceClass | one of CLASS_* |
configured | int configured | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configureComponent | void configureComponent(String manufacturer, String partName, int cls) | No description in source. |
manufacturer | String manufacturer() | No description in source. |
partName | String partName() | No description in source. |
componentClass | int componentClass() | No description in source. |
isConfigured | boolean isConfigured() | No description in source. |
className | String className() | No description in source. |
identity | String 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
ddr | SLDDRCatalog ddr | No description in source. |
ssds | SLSSDCatalog ssds | No description in source. |
hdds | SLHardDiskCatalog hdds | No description in source. |
usb | SLUSBCatalog usb | No description in source. |
gpus | SLVideoCardCatalog gpus | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
memory | SLDDRModule memory(String manufacturer, String generation, int capacityMb) | ---- Memory ------------------------------------------------------------ A DDR module by manufacturer, generation name ("DDR".."DDR5"), capacity MB. |
eccMemory | SLDDRModule eccMemory(String manufacturer, String generation, int capacityMb) | No description in source. |
ssd | SLSSD ssd(String manufacturer, String iface, int capacityGb) | ---- Solid-state storage ----------------------------------------------- An SSD by manufacturer, interface name ("SATA"/"PCIe3"/"PCIe4"/"PCIe5"), GB. |
hdd | SLHardDisk hdd(String manufacturer, int rpm, int capacityGb) | ---- Rotational storage ------------------------------------------------ |
usbController | SLUSBDevice usbController(String vendor, String generation, int ports) | ---- USB --------------------------------------------------------------- A USB host controller by vendor + generation name. |
usbFlash | SLUSBDevice usbFlash(String vendor, String model, String generation) | No description in source. |
uefi | SLUEFIFirmware uefi(String vendor) | ---- UEFI firmware ----------------------------------------------------- |
video | SLVideoCard video(String vendor, String model, int vramMb) | ---- Video card -------------------------------------------------------- |
memoryCatalog | SLDDRCatalog memoryCatalog() | Catalogue accessors for callers that want the richer per-family API. |
ssdCatalog | SLSSDCatalog ssdCatalog() | No description in source. |
hddCatalog | SLHardDiskCatalog hddCatalog() | No description in source. |
usbCatalog | SLUSBCatalog usbCatalog() | No description in source. |
videoCatalog | SLVideoCardCatalog 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).
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
configured | int configured | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
generate | SLOSArtifact generate(SLOSModel m) | Generate the installer that matches the model's shape. |
linuxInstaller | SLOSArtifact linuxInstaller(SLOSModel m) | ---- Linux: POSIX shell installer -------------------------------------- |
windowsInstaller | SLOSArtifact windowsInstaller(SLOSModel m) | ---- Windows: PowerShell installer ------------------------------------- |
macInstaller | SLOSArtifact macInstaller(SLOSModel m) | ---- macOS: APFS shell installer --------------------------------------- |
vmBranchPosix | String vmBranchPosix(SLOSModel m) | The shared --vm (QEMU) branch for POSIX installers: boot the ISO read-only. |
isoFileName | String 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
stagingRoot | String stagingRoot | where the rootfs is assembled |
configured | int configured | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
stageAt | void stageAt(String dir) | No description in source. |
build | SLOSArtifact 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). |
emitMkdirs | String emitMkdirs(SLOSModel m) | ---- Recipe fragments --------------------------------------------------- One `mkdir -p` per directory in the model's filesystem manifest. |
emitPackageInstall | String emitPackageInstall(SLOSModel m) | One package-install line per entry in the model's package manifest. |
normalize | String 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). |
replaceBackslash | String replaceBackslash(String s) | No description in source. |
volumeLabel | String volumeLabel(SLOSModel m) | No description in source. |
isoFileName | String isoFileName(SLOSModel m) | No description in source. |
strLen | int strLen(String s) | String primitives wrap the shared native text intrinsics. |
substr | String substr(String s, int a, int b) | No description in source. |
charAt | String 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.
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
kernelName | String kernelName(String family) | The kernel NAME for a family label. |
defaultVersion | String defaultVersion(String family) | The family DEFAULT version (what forShape would pick). |
resolveLinux | String 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). |
resolveWindows | String 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). |
resolveMac | String resolveMac(String sel) | resolveMac(sel): macOS release name or Darwin version -> Darwin version. |
resolve | String 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). |
isSupported | boolean isSupported(String family, String sel) | isSupported(family, sel): true when resolve() yields a concrete version. |
selectionsFor | String selectionsFor(String family) | A newline-separated menu of named selections for a family (for a GUI). |
startsWith10 | boolean startsWith10(String nt) | Windows-10+ guard: an explicit NT build is accepted only when it is NT 10.x. |
prefix10 | boolean 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.
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
emit | SLOSPiece emit(SLOSModel m) | No description in source. |
boolLit | String 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
kernelName | String kernelName | "NT", "Linux", "XNU" |
version | String version | e.g. "6.18.27" |
cmdline | String cmdline | kernel boot parameters |
processMgmt | int processMgmt | Subsystem toggles (1 = required, 0 = omitted). |
memoryMgmt | int memoryMgmt | No description in source. |
scheduler | int scheduler | No description in source. |
networking | int networking | No description in source. |
filesystems | int filesystems | No description in source. |
drivers | int drivers | No description in source. |
security | int security | No description in source. |
preemptible | int preemptible | preemptible kernel |
configured | int configured | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String name, String ver) | Baseline: a full-featured, preemptible kernel with every core subsystem. |
forShape | void forShape(SLOSShape shape) | Pick the kernel family that matches a shape, with a sensible version. |
selectVersion | boolean 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). |
setCmdline | void setCmdline(String line) | No description in source. |
appendCmdline | void appendCmdline(String arg) | No description in source. |
requireSecurity | void requireSecurity(boolean on) | No description in source. |
name | String name() | No description in source. |
kernelVersion | String kernelVersion() | No description in source. |
commandLine | String commandLine() | No description in source. |
subsystemCount | int subsystemCount() | Count of enabled core subsystems (used by the model's validity check). |
isBootable | boolean 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.
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
isHost | boolean isHost() | True when the running host is actually Linux. |
sh | int sh(String command) | ---- Shell / processes -------------------------------------------------- Run a command through /bin/sh (osRun uses /bin/sh -c on POSIX). |
startSh | SLProcess startSh(String command) | Start a background command; returns an SLProcess to wait()/kill(). |
waitFor | int waitFor(int processHandle) | Reap a daemon-style child by handle. |
home | String home() | ---- Environment (HOME/PATH/XDG/SHELL) --------------------------------- |
path | String path() | No description in source. |
shell | String shell() | No description in source. |
xdgConfigHome | String xdgConfigHome() | No description in source. |
xdgRuntimeDir | String xdgRuntimeDir() | No description in source. |
etc | String etc() | ---- Filesystem Hierarchy Standard roots ------------------------------- |
proc | String proc() | No description in source. |
sys | String sys() | No description in source. |
tmp | String tmp() | No description in source. |
var | String var() | No description in source. |
kernelCmdline | String kernelCmdline() | ---- Kernel / distro facts (read real files via file I/O built-ins) ----- The kernel command line exposed by procfs; "" if unreadable. |
osRelease | String osRelease() | The os-release metadata (distro name/version); "" if unreadable. |
procExists | boolean procExists(int pid) | True if a /proc entry exists for the given pid. |
readSmallFile | String 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. |
hostName | String hostName() | No description in source. |
userName | String 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.
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
build | void build(String name, String ver) | Build a Linux-shaped model with the given product name/version on amd64. |
buildMultiArch | void 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).
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
machine | SLMachine machine | the composed lib/cpu machine |
built | int built | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
build | SLMachine 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). |
buildBootAndRun | int 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. |
buildAndRunSource | int 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. |
buildAndBootGuest | int 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. |
builtMachine | SLMachine builtMachine() | No description in source. |
buildCount | int 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
machineName | String machineName | No description in source. |
cpuVendor | String cpuVendor | CPU identity (the processor itself is modeled by lib/cpu/SLCPU at build). |
cpuModel | String cpuModel | No description in source. |
cpuCores | int cpuCores | No description in source. |
wordBits | int wordBits | No description in source. |
clockMhz | int clockMhz | No description in source. |
memory | SLDDRModule memory | Named parts. main memory module (represents the populated set) |
memoryModules | int memoryModules | how many identical modules are installed |
ssd | SLSSD ssd | primary SSD, or null |
hdd | SLHardDisk hdd | primary HDD, or null |
firmware | SLUEFIFirmware firmware | platform firmware |
usb | SLUSBDevice usb | USB host controller |
video | SLVideoCard video | display adapter, or null (headless) |
configured | int configured | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String name) | No description in source. |
cpu | void cpu(String vendor, String model, int cores, int bits, int mhz) | ---- CPU --------------------------------------------------------------- |
installMemory | void installMemory(SLDDRModule module, int count) | ---- Named parts (set from a registry lookup) -------------------------- |
installSsd | void installSsd(SLSSD drive) | No description in source. |
installHdd | void installHdd(SLHardDisk disk) | No description in source. |
installFirmware | void installFirmware(SLUEFIFirmware fw) | No description in source. |
installUsb | void installUsb(SLUSBDevice controller) | No description in source. |
installVideo | void installVideo(SLVideoCard card) | No description in source. |
name | String name() | ---- Accessors --------------------------------------------------------- |
processorVendor | String processorVendor() | No description in source. |
processorModel | String processorModel() | No description in source. |
cores | int cores() | No description in source. |
bits | int bits() | No description in source. |
mhz | int mhz() | No description in source. |
memoryModule | SLDDRModule memoryModule() | No description in source. |
moduleCount | int moduleCount() | No description in source. |
primarySsd | SLSSD primarySsd() | No description in source. |
primaryHdd | SLHardDisk primaryHdd() | No description in source. |
uefiFirmware | SLUEFIFirmware uefiFirmware() | No description in source. |
usbController | SLUSBDevice usbController() | No description in source. |
videoCard | SLVideoCard videoCard() | No description in source. |
hasVideo | boolean hasVideo() | No description in source. |
bootsFromSsd | boolean bootsFromSsd() | No description in source. |
totalMemoryMb | int totalMemoryMb() | Total installed memory in MB across all modules. |
bootCapacityBlocks | int bootCapacityBlocks() | The boot storage device's capacity in VM blocks (SSD preferred over HDD). |
bootBlockBytes | int bootBlockBytes() | No description in source. |
bootMediaKind | int bootMediaKind() | Media kind for lib/cpu/SLHardDrive: 1 solid-state, 0 rotational. |
isRunnable | boolean isRunnable() | A machine is runnable when it has memory, a boot device, and firmware. |
identity | String 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.
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
isHost | boolean isHost() | True when the running host is actually macOS. |
sh | int sh(String command) | ---- Shell / Apple tools ----------------------------------------------- Run a command through /bin/sh. |
openWith | int openWith(String target) | Open a file/URL/app with the default handler via the `open(1)` tool. |
launchApp | int launchApp(String appName) | Launch a .app bundle by name, e.g. "Safari". |
startSh | SLProcess startSh(String command) | Start a background command; returns an SLProcess. |
home | String home() | ---- Apple directory layout -------------------------------------------- |
library | String library() | No description in source. |
appSupport | String appSupport() | No description in source. |
preferences | String preferences() | No description in source. |
applications | String applications() | No description in source. |
system | String system() | No description in source. |
volumes | String volumes() | No description in source. |
brewPrefix | String brewPrefix() | Homebrew prefix: Apple Silicon uses /opt/homebrew, Intel uses /usr/local. |
productVersion | int productVersion() | ---- System facts via Apple CLIs --------------------------------------- Run `sw_vers` to print the macOS product version to the console. |
readDefault | int readDefault(String domain, String key) | Read a defaults domain key, e.g. domain "NSGlobalDomain", key "AppleLocale". |
exists | boolean exists(String path) | ---- Filesystem / identity (through the real OS) ------------------------ |
tempDir | String tempDir() | honours TMPDIR |
hostName | String hostName() | No description in source. |
userName | String 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.
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
build | void build(String name, String ver) | Build a macOS-shaped model with the given product name/version on arm64. |
buildUniversal | void 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
CAP_MEMORY | static final int CAP_MEMORY = 0 | Capability ordinals (mirror SLPlatformCapability in the VM). |
CAP_FILE_IO | static final int CAP_FILE_IO = 1 | No description in source. |
CAP_NETWORK | static final int CAP_NETWORK = 2 | No description in source. |
CAP_THREADS | static final int CAP_THREADS = 3 | No description in source. |
CAP_LIBRARY | static final int CAP_LIBRARY = 4 | No description in source. |
CAP_TERMINAL | static final int CAP_TERMINAL= 5 | No description in source. |
CAP_PATHS | static final int CAP_PATHS = 6 | No description in source. |
CAP_PROCESS | static final int CAP_PROCESS = 7 | No description in source. |
CAP_IPC | static final int CAP_IPC = 8 | No description in source. |
CAP_TIME | static final int CAP_TIME = 9 | No description in source. |
name | String name | human label chosen by the caller |
opened | int opened | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String label) | No description in source. |
open | void open() | No description in source. |
close | void close() | No description in source. |
active | boolean active() | No description in source. |
platform | String platform() | ---- Identity ----------------------------------------------------------- The host OS name as reported by the VM: "Windows", "Linux", or "macOS". |
isWindows | boolean isWindows() | No description in source. |
isLinux | boolean isLinux() | No description in source. |
isMac | boolean isMac() | No description in source. |
hostName | String hostName() | No description in source. |
userName | String userName() | No description in source. |
processId | int processId() | No description in source. |
supports | boolean supports(int capability) | True if the host advertises a capability class (process/ipc/network/...). |
getEnv | String getEnv(String key) | ---- Environment -------------------------------------------------------- |
setEnv | boolean setEnv(String key, String value) | No description in source. |
currentDir | String currentDir() | ---- Working directory -------------------------------------------------- |
changeDir | boolean changeDir(String path) | No description in source. |
tempDir | String tempDir() | No description in source. |
run | int run(String command) | ---- Process execution -------------------------------------------------- Run a shell command synchronously; returns its exit code (0 == success). |
runOk | boolean runOk(String command) | True if the command ran and exited 0. |
equalsString | boolean 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
triple | String triple | LLVM-style target triple |
packageArch | String packageArch | distro package arch label (amd64/arm64/...) |
wordBits | int wordBits | 32 or 64 |
littleEndian | int littleEndian | 1 little, 0 big |
configured | int configured | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
amd64 | void amd64() | ---- Presets ------------------------------------------------------------ |
arm64 | void arm64() | No description in source. |
armhf | void armhf() | No description in source. |
ppc64el | void ppc64el() | No description in source. |
s390x | void s390x() | No description in source. |
riscv64 | void riscv64() | No description in source. |
x86 | void x86() | No description in source. |
configure | void configure(String arch) | Choose by package-arch label; defaults to amd64. |
retargetForShape | void retargetForShape(SLOSShape shape) | Re-triple for a non-Linux shape so the triple reflects the target OS. |
targetTriple | String targetTriple() | No description in source. |
arch | String arch() | No description in source. |
bits | int bits() | No description in source. |
isLittleEndian | boolean 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
KIND_C_HEADER | static final int KIND_C_HEADER = 0 | Kind tags. |
KIND_C_SOURCE | static final int KIND_C_SOURCE = 1 | No description in source. |
KIND_CPP_SOURCE | static final int KIND_CPP_SOURCE = 2 | No description in source. |
KIND_SCRIPT | static final int KIND_SCRIPT = 3 | No description in source. |
KIND_ISO | static final int KIND_ISO = 4 | No description in source. |
KIND_MANIFEST | static final int KIND_MANIFEST = 5 | No description in source. |
path | String path | logical output path |
kind | int kind | one of KIND_* |
contents | String contents | text (source/script/manifest) or ISO descriptor |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String outPath, int artifactKind, String text) | No description in source. |
outputPath | String outputPath() | No description in source. |
artifactKind | int artifactKind() | No description in source. |
text | String text() | No description in source. |
byteCount | int byteCount() | No description in source. |
kindName | String 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
identity | String identity | the model identity this build is for |
index | String index | newline-separated "kind size path" lines |
artifactCount | int artifactCount | No description in source. |
ok | int ok | 1 if the build completed without a failure |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String modelIdentity) | No description in source. |
record | void record(SLOSArtifact a) | Record one produced artifact. |
fail | void fail() | Mark the build as failed (e.g. an unbuildable model). |
succeeded | boolean succeeded() | No description in source. |
count | int count() | No description in source. |
artifactIndex | String artifactIndex() | No description in source. |
modelIdentity | String modelIdentity() | No description in source. |
summary | String summary() | A one-line human summary. |
intToStr | String 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
cEmit | SLCEmitter cEmit | No description in source. |
cppEmit | SLCppEmitter cppEmit | No description in source. |
report | SLOSBuildReport report | No description in source. |
configHeader | SLOSArtifact configHeader | The artifacts of the most recent compile (held for the caller to persist). |
bootUnit | SLOSArtifact bootUnit | No description in source. |
osImage | SLOSArtifact osImage | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
compile | SLOSBuildReport 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. |
compileToIso | SLOSBuildReport 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. |
header | SLOSArtifact header() | ---- Accessors to the most recent compile's artifacts ------------------- |
boot | SLOSArtifact boot() | No description in source. |
image | SLOSArtifact image() | No description in source. |
lastReport | SLOSBuildReport 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
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
uefi | SLUEFIEmitter uefi | No description in source. |
bios | SLBIOSEmitter bios | No description in source. |
bootLoader | SLBootLoaderEmitter bootLoader | No description in source. |
kernelLoader | SLKernelLoaderEmitter kernelLoader | No description in source. |
driverLoader | SLDriverLoaderEmitter driverLoader | No description in source. |
osLoader | SLOSLoaderEmitter osLoader | No description in source. |
desktopLoader | SLDesktopLoaderEmitter desktopLoader | No description in source. |
compatLoader | SLCompatLoaderEmitter compatLoader | No description in source. |
baseDriverEmit | SLBaseDriverEmitter baseDriverEmit | No description in source. |
cEmit | SLCEmitter cEmit | No description in source. |
cppEmit | SLCppEmitter cppEmit | No description in source. |
toolchain | SLToolchainEmitter toolchain | No description in source. |
dropper | SLSourceDropper dropper | No description in source. |
tree | SLOSDevTree tree | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
create | SLOSBuildReport 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. |
downloadsConf | String downloadsConf(SLOSModel m) | The resolved download URLs for the model, as a conf header + the set's manifest ("<kind> <phase> <url>" lines from SLDownloadSet). |
plan | String plan(SLOSModel m) | plan() returns a human description of what create() would write, without touching the filesystem — useful for a dry run. |
writePiece | void writePiece(SLOSPiece p, SLOSBuildReport report) | Write a piece and record each of its files in the report. |
recordWrite | void recordWrite(SLOSBuildReport report, String path, int bytes) | Record a direct writeFile result in the report when the write succeeded. |
sourceArtifact | SLOSArtifact sourceArtifact(String path) | Build a lightweight artifact handle for the report index. |
devTree | SLOSDevTree 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
root | String root | absolute output root, e.g. "/os-development" |
manifest | String manifest | newline-separated "bytes path" index |
fileCount | int fileCount | No description in source. |
configured | int configured | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String outputRoot) | No description in source. |
layout | int layout(boolean withDesktop) | Create the standard /os-development subtree. Returns 1 on success. Existing directories are tolerated (osMakeDir is idempotent-friendly in the bridge). |
makeDir | int makeDir(String rel) | Make one directory relative to the root (relative "" makes the root itself). |
writeFile | int 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). |
writePiece | void writePiece(SLOSPiece p) | Write every file an SLOSPiece carries into the piece's subtree. |
recordFile | void recordFile(String rel, int bytes) | No description in source. |
writeManifest | int writeManifest(String identityLine) | Finalise the tree: write MANIFEST.md listing everything produced. |
outputRoot | String outputRoot() | No description in source. |
filesWritten | int filesWritten() | No description in source. |
fileIndex | String fileIndex() | No description in source. |
intToStr | String 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.
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
emit | SLOSPiece emit(SLOSModel m) | No description in source. |
emitServiceStarts | String emitServiceStarts(String units) | One start_service() call per boot-mode unit in the manifest. |
bootUnitList | String bootUnitList(String units) | No description in source. |
nameOf | String nameOf(String line) | No description in source. |
modeOf | String modeOf(String line) | No description in source. |
strLen | int strLen(String s) | No description in source. |
substr | String substr(String s, int a, int b) | No description in source. |
charAt | String charAt(String s, int i) | No description in source. |
boolLit | String 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
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
osName | String osName | product name, e.g. "Determinant" |
edition | String edition | "Desktop" / "Server" |
version | String version | product version |
shape | SLOSShape shape | No description in source. |
arches | SLArchitectureSet arches | No description in source. |
boot | SLBootloaderSpec boot | No description in source. |
kernel | SLKernelSpec kernel | No description in source. |
filesystem | SLFilesystemLayout filesystem | No description in source. |
swap | SLSwapConfig swap | swap/paging kind + quality |
baseDrivers | SLBaseDriverSeries baseDrivers | minimum-boot driver series |
driverSource | SLDriverSource driverSource | driver provenance/trust + cross-OS bridge |
drivers | SLDriverSet drivers | No description in source. |
packages | SLPackageSet packages | No description in source. |
services | SLServiceSet services | No description in source. |
desktop | SLDesktopSpec desktop | No description in source. |
compat | SLCompatSet compat | foreign-OS execution capability (optional layer) |
downloads | SLDownloadSet downloads | URLs for related downloads (pre-compile / pre-ISO) |
configFiles | SLConfigSet configFiles | the settings files that must be present pre-build |
configured | int configured | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void 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. |
shapeAs | void 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. |
asServer | void asServer() | Mark this as a server edition: drop the desktop layer. |
osShape | SLOSShape osShape() | ---- Accessors for the layers (for refinement and emission) ------------- |
architectures | SLArchitectureSet architectures() | No description in source. |
bootloader | SLBootloaderSpec bootloader() | No description in source. |
kernelSpec | SLKernelSpec kernelSpec() | No description in source. |
layout | SLFilesystemLayout layout() | No description in source. |
swapConfig | SLSwapConfig swapConfig() | No description in source. |
baseDriverSeries | SLBaseDriverSeries baseDriverSeries() | No description in source. |
driverPolicy | SLDriverSource driverPolicy() | No description in source. |
driverSet | SLDriverSet driverSet() | No description in source. |
fsCatalog | SLFilesystemCatalog fsCatalog() | The filesystem (file-table) type catalogue — a fresh reference helper for choosing/validating a filesystem format (FAT/NTFS/ext4/APFS/...). |
packageSet | SLPackageSet packageSet() | No description in source. |
serviceSet | SLServiceSet serviceSet() | No description in source. |
desktopSpec | SLDesktopSpec desktopSpec() | No description in source. |
compatSet | SLCompatSet compatSet() | No description in source. |
downloadSet | SLDownloadSet downloadSet() | No description in source. |
configSet | SLConfigSet configSet() | No description in source. |
name | String name() | No description in source. |
osVersion | String osVersion() | No description in source. |
osEdition | String osEdition() | No description in source. |
isBuildable | boolean isBuildable() | ---- Validity: can this model be built into a bootable OS? -------------- Every irreducible layer must be present and self-consistent. |
readyToCompile | boolean 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. |
readyForIso | boolean readyForIso() | Before the final ISO conversion, additionally the ISO-phase downloads (firmware, runtime payloads) and settings (services, swap) must be ready. |
identity | String 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
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
library | String library | the static library the /os subsystem builds to |
configured | int configured | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
libraryName | String libraryName() | No description in source. |
headerFor | String 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). |
provides | boolean provides(String capability) | No description in source. |
theSLeeLa | String 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. |
capabilityCount | int capabilityCount() | Number of executive capabilities backed by the native subsystem. |
contractSheet | String 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
name | String name | human name, e.g. "Boot Loader" |
directory | String directory | tree-relative dir, e.g. "boot/loader" |
baseName | String baseName | file stem, e.g. "bootloader" |
cSource | String cSource | the .c surface |
cppSource | String cppSource | the .cpp surface |
configName | String configName | config file name, e.g. "loader.conf" |
configText | String configText | config file contents |
readme | String readme | per-piece README.md contents |
configured | int configured | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String pieceName, String dir, String stem) | No description in source. |
setC | void setC(String src) | No description in source. |
setCpp | void setCpp(String src) | No description in source. |
setConfig | void setConfig(String fileName, String text) | No description in source. |
setReadme | void setReadme(String text) | No description in source. |
cPath | String cPath() | ---- Derived file paths (relative to the dev-tree root) ----------------- |
cppPath | String cppPath() | No description in source. |
configPath | String configPath() | No description in source. |
readmePath | String readmePath() | No description in source. |
pieceName | String pieceName() | ---- Accessors ---------------------------------------------------------- |
dir | String dir() | No description in source. |
c | String c() | No description in source. |
cpp | String cpp() | No description in source. |
config | String config() | No description in source. |
configFile | String configFile() | No description in source. |
readmeText | String readmeText() | No description in source. |
hasConfig | boolean hasConfig() | No description in source. |
hasReadme | boolean hasReadme() | No description in source. |
SLOSSensitivityFetch #sleela 2.5 (lib/operating-system/SLOSSensitivityFetch.sleela)
SLOSSensitivityFetch class
Defines SLOSSensitivityFetch -- the OPT-IN, per-user downloader
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
MODE_SHALLOW | static final int MODE_SHALLOW = 0 | Fetch depth/mode tags. --depth 1 --single-branch (default) |
MODE_FULL | static final int MODE_FULL = 1 | full history |
src | SLOSSensitivitySource src | the reference (field; wired by configure()) |
mode | int mode | No description in source. |
lastExit | int lastExit | exit code of the most recent fetch (-1 if none run) |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
useSource | void useSource(SLOSSensitivitySource source) | Point at a specific reference instead of the default. |
setMode | void setMode(int m) | No description in source. |
source | SLOSSensitivitySource source() | No description in source. |
cloneCommand | String 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). |
pinCommand | String 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. |
fetch | int 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. |
fetchShallow | int fetchShallow(String destRoot) | Convenience: shallow fetch (the safe default). |
fetchComplete | int fetchComplete(String destRoot) | Convenience: full fetch pinned to the reference commit. |
lastExitCode | int lastExitCode() | No description in source. |
succeeded | boolean succeeded() | No description in source. |
probe | int 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. |
shapePath | String 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. |
componentPath | String 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. |
descriptorPath | String 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
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
name | String name | Warehouse identity. |
owner | String owner | No description in source. |
repo | String repo | No description in source. |
url | String url | https clone URL |
branch | String branch | default branch |
pinnedCommit | String pinnedCommit | exact revision for reproducible fetches |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | Configure with the known OS.Sensitivity.III warehouse reference. The pinned commit is the current main tip; callers may repin with pin(commit). |
descriptorFile | String 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. |
descriptorPath | String descriptorPath(String destRoot) | On-disk path to the descriptor after a fetch into destRoot. |
pin | void pin(String commit) | Repin to a specific revision (keeps fetches reproducible). |
identity | String identity() | No description in source. |
cloneUrl | String cloneUrl() | No description in source. |
defaultBranch | String defaultBranch() | No description in source. |
commit | String commit() | No description in source. |
shapeDir | String 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. |
providesShape | boolean providesShape(String shape) | No description in source. |
componentDir | String 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. |
providesComponent | boolean providesComponent(String component) | No description in source. |
shapeComponentDir | String shapeComponentDir(String shape, String component) | No description in source. |
providesShapeComponent | boolean providesShapeComponent(String shape, String component) | No description in source. |
dirFor | String dirFor(String shape, String component) | dirFor(shape, component): the warehouse path "<shape>/<component>", or "" if either the shape or the component is unknown. |
downloadabilityNote | String 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. |
referenceSheet | String 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
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
SHAPE_LINUX | static final int SHAPE_LINUX = 0 | Canonical shape ordinals. |
SHAPE_WINDOWS | static final int SHAPE_WINDOWS = 1 | No description in source. |
SHAPE_MACOS | static final int SHAPE_MACOS = 2 | No description in source. |
shape | int shape | one of SHAPE_* |
label | String label | "Linux" / "Windows" / "macOS" |
configured | int configured | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
linux | void linux() | ---- Construction ------------------------------------------------------- |
windows | void windows() | No description in source. |
macos | void macos() | No description in source. |
configure | void configure(String name) | Choose by name; defaults to Linux for an unrecognised label. |
isLinux | boolean isLinux() | No description in source. |
isWindows | boolean isWindows() | No description in source. |
isMac | boolean isMac() | No description in source. |
ordinal | int ordinal() | No description in source. |
name | String name() | No description in source. |
pathSeparator | String pathSeparator() | ---- Per-family defaults the composed specs read ----------------------- The path separator convention for this shape. |
listSeparator | String listSeparator() | The PATH-list separator convention for this shape. |
initManager | String initManager() | The name of the first user-space process / service manager. |
bootStyle | String bootStyle() | The default firmware/boot style for this shape. |
rootFilesystem | String rootFilesystem() | The default root-filesystem format for this shape. |
desktopSession | String desktopSession() | The default desktop/session shell for this shape. |
systemRoot | String systemRoot() | The conventional system-root directory for this shape. |
executableExtension | String 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
manifest | String manifest | newline-separated "name version" lines |
count | int count | No description in source. |
configured | int configured | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
add | void add(String name, String version) | Add a package with an explicit version. |
addLatest | void addLatest(String name) | Add a package at an unpinned/"latest" version. |
baseSeedForShape | void baseSeedForShape(SLOSShape shape) | Seed the base-system packages a shape needs before any layering. |
packages | String packages() | No description in source. |
packageCount | int packageCount() | No description in source. |
isEmpty | boolean 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
value | String value | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String p) | No description in source. |
text | String text() | No description in source. |
separator | String separator() | The host path separator: "\\" on Windows, "/" elsewhere. |
listSeparator | String listSeparator() | The host entry (PATH) separator: ";" on Windows, ":" elsewhere. |
join | String join(String child) | Join a child segment onto this path using the host separator; returns the combined path text. |
append | String append(String child) | Append in place and return the new path text. |
joinList | String joinList(String a, String b) | Build a PATH-style list string from two entries using the host list separator (";" on Windows, ":" elsewhere). |
exists | boolean 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
path | String path | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String p) | No description in source. |
exists | boolean exists() | No description in source. |
readable | boolean 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. |
writable | boolean writable() | No description in source. |
executable | boolean executable() | No description in source. |
posixModel | boolean 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
STATE_NEW | static final int STATE_NEW = 0 | No description in source. |
STATE_RUNNING | static final int STATE_RUNNING = 1 | No description in source. |
STATE_EXITED | static final int STATE_EXITED = 2 | No description in source. |
STATE_FAILED | static final int STATE_FAILED = 3 | No description in source. |
command | String command | No description in source. |
handle | int handle | VM-local process handle (-1 = none) |
state | int state | No description in source. |
exitCode | int exitCode | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String cmd) | No description in source. |
runSync | int runSync() | Run synchronously: block until the process exits, recording the exit code. Returns the exit code (0 == success). |
start | boolean 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()). |
wait | int wait() | Block for a started process and collect its exit code; releases the handle. |
kill | boolean 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. |
close | void close() | Release a started-but-unwaited process without blocking. |
running | boolean running() | No description in source. |
succeeded | boolean succeeded() | No description in source. |
status | int status() | No description in source. |
processState | int 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
manager | String manager | "systemd" / "ServiceControlManager" / "launchd" |
units | String units | newline-separated "name mode" lines (mode: boot|ondemand) |
count | int count | No description in source. |
configured | int configured | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String svcManager) | No description in source. |
addUnit | void addUnit(String name, String mode) | No description in source. |
enableAtBoot | void enableAtBoot(String name) | No description in source. |
enableOnDemand | void enableOnDemand(String name) | No description in source. |
forShape | void forShape(SLOSShape shape) | Seed the baseline services a shape brings up, under its own manager. |
serviceManager | String serviceManager() | No description in source. |
unitManifest | String unitManifest() | No description in source. |
serviceCount | int serviceCount() | No description in source. |
hasServices | boolean 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.
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
drop | void drop(SLOSModel m, SLOSDevTree tree) | Drop the reconstructable SLeeLa source and a provenance README into the tree. |
modelSource | String modelSource(SLOSModel m) | A minimal, runnable SLeeLa program that reconstructs this model and re-runs OS Creator(TM) to regenerate the tree. |
provenance | String 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
IF_SATA3 | static final int IF_SATA3 = 0 | Interface ordinals. 6 Gb/s |
IF_NVME_PCIE3 | static final int IF_NVME_PCIE3 = 1 | No description in source. |
IF_NVME_PCIE4 | static final int IF_NVME_PCIE4 = 2 | No description in source. |
IF_NVME_PCIE5 | static final int IF_NVME_PCIE5 = 3 | No description in source. |
NAND_SLC | static final int NAND_SLC = 1 | NAND cell types. |
NAND_MLC | static final int NAND_MLC = 2 | No description in source. |
NAND_TLC | static final int NAND_TLC = 3 | No description in source. |
NAND_QLC | static final int NAND_QLC = 4 | No description in source. |
iface | int iface | IF_* |
formFactor | String formFactor | "2.5\"", "M.2 2280", "U.2", "AIC" |
nand | int nand | NAND_* |
capacityGb | int capacityGb | No description in source. |
seqReadMBps | int seqReadMBps | representative sequential read |
seqWriteMBps | int seqWriteMBps | representative sequential write |
blockBytes | int blockBytes | logical block size (typically 512 or 4096) |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void 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. |
configureByName | void configureByName(String manufacturer, String partName, String ifName, int capacityGb) | Configure by interface name ("SATA", "PCIe3", "PCIe4", "PCIe5"). |
setNand | void setNand(int cellType) | No description in source. |
setFormFactor | void setFormFactor(String ff) | No description in source. |
setThroughput | void setThroughput(int readMBps, int writeMBps) | No description in source. |
isNvme | boolean isNvme() | No description in source. |
interfaceName | String interfaceName() | No description in source. |
nandName | String nandName() | No description in source. |
form | String form() | No description in source. |
capacityGigabytes | int capacityGigabytes() | No description in source. |
readMBps | int readMBps() | No description in source. |
writeMBps | int writeMBps() | No description in source. |
blockSize | int blockSize() | No description in source. |
capacityBlocks | int 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.
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
nvme4 | SLSSD nvme4(String manufacturer, int capacityGb) | A flagship NVMe PCIe 4.0 drive from a named manufacturer. |
nvme5 | SLSSD nvme5(String manufacturer, int capacityGb) | A flagship NVMe PCIe 5.0 drive from a named manufacturer. |
sata | SLSSD sata(String manufacturer, int capacityGb) | A SATA III 2.5" drive from a named manufacturer. |
drive | SLSSD drive(String manufacturer, String ifName, int capacityGb) | Build an SSD by interface name from any manufacturer. |
known | boolean known(String manufacturer) | No description in source. |
nvme5Part | String nvme5Part(String mfr) | ---- Representative model names ---------------------------------------- |
nvmePart | String nvmePart(String mfr) | No description in source. |
sataPart | String sataPart(String mfr) | No description in source. |
partFor | String 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
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
PRIO_AUTHORITATIVE | static final int PRIO_AUTHORITATIVE = 0 | Priority ordinals (lower = tried first; by likelihood of a final/edu ref). |
PRIO_OFFICIAL_MIRROR | static final int PRIO_OFFICIAL_MIRROR = 1 | No description in source. |
PRIO_COLLEGE | static final int PRIO_COLLEGE = 2 | No description in source. |
PRIO_ARCHIVE | static final int PRIO_ARCHIVE = 3 | No description in source. |
configured | int configured | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
kernelPrimary | String kernelPrimary() | Linux kernel source mirrors. |
kernelSupport | String kernelSupport(int prio) | No description in source. |
packagePrimary | String packagePrimary() | Ubuntu/Debian package archive mirrors. |
packageSupport | String packageSupport(int prio) | No description in source. |
firmwarePrimary | String firmwarePrimary() | linux-firmware source mirrors. |
firmwareSupport | String firmwareSupport(int prio) | No description in source. |
upstreamPrimary | String upstreamPrimary() | The upstream Determinant distro mirrors. |
upstreamSupport | String upstreamSupport(int prio) | No description in source. |
winePrimary | String winePrimary() | Wine runtime mirrors. |
wineSupport | String wineSupport(int prio) | No description in source. |
qemuPrimary | String qemuPrimary() | QEMU runtime mirrors. |
qemuSupport | String qemuSupport(int prio) | No description in source. |
supportUrl | String 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. |
knownKind | boolean knownKind(String kind) | No description in source. |
priorityName | String priorityName(int prio) | No description in source. |
rankedList | String rankedList(String kind) | The ranked list "<priority> <url>" for a kind (primary first, archive last). |
add | String add(String acc, String line) | No description in source. |
fetchWithFallback | String 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`. |
isGitKind | boolean isGitKind(String kind) | No description in source. |
firstReachable | String 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. |
reachable | boolean reachable(String kind, String url) | No description in source. |
ready | boolean 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
kind | String kind | "file" / "partition" / "zram" / "zswap" / "pagefile" / "dynamic" / "none" |
host | String host | the OS family this swap belongs to |
sizeMb | int sizeMb | swap size in MB (0 = auto / RAM-relative) |
ramMultipleTenths | int ramMultipleTenths | size as a multiple of RAM, in tenths (e.g. 10 = 1.0x RAM); 0 = use sizeMb |
swappiness | int swappiness | 0..100 reclaim aggressiveness (Linux vm.swappiness) |
compAlgo | String compAlgo | compression algorithm for zram/zswap ("lzo","lz4","zstd"), else "" |
compLevel | int compLevel | compression quality/level (algorithm-dependent), 0 = default |
priority | int priority | swap priority (higher = preferred); -1 = default |
configured | int configured | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String swapKind, int sizeMegabytes, int swappinessValue) | Configure explicitly. compAlgo/compLevel apply only to zram/zswap. |
norm | String norm(String k) | No description in source. |
clamp0to100 | int clamp0to100(int v) | No description in source. |
forShape | void 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. |
setSizeMb | void 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. |
setSizeRamMultiple | void setSizeRamMultiple(int tenths) | No description in source. |
setSwappiness | void setSwappiness(int v) | No description in source. |
setPriority | void setPriority(int p) | No description in source. |
setCompression | void 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. |
isCompressed | boolean isCompressed() | No description in source. |
isValid | boolean 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. |
validForShape | boolean 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. |
swapKind | String swapKind() | ---- Accessors ------------------------------------------------------ |
swapSizeMb | int swapSizeMb() | No description in source. |
swappinessValue | int swappinessValue() | No description in source. |
compression | String compression() | No description in source. |
compressionLevel | int compressionLevel() | No description in source. |
sizeText | String sizeText() | A human size description. |
tenths | String tenths(int t) | No description in source. |
emitLinux | String emitLinux() | ---- Emission ------------------------------------------------------- The Linux fstab entry (file/partition) or the systemd/zram-generator line (zram), plus a vm.swappiness sysctl. Empty for kind "none". |
prioOpt | String prioOpt() | No description in source. |
algoOrDefault | String algoOrDefault() | No description in source. |
emitForShape | String emitForShape(SLOSShape shape) | The per-shape swap note the generator/creator records. |
summary | String 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.
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
intToStr | String intToStr(int v) | No description in source. |
emitMakefile | String emitMakefile(SLOSModel m, boolean withDesktop) | The top-level Makefile that builds all pieces and authors the ISO. |
emitBuildSh | String emitBuildSh(SLOSModel m) | POSIX build driver (Linux / macOS shapes). |
emitBuildPs1 | String emitBuildPs1(SLOSModel m) | PowerShell build driver (Windows shape). |
emitOsConf | String emitOsConf(SLOSModel m) | The global os.conf config carrying the model identity. |
isoName | String 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.
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
emit | SLOSPiece emit(SLOSModel m) | No description in source. |
loaderImage | String loaderImage(String loader) | Map a loader name to its EFI image filename. |
boolLit | String 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
specRevision | String specRevision | UEFI spec revision, e.g. "2.10" |
secureBoot | int secureBoot | 1 if Secure Boot is supported |
csm | int csm | 1 if a Compatibility Support Module (legacy BIOS) exists |
bootServices | int bootServices | 1 if boot services present (always, modeled) |
runtimeServices | int runtimeServices | 1 if runtime services present |
espLabel | String espLabel | EFI System Partition label it reads |
configured2 | int configured2 | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String vendor, String product, String revision) | No description in source. |
ami | void ami() | Named presets for the common firmware vendors. |
insyde | void insyde() | No description in source. |
phoenix | void phoenix() | No description in source. |
tianocore | void tianocore() | No description in source. |
coreboot | void coreboot() | No description in source. |
configureByVendor | void configureByVendor(String vendor) | Choose by vendor name; defaults to TianoCore (the reference/open firmware). |
enableSecureBoot | void enableSecureBoot(boolean on) | No description in source. |
enableCsm | void enableCsm(boolean on) | No description in source. |
uefiRevision | String uefiRevision() | No description in source. |
supportsSecureBoot | boolean supportsSecureBoot() | No description in source. |
hasCsm | boolean hasCsm() | No description in source. |
hasRuntimeServices | boolean hasRuntimeServices() | No description in source. |
esp | String esp() | No description in source. |
canLaunch | boolean 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.
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
controller | SLUSBDevice controller(String vendor, String genName, int ports) | A USB host controller (root hub) from a named vendor at a generation. |
hub | SLUSBDevice hub(String vendor, String genName, int ports) | A USB hub from a named vendor. |
hid | SLUSBDevice hid(String vendor, String part) | A HID device (keyboard/mouse), typically USB 2.0 Type-A. |
flashDrive | SLUSBDevice flashDrive(String vendor, String part, String genName) | A mass-storage flash drive at a given generation. |
knownController | boolean knownController(String vendor) | No description in source. |
controllerPart | String 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
USB_1_1 | static final int USB_1_1 = 0 | Specification-generation ordinals. Full Speed, 12 Mb/s |
USB_2_0 | static final int USB_2_0 = 1 | High Speed, 480 Mb/s |
USB_3_2G1 | static final int USB_3_2G1 = 2 | 5 Gb/s (formerly USB 3.0) |
USB_3_2G2 | static final int USB_3_2G2 = 3 | 10 Gb/s (formerly USB 3.1) |
USB_3_2G2X2 | static final int USB_3_2G2X2 = 4 | 20 Gb/s |
USB4 | static final int USB4 = 5 | 40 Gb/s |
UC_HID | static final int UC_HID = 1 | Device-class ordinals (USB class codes, abbreviated set). |
UC_MASS | static final int UC_MASS = 2 | No description in source. |
UC_HUB | static final int UC_HUB = 3 | No description in source. |
UC_AUDIO | static final int UC_AUDIO = 4 | No description in source. |
UC_VIDEO | static final int UC_VIDEO = 5 | No description in source. |
UC_CONTROLLER | static final int UC_CONTROLLER = 6 | host controller / root hub |
generation | int generation | USB_* |
usbClass | int usbClass | UC_* |
rateMbps | int rateMbps | signalling rate in Mb/s |
connector | String connector | "Type-A" / "Type-B" / "Type-C" / "Micro-B" |
powerDelivery | int powerDelivery | 1 if USB-PD capable |
maxPorts | int maxPorts | for hubs/controllers |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String manufacturer, String partName, int gen, int cls) | No description in source. |
configureByName | void configureByName(String manufacturer, String partName, String genName, int cls) | Configure by generation name ("USB1.1","USB2.0","USB3.2G1","USB3.2G2","USB3.2G2x2","USB4"). |
setConnector | void setConnector(String c) | No description in source. |
setPorts | void setPorts(int ports) | No description in source. |
generationName | String generationName() | No description in source. |
usbClassName | String usbClassName() | No description in source. |
signallingRateMbps | int signallingRateMbps() | No description in source. |
connectorType | String connectorType() | No description in source. |
hasPowerDelivery | boolean hasPowerDelivery() | No description in source. |
portCount | int portCount() | No description in source. |
isController | boolean 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
GPU_NVIDIA | static final int GPU_NVIDIA = 0 | GPU vendor ordinals. |
GPU_AMD | static final int GPU_AMD = 1 | No description in source. |
GPU_INTEL | static final int GPU_INTEL = 2 | No description in source. |
VRAM_GDDR6 | static final int VRAM_GDDR6 = 0 | Video-memory type ordinals. |
VRAM_GDDR6X | static final int VRAM_GDDR6X = 1 | No description in source. |
VRAM_GDDR7 | static final int VRAM_GDDR7 = 2 | No description in source. |
VRAM_HBM | static final int VRAM_HBM = 3 | No description in source. |
gpuVendor | int gpuVendor | GPU_* |
architecture | String architecture | e.g. "Ada Lovelace", "RDNA 3", "Xe-HPG" |
pcieGen | int pcieGen | PCIe generation (3,4,5) |
pcieLanes | int pcieLanes | typically 16 |
vramMb | int vramMb | video memory in MB |
vramType | int vramType | VRAM_* |
hdmiPorts | int hdmiPorts | No description in source. |
displayPorts | int displayPorts | No description in source. |
boardPowerW | int boardPowerW | typical board power (TGP) in watts |
vulkan | int vulkan | 1 if Vulkan supported |
direct3d | int direct3d | 1 if Direct3D 12 supported |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String vendorName, String partName, int vendorOrdinal, int vramMegabytes) | No description in source. |
configureByVendor | void configureByVendor(String vendorName, String partName, int vramMb) | Configure by vendor name ("NVIDIA"/"AMD"/"Intel"). |
setArchitecture | void setArchitecture(String arch) | No description in source. |
setPcie | void setPcie(int gen, int lanes) | No description in source. |
setVram | void setVram(int megabytes, int type) | No description in source. |
setOutputs | void setOutputs(int hdmi, int dp) | No description in source. |
setBoardPower | void setBoardPower(int watts) | No description in source. |
vendorName | String vendorName() | No description in source. |
architectureName | String architectureName() | No description in source. |
pcieGeneration | int pcieGeneration() | No description in source. |
lanes | int lanes() | No description in source. |
vramMegabytes | int vramMegabytes() | No description in source. |
vramTypeName | String vramTypeName() | No description in source. |
outputsTotal | int outputsTotal() | No description in source. |
boardPower | int boardPower() | No description in source. |
supportsVulkan | boolean supportsVulkan() | No description in source. |
supportsDirect3D | boolean 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.
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
geforce | SLVideoCard geforce(String model, int vramMb) | A GeForce/RTX card by model, e.g. geforce("RTX 4090", 24576). |
radeon | SLVideoCard radeon(String model, int vramMb) | A Radeon RX card by model, e.g. radeon("RX 7900 XTX", 24576). |
arc | SLVideoCard arc(String model, int vramMb) | An Intel Arc card by model, e.g. arc("A770", 16384). |
card | SLVideoCard card(String vendor, String model, int vramMb) | Build any card by vendor + model name. |
knownVendor | boolean knownVendor(String vendor) | No description in source. |
knownBoardPartner | boolean knownBoardPartner(String partner) | Board partners that ship these GPUs (for identity/branding). |
nvPower | int 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.
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
isHost | boolean isHost() | True when the running host is actually Windows. |
cmd | int cmd(String commandLine) | ---- Shells ------------------------------------------------------------- Run a command through cmd.exe (osRun already routes through cmd.exe on Windows). Returns the exit code. |
powershell | int powershell(String script) | Run a command through PowerShell. Returns the exit code. |
startCmd | SLProcess startCmd(String commandLine) | Start a background command via the process bridge; returns an SLProcess. |
userProfile | String userProfile() | ---- Windows environment entries --------------------------------------- |
appData | String appData() | No description in source. |
localAppData | String localAppData() | No description in source. |
systemRoot | String systemRoot() | No description in source. |
programFiles | String programFiles() | No description in source. |
comSpec | String comSpec() | path to cmd.exe |
computerName | String computerName() | No description in source. |
separator | String separator() | ---- Paths (backslash world) ------------------------------------------- |
join | String join(String base, String child) | No description in source. |
onDrive | String onDrive(String driveLetter, String rest) | Build a drive-rooted path, e.g. drive 'C' -> "C:\\...". |
exists | boolean exists(String path) | ---- Filesystem / identity (through the real OS) ------------------------ |
makeDir | boolean makeDir(String path) | No description in source. |
tempDir | String tempDir() | honours TMP/TEMP via GetTempPath |
hostName | String hostName() | No description in source. |
userName | String 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.
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
build | void build(String name, String ver) | Build a Windows-shaped model with the given product name/version on amd64. |
buildMultiArch | void 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
WindowsCreator class
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
windows | Model windows(String name, String version) | No description in source. |
identity | String identity(Model m) | No description in source. |
readyToCompile | boolean readyToCompile(Model m) | No description in source. |
packageRepo | String packageRepo(Model m) | No description in source. |
kernelSrc | String kernelSrc(Model m) | No description in source. |
configHeader | String configHeader(Model m) | No description in source. |
baseDrivers | String baseDrivers(Model m) | No description in source. |
downloads | String downloads(Model m) | No description in source. |
settings | String settings(Model m) | No description in source. |
compat | String compat(Model m) | Windows has no FS-level interpreter; it runs a Linux guest via WSL2. |
banner | void banner(String t) | No description in source. |
main | void main() | No description in source. |