operating-system.html
api/sleela/3.1/version-014/package/operating-system.html · 2573 line(s) · html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Package operating-system — SleelaDoc API</title>
<link rel="stylesheet" href="../style.css">
</head>
<body>
<header class="top">
<div class="brand"><a href="../index.html">SleelaDoc API</a></div>
<div class="tag">HTML documentation for the SLeeLa standard library (/lib)</div>
</header>
<div class="wrap">
<nav class="side">
<a href="../index.html"><strong>Home</strong></a>
<a href="../packages.html"><strong>All packages</strong></a>
<a href="../glossary.html"><strong>Glossary</strong></a>
<a href="../authorship.html"><strong>Authorship</strong></a>
<h2>Packages</h2><ul>
<li><a href="../package/advantage.html">advantage</a></li>
<li><a href="../package/alphabet.html">alphabet</a></li>
<li><a href="../package/antivirus.html">antivirus</a></li>
<li><a href="../package/api.html">api</a></li>
<li><a href="../package/array.html">array</a></li>
<li><a href="../package/audio.html">audio</a></li>
<li><a href="../package/autocad.html">autocad</a></li>
<li><a href="../package/ballum.html">ballum</a></li>
<li><a href="../package/bash.html">bash</a></li>
<li><a href="../package/boolean.html">boolean</a></li>
<li><a href="../package/cdma.html">cdma</a></li>
<li><a href="../package/char.html">char</a></li>
<li><a href="../package/character.html">character</a></li>
<li><a href="../package/character-recognition.html">character-recognition</a></li>
<li><a href="../package/churn.html">churn</a></li>
<li><a href="../package/citizen.html">citizen</a></li>
<li><a href="../package/codecs.html">codecs</a></li>
<li><a href="../package/collections.html">collections</a></li>
<li><a href="../package/common-rails.html">common-rails</a></li>
<li><a href="../package/compiler.html">compiler</a></li>
<li><a href="../package/compression.html">compression</a></li>
<li><a href="../package/config.html">config</a></li>
<li><a href="../package/connector.html">connector</a></li>
<li><a href="../package/coorenagraph.html">coorenagraph</a></li>
<li><a href="../package/core.html">core</a></li>
<li><a href="../package/cpu.html">cpu</a></li>
<li><a href="../package/crypto.html">crypto</a></li>
<li><a href="../package/data.html">data</a></li>
<li><a href="../package/data-structures.html">data-structures</a></li>
<li><a href="../package/database.html">database</a></li>
<li><a href="../package/debugger.html">debugger</a></li>
<li><a href="../package/decompiler.html">decompiler</a></li>
<li><a href="../package/deliberation.html">deliberation</a></li>
<li><a href="../package/drivers.html">drivers</a></li>
<li><a href="../package/examples.html">examples</a></li>
<li><a href="../package/filesystem.html">filesystem</a></li>
<li><a href="../package/gameplay.html">gameplay</a></li>
<li><a href="../package/governance.html">governance</a></li>
<li><a href="../package/gui.html">gui</a></li>
<li><a href="../package/guidoc.html">guidoc</a></li>
<li><a href="../package/hotlink.html">hotlink</a></li>
<li><a href="../package/html.html">html</a></li>
<li><a href="../package/http.html">http</a></li>
<li><a href="../package/http-1.0.html">http-1.0</a></li>
<li><a href="../package/http-2.0.html">http-2.0</a></li>
<li><a href="../package/http-3.0.html">http-3.0</a></li>
<li><a href="../package/http-4.0.html">http-4.0</a></li>
<li><a href="../package/http-5.0.html">http-5.0</a></li>
<li><a href="../package/http-6.0.html">http-6.0</a></li>
<li><a href="../package/http-7.0.html">http-7.0</a></li>
<li><a href="../package/http-8.0.html">http-8.0</a></li>
<li><a href="../package/http-9.0.html">http-9.0</a></li>
<li><a href="../package/http-servers.html">http-servers</a></li>
<li><a href="../package/ide.html">ide</a></li>
<li><a href="../package/ide-workbench.html">ide-workbench</a></li>
<li><a href="../package/idea.html">idea</a></li>
<li><a href="../package/inference-model.html">inference-model</a></li>
<li><a href="../package/inputs.html">inputs</a></li>
<li><a href="../package/international-criminal-court.html">international-criminal-court</a></li>
<li><a href="../package/io.html">io</a></li>
<li><a href="../package/java.html">java</a></li>
<li><a href="../package/java28.html">java28</a></li>
<li><a href="../package/journey.html">journey</a></li>
<li><a href="../package/languages.html">languages</a></li>
<li><a href="../package/large-language-models.html">large-language-models</a></li>
<li><a href="../package/ledger.html">ledger</a></li>
<li><a href="../package/linux-editors.html">linux-editors</a></li>
<li><a href="../package/manifesto.html">manifesto</a></li>
<li><a href="../package/math.html">math</a></li>
<li><a href="../package/memory.html">memory</a></li>
<li><a href="../package/modules.html">modules</a></li>
<li><a href="../package/moral-capacitor.html">moral-capacitor</a></li>
<li><a href="../package/munction.html">munction</a></li>
<li><a href="../package/native.html">native</a></li>
<li><a href="../package/net.html">net</a></li>
<li><a href="../package/neural-nets.html">neural-nets</a></li>
<li><a href="../package/nordshrift.html">nordshrift</a></li>
<li><a href="../package/observer.html">observer</a></li>
<li><a href="../package/opcodes.html">opcodes</a></li>
<li><a href="../package/operating-system.html">operating-system</a></li>
<li><a href="../package/os-level-support.html">os-level-support</a></li>
<li><a href="../package/philosophers.html">philosophers</a></li>
<li><a href="../package/philosophy.html">philosophy</a></li>
<li><a href="../package/politico.html">politico</a></li>
<li><a href="../package/process.html">process</a></li>
<li><a href="../package/psychiatry.html">psychiatry</a></li>
<li><a href="../package/public.html">public</a></li>
<li><a href="../package/reflection.html">reflection</a></li>
<li><a href="../package/regex.html">regex</a></li>
<li><a href="../package/registry.html">registry</a></li>
<li><a href="../package/rmi.html">rmi</a></li>
<li><a href="../package/rrs.html">rrs</a></li>
<li><a href="../package/runtime.html">runtime</a></li>
<li><a href="../package/security.html">security</a></li>
<li><a href="../package/server-edition.html">server-edition</a></li>
<li><a href="../package/signal-processing.html">signal-processing</a></li>
<li><a href="../package/sldocument.html">sldocument</a></li>
<li><a href="../package/sleela.html">sleela</a></li>
<li><a href="../package/sleela-sql.html">sleela-sql</a></li>
<li><a href="../package/sleela-terminal.html">sleela-terminal</a></li>
<li><a href="../package/sleeladoc.html">sleeladoc</a></li>
<li><a href="../package/slrtp.html">slrtp</a></li>
<li><a href="../package/social-model.html">social-model</a></li>
<li><a href="../package/softlisten.html">softlisten</a></li>
<li><a href="../package/sommeliers.html">sommeliers</a></li>
<li><a href="../package/spatial.html">spatial</a></li>
<li><a href="../package/sst.html">sst</a></li>
<li><a href="../package/synchro.html">synchro</a></li>
<li><a href="../package/systems.html">systems</a></li>
<li><a href="../package/telephony-skya.html">telephony-skya</a></li>
<li><a href="../package/terminal.html">terminal</a></li>
<li><a href="../package/terminal_pixel.html">terminal_pixel</a></li>
<li><a href="../package/text.html">text</a></li>
<li><a href="../package/ui.html">ui</a></li>
<li><a href="../package/us-infrastructure.html">us-infrastructure</a></li>
<li><a href="../package/user-interface.html">user-interface</a></li>
<li><a href="../package/video.html">video</a></li>
<li><a href="../package/vm.html">vm</a></li>
<li><a href="../package/web-server-technology.html">web-server-technology</a></li>
<li><a href="../package/website.html">website</a></li>
<li><a href="../package/wifi.html">wifi</a></li>
<li><a href="../package/xlt.html">xlt</a></li>
<li><a href="../package/xml.html">xml</a></li>
</ul>
</nav>
<main>
<div class="crumbs"><a href="../index.html">Home</a> › <a href="../packages.html">Packages</a> › operating-system</div>
<h1>Package <code>operating-system</code></h1>
<div class="lead">This package contains <strong>91</strong> source unit(s) defining <strong>102</strong> class(es) / struct(s). Each unit below lists its fields (the values it stores) and methods (the actions it performs), with a plain explanation of each.</div>
<input class="search" placeholder="Filter on this page (Ctrl+F also works)…" oninput="flt(this.value)">
<h2 class="section" data-u="distro-source">distro-source <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/distro-source.sleela)</span></h2>
<div data-u="distro-source source">
<h3 id="Source">Source <span class="pill">class</span></h3>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>hasSubmodules</code></td><td><span class="sig">int hasSubmodules</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>dirFor</code></td><td><span class="sig">String dirFor(String layer)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>referenceSheet</code></td><td><span class="sig">String referenceSheet()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<div data-u="distro-source fetch">
<h3 id="Fetch">Fetch <span class="pill">class</span></h3>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>src</code></td><td><span class="sig">Source src</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>cloneCommand</code></td><td><span class="sig">String cloneCommand(String destDir)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>probe</code></td><td><span class="sig">int probe()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<div data-u="distro-source distrosourcedemo">
<h3 id="DistroSourceDemo">DistroSourceDemo <span class="pill">class</span></h3>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>banner</code></td><td><span class="sig">void banner(String t)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>main</code></td><td><span class="sig">void main()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="linux-creator">linux-creator <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/examples/linux/linux-creator.sleela)</span></h2>
<div data-u="linux-creator model">
<h3 id="Model">Model <span class="pill struct">struct</span></h3>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
</div>
<div data-u="linux-creator linuxcreator">
<h3 id="LinuxCreator">LinuxCreator <span class="pill">class</span></h3>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>linux</code></td><td><span class="sig">Model linux(String name, String version)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>identity</code></td><td><span class="sig">String identity(Model m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>readyToCompile</code></td><td><span class="sig">boolean readyToCompile(Model m)</span></td><td class="desc">---- readiness gate: URLs + settings present before compile ---------</td></tr>
<tr><td><code>packageRepo</code></td><td><span class="sig">String packageRepo(Model m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>kernelSrc</code></td><td><span class="sig">String kernelSrc(Model m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>configHeader</code></td><td><span class="sig">String configHeader(Model m)</span></td><td class="desc">---- emitted artifacts (what the OS Creator writes) -----------------</td></tr>
<tr><td><code>baseDrivers</code></td><td><span class="sig">String baseDrivers(Model m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>downloads</code></td><td><span class="sig">String downloads(Model m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>settings</code></td><td><span class="sig">String settings(Model m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>compat</code></td><td><span class="sig">String compat(Model m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>banner</code></td><td><span class="sig">void banner(String t)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>main</code></td><td><span class="sig">void main()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="machine-build">machine-build <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/machine-build.sleela)</span></h2>
<div data-u="machine-build part">
<h3 id="Part">Part <span class="pill struct">struct</span></h3>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
</div>
<div data-u="machine-build machine">
<h3 id="Machine">Machine <span class="pill struct">struct</span></h3>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>memModules</code></td><td><span class="sig">int memModules</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<div data-u="machine-build machinebuilder">
<h3 id="MachineBuilder">MachineBuilder <span class="pill">class</span></h3>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>intToStr</code></td><td><span class="sig">String intToStr(int v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>part</code></td><td><span class="sig">Part part(String cls, String vendor, String model, String spec, int sizeUnits)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ddr</code></td><td><span class="sig">Part ddr(String vendor, String gen, int capacityMb)</span></td><td class="desc">DDR module: sizeUnits = capacity in MB. spec = generation name.</td></tr>
<tr><td><code>ssd</code></td><td><span class="sig">Part ssd(String vendor, String model, String iface, int capacityGb)</span></td><td class="desc">SSD: sizeUnits = capacity in GB. spec = interface name.</td></tr>
<tr><td><code>hdd</code></td><td><span class="sig">Part hdd(String vendor, String model, int capacityGb)</span></td><td class="desc">HDD: sizeUnits = capacity in GB. spec = "RPM/iface".</td></tr>
<tr><td><code>uefi</code></td><td><span class="sig">Part uefi(String vendor, String product)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>usbController</code></td><td><span class="sig">Part usbController(String vendor, String gen, int ports)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>gpu</code></td><td><span class="sig">Part gpu(String vendor, String model, int vramMb)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>machine</code></td><td><span class="sig">Machine machine(String name)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>totalMemMb</code></td><td><span class="sig">int totalMemMb(Machine m)</span></td><td class="desc">Total installed memory (MB) across modules.</td></tr>
<tr><td><code>memoryWords</code></td><td><span class="sig">int memoryWords(Machine m)</span></td><td class="desc">VM memory words from installed MB at the machine's word width.</td></tr>
<tr><td><code>bootBlocks</code></td><td><span class="sig">int bootBlocks(Machine m)</span></td><td class="desc">VM block count from the boot device's GB capacity at 4096-byte blocks.</td></tr>
<tr><td><code>banner</code></td><td><span class="sig">void banner(String title)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>printPart</code></td><td><span class="sig">void printPart(Machine m, String label, Part p)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>main</code></td><td><span class="sig">void main()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="macos-creator">macos-creator <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/examples/macos/macos-creator.sleela)</span></h2>
<div data-u="macos-creator model">
<h3 id="Model">Model <span class="pill struct">struct</span></h3>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
</div>
<div data-u="macos-creator macoscreator">
<h3 id="MacosCreator">MacosCreator <span class="pill">class</span></h3>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>macos</code></td><td><span class="sig">Model macos(String name, String version)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>identity</code></td><td><span class="sig">String identity(Model m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>readyToCompile</code></td><td><span class="sig">boolean readyToCompile(Model m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>packageRepo</code></td><td><span class="sig">String packageRepo(Model m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>kernelSrc</code></td><td><span class="sig">String kernelSrc(Model m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>configHeader</code></td><td><span class="sig">String configHeader(Model m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>baseDrivers</code></td><td><span class="sig">String baseDrivers(Model m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>downloads</code></td><td><span class="sig">String downloads(Model m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>settings</code></td><td><span class="sig">String settings(Model m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>compat</code></td><td><span class="sig">String compat(Model m)</span></td><td class="desc">macOS has no FS interpreter; it runs Windows (Wine) and Linux (Lima VM) guests; Rosetta 2 translates x86-64 within the macOS world.</td></tr>
<tr><td><code>banner</code></td><td><span class="sig">void banner(String t)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>main</code></td><td><span class="sig">void main()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="os-build">os-build <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/os-build.sleela)</span></h2>
<div data-u="os-build osmodel">
<h3 id="OsModel">OsModel <span class="pill struct">struct</span></h3>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
</div>
<div data-u="os-build osbuilder">
<h3 id="OsBuilder">OsBuilder <span class="pill">class</span></h3>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>intToStr</code></td><td><span class="sig">String intToStr(int v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>shape</code></td><td><span class="sig">OsModel shape(String name, String version, String family)</span></td><td class="desc">OOD extrapolation: fill an OsModel with a shape's defaults, then refine.</td></tr>
<tr><td><code>identity</code></td><td><span class="sig">String identity(OsModel m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>emitConfigHeader</code></td><td><span class="sig">String emitConfigHeader(OsModel m)</span></td><td class="desc">--- C backend: the generated configuration header -------------------</td></tr>
<tr><td><code>emitOsImage</code></td><td><span class="sig">String emitOsImage(OsModel m)</span></td><td class="desc">--- C++ backend: the OsImage that composes the boot chain -----------</td></tr>
<tr><td><code>emitIsoRecipe</code></td><td><span class="sig">String emitIsoRecipe(OsModel m)</span></td><td class="desc">--- ISO backend: the xorriso build recipe ---------------------------</td></tr>
<tr><td><code>emitInstaller</code></td><td><span class="sig">String emitInstaller(OsModel m)</span></td><td class="desc">--- Installer backend: the per-shape installer ----------------------</td></tr>
<tr><td><code>lower</code></td><td><span class="sig">String lower(String shape)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>banner</code></td><td><span class="sig">void banner(String title)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>main</code></td><td><span class="sig">void main()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="os-creator">os-creator <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/os-creator/os-creator.sleela)</span></h2>
<div data-u="os-creator os">
<h3 id="Os">Os <span class="pill struct">struct</span></h3>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
</div>
<div data-u="os-creator oscreatordemo">
<h3 id="OsCreatorDemo">OsCreatorDemo <span class="pill">class</span></h3>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>linux</code></td><td><span class="sig">Os linux(String name, String version)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>identity</code></td><td><span class="sig">String identity(Os o)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>banner</code></td><td><span class="sig">void banner(String t)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>printLayout</code></td><td><span class="sig">void printLayout(Os o)</span></td><td class="desc">The /os-development layout OS Creator(TM) writes.</td></tr>
<tr><td><code>osLoaderC</code></td><td><span class="sig">String osLoaderC(Os o)</span></td><td class="desc">A representative emitted piece: the OS loader (PID 1) C surface.</td></tr>
<tr><td><code>osLoaderCpp</code></td><td><span class="sig">String osLoaderCpp(Os o)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>makefileTarget</code></td><td><span class="sig">String makefileTarget(Os o)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>regenSource</code></td><td><span class="sig">String regenSource(Os o)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>main</code></td><td><span class="sig">void main()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="os-generate">os-generate <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/os-generate.sleela)</span></h2>
<div data-u="os-generate upstream">
<h3 id="Upstream">Upstream <span class="pill">class</span></h3>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>referenceSheet</code></td><td><span class="sig">String referenceSheet()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>fetchScript</code></td><td><span class="sig">String fetchScript()</span></td><td class="desc">The opt-in shallow fetch script written into the tree.</td></tr>
</table>
</div>
<div data-u="os-generate osmodel">
<h3 id="OsModel">OsModel <span class="pill struct">struct</span></h3>
<p class="muted">No public fields or methods detected (the unit may be a facade or a pure contract).</p>
</div>
<div data-u="os-generate osgenerator">
<h3 id="OsGenerator">OsGenerator <span class="pill">class</span></h3>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>root</code></td><td><span class="sig">String root</span></td><td class="desc">output root</td></tr>
<tr><td><code>manifest</code></td><td><span class="sig">String manifest</span></td><td class="desc">"bytes path" index</td></tr>
<tr><td><code>fileCount</code></td><td><span class="sig">int fileCount</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>upstream</code></td><td><span class="sig">Upstream upstream</span></td><td class="desc">field dispatch (1.11)</td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String outputRoot)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>makeDir</code></td><td><span class="sig">int makeDir(String rel)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>writeFile</code></td><td><span class="sig">int writeFile(String rel, String contents)</span></td><td class="desc">Write one file relative to root; records bytes in the manifest.</td></tr>
<tr><td><code>identity</code></td><td><span class="sig">String identity(OsModel m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>linux</code></td><td><span class="sig">OsModel linux(String name, String version, String arch, String kernelVer)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>resolveKernel</code></td><td><span class="sig">String resolveKernel(String sel)</span></td><td class="desc">Resolve a requested Linux kernel selection to a concrete version (compact mirror of SLKernelCatalog.resolveLinux). "" / "default" -> the LTS default.</td></tr>
<tr><td><code>execTranslateHeader</code></td><td><span class="sig">String execTranslateHeader(OsModel m)</span></td><td class="desc">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.</td></tr>
<tr><td><code>compatLoaderC</code></td><td><span class="sig">String compatLoaderC(OsModel m)</span></td><td class="desc">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).</td></tr>
<tr><td><code>compatConf</code></td><td><span class="sig">String compatConf(OsModel m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>baseDriversTableC</code></td><td><span class="sig">String baseDriversTableC(OsModel m)</span></td><td class="desc">The minimum-boot base-driver series table for the Linux shape, plugging into os/base_drivers.h. Compact mirror of SLBaseDriverEmitter for Linux.</td></tr>
<tr><td><code>downloadsConf</code></td><td><span class="sig">String downloadsConf(OsModel m)</span></td><td class="desc">The resolved download URLs for the Linux build, by phase (compile|iso). Mirror of SLDownloadSet.downloadManifest for the Linux shape.</td></tr>
<tr><td><code>supportUrlsConf</code></td><td><span class="sig">String supportUrlsConf(OsModel m)</span></td><td class="desc">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.</td></tr>
<tr><td><code>fetchResilientSh</code></td><td><span class="sig">String fetchResilientSh(OsModel m)</span></td><td class="desc">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).</td></tr>
<tr><td><code>fetchDownloadsSh</code></td><td><span class="sig">String fetchDownloadsSh(OsModel m)</span></td><td class="desc">The opt-in fetch script for the related downloads (compile-phase sources).</td></tr>
<tr><td><code>osConf</code></td><td><span class="sig">String osConf(OsModel m)</span></td><td class="desc">The global settings header + the kernel command line settings file.</td></tr>
<tr><td><code>cmdlineConf</code></td><td><span class="sig">String cmdlineConf(OsModel m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>baseDriversConf</code></td><td><span class="sig">String baseDriversConf(OsModel m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>swapConf</code></td><td><span class="sig">String swapConf(OsModel m)</span></td><td class="desc">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).</td></tr>
<tr><td><code>filesystemsConf</code></td><td><span class="sig">String filesystemsConf(OsModel m)</span></td><td class="desc">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.</td></tr>
<tr><td><code>execTypesHeader</code></td><td><span class="sig">String execTypesHeader(OsModel m)</span></td><td class="desc">The executable file-type table for Linux (compact mirror of SLExecutableTypes.emitExecTypesHeader for the Linux shape).</td></tr>
<tr><td><code>configHeader</code></td><td><span class="sig">String configHeader(OsModel m)</span></td><td class="desc">---- the emitted Linux-level sources --------------------------------</td></tr>
<tr><td><code>bootUnit</code></td><td><span class="sig">String bootUnit(OsModel m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>osImage</code></td><td><span class="sig">String osImage(OsModel m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>osLoaderC</code></td><td><span class="sig">String osLoaderC(OsModel m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isoRecipe</code></td><td><span class="sig">String isoRecipe(OsModel m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>makefile</code></td><td><span class="sig">String makefile(OsModel m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>buildSh</code></td><td><span class="sig">String buildSh(OsModel m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>generate</code></td><td><span class="sig">void generate(OsModel m)</span></td><td class="desc">---- materialise the whole tree -------------------------------------</td></tr>
<tr><td><code>param</code></td><td><span class="sig">String param(String envName, String fallback)</span></td><td class="desc">Read a build parameter from the environment, or fall back to a default.</td></tr>
<tr><td><code>main</code></td><td><span class="sig">void main()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="os-sensitivity-fetch">os-sensitivity-fetch <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/os-sensitivity-fetch.sleela)</span></h2>
<div data-u="os-sensitivity-fetch ossensitivityfetch">
<h3 id="OsSensitivityFetch">OsSensitivityFetch <span class="pill">class</span></h3>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>param</code></td><td><span class="sig">String param(String name, String fallback)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>main</code></td><td><span class="sig">void main()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="os-theme-demo">os-theme-demo <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/os-theme-demo.sleela)</span></h2>
<div data-u="os-theme-demo osthemedemo">
<h3 id="OsThemeDemo">OsThemeDemo <span class="pill">class</span></h3>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>printTheme</code></td><td><span class="sig">void printTheme(SLDesktopTheme t)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>main</code></td><td><span class="sig">void main()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slarchitectureset">SLArchitectureSet <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLArchitectureSet.sleela)</span></h2>
<div data-u="slarchitectureset slarchitectureset">
<h3 id="SLArchitectureSet">SLArchitectureSet <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>primary</code></td><td><span class="sig">SLOSArchitecture primary</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>targets</code></td><td><span class="sig">String targets</span></td><td class="desc">newline-separated package-arch labels</td></tr>
<tr><td><code>count</code></td><td><span class="sig">int count</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>configured</code></td><td><span class="sig">int configured</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(SLOSArchitecture primaryArch)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>configureLabel</code></td><td><span class="sig">void configureLabel(String arch)</span></td><td class="desc">Convenience: configure directly from a package-arch label.</td></tr>
<tr><td><code>addTarget</code></td><td><span class="sig">void addTarget(String arch)</span></td><td class="desc">Add another target architecture by label.</td></tr>
<tr><td><code>primaryArch</code></td><td><span class="sig">SLOSArchitecture primaryArch()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>targetManifest</code></td><td><span class="sig">String targetManifest()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>targetCount</code></td><td><span class="sig">int targetCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isMultiArch</code></td><td><span class="sig">boolean isMultiArch()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slbasedriveremitter">SLBaseDriverEmitter <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/os-creator/SLBaseDriverEmitter.sleela)</span></h2>
<div data-u="slbasedriveremitter slbasedriveremitter">
<h3 id="SLBaseDriverEmitter">SLBaseDriverEmitter <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>emit</code></td><td><span class="sig">SLOSPiece emit(SLOSModel m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>row</code></td><td><span class="sig">String row(String cls, String name, boolean boot)</span></td><td class="desc">A C row with the series' default (boot-origin in-tree) phase derived from canBoot for the bus; the rest use rowPhase.</td></tr>
<tr><td><code>rowPhase</code></td><td><span class="sig">String rowPhase(String cls, String name, String phase)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>cppRow</code></td><td><span class="sig">String cppRow(String cls, String name, String phase)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>cEscape</code></td><td><span class="sig">String cEscape(String s)</span></td><td class="desc">Driver names here contain no quotes/backslashes, but keep the escape honest.</td></tr>
<tr><td><code>unknownAllowed</code></td><td><span class="sig">boolean unknownAllowed(SLDriverSource pol)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>foreignAllowed</code></td><td><span class="sig">boolean foreignAllowed(SLDriverSource pol)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>boolLit</code></td><td><span class="sig">String boolLit(boolean b)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slbasedriverseries">SLBaseDriverSeries <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLBaseDriverSeries.sleela)</span></h2>
<div data-u="slbasedriverseries slbasedriverseries">
<h3 id="SLBaseDriverSeries">SLBaseDriverSeries <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>configured</code></td><td><span class="sig">int configured</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>forShape</code></td><td><span class="sig">void forShape(SLOSShape shape)</span></td><td class="desc">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.</td></tr>
<tr><td><code>setBus</code></td><td><span class="sig">void setBus(String n, boolean boot)</span></td><td class="desc">---- Setters -------------------------------------------------------</td></tr>
<tr><td><code>setStorage</code></td><td><span class="sig">void setStorage(String n, boolean boot)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setKeyboard</code></td><td><span class="sig">void setKeyboard(String n, boolean boot)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setMouse</code></td><td><span class="sig">void setMouse(String n, boolean boot)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setDisplay</code></td><td><span class="sig">void setDisplay(String n, boolean boot)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setUsb</code></td><td><span class="sig">void setUsb(String n, boolean boot)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setAudio</code></td><td><span class="sig">void setAudio(String n, boolean boot)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>b</code></td><td><span class="sig">int b(boolean x)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>canBoot</code></td><td><span class="sig">boolean canBoot()</span></td><td class="desc">---- 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.</td></tr>
<tr><td><code>bootRequiredCount</code></td><td><span class="sig">int bootRequiredCount()</span></td><td class="desc">Count of boot-required drivers present.</td></tr>
<tr><td><code>seriesManifest</code></td><td><span class="sig">String seriesManifest()</span></td><td class="desc">---- Manifest ------------------------------------------------------ Newline "class name boot" lines (boot = boot|early) for the emitters.</td></tr>
<tr><td><code>line</code></td><td><span class="sig">String line(String acc, String cls, String name, int boot)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>bus</code></td><td><span class="sig">String bus()</span></td><td class="desc">Accessors for the emitters.</td></tr>
<tr><td><code>storage</code></td><td><span class="sig">String storage()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>keyboard</code></td><td><span class="sig">String keyboard()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>mouse</code></td><td><span class="sig">String mouse()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>display</code></td><td><span class="sig">String display()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>usb</code></td><td><span class="sig">String usb()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>audio</code></td><td><span class="sig">String audio()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slbiosemitter">SLBIOSEmitter <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/os-creator/SLBIOSEmitter.sleela)</span></h2>
<div data-u="slbiosemitter slbiosemitter">
<h3 id="SLBIOSEmitter">SLBIOSEmitter <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>emit</code></td><td><span class="sig">SLOSPiece emit(SLOSModel m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>boolLit</code></td><td><span class="sig">String boolLit(boolean b)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slbootloaderemitter">SLBootLoaderEmitter <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/os-creator/SLBootLoaderEmitter.sleela)</span></h2>
<div data-u="slbootloaderemitter slbootloaderemitter">
<h3 id="SLBootLoaderEmitter">SLBootLoaderEmitter <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>emit</code></td><td><span class="sig">SLOSPiece emit(SLOSModel m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>loaderMenu</code></td><td><span class="sig">String loaderMenu(String loader, SLOSModel m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slbootloaderspec">SLBootloaderSpec <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLBootloaderSpec.sleela)</span></h2>
<div data-u="slbootloaderspec slbootloaderspec">
<h3 id="SLBootloaderSpec">SLBootloaderSpec <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>firmware</code></td><td><span class="sig">String firmware</span></td><td class="desc">"UEFI" or "BIOS"</td></tr>
<tr><td><code>loader</code></td><td><span class="sig">String loader</span></td><td class="desc">"GRUB" / "BOOTMGR" / "boot.efi" / "systemd-boot"</td></tr>
<tr><td><code>secureBoot</code></td><td><span class="sig">int secureBoot</span></td><td class="desc">1 require Secure Boot</td></tr>
<tr><td><code>useInitramfs</code></td><td><span class="sig">int useInitramfs</span></td><td class="desc">1 stage an initramfs/initrd early userspace</td></tr>
<tr><td><code>espLabel</code></td><td><span class="sig">String espLabel</span></td><td class="desc">EFI System Partition volume label</td></tr>
<tr><td><code>timeout</code></td><td><span class="sig">String timeout</span></td><td class="desc">menu timeout, as a string ("5")</td></tr>
<tr><td><code>configured</code></td><td><span class="sig">int configured</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String fw, String bootLoader)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>forShape</code></td><td><span class="sig">void forShape(SLOSShape shape)</span></td><td class="desc">Default boot style for a shape (UEFI everywhere on modern hardware).</td></tr>
<tr><td><code>requireSecureBoot</code></td><td><span class="sig">void requireSecureBoot(boolean on)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setTimeout</code></td><td><span class="sig">void setTimeout(String seconds)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>menuTimeout</code></td><td><span class="sig">String menuTimeout()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isUefi</code></td><td><span class="sig">boolean isUefi()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>loaderName</code></td><td><span class="sig">String loaderName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>firmwareName</code></td><td><span class="sig">String firmwareName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>stagesInitramfs</code></td><td><span class="sig">boolean stagesInitramfs()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isComplete</code></td><td><span class="sig">boolean isComplete()</span></td><td class="desc">A boot layer is complete when it names a firmware and a loader.</td></tr>
</table>
</div>
<h2 class="section" data-u="slcemitter">SLCEmitter <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLCEmitter.sleela)</span></h2>
<div data-u="slcemitter slcemitter">
<h3 id="SLCEmitter">SLCEmitter <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>intToStr</code></td><td><span class="sig">String intToStr(int v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>emitConfigHeader</code></td><td><span class="sig">String emitConfigHeader(SLOSModel m)</span></td><td class="desc">Emit the generated configuration header for the model.</td></tr>
<tr><td><code>emitBootUnit</code></td><td><span class="sig">String emitBootUnit(SLOSModel m)</span></td><td class="desc">Emit the early-boot C translation unit for the model.</td></tr>
<tr><td><code>emitBuiltinDriverCalls</code></td><td><span class="sig">String emitBuiltinDriverCalls(SLOSModel m)</span></td><td class="desc">Walk the driver manifest and emit a load_driver() call for each built-in.</td></tr>
<tr><td><code>containsBuiltin</code></td><td><span class="sig">boolean containsBuiltin(String line)</span></td><td class="desc">---- Small text helpers (manifest lines are "name binding") -------------</td></tr>
<tr><td><code>driverName</code></td><td><span class="sig">String driverName(String line)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>strLen</code></td><td><span class="sig">int strLen(String s)</span></td><td class="desc">String primitives wrap the shared native text intrinsics (same contract as lib/cpu/SLCompilerDriver): SLeeLa Strings are Java-style, length+substring.</td></tr>
<tr><td><code>substr</code></td><td><span class="sig">String substr(String s, int a, int b)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>charAt</code></td><td><span class="sig">String charAt(String s, int i)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>endsWith</code></td><td><span class="sig">boolean endsWith(String s, String suf)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slclock">SLClock <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLClock.sleela)</span></h2>
<div data-u="slclock slclock">
<h3 id="SLClock">SLClock <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>monoStart</code></td><td><span class="sig">int monoStart</span></td><td class="desc">monotonic reference captured at reset (nanoseconds)</td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>nowMillis</code></td><td><span class="sig">int nowMillis()</span></td><td class="desc">Milliseconds since the Unix epoch (UTC wall-clock).</td></tr>
<tr><td><code>monotonicNanos</code></td><td><span class="sig">int monotonicNanos()</span></td><td class="desc">Monotonic nanoseconds (never goes backward; for durations).</td></tr>
<tr><td><code>httpDate</code></td><td><span class="sig">String httpDate()</span></td><td class="desc">An RFC 1123 HTTP date string for "now".</td></tr>
<tr><td><code>location</code></td><td><span class="sig">String location()</span></td><td class="desc">The host's configured time-zone location.</td></tr>
<tr><td><code>reset</code></td><td><span class="sig">void reset()</span></td><td class="desc">Start a monotonic stopwatch.</td></tr>
<tr><td><code>elapsedNanos</code></td><td><span class="sig">int elapsedNanos()</span></td><td class="desc">Elapsed nanoseconds since reset().</td></tr>
<tr><td><code>elapsedMillis</code></td><td><span class="sig">int elapsedMillis()</span></td><td class="desc">Elapsed whole milliseconds since reset().</td></tr>
</table>
</div>
<h2 class="section" data-u="slcompatlayer">SLCompatLayer <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLCompatLayer.sleela)</span></h2>
<div data-u="slcompatlayer slcompatlayer">
<h3 id="SLCompatLayer">SLCompatLayer <span class="pill">class</span></h3>
<p class="desc">Defines SLCompatLayer — one HOST->GUEST compatibility layer: the</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>host</code></td><td><span class="sig">String host</span></td><td class="desc">the OS doing the running: "Linux"/"Windows"/"macOS"</td></tr>
<tr><td><code>guest</code></td><td><span class="sig">String guest</span></td><td class="desc">the OS whose executables we run: "Linux"/"Windows"/"macOS"</td></tr>
<tr><td><code>loaded</code></td><td><span class="sig">int loaded</span></td><td class="desc">1 once the layer's components are loaded</td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String hostOs, String guestOs)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>normalize</code></td><td><span class="sig">String normalize(String s)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hostName</code></td><td><span class="sig">String hostName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>guestName</code></td><td><span class="sig">String guestName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isNative</code></td><td><span class="sig">boolean isNative()</span></td><td class="desc">Same host and guest need no layer (native execution).</td></tr>
<tr><td><code>runtime</code></td><td><span class="sig">String runtime()</span></td><td class="desc">---- Which components this host->guest layer requires --------------- runtime(): the primary translation runtime/container for this pair.</td></tr>
<tr><td><code>fsInterpreter</code></td><td><span class="sig">String fsInterpreter()</span></td><td class="desc">fsInterpreter(): the filesystem-level interpreter facility, when the host has one (only Linux's binfmt_misc). Empty elsewhere.</td></tr>
<tr><td><code>libraryPackage</code></td><td><span class="sig">String libraryPackage()</span></td><td class="desc">libraryPackage(): the shared-library set the guest's executables link against, which the layer must provide so a library + executable both load.</td></tr>
<tr><td><code>componentManifest</code></td><td><span class="sig">String componentManifest()</span></td><td class="desc">The ordered component manifest: "<name> <kind>" per line. Kinds: interpreter (FS-level), runtime (translation layer), library (guest libs).</td></tr>
<tr><td><code>guestLibToken</code></td><td><span class="sig">String guestLibToken()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>componentCount</code></td><td><span class="sig">int componentCount()</span></td><td class="desc">Number of components this layer loads (interpreter? + runtime + libraries).</td></tr>
<tr><td><code>load</code></td><td><span class="sig">int load(String runtimePath)</span></td><td class="desc">---- 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.</td></tr>
<tr><td><code>unload</code></td><td><span class="sig">int unload()</span></td><td class="desc">unload(): tear the layer down. On Linux unregister the binfmt_misc rule; elsewhere drop the ready flag. Returns 0 ok. Idempotent.</td></tr>
<tr><td><code>isLoaded</code></td><td><span class="sig">boolean isLoaded()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>present</code></td><td><span class="sig">boolean present(String runtimePath)</span></td><td class="desc">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.)</td></tr>
<tr><td><code>handle</code></td><td><span class="sig">String handle(String exePath)</span></td><td class="desc">---- 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.</td></tr>
<tr><td><code>handlePair</code></td><td><span class="sig">String handlePair(String libPath, String exePath)</span></td><td class="desc">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.</td></tr>
<tr><td><code>libEnv</code></td><td><span class="sig">String libEnv(String libDir)</span></td><td class="desc">The environment prefix that adds a guest library dir to the runtime's search path (WINEDLLPATH for Wine, LD_LIBRARY_PATH for ELF, etc.).</td></tr>
<tr><td><code>binfmtName</code></td><td><span class="sig">String binfmtName()</span></td><td class="desc">---- binfmt_misc helpers (Linux FS interpreter) ---------------------</td></tr>
<tr><td><code>binfmtRegister</code></td><td><span class="sig">String binfmtRegister(String interp)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>guestExt</code></td><td><span class="sig">String guestExt()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>summary</code></td><td><span class="sig">String summary()</span></td><td class="desc">---- A human/log summary --------------------------------------------</td></tr>
</table>
</div>
<h2 class="section" data-u="slcompatloaderemitter">SLCompatLoaderEmitter <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/os-creator/SLCompatLoaderEmitter.sleela)</span></h2>
<div data-u="slcompatloaderemitter slcompatloaderemitter">
<h3 id="SLCompatLoaderEmitter">SLCompatLoaderEmitter <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>emit</code></td><td><span class="sig">SLOSPiece emit(SLOSModel m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>emitLoadFn</code></td><td><span class="sig">String emitLoadFn(SLCompatSet cs)</span></td><td class="desc">One load block per supported guest route.</td></tr>
<tr><td><code>loadLine</code></td><td><span class="sig">String loadLine(SLCompatSet cs, String guest)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>emitUnloadFn</code></td><td><span class="sig">String emitUnloadFn(SLCompatSet cs)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>unloadLine</code></td><td><span class="sig">String unloadLine(SLCompatSet cs, String guest)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>emitHandleFn</code></td><td><span class="sig">String emitHandleFn()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>routeInits</code></td><td><span class="sig">String routeInits(SLCompatSet cs)</span></td><td class="desc">C++ route initialisers, one brace-init per supported guest.</td></tr>
<tr><td><code>addRoute</code></td><td><span class="sig">String addRoute(String acc, SLCompatSet cs, String guest)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>routeConf</code></td><td><span class="sig">String routeConf(SLCompatSet cs, String guest)</span></td><td class="desc">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).</td></tr>
</table>
</div>
<h2 class="section" data-u="slcompatset">SLCompatSet <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLCompatSet.sleela)</span></h2>
<div data-u="slcompatset slcompatset">
<h3 id="SLCompatSet">SLCompatSet <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>host</code></td><td><span class="sig">String host</span></td><td class="desc">the built OS's own family</td></tr>
<tr><td><code>linuxGuest</code></td><td><span class="sig">SLCompatLayer linuxGuest</span></td><td class="desc">Up to three guest layers (Linux/Windows/macOS). Fixed slots keep the model array-free; an unused slot has an empty guest.</td></tr>
<tr><td><code>windowsGuest</code></td><td><span class="sig">SLCompatLayer windowsGuest</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>macGuest</code></td><td><span class="sig">SLCompatLayer macGuest</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hasLinux</code></td><td><span class="sig">int hasLinux</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hasWindows</code></td><td><span class="sig">int hasWindows</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hasMac</code></td><td><span class="sig">int hasMac</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>configured</code></td><td><span class="sig">int configured</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String hostFamily)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>norm</code></td><td><span class="sig">String norm(String s)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>forShape</code></td><td><span class="sig">void forShape(SLOSShape shape)</span></td><td class="desc">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.</td></tr>
<tr><td><code>support</code></td><td><span class="sig">void support(String guestFamily)</span></td><td class="desc">Add support for running a guest family's executables on this OS.</td></tr>
<tr><td><code>drop</code></td><td><span class="sig">void drop(String guestFamily)</span></td><td class="desc">Remove a previously added guest.</td></tr>
<tr><td><code>supports</code></td><td><span class="sig">boolean supports(String guestFamily)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>layerFor</code></td><td><span class="sig">SLCompatLayer layerFor(String guestFamily)</span></td><td class="desc">The layer object for a guest family (null if not supported). Lets a caller load/unload/handle through it.</td></tr>
<tr><td><code>guestCount</code></td><td><span class="sig">int guestCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hasAny</code></td><td><span class="sig">boolean hasAny()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hostName</code></td><td><span class="sig">String hostName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>compatManifest</code></td><td><span class="sig">String compatManifest()</span></td><td class="desc">A newline manifest "<host> runs <guest> via <runtime>" per supported guest, for the generated config and for logs.</td></tr>
<tr><td><code>add</code></td><td><span class="sig">String add(String acc, String line)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slconfigset">SLConfigSet <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLConfigSet.sleela)</span></h2>
<div data-u="slconfigset slconfigset">
<h3 id="SLConfigSet">SLConfigSet <span class="pill">class</span></h3>
<p class="desc">Defines SLConfigSet — the assorted and specific CONFIGURATION</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>PHASE_COMPILE</code></td><td><span class="sig">static final int PHASE_COMPILE = 0</span></td><td class="desc">Phase: when the config file must be present.</td></tr>
<tr><td><code>PHASE_ISO</code></td><td><span class="sig">static final int PHASE_ISO = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wantOsConf</code></td><td><span class="sig">int wantOsConf</span></td><td class="desc">Well-known settings files: 1 if required, with their path/format fixed. config/os.conf (global settings) compile</td></tr>
<tr><td><code>wantSwap</code></td><td><span class="sig">int wantSwap</span></td><td class="desc">config/swap.conf (paging) iso</td></tr>
<tr><td><code>wantFilesystems</code></td><td><span class="sig">int wantFilesystems</span></td><td class="desc">config/filesystems.txt(file-table choices) compile</td></tr>
<tr><td><code>wantBaseDrivers</code></td><td><span class="sig">int wantBaseDrivers</span></td><td class="desc">kernel/base-drivers/base-drivers.conf compile</td></tr>
<tr><td><code>wantServices</code></td><td><span class="sig">int wantServices</span></td><td class="desc">userspace/os-loader/services.conf iso</td></tr>
<tr><td><code>wantCompat</code></td><td><span class="sig">int wantCompat</span></td><td class="desc">userspace/compat-loader/compat.conf iso</td></tr>
<tr><td><code>wantCmdline</code></td><td><span class="sig">int wantCmdline</span></td><td class="desc">config/cmdline.conf (kernel command line) compile</td></tr>
<tr><td><code>wantDownloads</code></td><td><span class="sig">int wantDownloads</span></td><td class="desc">config/downloads.conf (resolved URLs) compile</td></tr>
<tr><td><code>configured</code></td><td><span class="sig">int configured</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>forModel</code></td><td><span class="sig">void forModel(boolean hasCompat)</span></td><td class="desc">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.</td></tr>
<tr><td><code>addExtra</code></td><td><span class="sig">int addExtra(String path, String format, int phase)</span></td><td class="desc">Add a developer config file: target path, format ("conf"/"ini"/"json"/ "yaml"/"xml"/"text"), and the phase it is needed. Up to four.</td></tr>
<tr><td><code>configManifest</code></td><td><span class="sig">String configManifest()</span></td><td class="desc">---- The checklist -------------------------------------------------- A newline manifest "<path> <format> <phase> required|optional" of every settings file the build expects.</td></tr>
<tr><td><code>row</code></td><td><span class="sig">String row(String acc, String path, String fmt, String phase, int want)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>rowExtra</code></td><td><span class="sig">String rowExtra(String acc, String rec)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>compilePhaseCount</code></td><td><span class="sig">int compilePhaseCount()</span></td><td class="desc">Count of required compile-phase / iso-phase settings files.</td></tr>
<tr><td><code>isoPhaseCount</code></td><td><span class="sig">int isoPhaseCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>readyForCompile</code></td><td><span class="sig">boolean readyForCompile()</span></td><td class="desc">---- 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.</td></tr>
<tr><td><code>readyForIso</code></td><td><span class="sig">boolean readyForIso()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>compileFilesPresent</code></td><td><span class="sig">int compileFilesPresent(String root)</span></td><td class="desc">---- 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).</td></tr>
<tr><td><code>emitOsConf</code></td><td><span class="sig">String emitOsConf(String osName, String osVersion, String shape, String arch)</span></td><td class="desc">---- 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.</td></tr>
</table>
</div>
<h2 class="section" data-u="slcppemitter">SLCppEmitter <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLCppEmitter.sleela)</span></h2>
<div data-u="slcppemitter slcppemitter">
<h3 id="SLCppEmitter">SLCppEmitter <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>intToStr</code></td><td><span class="sig">String intToStr(int v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>emitOsImage</code></td><td><span class="sig">String emitOsImage(SLOSModel m)</span></td><td class="desc">Emit the OsImage C++ translation unit for the model.</td></tr>
<tr><td><code>emitServiceVector</code></td><td><span class="sig">String emitServiceVector(SLOSModel m)</span></td><td class="desc">Emit the service vector initialiser from the model's unit manifest.</td></tr>
<tr><td><code>firstToken</code></td><td><span class="sig">String firstToken(String line)</span></td><td class="desc">The token before the first space on a "name mode" line.</td></tr>
<tr><td><code>strLen</code></td><td><span class="sig">int strLen(String s)</span></td><td class="desc">String primitives wrap the shared native text intrinsics.</td></tr>
<tr><td><code>substr</code></td><td><span class="sig">String substr(String s, int a, int b)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>charAt</code></td><td><span class="sig">String charAt(String s, int i)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slddrcatalog">SLDDRCatalog <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/memory-ddr/SLDDRCatalog.sleela)</span></h2>
<div data-u="slddrcatalog slddrcatalog">
<h3 id="SLDDRCatalog">SLDDRCatalog <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ddr5</code></td><td><span class="sig">SLDDRModule ddr5(String manufacturer, int capacityMb)</span></td><td class="desc">Return a DDR5 module from a named manufacturer at a given capacity (MB).</td></tr>
<tr><td><code>ddr4</code></td><td><span class="sig">SLDDRModule ddr4(String manufacturer, int capacityMb)</span></td><td class="desc">Return a DDR4 module from a named manufacturer at a given capacity (MB).</td></tr>
<tr><td><code>module</code></td><td><span class="sig">SLDDRModule module(String manufacturer, String genName, int capacityMb, boolean ecc)</span></td><td class="desc">Build a module of any generation by name from any manufacturer.</td></tr>
<tr><td><code>known</code></td><td><span class="sig">boolean known(String manufacturer)</span></td><td class="desc">Is this one of the recognised DRAM manufacturers?</td></tr>
<tr><td><code>ddr5Part</code></td><td><span class="sig">String ddr5Part(String mfr)</span></td><td class="desc">---- Representative part numbers per manufacturer ----------------------</td></tr>
<tr><td><code>ddr4Part</code></td><td><span class="sig">String ddr4Part(String mfr)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>genPart</code></td><td><span class="sig">String genPart(String mfr, String genName)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slddrmodule">SLDDRModule <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/memory-ddr/SLDDRModule.sleela)</span></h2>
<div data-u="slddrmodule slddrmodule">
<h3 id="SLDDRModule">SLDDRModule <span class="pill">class</span> <span class="muted">extends <code>SLHardwareComponent</code></span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>GEN_DDR</code></td><td><span class="sig">static final int GEN_DDR = 1</span></td><td class="desc">Generation ordinals.</td></tr>
<tr><td><code>GEN_DDR2</code></td><td><span class="sig">static final int GEN_DDR2 = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>GEN_DDR3</code></td><td><span class="sig">static final int GEN_DDR3 = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>GEN_DDR4</code></td><td><span class="sig">static final int GEN_DDR4 = 4</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>GEN_DDR5</code></td><td><span class="sig">static final int GEN_DDR5 = 5</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>generation</code></td><td><span class="sig">int generation</span></td><td class="desc">GEN_*</td></tr>
<tr><td><code>standard</code></td><td><span class="sig">String standard</span></td><td class="desc">JEDEC module standard, e.g. "PC5-44800"</td></tr>
<tr><td><code>dataRateMtps</code></td><td><span class="sig">int dataRateMtps</span></td><td class="desc">transfer rate in MT/s</td></tr>
<tr><td><code>voltageMv</code></td><td><span class="sig">int voltageMv</span></td><td class="desc">supply voltage in millivolts</td></tr>
<tr><td><code>busWidthBits</code></td><td><span class="sig">int busWidthBits</span></td><td class="desc">data bus width (64 non-ECC, 72 ECC)</td></tr>
<tr><td><code>capacityMb</code></td><td><span class="sig">int capacityMb</span></td><td class="desc">module capacity in megabytes</td></tr>
<tr><td><code>eccSupported</code></td><td><span class="sig">int eccSupported</span></td><td class="desc">1 if the module carries ECC</td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String manufacturer, String part, int gen)</span></td><td class="desc">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()).</td></tr>
<tr><td><code>configureByName</code></td><td><span class="sig">void configureByName(String manufacturer, String part, String genName)</span></td><td class="desc">Convenience: configure by generation name ("DDR".."DDR5").</td></tr>
<tr><td><code>sized</code></td><td><span class="sig">void sized(int megabytes, boolean ecc)</span></td><td class="desc">Refine capacity (MB) and bus width; ECC uses a 72-bit bus.</td></tr>
<tr><td><code>setDataRate</code></td><td><span class="sig">void setDataRate(int mtps)</span></td><td class="desc">Override the data rate for an overclock/XMP/EXPO profile.</td></tr>
<tr><td><code>generationOrdinal</code></td><td><span class="sig">int generationOrdinal()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>generationName</code></td><td><span class="sig">String generationName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>moduleStandard</code></td><td><span class="sig">String moduleStandard()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>dataRate</code></td><td><span class="sig">int dataRate()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>voltageMillivolts</code></td><td><span class="sig">int voltageMillivolts()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>busWidth</code></td><td><span class="sig">int busWidth()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>capacityMegabytes</code></td><td><span class="sig">int capacityMegabytes()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hasEcc</code></td><td><span class="sig">boolean hasEcc()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>peakBandwidthMBps</code></td><td><span class="sig">int peakBandwidthMBps()</span></td><td class="desc">Peak transfer bandwidth in MB/s: data rate * (bus width in bytes).</td></tr>
<tr><td><code>wordsForWidth</code></td><td><span class="sig">int wordsForWidth(int wordBits)</span></td><td class="desc">The number of VM memory words this module backs, given a word width in bits — the figure SLMachineModel hands to SLRAM.</td></tr>
</table>
</div>
<h2 class="section" data-u="sldesktoploaderemitter">SLDesktopLoaderEmitter <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/os-creator/SLDesktopLoaderEmitter.sleela)</span></h2>
<div data-u="sldesktoploaderemitter sldesktoploaderemitter">
<h3 id="SLDesktopLoaderEmitter">SLDesktopLoaderEmitter <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>emit</code></td><td><span class="sig">SLOSPiece emit(SLOSModel m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="sldesktopspec">SLDesktopSpec <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLDesktopSpec.sleela)</span></h2>
<div data-u="sldesktopspec sldesktopspec">
<h3 id="SLDesktopSpec">SLDesktopSpec <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>enabled</code></td><td><span class="sig">int enabled</span></td><td class="desc">1 if the OS has a desktop at all (0 = server/headless)</td></tr>
<tr><td><code>displayServer</code></td><td><span class="sig">String displayServer</span></td><td class="desc">"Wayland" / "DWM" / "WindowServer"</td></tr>
<tr><td><code>sessionShell</code></td><td><span class="sig">String sessionShell</span></td><td class="desc">"GNOME Shell" / "Explorer" / "Aqua"</td></tr>
<tr><td><code>toolkit</code></td><td><span class="sig">String toolkit</span></td><td class="desc">"GTK" / "Win32/WinUI" / "AppKit"</td></tr>
<tr><td><code>displayManager</code></td><td><span class="sig">String displayManager</span></td><td class="desc">login/greeter</td></tr>
<tr><td><code>appearance</code></td><td><span class="sig">SLDesktopTheme appearance</span></td><td class="desc">the desktop appearance/theme (null on a headless edition)</td></tr>
<tr><td><code>configured</code></td><td><span class="sig">int configured</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>headless</code></td><td><span class="sig">void headless()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String server, String shell, String kit, String greeter)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>forShape</code></td><td><span class="sig">void forShape(SLOSShape shape)</span></td><td class="desc">Seed the native desktop stack for a shape, including its default theme.</td></tr>
<tr><td><code>applyTheme</code></td><td><span class="sig">void applyTheme(SLDesktopTheme t)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>theme</code></td><td><span class="sig">SLDesktopTheme theme()</span></td><td class="desc">The desktop theme, or null when headless / not yet seeded.</td></tr>
<tr><td><code>hasTheme</code></td><td><span class="sig">boolean hasTheme()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>useAlternate</code></td><td><span class="sig">void useAlternate(String shell, String kit)</span></td><td class="desc">Swap the Linux desktop for an alternate (the desktop is replaceable).</td></tr>
<tr><td><code>hasDesktop</code></td><td><span class="sig">boolean hasDesktop()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>server</code></td><td><span class="sig">String server()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>shell</code></td><td><span class="sig">String shell()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>widgetToolkit</code></td><td><span class="sig">String widgetToolkit()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>greeter</code></td><td><span class="sig">String greeter()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="sldesktoptheme">SLDesktopTheme <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLDesktopTheme.sleela)</span></h2>
<div data-u="sldesktoptheme sldesktoptheme">
<h3 id="SLDesktopTheme">SLDesktopTheme <span class="pill">class</span></h3>
<p class="desc">Defines SLDesktopTheme — the appearance a constructed OS's</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>id</code></td><td><span class="sig">String id</span></td><td class="desc">theme identity</td></tr>
<tr><td><code>label</code></td><td><span class="sig">String label</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>background</code></td><td><span class="sig">String background</span></td><td class="desc">role colors (shared vocabulary with the editor palettes + SleelaUI accent)</td></tr>
<tr><td><code>foreground</code></td><td><span class="sig">String foreground</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>accent</code></td><td><span class="sig">String accent</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>gtkTheme</code></td><td><span class="sig">String gtkTheme</span></td><td class="desc">desktop asset identifiers (bytes come from the desktop-loader warehouse)</td></tr>
<tr><td><code>iconSet</code></td><td><span class="sig">String iconSet</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>cursor</code></td><td><span class="sig">String cursor</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wallpaper</code></td><td><span class="sig">String wallpaper</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>configured</code></td><td><span class="sig">int configured</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String themeId, String themeLabel,</span></td><td class="desc">Full configuration.</td></tr>
<tr><td><code>slickBlack</code></td><td><span class="sig">void slickBlack()</span></td><td class="desc">---- Presets (mirror os/sleela_os_theme.c) --------------------------- The SleelaUI-aligned matte-dark default.</td></tr>
<tr><td><code>white</code></td><td><span class="sig">void white()</span></td><td class="desc">The White Edition look, aligned with ubuntu-white (Ubuntu-orange accent).</td></tr>
<tr><td><code>linuxDefault</code></td><td><span class="sig">void linuxDefault()</span></td><td class="desc">Per-shape native defaults.</td></tr>
<tr><td><code>windowsDefault</code></td><td><span class="sig">void windowsDefault()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>macosDefault</code></td><td><span class="sig">void macosDefault()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>forShape</code></td><td><span class="sig">void forShape(SLOSShape shape)</span></td><td class="desc">Seed the native-default theme for a shape (mirrors the other forShape seeds).</td></tr>
<tr><td><code>select</code></td><td><span class="sig">void select(String themeId)</span></td><td class="desc">Choose a theme by id; unknown ids fall back to the Linux default.</td></tr>
<tr><td><code>themeId</code></td><td><span class="sig">String themeId()</span></td><td class="desc">---- Accessors -------------------------------------------------------</td></tr>
<tr><td><code>name</code></td><td><span class="sig">String name()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>bg</code></td><td><span class="sig">String bg()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>fg</code></td><td><span class="sig">String fg()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>accentColor</code></td><td><span class="sig">String accentColor()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>gtk</code></td><td><span class="sig">String gtk()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>icons</code></td><td><span class="sig">String icons()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>cursorTheme</code></td><td><span class="sig">String cursorTheme()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wallpaperId</code></td><td><span class="sig">String wallpaperId()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>assetComponent</code></td><td><span class="sig">String assetComponent()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>appearanceSheet</code></td><td><span class="sig">String appearanceSheet()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="sldirectory">SLDirectory <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLDirectory.sleela)</span></h2>
<div data-u="sldirectory sldirectory">
<h3 id="SLDirectory">SLDirectory <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>path</code></td><td><span class="sig">String path</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String p)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>name</code></td><td><span class="sig">String name()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>exists</code></td><td><span class="sig">boolean exists()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>create</code></td><td><span class="sig">boolean create()</span></td><td class="desc">Create this directory (succeeds if it already exists).</td></tr>
<tr><td><code>remove</code></td><td><span class="sig">boolean remove()</span></td><td class="desc">Remove this directory (must be empty on POSIX/Windows).</td></tr>
<tr><td><code>renameTo</code></td><td><span class="sig">boolean renameTo(String newPath)</span></td><td class="desc">Rename/move; on success the handle tracks the new path.</td></tr>
<tr><td><code>enter</code></td><td><span class="sig">boolean enter()</span></td><td class="desc">Make this directory the process' current working directory.</td></tr>
<tr><td><code>current</code></td><td><span class="sig">String current()</span></td><td class="desc">The process' current working directory (static-style convenience).</td></tr>
<tr><td><code>temp</code></td><td><span class="sig">String temp()</span></td><td class="desc">The system temporary directory.</td></tr>
</table>
</div>
<h2 class="section" data-u="sldistrofetch">SLDistroFetch <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLDistroFetch.sleela)</span></h2>
<div data-u="sldistrofetch sldistrofetch">
<h3 id="SLDistroFetch">SLDistroFetch <span class="pill">class</span></h3>
<p class="desc">Defines SLDistroFetch — the OPT-IN downloader that materialises</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>MODE_SHALLOW</code></td><td><span class="sig">static final int MODE_SHALLOW = 0</span></td><td class="desc">Fetch depth/mode tags. --depth 1 --single-branch (default)</td></tr>
<tr><td><code>MODE_FULL</code></td><td><span class="sig">static final int MODE_FULL = 1</span></td><td class="desc">full history</td></tr>
<tr><td><code>MODE_RECURSE</code></td><td><span class="sig">static final int MODE_RECURSE = 2</span></td><td class="desc">full + --recurse-submodules</td></tr>
<tr><td><code>src</code></td><td><span class="sig">SLDistroSource src</span></td><td class="desc">the reference (field; wired by configure())</td></tr>
<tr><td><code>mode</code></td><td><span class="sig">int mode</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>lastExit</code></td><td><span class="sig">int lastExit</span></td><td class="desc">exit code of the most recent fetch (-1 if none run)</td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>useSource</code></td><td><span class="sig">void useSource(SLDistroSource source)</span></td><td class="desc">Point at a specific reference instead of the default.</td></tr>
<tr><td><code>setMode</code></td><td><span class="sig">void setMode(int m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>source</code></td><td><span class="sig">SLDistroSource source()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>cloneCommand</code></td><td><span class="sig">String cloneCommand(String destDir)</span></td><td class="desc">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).</td></tr>
<tr><td><code>pinCommand</code></td><td><span class="sig">String pinCommand(String destDir)</span></td><td class="desc">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.</td></tr>
<tr><td><code>fetch</code></td><td><span class="sig">int fetch(String destRoot, boolean force)</span></td><td class="desc">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.</td></tr>
<tr><td><code>fetchShallow</code></td><td><span class="sig">int fetchShallow(String destRoot)</span></td><td class="desc">Convenience: shallow fetch (the safe default for the large distro).</td></tr>
<tr><td><code>fetchComplete</code></td><td><span class="sig">int fetchComplete(String destRoot)</span></td><td class="desc">Convenience: full fetch with submodules (a complete working tree).</td></tr>
<tr><td><code>lastExitCode</code></td><td><span class="sig">int lastExitCode()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>succeeded</code></td><td><span class="sig">boolean succeeded()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>probe</code></td><td><span class="sig">int probe()</span></td><td class="desc">Verify the upstream is reachable without downloading it (git ls-remote). Returns 0 when the branch is resolvable. Cheap pre-flight for a GUI.</td></tr>
</table>
</div>
<h2 class="section" data-u="sldistrosource">SLDistroSource <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLDistroSource.sleela)</span></h2>
<div data-u="sldistrosource sldistrosource">
<h3 id="SLDistroSource">SLDistroSource <span class="pill">class</span></h3>
<p class="desc">Defines SLDistroSource — the zero-payload REFERENCE to the</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>name</code></td><td><span class="sig">String name</span></td><td class="desc">Upstream identity.</td></tr>
<tr><td><code>owner</code></td><td><span class="sig">String owner</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>repo</code></td><td><span class="sig">String repo</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>url</code></td><td><span class="sig">String url</span></td><td class="desc">https clone URL</td></tr>
<tr><td><code>branch</code></td><td><span class="sig">String branch</span></td><td class="desc">default branch</td></tr>
<tr><td><code>pinnedCommit</code></td><td><span class="sig">String pinnedCommit</span></td><td class="desc">exact revision for reproducible fetches</td></tr>
<tr><td><code>hasSubmodules</code></td><td><span class="sig">int hasSubmodules</span></td><td class="desc">1 if the distro uses git submodules (needs --recurse)</td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc">Configure with the known Ubuntu.Determinant distro reference. The pinned commit is the current main tip; callers may repin with pin(commit).</td></tr>
<tr><td><code>pin</code></td><td><span class="sig">void pin(String commit)</span></td><td class="desc">Repin to a specific revision (keeps fetches reproducible).</td></tr>
<tr><td><code>identity</code></td><td><span class="sig">String identity()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>cloneUrl</code></td><td><span class="sig">String cloneUrl()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>defaultBranch</code></td><td><span class="sig">String defaultBranch()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>commit</code></td><td><span class="sig">String commit()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>usesSubmodules</code></td><td><span class="sig">boolean usesSubmodules()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>shortCommit</code></td><td><span class="sig">String shortCommit()</span></td><td class="desc">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().</td></tr>
<tr><td><code>dirFor</code></td><td><span class="sig">String dirFor(String layer)</span></td><td class="desc">---- 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).</td></tr>
<tr><td><code>providesLayer</code></td><td><span class="sig">boolean providesLayer(String layer)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>downloadabilityNote</code></td><td><span class="sig">String downloadabilityNote(String part)</span></td><td class="desc">downloadabilityNote(part): per-part answer to "can this be downloaded?".</td></tr>
<tr><td><code>needsSubmoduleForComplete</code></td><td><span class="sig">boolean needsSubmoduleForComplete()</span></td><td class="desc">Whether a complete working tree needs the submodule fetched too.</td></tr>
<tr><td><code>referenceSheet</code></td><td><span class="sig">String referenceSheet()</span></td><td class="desc">A newline-separated reference sheet a tool or README can print.</td></tr>
</table>
</div>
<h2 class="section" data-u="sldownloadset">SLDownloadSet <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLDownloadSet.sleela)</span></h2>
<div data-u="sldownloadset sldownloadset">
<h3 id="SLDownloadSet">SLDownloadSet <span class="pill">class</span></h3>
<p class="desc">Defines SLDownloadSet — the set of URLs for the related downloads</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>PHASE_COMPILE</code></td><td><span class="sig">static final int PHASE_COMPILE = 0</span></td><td class="desc">Phase tags: when a download must be present. before compiling the OS (sources/toolchain)</td></tr>
<tr><td><code>PHASE_ISO</code></td><td><span class="sig">static final int PHASE_ISO = 1</span></td><td class="desc">before authoring the ISO (rootfs payloads)</td></tr>
<tr><td><code>extraCount</code></td><td><span class="sig">int extraCount</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>support</code></td><td><span class="sig">SLSupportDownloader support</span></td><td class="desc">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.</td></tr>
<tr><td><code>configured</code></td><td><span class="sig">int configured</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>supportDownloader</code></td><td><span class="sig">SLSupportDownloader supportDownloader()</span></td><td class="desc">The composed support downloader (for the OS document to reach).</td></tr>
<tr><td><code>forShape</code></td><td><span class="sig">void forShape(SLOSShape shape)</span></td><td class="desc">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.</td></tr>
<tr><td><code>setPackageRepo</code></td><td><span class="sig">void setPackageRepo(String url)</span></td><td class="desc">---- Setters --------------------------------------------------------</td></tr>
<tr><td><code>setKernelSrc</code></td><td><span class="sig">void setKernelSrc(String url)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setFirmwareSrc</code></td><td><span class="sig">void setFirmwareSrc(String url)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setRuntimeWine</code></td><td><span class="sig">void setRuntimeWine(String url)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setRuntimeQemu</code></td><td><span class="sig">void setRuntimeQemu(String url)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setUpstreamDistro</code></td><td><span class="sig">void setUpstreamDistro(String url)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>addExtra</code></td><td><span class="sig">int addExtra(String kind, String url, int phase)</span></td><td class="desc">Add a developer download: kind label, URL, and phase (0 compile / 1 iso). Up to four extras are held.</td></tr>
<tr><td><code>readyForCompile</code></td><td><span class="sig">boolean readyForCompile()</span></td><td class="desc">---- Validity ------------------------------------------------------- Before COMPILE: a package repo + kernel source must be known (you cannot build an OS without where its base and kernel come from).</td></tr>
<tr><td><code>readyForIso</code></td><td><span class="sig">boolean readyForIso()</span></td><td class="desc">Before ISO: additionally the firmware source must be known (the ESP/loader needs firmware), and every required slot resolved.</td></tr>
<tr><td><code>downloadManifest</code></td><td><span class="sig">String downloadManifest()</span></td><td class="desc">---- Manifest + fetch ----------------------------------------------- A newline manifest "<kind> <phase> <url>" of every known download.</td></tr>
<tr><td><code>row</code></td><td><span class="sig">String row(String acc, String kind, String phase, String url)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>rowExtra</code></td><td><span class="sig">String rowExtra(String acc, String rec)</span></td><td class="desc">An extra record "kind|url|phase" -> "kind phase url".</td></tr>
<tr><td><code>fetchScript</code></td><td><span class="sig">String fetchScript(int phase)</span></td><td class="desc">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.</td></tr>
<tr><td><code>fetchLine</code></td><td><span class="sig">String fetchLine(int wantPhase, int rowPhase, String kind, String url)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>phaseName</code></td><td><span class="sig">String phaseName(int phase)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>supportFetchScript</code></td><td><span class="sig">String supportFetchScript(int phase)</span></td><td class="desc">---- 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.</td></tr>
<tr><td><code>supportManifest</code></td><td><span class="sig">String supportManifest()</span></td><td class="desc">The support URL table for the manifest/report (every kind, every tier).</td></tr>
</table>
</div>
<h2 class="section" data-u="sldriverloaderemitter">SLDriverLoaderEmitter <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/os-creator/SLDriverLoaderEmitter.sleela)</span></h2>
<div data-u="sldriverloaderemitter sldriverloaderemitter">
<h3 id="SLDriverLoaderEmitter">SLDriverLoaderEmitter <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>emit</code></td><td><span class="sig">SLOSPiece emit(SLOSModel m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>emitLoadCalls</code></td><td><span class="sig">String emitLoadCalls(String manifest, String binding, int errCode)</span></td><td class="desc">One load_driver() call per manifest line whose binding matches, with the given error code on failure.</td></tr>
<tr><td><code>driverList</code></td><td><span class="sig">String driverList(String manifest, String binding)</span></td><td class="desc">A comma-separated C++ initializer list of driver names with the binding.</td></tr>
<tr><td><code>lineName</code></td><td><span class="sig">String lineName(String line)</span></td><td class="desc">"name binding" -> name (token before the space).</td></tr>
<tr><td><code>lineBinding</code></td><td><span class="sig">String lineBinding(String line)</span></td><td class="desc">"name binding" -> binding (token after the space).</td></tr>
<tr><td><code>strLen</code></td><td><span class="sig">int strLen(String s)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>substr</code></td><td><span class="sig">String substr(String s, int a, int b)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>charAt</code></td><td><span class="sig">String charAt(String s, int i)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>intToStr</code></td><td><span class="sig">String intToStr(int v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="sldriverset">SLDriverSet <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLDriverSet.sleela)</span></h2>
<div data-u="sldriverset sldriverset">
<h3 id="SLDriverSet">SLDriverSet <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>drivers</code></td><td><span class="sig">String drivers</span></td><td class="desc">newline-separated "name binding" lines (binding: builtin|module)</td></tr>
<tr><td><code>count</code></td><td><span class="sig">int count</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>builtinCount</code></td><td><span class="sig">int builtinCount</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>configured</code></td><td><span class="sig">int configured</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>add</code></td><td><span class="sig">void add(String name, String binding)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>builtin</code></td><td><span class="sig">void builtin(String name)</span></td><td class="desc">A driver that must be present before the rootfs mounts -> built-in.</td></tr>
<tr><td><code>module</code></td><td><span class="sig">void module(String name)</span></td><td class="desc">A driver loaded on demand after boot -> module.</td></tr>
<tr><td><code>forShape</code></td><td><span class="sig">void forShape(SLOSShape shape)</span></td><td class="desc">Seed the baseline driver set for a shape. Storage/bus/input are built in; GPU/audio/extra network are modules.</td></tr>
<tr><td><code>driverManifest</code></td><td><span class="sig">String driverManifest()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>driverCount</code></td><td><span class="sig">int driverCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>builtinDriverCount</code></td><td><span class="sig">int builtinDriverCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>canReachRootfs</code></td><td><span class="sig">boolean canReachRootfs()</span></td><td class="desc">The kernel can reach a rootfs only if at least one storage driver is built in.</td></tr>
</table>
</div>
<h2 class="section" data-u="sldriversource">SLDriverSource <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLDriverSource.sleela)</span></h2>
<div data-u="sldriversource sldriversource">
<h3 id="SLDriverSource">SLDriverSource <span class="pill">class</span></h3>
<p class="desc">Defines SLDriverSource — the provenance and trust policy for a</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>ORIGIN_INTREE</code></td><td><span class="sig">static final int ORIGIN_INTREE = 0</span></td><td class="desc">Origin tags. shipped with the OS</td></tr>
<tr><td><code>ORIGIN_VENDOR</code></td><td><span class="sig">static final int ORIGIN_VENDOR = 1</span></td><td class="desc">signed by a trusted vendor</td></tr>
<tr><td><code>ORIGIN_UNKNOWN</code></td><td><span class="sig">static final int ORIGIN_UNKNOWN = 2</span></td><td class="desc">unsigned / out-of-tree</td></tr>
<tr><td><code>ORIGIN_FOREIGN</code></td><td><span class="sig">static final int ORIGIN_FOREIGN = 3</span></td><td class="desc">written for another OS family</td></tr>
<tr><td><code>host</code></td><td><span class="sig">String host</span></td><td class="desc">the OS loading the driver</td></tr>
<tr><td><code>unknownPolicy</code></td><td><span class="sig">String unknownPolicy</span></td><td class="desc">Policy per origin: "enforce" (signature required), "permissive" (load with a taint warning), or "off" (refuse). Defaults are safe. for ORIGIN_UNKNOWN</td></tr>
<tr><td><code>foreignPolicy</code></td><td><span class="sig">String foreignPolicy</span></td><td class="desc">for ORIGIN_FOREIGN</td></tr>
<tr><td><code>configured</code></td><td><span class="sig">int configured</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String hostFamily)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>norm</code></td><td><span class="sig">String norm(String s)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>allowUnknown</code></td><td><span class="sig">void allowUnknown(boolean on)</span></td><td class="desc">Developer stance: allow unknown-source drivers (load unsigned with a taint).</td></tr>
<tr><td><code>allowForeign</code></td><td><span class="sig">void allowForeign(boolean on)</span></td><td class="desc">Allow foreign-OS drivers where a bridge exists ("bridge"), or refuse ("off").</td></tr>
<tr><td><code>originName</code></td><td><span class="sig">String originName(int origin)</span></td><td class="desc">---- Origin naming --------------------------------------------------</td></tr>
<tr><td><code>admit</code></td><td><span class="sig">int admit(int origin, String guestFamily, String deviceClass)</span></td><td class="desc">---- 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.</td></tr>
<tr><td><code>bridgeFor</code></td><td><span class="sig">String bridgeFor(String guestFamily, String deviceClass)</span></td><td class="desc">---- 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.</td></tr>
<tr><td><code>foreignSupported</code></td><td><span class="sig">boolean foreignSupported(String guestFamily, String deviceClass)</span></td><td class="desc">Can this host use a foreign driver from guestFamily for a device class?</td></tr>
<tr><td><code>verifySignature</code></td><td><span class="sig">int verifySignature(String path, String trustedKeyring)</span></td><td class="desc">---- 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.</td></tr>
<tr><td><code>policySummary</code></td><td><span class="sig">String policySummary()</span></td><td class="desc">---- Config / summary ----------------------------------------------</td></tr>
<tr><td><code>admitText</code></td><td><span class="sig">String admitText(int code)</span></td><td class="desc">The admit decision as text, for logs and the generated config.</td></tr>
</table>
</div>
<h2 class="section" data-u="slenvironment">SLEnvironment <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLEnvironment.sleela)</span></h2>
<div data-u="slenvironment slenvironment">
<h3 id="SLEnvironment">SLEnvironment <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>reads</code></td><td><span class="sig">int reads</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>writes</code></td><td><span class="sig">int writes</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>get</code></td><td><span class="sig">String get(String key)</span></td><td class="desc">Read a variable; "" when unset. Tracks a read count for observability.</td></tr>
<tr><td><code>getOrDefault</code></td><td><span class="sig">String getOrDefault(String key, String fallback)</span></td><td class="desc">Read with a fallback used when the variable is unset (empty).</td></tr>
<tr><td><code>has</code></td><td><span class="sig">boolean has(String key)</span></td><td class="desc">True when the variable is present (non-empty).</td></tr>
<tr><td><code>set</code></td><td><span class="sig">boolean set(String key, String value)</span></td><td class="desc">Set (overwrite) a variable; returns true on success.</td></tr>
<tr><td><code>path</code></td><td><span class="sig">String path()</span></td><td class="desc">Common entries, resolved per-OS by the host (PATH, HOME/USERPROFILE, ...).</td></tr>
<tr><td><code>home</code></td><td><span class="sig">String home()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>shell</code></td><td><span class="sig">String shell()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>readCount</code></td><td><span class="sig">int readCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>writeCount</code></td><td><span class="sig">int writeCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="sleventsignal">SLEventSignal <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLEventSignal.sleela)</span></h2>
<div data-u="sleventsignal sleventsignal">
<h3 id="SLEventSignal">SLEventSignal <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>delivered</code></td><td><span class="sig">int delivered</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>terminate</code></td><td><span class="sig">boolean terminate(int processHandle)</span></td><td class="desc">Ask the process behind the given handle to terminate (SIGTERM / TerminateProcess). Returns true if the request was accepted.</td></tr>
<tr><td><code>terminateProcess</code></td><td><span class="sig">boolean terminateProcess(SLProcess p)</span></td><td class="desc">Convenience: terminate the process wrapped by an SLProcess.</td></tr>
<tr><td><code>deliveredCount</code></td><td><span class="sig">int deliveredCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slexecutabletranslator">SLExecutableTranslator <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLExecutableTranslator.sleela)</span></h2>
<div data-u="slexecutabletranslator slexecutabletranslator">
<h3 id="SLExecutableTranslator">SLExecutableTranslator <span class="pill">class</span></h3>
<p class="desc">Defines SLExecutableTranslator — the policy and mechanism for</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>host</code></td><td><span class="sig">String host</span></td><td class="desc">the host OS running the file: "Linux" / "Windows" / "macOS"</td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String hostShape)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>configureForHost</code></td><td><span class="sig">void configureForHost()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hostName</code></td><td><span class="sig">String hostName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>worldOf</code></td><td><span class="sig">String worldOf(String ext)</span></td><td class="desc">---- 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.</td></tr>
<tr><td><code>isForeign</code></td><td><span class="sig">boolean isForeign(String ext)</span></td><td class="desc">isForeign(ext): does running this type on the host require translation?</td></tr>
<tr><td><code>translatorFor</code></td><td><span class="sig">String translatorFor(String ext)</span></td><td class="desc">---- 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.</td></tr>
<tr><td><code>kind</code></td><td><span class="sig">String kind(String ext)</span></td><td class="desc">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).</td></tr>
<tr><td><code>hasFsInterpreter</code></td><td><span class="sig">boolean hasFsInterpreter()</span></td><td class="desc">Does the host provide a filesystem-level interpreter facility at all?</td></tr>
<tr><td><code>binfmtLine</code></td><td><span class="sig">String binfmtLine(String ext, String interpreter)</span></td><td class="desc">---- 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".</td></tr>
<tr><td><code>stripDot</code></td><td><span class="sig">String stripDot(String ext)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>registerCommand</code></td><td><span class="sig">String registerCommand(String ext, String interpreter)</span></td><td class="desc">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).</td></tr>
<tr><td><code>runCommand</code></td><td><span class="sig">String runCommand(String path, String ext, String interpreter)</span></td><td class="desc">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.</td></tr>
<tr><td><code>register</code></td><td><span class="sig">int register(String ext, String interpreter)</span></td><td class="desc">---- 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.</td></tr>
<tr><td><code>runnableNow</code></td><td><span class="sig">boolean runnableNow(String ext, String interpreterPath)</span></td><td class="desc">runnableNow(ext, interpreterPath): best-effort check that the host can run this foreign type right now — the interpreter/container binary is present.</td></tr>
<tr><td><code>emitTranslatorHeader</code></td><td><span class="sig">String emitTranslatorHeader()</span></td><td class="desc">---- 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.</td></tr>
<tr><td><code>bit</code></td><td><span class="sig">String bit(boolean b)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slexecutabletypes">SLExecutableTypes <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLExecutableTypes.sleela)</span></h2>
<div data-u="slexecutabletypes slexecutabletypes">
<h3 id="SLExecutableTypes">SLExecutableTypes <span class="pill">class</span></h3>
<p class="desc">Defines SLExecutableTypes — the per-OS policy for which FILE</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>shape</code></td><td><span class="sig">String shape</span></td><td class="desc">"Linux" / "Windows" / "macOS"</td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String shapeName)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>configureForHost</code></td><td><span class="sig">void configureForHost()</span></td><td class="desc">Configure from the real host OS the VM runs on.</td></tr>
<tr><td><code>name</code></td><td><span class="sig">String name()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isWindows</code></td><td><span class="sig">boolean isWindows()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isMac</code></td><td><span class="sig">boolean isMac()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isLinux</code></td><td><span class="sig">boolean isLinux()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isExecutable</code></td><td><span class="sig">boolean isExecutable(String ext)</span></td><td class="desc">---- 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.</td></tr>
<tr><td><code>executableTypes</code></td><td><span class="sig">String executableTypes()</span></td><td class="desc">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.</td></tr>
<tr><td><code>pathext</code></td><td><span class="sig">String pathext()</span></td><td class="desc">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.</td></tr>
<tr><td><code>mechanism</code></td><td><span class="sig">String mechanism()</span></td><td class="desc">How a file becomes executable on this shape (human-readable mechanism).</td></tr>
<tr><td><code>usesExecBit</code></td><td><span class="sig">boolean usesExecBit()</span></td><td class="desc">Whether this shape uses the POSIX exec-bit model at all.</td></tr>
<tr><td><code>markExecutable</code></td><td><span class="sig">int markExecutable(String path)</span></td><td class="desc">---- 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.</td></tr>
<tr><td><code>isHostExecutable</code></td><td><span class="sig">boolean isHostExecutable(String path, String ext)</span></td><td class="desc">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.</td></tr>
<tr><td><code>emitExecTypesHeader</code></td><td><span class="sig">String emitExecTypesHeader()</span></td><td class="desc">---- 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.</td></tr>
<tr><td><code>emitTableRows</code></td><td><span class="sig">String emitTableRows()</span></td><td class="desc">One C string literal per executable extension for this shape.</td></tr>
<tr><td><code>bit</code></td><td><span class="sig">String bit(boolean b)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slfile">SLFile <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLFile.sleela)</span></h2>
<div data-u="slfile slfile">
<h3 id="SLFile">SLFile <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>path</code></td><td><span class="sig">String path</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String p)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>name</code></td><td><span class="sig">String name()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>exists</code></td><td><span class="sig">boolean exists()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isRegular</code></td><td><span class="sig">boolean isRegular()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>size</code></td><td><span class="sig">int size()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>delete</code></td><td><span class="sig">boolean delete()</span></td><td class="desc">Remove this file; returns true on success.</td></tr>
<tr><td><code>renameTo</code></td><td><span class="sig">boolean renameTo(String newPath)</span></td><td class="desc">Rename/move this file; on success the handle tracks the new path.</td></tr>
</table>
</div>
<h2 class="section" data-u="slfilesystem">SLFileSystem <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLFileSystem.sleela)</span></h2>
<div data-u="slfilesystem slfilesystem">
<h3 id="SLFileSystem">SLFileSystem <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>ops</code></td><td><span class="sig">int ops</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>exists</code></td><td><span class="sig">boolean exists(String path)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isDir</code></td><td><span class="sig">boolean isDir(String path)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isFile</code></td><td><span class="sig">boolean isFile(String path)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>size</code></td><td><span class="sig">int size(String path)</span></td><td class="desc">Size in bytes, or -1 if the path does not exist / is not a regular file.</td></tr>
<tr><td><code>makeDir</code></td><td><span class="sig">boolean makeDir(String path)</span></td><td class="desc">Create a directory (succeeds if it already exists). Returns true on success.</td></tr>
<tr><td><code>remove</code></td><td><span class="sig">boolean remove(String path)</span></td><td class="desc">Remove a file or an empty directory. Returns true on success.</td></tr>
<tr><td><code>rename</code></td><td><span class="sig">boolean rename(String from, String to)</span></td><td class="desc">Rename/move a path. Returns true on success.</td></tr>
<tr><td><code>move</code></td><td><span class="sig">boolean move(String from, String to)</span></td><td class="desc">Move is rename across directories (same host primitive).</td></tr>
<tr><td><code>operationCount</code></td><td><span class="sig">int operationCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slfilesystemcatalog">SLFilesystemCatalog <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLFilesystemCatalog.sleela)</span></h2>
<div data-u="slfilesystemcatalog slfilesystemcatalog">
<h3 id="SLFilesystemCatalog">SLFilesystemCatalog <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>isKnown</code></td><td><span class="sig">boolean isKnown(String fs)</span></td><td class="desc">Canonical, lowercase filesystem identifiers this catalogue knows.</td></tr>
<tr><td><code>family</code></td><td><span class="sig">String family(String fs)</span></td><td class="desc">The family a filesystem belongs to, or "unknown".</td></tr>
<tr><td><code>nativeOs</code></td><td><span class="sig">String nativeOs(String fs)</span></td><td class="desc">The OS that natively owns/defaults to this filesystem.</td></tr>
<tr><td><code>journaling</code></td><td><span class="sig">boolean journaling(String fs)</span></td><td class="desc">Does it journal (crash-consistent metadata)? FAT and classic HFS do not.</td></tr>
<tr><td><code>copyOnWrite</code></td><td><span class="sig">boolean copyOnWrite(String fs)</span></td><td class="desc">Copy-on-write (snapshotting) filesystems.</td></tr>
<tr><td><code>caseSensitivity</code></td><td><span class="sig">String caseSensitivity(String fs)</span></td><td class="desc">Case sensitivity of file names by default.</td></tr>
<tr><td><code>maxFileSize</code></td><td><span class="sig">String maxFileSize(String fs)</span></td><td class="desc">A typical maximum single-file size, as human text (real per-fs limits).</td></tr>
<tr><td><code>rootable</code></td><td><span class="sig">boolean rootable(String fs)</span></td><td class="desc">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.</td></tr>
<tr><td><code>efiSystemPartition</code></td><td><span class="sig">boolean efiSystemPartition(String fs)</span></td><td class="desc">Suitable for the EFI System Partition (must be FAT).</td></tr>
<tr><td><code>mkfsTool</code></td><td><span class="sig">String mkfsTool(String fs)</span></td><td class="desc">The mkfs-style tool that formats this filesystem.</td></tr>
<tr><td><code>useCase</code></td><td><span class="sig">String useCase(String fs)</span></td><td class="desc">A one-line use-case note for a GUI/menu.</td></tr>
<tr><td><code>defaultRootFor</code></td><td><span class="sig">String defaultRootFor(String shapeName)</span></td><td class="desc">The default root filesystem for an OS shape (what forShape would pick).</td></tr>
<tr><td><code>rootChoicesFor</code></td><td><span class="sig">String rootChoicesFor(String shapeName)</span></td><td class="desc">A newline menu of the catalogue's rootable choices for a shape, for a GUI.</td></tr>
<tr><td><code>describe</code></td><td><span class="sig">String describe(String fs)</span></td><td class="desc">A compact spec line a tool can print for one filesystem.</td></tr>
<tr><td><code>yn</code></td><td><span class="sig">String yn(boolean b)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slfilesystemlayout">SLFilesystemLayout <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLFilesystemLayout.sleela)</span></h2>
<div data-u="slfilesystemlayout slfilesystemlayout">
<h3 id="SLFilesystemLayout">SLFilesystemLayout <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>format</code></td><td><span class="sig">String format</span></td><td class="desc">"ext4" / "NTFS" / "APFS"</td></tr>
<tr><td><code>separator</code></td><td><span class="sig">String separator</span></td><td class="desc">path separator for this layout</td></tr>
<tr><td><code>tree</code></td><td><span class="sig">String tree</span></td><td class="desc">newline-separated directory manifest</td></tr>
<tr><td><code>dirCount</code></td><td><span class="sig">int dirCount</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>configured</code></td><td><span class="sig">int configured</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String fsFormat, String sep)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>addDir</code></td><td><span class="sig">void addDir(String path)</span></td><td class="desc">Add one directory to the manifest.</td></tr>
<tr><td><code>forShape</code></td><td><span class="sig">void forShape(SLOSShape shape)</span></td><td class="desc">Seed the standard directory tree for a shape.</td></tr>
<tr><td><code>fsFormat</code></td><td><span class="sig">String fsFormat()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>manifest</code></td><td><span class="sig">String manifest()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>directoryCount</code></td><td><span class="sig">int directoryCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isComplete</code></td><td><span class="sig">boolean isComplete()</span></td><td class="desc">A layout must declare at least a system root and a user-data root.</td></tr>
</table>
</div>
<h2 class="section" data-u="slharddisk">SLHardDisk <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/hdd/SLHardDisk.sleela)</span></h2>
<div data-u="slharddisk slharddisk">
<h3 id="SLHardDisk">SLHardDisk <span class="pill">class</span> <span class="muted">extends <code>SLHardwareComponent</code></span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>IF_SATA3</code></td><td><span class="sig">static final int IF_SATA3 = 0</span></td><td class="desc">Interface ordinals. 6 Gb/s</td></tr>
<tr><td><code>IF_SAS</code></td><td><span class="sig">static final int IF_SAS = 1</span></td><td class="desc">12 Gb/s enterprise</td></tr>
<tr><td><code>REC_CMR</code></td><td><span class="sig">static final int REC_CMR = 0</span></td><td class="desc">Recording technology. conventional (preferred)</td></tr>
<tr><td><code>REC_SMR</code></td><td><span class="sig">static final int REC_SMR = 1</span></td><td class="desc">shingled (higher density, slower random writes)</td></tr>
<tr><td><code>iface</code></td><td><span class="sig">int iface</span></td><td class="desc">IF_*</td></tr>
<tr><td><code>formFactor</code></td><td><span class="sig">String formFactor</span></td><td class="desc">"3.5\"" / "2.5\""</td></tr>
<tr><td><code>rpm</code></td><td><span class="sig">int rpm</span></td><td class="desc">spindle speed</td></tr>
<tr><td><code>recording</code></td><td><span class="sig">int recording</span></td><td class="desc">REC_*</td></tr>
<tr><td><code>cacheMb</code></td><td><span class="sig">int cacheMb</span></td><td class="desc">DRAM cache</td></tr>
<tr><td><code>capacityGb</code></td><td><span class="sig">int capacityGb</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>sustainedMBps</code></td><td><span class="sig">int sustainedMBps</span></td><td class="desc">representative sustained transfer rate</td></tr>
<tr><td><code>blockBytes</code></td><td><span class="sig">int blockBytes</span></td><td class="desc">logical block size</td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String manufacturer, String partName, int interfaceKind, int rpmSpeed, int capacityGigabytes)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setRecording</code></td><td><span class="sig">void setRecording(int tech)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setCache</code></td><td><span class="sig">void setCache(int megabytes)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setFormFactor</code></td><td><span class="sig">void setFormFactor(String ff)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setSustained</code></td><td><span class="sig">void setSustained(int mbps)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isSas</code></td><td><span class="sig">boolean isSas()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isSmr</code></td><td><span class="sig">boolean isSmr()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>interfaceName</code></td><td><span class="sig">String interfaceName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>recordingName</code></td><td><span class="sig">String recordingName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>form</code></td><td><span class="sig">String form()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>spindleRpm</code></td><td><span class="sig">int spindleRpm()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>cacheMegabytes</code></td><td><span class="sig">int cacheMegabytes()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>capacityGigabytes</code></td><td><span class="sig">int capacityGigabytes()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>transferMBps</code></td><td><span class="sig">int transferMBps()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>blockSize</code></td><td><span class="sig">int blockSize()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>capacityBlocks</code></td><td><span class="sig">int capacityBlocks()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slharddiskcatalog">SLHardDiskCatalog <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/hdd/SLHardDiskCatalog.sleela)</span></h2>
<div data-u="slharddiskcatalog slharddiskcatalog">
<h3 id="SLHardDiskCatalog">SLHardDiskCatalog <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>sata7200</code></td><td><span class="sig">SLHardDisk sata7200(String manufacturer, int capacityGb)</span></td><td class="desc">A 7200 RPM SATA desktop/NAS drive from a named manufacturer.</td></tr>
<tr><td><code>enterprise</code></td><td><span class="sig">SLHardDisk enterprise(String manufacturer, int capacityGb)</span></td><td class="desc">A 7200 RPM SAS enterprise drive from a named manufacturer.</td></tr>
<tr><td><code>performance</code></td><td><span class="sig">SLHardDisk performance(String manufacturer, int rpm, int capacityGb)</span></td><td class="desc">A high-RPM (10k/15k) SAS performance drive.</td></tr>
<tr><td><code>known</code></td><td><span class="sig">boolean known(String manufacturer)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>desktopPart</code></td><td><span class="sig">String desktopPart(String mfr)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>enterprisePart</code></td><td><span class="sig">String enterprisePart(String mfr)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slhardwarecomponent">SLHardwareComponent <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLHardwareComponent.sleela)</span></h2>
<div data-u="slhardwarecomponent slhardwarecomponent">
<h3 id="SLHardwareComponent">SLHardwareComponent <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>CLASS_MEMORY</code></td><td><span class="sig">static final int CLASS_MEMORY = 0</span></td><td class="desc">Device-class ordinals (what kind of part this is).</td></tr>
<tr><td><code>CLASS_SSD</code></td><td><span class="sig">static final int CLASS_SSD = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>CLASS_HDD</code></td><td><span class="sig">static final int CLASS_HDD = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>CLASS_USB</code></td><td><span class="sig">static final int CLASS_USB = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>CLASS_UEFI</code></td><td><span class="sig">static final int CLASS_UEFI = 4</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>CLASS_VIDEO</code></td><td><span class="sig">static final int CLASS_VIDEO = 5</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>CLASS_CPU</code></td><td><span class="sig">static final int CLASS_CPU = 6</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>CLASS_MAINBOARD</code></td><td><span class="sig">static final int CLASS_MAINBOARD = 7</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>vendor</code></td><td><span class="sig">String vendor</span></td><td class="desc">manufacturer, e.g. "Samsung", "NVIDIA"</td></tr>
<tr><td><code>model</code></td><td><span class="sig">String model</span></td><td class="desc">model / part name, e.g. "M378A2K43DB1", "GeForce RTX 4090"</td></tr>
<tr><td><code>deviceClass</code></td><td><span class="sig">int deviceClass</span></td><td class="desc">one of CLASS_*</td></tr>
<tr><td><code>configured</code></td><td><span class="sig">int configured</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configureComponent</code></td><td><span class="sig">void configureComponent(String manufacturer, String partName, int cls)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>manufacturer</code></td><td><span class="sig">String manufacturer()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>partName</code></td><td><span class="sig">String partName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>componentClass</code></td><td><span class="sig">int componentClass()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isConfigured</code></td><td><span class="sig">boolean isConfigured()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>className</code></td><td><span class="sig">String className()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>identity</code></td><td><span class="sig">String identity()</span></td><td class="desc">A short identity line shared by every part, e.g. "ssd Samsung 990 PRO".</td></tr>
</table>
</div>
<h2 class="section" data-u="slhardwareregistry">SLHardwareRegistry <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLHardwareRegistry.sleela)</span></h2>
<div data-u="slhardwareregistry slhardwareregistry">
<h3 id="SLHardwareRegistry">SLHardwareRegistry <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>ddr</code></td><td><span class="sig">SLDDRCatalog ddr</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ssds</code></td><td><span class="sig">SLSSDCatalog ssds</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hdds</code></td><td><span class="sig">SLHardDiskCatalog hdds</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>usb</code></td><td><span class="sig">SLUSBCatalog usb</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>gpus</code></td><td><span class="sig">SLVideoCardCatalog gpus</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>memory</code></td><td><span class="sig">SLDDRModule memory(String manufacturer, String generation, int capacityMb)</span></td><td class="desc">---- Memory ------------------------------------------------------------ A DDR module by manufacturer, generation name ("DDR".."DDR5"), capacity MB.</td></tr>
<tr><td><code>eccMemory</code></td><td><span class="sig">SLDDRModule eccMemory(String manufacturer, String generation, int capacityMb)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ssd</code></td><td><span class="sig">SLSSD ssd(String manufacturer, String iface, int capacityGb)</span></td><td class="desc">---- Solid-state storage ----------------------------------------------- An SSD by manufacturer, interface name ("SATA"/"PCIe3"/"PCIe4"/"PCIe5"), GB.</td></tr>
<tr><td><code>hdd</code></td><td><span class="sig">SLHardDisk hdd(String manufacturer, int rpm, int capacityGb)</span></td><td class="desc">---- Rotational storage ------------------------------------------------</td></tr>
<tr><td><code>usbController</code></td><td><span class="sig">SLUSBDevice usbController(String vendor, String generation, int ports)</span></td><td class="desc">---- USB --------------------------------------------------------------- A USB host controller by vendor + generation name.</td></tr>
<tr><td><code>usbFlash</code></td><td><span class="sig">SLUSBDevice usbFlash(String vendor, String model, String generation)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>uefi</code></td><td><span class="sig">SLUEFIFirmware uefi(String vendor)</span></td><td class="desc">---- UEFI firmware -----------------------------------------------------</td></tr>
<tr><td><code>video</code></td><td><span class="sig">SLVideoCard video(String vendor, String model, int vramMb)</span></td><td class="desc">---- Video card --------------------------------------------------------</td></tr>
<tr><td><code>memoryCatalog</code></td><td><span class="sig">SLDDRCatalog memoryCatalog()</span></td><td class="desc">Catalogue accessors for callers that want the richer per-family API.</td></tr>
<tr><td><code>ssdCatalog</code></td><td><span class="sig">SLSSDCatalog ssdCatalog()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hddCatalog</code></td><td><span class="sig">SLHardDiskCatalog hddCatalog()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>usbCatalog</code></td><td><span class="sig">SLUSBCatalog usbCatalog()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>videoCatalog</code></td><td><span class="sig">SLVideoCardCatalog videoCatalog()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slinstallergenerator">SLInstallerGenerator <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLInstallerGenerator.sleela)</span></h2>
<div data-u="slinstallergenerator slinstallergenerator">
<h3 id="SLInstallerGenerator">SLInstallerGenerator <span class="pill">class</span></h3>
<p class="desc">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).</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>configured</code></td><td><span class="sig">int configured</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>generate</code></td><td><span class="sig">SLOSArtifact generate(SLOSModel m)</span></td><td class="desc">Generate the installer that matches the model's shape.</td></tr>
<tr><td><code>linuxInstaller</code></td><td><span class="sig">SLOSArtifact linuxInstaller(SLOSModel m)</span></td><td class="desc">---- Linux: POSIX shell installer --------------------------------------</td></tr>
<tr><td><code>windowsInstaller</code></td><td><span class="sig">SLOSArtifact windowsInstaller(SLOSModel m)</span></td><td class="desc">---- Windows: PowerShell installer -------------------------------------</td></tr>
<tr><td><code>macInstaller</code></td><td><span class="sig">SLOSArtifact macInstaller(SLOSModel m)</span></td><td class="desc">---- macOS: APFS shell installer ---------------------------------------</td></tr>
<tr><td><code>vmBranchPosix</code></td><td><span class="sig">String vmBranchPosix(SLOSModel m)</span></td><td class="desc">The shared --vm (QEMU) branch for POSIX installers: boot the ISO read-only.</td></tr>
<tr><td><code>isoFileName</code></td><td><span class="sig">String isoFileName(SLOSModel m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slisobuilder">SLISOBuilder <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLISOBuilder.sleela)</span></h2>
<div data-u="slisobuilder slisobuilder">
<h3 id="SLISOBuilder">SLISOBuilder <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>stagingRoot</code></td><td><span class="sig">String stagingRoot</span></td><td class="desc">where the rootfs is assembled</td></tr>
<tr><td><code>configured</code></td><td><span class="sig">int configured</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>stageAt</code></td><td><span class="sig">void stageAt(String dir)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>build</code></td><td><span class="sig">SLOSArtifact build(SLOSModel m, SLOSCompiler compiler)</span></td><td class="desc">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).</td></tr>
<tr><td><code>emitMkdirs</code></td><td><span class="sig">String emitMkdirs(SLOSModel m)</span></td><td class="desc">---- Recipe fragments --------------------------------------------------- One `mkdir -p` per directory in the model's filesystem manifest.</td></tr>
<tr><td><code>emitPackageInstall</code></td><td><span class="sig">String emitPackageInstall(SLOSModel m)</span></td><td class="desc">One package-install line per entry in the model's package manifest.</td></tr>
<tr><td><code>normalize</code></td><td><span class="sig">String normalize(String path)</span></td><td class="desc">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).</td></tr>
<tr><td><code>replaceBackslash</code></td><td><span class="sig">String replaceBackslash(String s)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>volumeLabel</code></td><td><span class="sig">String volumeLabel(SLOSModel m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isoFileName</code></td><td><span class="sig">String isoFileName(SLOSModel m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>strLen</code></td><td><span class="sig">int strLen(String s)</span></td><td class="desc">String primitives wrap the shared native text intrinsics.</td></tr>
<tr><td><code>substr</code></td><td><span class="sig">String substr(String s, int a, int b)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>charAt</code></td><td><span class="sig">String charAt(String s, int i)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slkernelcatalog">SLKernelCatalog <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLKernelCatalog.sleela)</span></h2>
<div data-u="slkernelcatalog slkernelcatalog">
<h3 id="SLKernelCatalog">SLKernelCatalog <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>kernelName</code></td><td><span class="sig">String kernelName(String family)</span></td><td class="desc">The kernel NAME for a family label.</td></tr>
<tr><td><code>defaultVersion</code></td><td><span class="sig">String defaultVersion(String family)</span></td><td class="desc">The family DEFAULT version (what forShape would pick).</td></tr>
<tr><td><code>resolveLinux</code></td><td><span class="sig">String resolveLinux(String sel)</span></td><td class="desc">---- 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).</td></tr>
<tr><td><code>resolveWindows</code></td><td><span class="sig">String resolveWindows(String sel)</span></td><td class="desc">resolveWindows(sel): Windows 10+ only. Maps an edition/name to its NT 10.0 build. Pre-10 selections resolve to "" (unsupported here).</td></tr>
<tr><td><code>resolveMac</code></td><td><span class="sig">String resolveMac(String sel)</span></td><td class="desc">resolveMac(sel): macOS release name or Darwin version -> Darwin version.</td></tr>
<tr><td><code>resolve</code></td><td><span class="sig">String resolve(String family, String sel)</span></td><td class="desc">resolve(family, sel): the family-dispatched resolver. Returns "" when the selection is not valid for the family (e.g. a pre-10 Windows request).</td></tr>
<tr><td><code>isSupported</code></td><td><span class="sig">boolean isSupported(String family, String sel)</span></td><td class="desc">isSupported(family, sel): true when resolve() yields a concrete version.</td></tr>
<tr><td><code>selectionsFor</code></td><td><span class="sig">String selectionsFor(String family)</span></td><td class="desc">A newline-separated menu of named selections for a family (for a GUI).</td></tr>
<tr><td><code>startsWith10</code></td><td><span class="sig">boolean startsWith10(String nt)</span></td><td class="desc">Windows-10+ guard: an explicit NT build is accepted only when it is NT 10.x.</td></tr>
<tr><td><code>prefix10</code></td><td><span class="sig">boolean prefix10(String nt)</span></td><td class="desc">True for the exact NT-10 builds the catalogue resolves to.</td></tr>
</table>
</div>
<h2 class="section" data-u="slkernelloaderemitter">SLKernelLoaderEmitter <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/os-creator/SLKernelLoaderEmitter.sleela)</span></h2>
<div data-u="slkernelloaderemitter slkernelloaderemitter">
<h3 id="SLKernelLoaderEmitter">SLKernelLoaderEmitter <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>emit</code></td><td><span class="sig">SLOSPiece emit(SLOSModel m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>boolLit</code></td><td><span class="sig">String boolLit(boolean b)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slkernelspec">SLKernelSpec <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLKernelSpec.sleela)</span></h2>
<div data-u="slkernelspec slkernelspec">
<h3 id="SLKernelSpec">SLKernelSpec <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>kernelName</code></td><td><span class="sig">String kernelName</span></td><td class="desc">"NT", "Linux", "XNU"</td></tr>
<tr><td><code>version</code></td><td><span class="sig">String version</span></td><td class="desc">e.g. "6.18.27"</td></tr>
<tr><td><code>cmdline</code></td><td><span class="sig">String cmdline</span></td><td class="desc">kernel boot parameters</td></tr>
<tr><td><code>processMgmt</code></td><td><span class="sig">int processMgmt</span></td><td class="desc">Subsystem toggles (1 = required, 0 = omitted).</td></tr>
<tr><td><code>memoryMgmt</code></td><td><span class="sig">int memoryMgmt</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>scheduler</code></td><td><span class="sig">int scheduler</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>networking</code></td><td><span class="sig">int networking</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>filesystems</code></td><td><span class="sig">int filesystems</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>drivers</code></td><td><span class="sig">int drivers</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>security</code></td><td><span class="sig">int security</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>preemptible</code></td><td><span class="sig">int preemptible</span></td><td class="desc">preemptible kernel</td></tr>
<tr><td><code>configured</code></td><td><span class="sig">int configured</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String name, String ver)</span></td><td class="desc">Baseline: a full-featured, preemptible kernel with every core subsystem.</td></tr>
<tr><td><code>forShape</code></td><td><span class="sig">void forShape(SLOSShape shape)</span></td><td class="desc">Pick the kernel family that matches a shape, with a sensible version.</td></tr>
<tr><td><code>selectVersion</code></td><td><span class="sig">boolean selectVersion(SLKernelCatalog catalog, String family, String selection)</span></td><td class="desc">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).</td></tr>
<tr><td><code>setCmdline</code></td><td><span class="sig">void setCmdline(String line)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>appendCmdline</code></td><td><span class="sig">void appendCmdline(String arg)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>requireSecurity</code></td><td><span class="sig">void requireSecurity(boolean on)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>name</code></td><td><span class="sig">String name()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>kernelVersion</code></td><td><span class="sig">String kernelVersion()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>commandLine</code></td><td><span class="sig">String commandLine()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>subsystemCount</code></td><td><span class="sig">int subsystemCount()</span></td><td class="desc">Count of enabled core subsystems (used by the model's validity check).</td></tr>
<tr><td><code>isBootable</code></td><td><span class="sig">boolean isBootable()</span></td><td class="desc">A kernel is bootable only if it provides the three irreducible subsystems.</td></tr>
</table>
</div>
<h2 class="section" data-u="sllinuxos">SLLinuxOS <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLLinuxOS.sleela)</span></h2>
<div data-u="sllinuxos sllinuxos">
<h3 id="SLLinuxOS">SLLinuxOS <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isHost</code></td><td><span class="sig">boolean isHost()</span></td><td class="desc">True when the running host is actually Linux.</td></tr>
<tr><td><code>sh</code></td><td><span class="sig">int sh(String command)</span></td><td class="desc">---- Shell / processes -------------------------------------------------- Run a command through /bin/sh (osRun uses /bin/sh -c on POSIX).</td></tr>
<tr><td><code>startSh</code></td><td><span class="sig">SLProcess startSh(String command)</span></td><td class="desc">Start a background command; returns an SLProcess to wait()/kill().</td></tr>
<tr><td><code>waitFor</code></td><td><span class="sig">int waitFor(int processHandle)</span></td><td class="desc">Reap a daemon-style child by handle.</td></tr>
<tr><td><code>home</code></td><td><span class="sig">String home()</span></td><td class="desc">---- Environment (HOME/PATH/XDG/SHELL) ---------------------------------</td></tr>
<tr><td><code>path</code></td><td><span class="sig">String path()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>shell</code></td><td><span class="sig">String shell()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>xdgConfigHome</code></td><td><span class="sig">String xdgConfigHome()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>xdgRuntimeDir</code></td><td><span class="sig">String xdgRuntimeDir()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>etc</code></td><td><span class="sig">String etc()</span></td><td class="desc">---- Filesystem Hierarchy Standard roots -------------------------------</td></tr>
<tr><td><code>proc</code></td><td><span class="sig">String proc()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>sys</code></td><td><span class="sig">String sys()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>tmp</code></td><td><span class="sig">String tmp()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>var</code></td><td><span class="sig">String var()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>kernelCmdline</code></td><td><span class="sig">String kernelCmdline()</span></td><td class="desc">---- Kernel / distro facts (read real files via file I/O built-ins) ----- The kernel command line exposed by procfs; "" if unreadable.</td></tr>
<tr><td><code>osRelease</code></td><td><span class="sig">String osRelease()</span></td><td class="desc">The os-release metadata (distro name/version); "" if unreadable.</td></tr>
<tr><td><code>procExists</code></td><td><span class="sig">boolean procExists(int pid)</span></td><td class="desc">True if a /proc entry exists for the given pid.</td></tr>
<tr><td><code>readSmallFile</code></td><td><span class="sig">String readSmallFile(String path)</span></td><td class="desc">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.</td></tr>
<tr><td><code>hostName</code></td><td><span class="sig">String hostName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>userName</code></td><td><span class="sig">String userName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="sllinuxosmodel">SLLinuxOSModel <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLLinuxOSModel.sleela)</span></h2>
<div data-u="sllinuxosmodel sllinuxosmodel">
<h3 id="SLLinuxOSModel">SLLinuxOSModel <span class="pill">class</span> <span class="muted">extends <code>SLOSModel</code></span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>build</code></td><td><span class="sig">void build(String name, String ver)</span></td><td class="desc">Build a Linux-shaped model with the given product name/version on amd64.</td></tr>
<tr><td><code>buildMultiArch</code></td><td><span class="sig">void buildMultiArch(String name, String ver)</span></td><td class="desc">Build a multi-arch Linux model (adds arm64 to the primary amd64 target).</td></tr>
</table>
</div>
<h2 class="section" data-u="slmachinebuilder">SLMachineBuilder <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLMachineBuilder.sleela)</span></h2>
<div data-u="slmachinebuilder slmachinebuilder">
<h3 id="SLMachineBuilder">SLMachineBuilder <span class="pill">class</span></h3>
<p class="desc">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).</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>machine</code></td><td><span class="sig">SLMachine machine</span></td><td class="desc">the composed lib/cpu machine</td></tr>
<tr><td><code>built</code></td><td><span class="sig">int built</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>build</code></td><td><span class="sig">SLMachine build(SLMachineModel m)</span></td><td class="desc">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).</td></tr>
<tr><td><code>buildBootAndRun</code></td><td><span class="sig">int buildBootAndRun(SLMachineModel m, int rounds)</span></td><td class="desc">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.</td></tr>
<tr><td><code>buildAndRunSource</code></td><td><span class="sig">int buildAndRunSource(SLMachineModel m, int langId, String sourcePath, String programName)</span></td><td class="desc">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.</td></tr>
<tr><td><code>buildAndBootGuest</code></td><td><span class="sig">int buildAndBootGuest(SLMachineModel m, String kernelSourcePath, int kernelLang,</span></td><td class="desc">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.</td></tr>
<tr><td><code>builtMachine</code></td><td><span class="sig">SLMachine builtMachine()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>buildCount</code></td><td><span class="sig">int buildCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slmachinemodel">SLMachineModel <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLMachineModel.sleela)</span></h2>
<div data-u="slmachinemodel slmachinemodel">
<h3 id="SLMachineModel">SLMachineModel <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>machineName</code></td><td><span class="sig">String machineName</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>cpuVendor</code></td><td><span class="sig">String cpuVendor</span></td><td class="desc">CPU identity (the processor itself is modeled by lib/cpu/SLCPU at build).</td></tr>
<tr><td><code>cpuModel</code></td><td><span class="sig">String cpuModel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>cpuCores</code></td><td><span class="sig">int cpuCores</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>wordBits</code></td><td><span class="sig">int wordBits</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>clockMhz</code></td><td><span class="sig">int clockMhz</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>memory</code></td><td><span class="sig">SLDDRModule memory</span></td><td class="desc">Named parts. main memory module (represents the populated set)</td></tr>
<tr><td><code>memoryModules</code></td><td><span class="sig">int memoryModules</span></td><td class="desc">how many identical modules are installed</td></tr>
<tr><td><code>ssd</code></td><td><span class="sig">SLSSD ssd</span></td><td class="desc">primary SSD, or null</td></tr>
<tr><td><code>hdd</code></td><td><span class="sig">SLHardDisk hdd</span></td><td class="desc">primary HDD, or null</td></tr>
<tr><td><code>firmware</code></td><td><span class="sig">SLUEFIFirmware firmware</span></td><td class="desc">platform firmware</td></tr>
<tr><td><code>usb</code></td><td><span class="sig">SLUSBDevice usb</span></td><td class="desc">USB host controller</td></tr>
<tr><td><code>video</code></td><td><span class="sig">SLVideoCard video</span></td><td class="desc">display adapter, or null (headless)</td></tr>
<tr><td><code>configured</code></td><td><span class="sig">int configured</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String name)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>cpu</code></td><td><span class="sig">void cpu(String vendor, String model, int cores, int bits, int mhz)</span></td><td class="desc">---- CPU ---------------------------------------------------------------</td></tr>
<tr><td><code>installMemory</code></td><td><span class="sig">void installMemory(SLDDRModule module, int count)</span></td><td class="desc">---- Named parts (set from a registry lookup) --------------------------</td></tr>
<tr><td><code>installSsd</code></td><td><span class="sig">void installSsd(SLSSD drive)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>installHdd</code></td><td><span class="sig">void installHdd(SLHardDisk disk)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>installFirmware</code></td><td><span class="sig">void installFirmware(SLUEFIFirmware fw)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>installUsb</code></td><td><span class="sig">void installUsb(SLUSBDevice controller)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>installVideo</code></td><td><span class="sig">void installVideo(SLVideoCard card)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>name</code></td><td><span class="sig">String name()</span></td><td class="desc">---- Accessors ---------------------------------------------------------</td></tr>
<tr><td><code>processorVendor</code></td><td><span class="sig">String processorVendor()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>processorModel</code></td><td><span class="sig">String processorModel()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>cores</code></td><td><span class="sig">int cores()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>bits</code></td><td><span class="sig">int bits()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>mhz</code></td><td><span class="sig">int mhz()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>memoryModule</code></td><td><span class="sig">SLDDRModule memoryModule()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>moduleCount</code></td><td><span class="sig">int moduleCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>primarySsd</code></td><td><span class="sig">SLSSD primarySsd()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>primaryHdd</code></td><td><span class="sig">SLHardDisk primaryHdd()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>uefiFirmware</code></td><td><span class="sig">SLUEFIFirmware uefiFirmware()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>usbController</code></td><td><span class="sig">SLUSBDevice usbController()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>videoCard</code></td><td><span class="sig">SLVideoCard videoCard()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hasVideo</code></td><td><span class="sig">boolean hasVideo()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>bootsFromSsd</code></td><td><span class="sig">boolean bootsFromSsd()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>totalMemoryMb</code></td><td><span class="sig">int totalMemoryMb()</span></td><td class="desc">Total installed memory in MB across all modules.</td></tr>
<tr><td><code>bootCapacityBlocks</code></td><td><span class="sig">int bootCapacityBlocks()</span></td><td class="desc">The boot storage device's capacity in VM blocks (SSD preferred over HDD).</td></tr>
<tr><td><code>bootBlockBytes</code></td><td><span class="sig">int bootBlockBytes()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>bootMediaKind</code></td><td><span class="sig">int bootMediaKind()</span></td><td class="desc">Media kind for lib/cpu/SLHardDrive: 1 solid-state, 0 rotational.</td></tr>
<tr><td><code>isRunnable</code></td><td><span class="sig">boolean isRunnable()</span></td><td class="desc">A machine is runnable when it has memory, a boot device, and firmware.</td></tr>
<tr><td><code>identity</code></td><td><span class="sig">String identity()</span></td><td class="desc">A build-sheet identity line.</td></tr>
</table>
</div>
<h2 class="section" data-u="slmacos">SLMacOS <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLMacOS.sleela)</span></h2>
<div data-u="slmacos slmacos">
<h3 id="SLMacOS">SLMacOS <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isHost</code></td><td><span class="sig">boolean isHost()</span></td><td class="desc">True when the running host is actually macOS.</td></tr>
<tr><td><code>sh</code></td><td><span class="sig">int sh(String command)</span></td><td class="desc">---- Shell / Apple tools ----------------------------------------------- Run a command through /bin/sh.</td></tr>
<tr><td><code>openWith</code></td><td><span class="sig">int openWith(String target)</span></td><td class="desc">Open a file/URL/app with the default handler via the `open(1)` tool.</td></tr>
<tr><td><code>launchApp</code></td><td><span class="sig">int launchApp(String appName)</span></td><td class="desc">Launch a .app bundle by name, e.g. "Safari".</td></tr>
<tr><td><code>startSh</code></td><td><span class="sig">SLProcess startSh(String command)</span></td><td class="desc">Start a background command; returns an SLProcess.</td></tr>
<tr><td><code>home</code></td><td><span class="sig">String home()</span></td><td class="desc">---- Apple directory layout --------------------------------------------</td></tr>
<tr><td><code>library</code></td><td><span class="sig">String library()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>appSupport</code></td><td><span class="sig">String appSupport()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>preferences</code></td><td><span class="sig">String preferences()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>applications</code></td><td><span class="sig">String applications()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>system</code></td><td><span class="sig">String system()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>volumes</code></td><td><span class="sig">String volumes()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>brewPrefix</code></td><td><span class="sig">String brewPrefix()</span></td><td class="desc">Homebrew prefix: Apple Silicon uses /opt/homebrew, Intel uses /usr/local.</td></tr>
<tr><td><code>productVersion</code></td><td><span class="sig">int productVersion()</span></td><td class="desc">---- System facts via Apple CLIs --------------------------------------- Run `sw_vers` to print the macOS product version to the console.</td></tr>
<tr><td><code>readDefault</code></td><td><span class="sig">int readDefault(String domain, String key)</span></td><td class="desc">Read a defaults domain key, e.g. domain "NSGlobalDomain", key "AppleLocale".</td></tr>
<tr><td><code>exists</code></td><td><span class="sig">boolean exists(String path)</span></td><td class="desc">---- Filesystem / identity (through the real OS) ------------------------</td></tr>
<tr><td><code>tempDir</code></td><td><span class="sig">String tempDir()</span></td><td class="desc">honours TMPDIR</td></tr>
<tr><td><code>hostName</code></td><td><span class="sig">String hostName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>userName</code></td><td><span class="sig">String userName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slmacosmodel">SLMacOSModel <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLMacOSModel.sleela)</span></h2>
<div data-u="slmacosmodel slmacosmodel">
<h3 id="SLMacOSModel">SLMacOSModel <span class="pill">class</span> <span class="muted">extends <code>SLOSModel</code></span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>build</code></td><td><span class="sig">void build(String name, String ver)</span></td><td class="desc">Build a macOS-shaped model with the given product name/version on arm64.</td></tr>
<tr><td><code>buildUniversal</code></td><td><span class="sig">void buildUniversal(String name, String ver)</span></td><td class="desc">Build a universal macOS model (adds the x86_64 target alongside arm64).</td></tr>
</table>
</div>
<h2 class="section" data-u="sloperatingsystem">SLOperatingSystem <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLOperatingSystem.sleela)</span></h2>
<div data-u="sloperatingsystem sloperatingsystem">
<h3 id="SLOperatingSystem">SLOperatingSystem <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>CAP_MEMORY</code></td><td><span class="sig">static final int CAP_MEMORY = 0</span></td><td class="desc">Capability ordinals (mirror SLPlatformCapability in the VM).</td></tr>
<tr><td><code>CAP_FILE_IO</code></td><td><span class="sig">static final int CAP_FILE_IO = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>CAP_NETWORK</code></td><td><span class="sig">static final int CAP_NETWORK = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>CAP_THREADS</code></td><td><span class="sig">static final int CAP_THREADS = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>CAP_LIBRARY</code></td><td><span class="sig">static final int CAP_LIBRARY = 4</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>CAP_TERMINAL</code></td><td><span class="sig">static final int CAP_TERMINAL= 5</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>CAP_PATHS</code></td><td><span class="sig">static final int CAP_PATHS = 6</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>CAP_PROCESS</code></td><td><span class="sig">static final int CAP_PROCESS = 7</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>CAP_IPC</code></td><td><span class="sig">static final int CAP_IPC = 8</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>CAP_TIME</code></td><td><span class="sig">static final int CAP_TIME = 9</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>name</code></td><td><span class="sig">String name</span></td><td class="desc">human label chosen by the caller</td></tr>
<tr><td><code>opened</code></td><td><span class="sig">int opened</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String label)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>open</code></td><td><span class="sig">void open()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>close</code></td><td><span class="sig">void close()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>active</code></td><td><span class="sig">boolean active()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>platform</code></td><td><span class="sig">String platform()</span></td><td class="desc">---- Identity ----------------------------------------------------------- The host OS name as reported by the VM: "Windows", "Linux", or "macOS".</td></tr>
<tr><td><code>isWindows</code></td><td><span class="sig">boolean isWindows()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isLinux</code></td><td><span class="sig">boolean isLinux()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isMac</code></td><td><span class="sig">boolean isMac()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hostName</code></td><td><span class="sig">String hostName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>userName</code></td><td><span class="sig">String userName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>processId</code></td><td><span class="sig">int processId()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>supports</code></td><td><span class="sig">boolean supports(int capability)</span></td><td class="desc">True if the host advertises a capability class (process/ipc/network/...).</td></tr>
<tr><td><code>getEnv</code></td><td><span class="sig">String getEnv(String key)</span></td><td class="desc">---- Environment --------------------------------------------------------</td></tr>
<tr><td><code>setEnv</code></td><td><span class="sig">boolean setEnv(String key, String value)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>currentDir</code></td><td><span class="sig">String currentDir()</span></td><td class="desc">---- Working directory --------------------------------------------------</td></tr>
<tr><td><code>changeDir</code></td><td><span class="sig">boolean changeDir(String path)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>tempDir</code></td><td><span class="sig">String tempDir()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>run</code></td><td><span class="sig">int run(String command)</span></td><td class="desc">---- Process execution -------------------------------------------------- Run a shell command synchronously; returns its exit code (0 == success).</td></tr>
<tr><td><code>runOk</code></td><td><span class="sig">boolean runOk(String command)</span></td><td class="desc">True if the command ran and exited 0.</td></tr>
<tr><td><code>equalsString</code></td><td><span class="sig">boolean equalsString(String a, String b)</span></td><td class="desc">String equality helper (SLeeLa compares value by ==, but keep intent clear).</td></tr>
</table>
</div>
<h2 class="section" data-u="slosarchitecture">SLOSArchitecture <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLOSArchitecture.sleela)</span></h2>
<div data-u="slosarchitecture slosarchitecture">
<h3 id="SLOSArchitecture">SLOSArchitecture <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>triple</code></td><td><span class="sig">String triple</span></td><td class="desc">LLVM-style target triple</td></tr>
<tr><td><code>packageArch</code></td><td><span class="sig">String packageArch</span></td><td class="desc">distro package arch label (amd64/arm64/...)</td></tr>
<tr><td><code>wordBits</code></td><td><span class="sig">int wordBits</span></td><td class="desc">32 or 64</td></tr>
<tr><td><code>littleEndian</code></td><td><span class="sig">int littleEndian</span></td><td class="desc">1 little, 0 big</td></tr>
<tr><td><code>configured</code></td><td><span class="sig">int configured</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>amd64</code></td><td><span class="sig">void amd64()</span></td><td class="desc">---- Presets ------------------------------------------------------------</td></tr>
<tr><td><code>arm64</code></td><td><span class="sig">void arm64()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>armhf</code></td><td><span class="sig">void armhf()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ppc64el</code></td><td><span class="sig">void ppc64el()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>s390x</code></td><td><span class="sig">void s390x()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>riscv64</code></td><td><span class="sig">void riscv64()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>x86</code></td><td><span class="sig">void x86()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String arch)</span></td><td class="desc">Choose by package-arch label; defaults to amd64.</td></tr>
<tr><td><code>retargetForShape</code></td><td><span class="sig">void retargetForShape(SLOSShape shape)</span></td><td class="desc">Re-triple for a non-Linux shape so the triple reflects the target OS.</td></tr>
<tr><td><code>targetTriple</code></td><td><span class="sig">String targetTriple()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>arch</code></td><td><span class="sig">String arch()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>bits</code></td><td><span class="sig">int bits()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isLittleEndian</code></td><td><span class="sig">boolean isLittleEndian()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slosartifact">SLOSArtifact <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLOSArtifact.sleela)</span></h2>
<div data-u="slosartifact slosartifact">
<h3 id="SLOSArtifact">SLOSArtifact <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>KIND_C_HEADER</code></td><td><span class="sig">static final int KIND_C_HEADER = 0</span></td><td class="desc">Kind tags.</td></tr>
<tr><td><code>KIND_C_SOURCE</code></td><td><span class="sig">static final int KIND_C_SOURCE = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>KIND_CPP_SOURCE</code></td><td><span class="sig">static final int KIND_CPP_SOURCE = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>KIND_SCRIPT</code></td><td><span class="sig">static final int KIND_SCRIPT = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>KIND_ISO</code></td><td><span class="sig">static final int KIND_ISO = 4</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>KIND_MANIFEST</code></td><td><span class="sig">static final int KIND_MANIFEST = 5</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>path</code></td><td><span class="sig">String path</span></td><td class="desc">logical output path</td></tr>
<tr><td><code>kind</code></td><td><span class="sig">int kind</span></td><td class="desc">one of KIND_*</td></tr>
<tr><td><code>contents</code></td><td><span class="sig">String contents</span></td><td class="desc">text (source/script/manifest) or ISO descriptor</td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String outPath, int artifactKind, String text)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>outputPath</code></td><td><span class="sig">String outputPath()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>artifactKind</code></td><td><span class="sig">int artifactKind()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>text</code></td><td><span class="sig">String text()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>byteCount</code></td><td><span class="sig">int byteCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>kindName</code></td><td><span class="sig">String kindName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slosbuildreport">SLOSBuildReport <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLOSBuildReport.sleela)</span></h2>
<div data-u="slosbuildreport slosbuildreport">
<h3 id="SLOSBuildReport">SLOSBuildReport <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>identity</code></td><td><span class="sig">String identity</span></td><td class="desc">the model identity this build is for</td></tr>
<tr><td><code>index</code></td><td><span class="sig">String index</span></td><td class="desc">newline-separated "kind size path" lines</td></tr>
<tr><td><code>artifactCount</code></td><td><span class="sig">int artifactCount</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ok</code></td><td><span class="sig">int ok</span></td><td class="desc">1 if the build completed without a failure</td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String modelIdentity)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>record</code></td><td><span class="sig">void record(SLOSArtifact a)</span></td><td class="desc">Record one produced artifact.</td></tr>
<tr><td><code>fail</code></td><td><span class="sig">void fail()</span></td><td class="desc">Mark the build as failed (e.g. an unbuildable model).</td></tr>
<tr><td><code>succeeded</code></td><td><span class="sig">boolean succeeded()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>count</code></td><td><span class="sig">int count()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>artifactIndex</code></td><td><span class="sig">String artifactIndex()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>modelIdentity</code></td><td><span class="sig">String modelIdentity()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>summary</code></td><td><span class="sig">String summary()</span></td><td class="desc">A one-line human summary.</td></tr>
<tr><td><code>intToStr</code></td><td><span class="sig">String intToStr(int v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="sloscompiler">SLOSCompiler <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLOSCompiler.sleela)</span></h2>
<div data-u="sloscompiler sloscompiler">
<h3 id="SLOSCompiler">SLOSCompiler <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>cEmit</code></td><td><span class="sig">SLCEmitter cEmit</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>cppEmit</code></td><td><span class="sig">SLCppEmitter cppEmit</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>report</code></td><td><span class="sig">SLOSBuildReport report</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>configHeader</code></td><td><span class="sig">SLOSArtifact configHeader</span></td><td class="desc">The artifacts of the most recent compile (held for the caller to persist).</td></tr>
<tr><td><code>bootUnit</code></td><td><span class="sig">SLOSArtifact bootUnit</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>osImage</code></td><td><span class="sig">SLOSArtifact osImage</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>compile</code></td><td><span class="sig">SLOSBuildReport compile(SLOSModel m)</span></td><td class="desc">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.</td></tr>
<tr><td><code>compileToIso</code></td><td><span class="sig">SLOSBuildReport compileToIso(SLOSModel m)</span></td><td class="desc">Compile the model, then build its ISO and generate its installer in one call. The returned report indexes every artifact across all three stages.</td></tr>
<tr><td><code>header</code></td><td><span class="sig">SLOSArtifact header()</span></td><td class="desc">---- Accessors to the most recent compile's artifacts -------------------</td></tr>
<tr><td><code>boot</code></td><td><span class="sig">SLOSArtifact boot()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>image</code></td><td><span class="sig">SLOSArtifact image()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>lastReport</code></td><td><span class="sig">SLOSBuildReport lastReport()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="sloscreator">SLOSCreator <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/os-creator/SLOSCreator.sleela)</span></h2>
<div data-u="sloscreator sloscreator">
<h3 id="SLOSCreator">SLOSCreator <span class="pill">class</span></h3>
<p class="desc">Defines SLOSCreator — the OS Creator(TM) provider: the single</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>uefi</code></td><td><span class="sig">SLUEFIEmitter uefi</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>bios</code></td><td><span class="sig">SLBIOSEmitter bios</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>bootLoader</code></td><td><span class="sig">SLBootLoaderEmitter bootLoader</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>kernelLoader</code></td><td><span class="sig">SLKernelLoaderEmitter kernelLoader</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>driverLoader</code></td><td><span class="sig">SLDriverLoaderEmitter driverLoader</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>osLoader</code></td><td><span class="sig">SLOSLoaderEmitter osLoader</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>desktopLoader</code></td><td><span class="sig">SLDesktopLoaderEmitter desktopLoader</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>compatLoader</code></td><td><span class="sig">SLCompatLoaderEmitter compatLoader</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>baseDriverEmit</code></td><td><span class="sig">SLBaseDriverEmitter baseDriverEmit</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>cEmit</code></td><td><span class="sig">SLCEmitter cEmit</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>cppEmit</code></td><td><span class="sig">SLCppEmitter cppEmit</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>toolchain</code></td><td><span class="sig">SLToolchainEmitter toolchain</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>dropper</code></td><td><span class="sig">SLSourceDropper dropper</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>tree</code></td><td><span class="sig">SLOSDevTree tree</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>create</code></td><td><span class="sig">SLOSBuildReport create(SLOSModel m, String root)</span></td><td class="desc">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.</td></tr>
<tr><td><code>downloadsConf</code></td><td><span class="sig">String downloadsConf(SLOSModel m)</span></td><td class="desc">The resolved download URLs for the model, as a conf header + the set's manifest ("<kind> <phase> <url>" lines from SLDownloadSet).</td></tr>
<tr><td><code>plan</code></td><td><span class="sig">String plan(SLOSModel m)</span></td><td class="desc">plan() returns a human description of what create() would write, without touching the filesystem — useful for a dry run.</td></tr>
<tr><td><code>writePiece</code></td><td><span class="sig">void writePiece(SLOSPiece p, SLOSBuildReport report)</span></td><td class="desc">Write a piece and record each of its files in the report.</td></tr>
<tr><td><code>recordWrite</code></td><td><span class="sig">void recordWrite(SLOSBuildReport report, String path, int bytes)</span></td><td class="desc">Record a direct writeFile result in the report when the write succeeded.</td></tr>
<tr><td><code>sourceArtifact</code></td><td><span class="sig">SLOSArtifact sourceArtifact(String path)</span></td><td class="desc">Build a lightweight artifact handle for the report index.</td></tr>
<tr><td><code>devTree</code></td><td><span class="sig">SLOSDevTree devTree()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slosdevtree">SLOSDevTree <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/os-creator/SLOSDevTree.sleela)</span></h2>
<div data-u="slosdevtree slosdevtree">
<h3 id="SLOSDevTree">SLOSDevTree <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>root</code></td><td><span class="sig">String root</span></td><td class="desc">absolute output root, e.g. "/os-development"</td></tr>
<tr><td><code>manifest</code></td><td><span class="sig">String manifest</span></td><td class="desc">newline-separated "bytes path" index</td></tr>
<tr><td><code>fileCount</code></td><td><span class="sig">int fileCount</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>configured</code></td><td><span class="sig">int configured</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String outputRoot)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>layout</code></td><td><span class="sig">int layout(boolean withDesktop)</span></td><td class="desc">Create the standard /os-development subtree. Returns 1 on success. Existing directories are tolerated (osMakeDir is idempotent-friendly in the bridge).</td></tr>
<tr><td><code>makeDir</code></td><td><span class="sig">int makeDir(String rel)</span></td><td class="desc">Make one directory relative to the root (relative "" makes the root itself).</td></tr>
<tr><td><code>writeFile</code></td><td><span class="sig">int writeFile(String rel, String contents)</span></td><td class="desc">Write one file relative to the root, creating/truncating it. Records the write in the manifest. Returns the byte count written (-1 on failure).</td></tr>
<tr><td><code>writePiece</code></td><td><span class="sig">void writePiece(SLOSPiece p)</span></td><td class="desc">Write every file an SLOSPiece carries into the piece's subtree.</td></tr>
<tr><td><code>recordFile</code></td><td><span class="sig">void recordFile(String rel, int bytes)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>writeManifest</code></td><td><span class="sig">int writeManifest(String identityLine)</span></td><td class="desc">Finalise the tree: write MANIFEST.md listing everything produced.</td></tr>
<tr><td><code>outputRoot</code></td><td><span class="sig">String outputRoot()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>filesWritten</code></td><td><span class="sig">int filesWritten()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>fileIndex</code></td><td><span class="sig">String fileIndex()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>intToStr</code></td><td><span class="sig">String intToStr(int v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slosloaderemitter">SLOSLoaderEmitter <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/os-creator/SLOSLoaderEmitter.sleela)</span></h2>
<div data-u="slosloaderemitter slosloaderemitter">
<h3 id="SLOSLoaderEmitter">SLOSLoaderEmitter <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>emit</code></td><td><span class="sig">SLOSPiece emit(SLOSModel m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>emitServiceStarts</code></td><td><span class="sig">String emitServiceStarts(String units)</span></td><td class="desc">One start_service() call per boot-mode unit in the manifest.</td></tr>
<tr><td><code>bootUnitList</code></td><td><span class="sig">String bootUnitList(String units)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>nameOf</code></td><td><span class="sig">String nameOf(String line)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>modeOf</code></td><td><span class="sig">String modeOf(String line)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>strLen</code></td><td><span class="sig">int strLen(String s)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>substr</code></td><td><span class="sig">String substr(String s, int a, int b)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>charAt</code></td><td><span class="sig">String charAt(String s, int i)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>boolLit</code></td><td><span class="sig">String boolLit(boolean b)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slosmodel">SLOSModel <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLOSModel.sleela)</span></h2>
<div data-u="slosmodel slosmodel">
<h3 id="SLOSModel">SLOSModel <span class="pill">class</span></h3>
<p class="desc">Defines SLOSModel — the root aggregate of the OS-construction</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>osName</code></td><td><span class="sig">String osName</span></td><td class="desc">product name, e.g. "Determinant"</td></tr>
<tr><td><code>edition</code></td><td><span class="sig">String edition</span></td><td class="desc">"Desktop" / "Server"</td></tr>
<tr><td><code>version</code></td><td><span class="sig">String version</span></td><td class="desc">product version</td></tr>
<tr><td><code>shape</code></td><td><span class="sig">SLOSShape shape</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>arches</code></td><td><span class="sig">SLArchitectureSet arches</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>boot</code></td><td><span class="sig">SLBootloaderSpec boot</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>kernel</code></td><td><span class="sig">SLKernelSpec kernel</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>filesystem</code></td><td><span class="sig">SLFilesystemLayout filesystem</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>swap</code></td><td><span class="sig">SLSwapConfig swap</span></td><td class="desc">swap/paging kind + quality</td></tr>
<tr><td><code>baseDrivers</code></td><td><span class="sig">SLBaseDriverSeries baseDrivers</span></td><td class="desc">minimum-boot driver series</td></tr>
<tr><td><code>driverSource</code></td><td><span class="sig">SLDriverSource driverSource</span></td><td class="desc">driver provenance/trust + cross-OS bridge</td></tr>
<tr><td><code>drivers</code></td><td><span class="sig">SLDriverSet drivers</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>packages</code></td><td><span class="sig">SLPackageSet packages</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>services</code></td><td><span class="sig">SLServiceSet services</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>desktop</code></td><td><span class="sig">SLDesktopSpec desktop</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>compat</code></td><td><span class="sig">SLCompatSet compat</span></td><td class="desc">foreign-OS execution capability (optional layer)</td></tr>
<tr><td><code>downloads</code></td><td><span class="sig">SLDownloadSet downloads</span></td><td class="desc">URLs for related downloads (pre-compile / pre-ISO)</td></tr>
<tr><td><code>configFiles</code></td><td><span class="sig">SLConfigSet configFiles</span></td><td class="desc">the settings files that must be present pre-build</td></tr>
<tr><td><code>configured</code></td><td><span class="sig">int configured</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String name, String ver)</span></td><td class="desc">Begin a model with a product name and version. Layers are created empty; call shape(...) to populate them with a family's defaults.</td></tr>
<tr><td><code>shapeAs</code></td><td><span class="sig">void shapeAs(String family, String primaryArch)</span></td><td class="desc">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.</td></tr>
<tr><td><code>asServer</code></td><td><span class="sig">void asServer()</span></td><td class="desc">Mark this as a server edition: drop the desktop layer.</td></tr>
<tr><td><code>osShape</code></td><td><span class="sig">SLOSShape osShape()</span></td><td class="desc">---- Accessors for the layers (for refinement and emission) -------------</td></tr>
<tr><td><code>architectures</code></td><td><span class="sig">SLArchitectureSet architectures()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>bootloader</code></td><td><span class="sig">SLBootloaderSpec bootloader()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>kernelSpec</code></td><td><span class="sig">SLKernelSpec kernelSpec()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>layout</code></td><td><span class="sig">SLFilesystemLayout layout()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>swapConfig</code></td><td><span class="sig">SLSwapConfig swapConfig()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>baseDriverSeries</code></td><td><span class="sig">SLBaseDriverSeries baseDriverSeries()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>driverPolicy</code></td><td><span class="sig">SLDriverSource driverPolicy()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>driverSet</code></td><td><span class="sig">SLDriverSet driverSet()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>fsCatalog</code></td><td><span class="sig">SLFilesystemCatalog fsCatalog()</span></td><td class="desc">The filesystem (file-table) type catalogue — a fresh reference helper for choosing/validating a filesystem format (FAT/NTFS/ext4/APFS/...).</td></tr>
<tr><td><code>packageSet</code></td><td><span class="sig">SLPackageSet packageSet()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>serviceSet</code></td><td><span class="sig">SLServiceSet serviceSet()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>desktopSpec</code></td><td><span class="sig">SLDesktopSpec desktopSpec()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>compatSet</code></td><td><span class="sig">SLCompatSet compatSet()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>downloadSet</code></td><td><span class="sig">SLDownloadSet downloadSet()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>configSet</code></td><td><span class="sig">SLConfigSet configSet()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>name</code></td><td><span class="sig">String name()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>osVersion</code></td><td><span class="sig">String osVersion()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>osEdition</code></td><td><span class="sig">String osEdition()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isBuildable</code></td><td><span class="sig">boolean isBuildable()</span></td><td class="desc">---- Validity: can this model be built into a bootable OS? -------------- Every irreducible layer must be present and self-consistent.</td></tr>
<tr><td><code>readyToCompile</code></td><td><span class="sig">boolean readyToCompile()</span></td><td class="desc">---- 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.</td></tr>
<tr><td><code>readyForIso</code></td><td><span class="sig">boolean readyForIso()</span></td><td class="desc">Before the final ISO conversion, additionally the ISO-phase downloads (firmware, runtime payloads) and settings (services, swap) must be ready.</td></tr>
<tr><td><code>identity</code></td><td><span class="sig">String identity()</span></td><td class="desc">A short, human-readable identity line for logs and ISO volume labels.</td></tr>
</table>
</div>
<h2 class="section" data-u="slosnativesubsystem">SLOSNativeSubsystem <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLOSNativeSubsystem.sleela)</span></h2>
<div data-u="slosnativesubsystem slosnativesubsystem">
<h3 id="SLOSNativeSubsystem">SLOSNativeSubsystem <span class="pill">class</span></h3>
<p class="desc">Defines SLOSNativeSubsystem -- the SLeeLa-facing handle to the</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>library</code></td><td><span class="sig">String library</span></td><td class="desc">the static library the /os subsystem builds to</td></tr>
<tr><td><code>configured</code></td><td><span class="sig">int configured</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>libraryName</code></td><td><span class="sig">String libraryName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>headerFor</code></td><td><span class="sig">String headerFor(String capability)</span></td><td class="desc">---- 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).</td></tr>
<tr><td><code>provides</code></td><td><span class="sig">boolean provides(String capability)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>theSLeeLa</code></td><td><span class="sig">String theSLeeLa(String capability)</span></td><td class="desc">theSLeeLa(capability): the lib/os SLeeLa class that USES this native capability across the os* bridge, so the two halves are paired.</td></tr>
<tr><td><code>capabilityCount</code></td><td><span class="sig">int capabilityCount()</span></td><td class="desc">Number of executive capabilities backed by the native subsystem.</td></tr>
<tr><td><code>contractSheet</code></td><td><span class="sig">String contractSheet()</span></td><td class="desc">A newline-separated contract sheet a tool or README can print.</td></tr>
</table>
</div>
<h2 class="section" data-u="slospiece">SLOSPiece <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/os-creator/SLOSPiece.sleela)</span></h2>
<div data-u="slospiece slospiece">
<h3 id="SLOSPiece">SLOSPiece <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>name</code></td><td><span class="sig">String name</span></td><td class="desc">human name, e.g. "Boot Loader"</td></tr>
<tr><td><code>directory</code></td><td><span class="sig">String directory</span></td><td class="desc">tree-relative dir, e.g. "boot/loader"</td></tr>
<tr><td><code>baseName</code></td><td><span class="sig">String baseName</span></td><td class="desc">file stem, e.g. "bootloader"</td></tr>
<tr><td><code>cSource</code></td><td><span class="sig">String cSource</span></td><td class="desc">the .c surface</td></tr>
<tr><td><code>cppSource</code></td><td><span class="sig">String cppSource</span></td><td class="desc">the .cpp surface</td></tr>
<tr><td><code>configName</code></td><td><span class="sig">String configName</span></td><td class="desc">config file name, e.g. "loader.conf"</td></tr>
<tr><td><code>configText</code></td><td><span class="sig">String configText</span></td><td class="desc">config file contents</td></tr>
<tr><td><code>readme</code></td><td><span class="sig">String readme</span></td><td class="desc">per-piece README.md contents</td></tr>
<tr><td><code>configured</code></td><td><span class="sig">int configured</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String pieceName, String dir, String stem)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setC</code></td><td><span class="sig">void setC(String src)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setCpp</code></td><td><span class="sig">void setCpp(String src)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setConfig</code></td><td><span class="sig">void setConfig(String fileName, String text)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setReadme</code></td><td><span class="sig">void setReadme(String text)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>cPath</code></td><td><span class="sig">String cPath()</span></td><td class="desc">---- Derived file paths (relative to the dev-tree root) -----------------</td></tr>
<tr><td><code>cppPath</code></td><td><span class="sig">String cppPath()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>configPath</code></td><td><span class="sig">String configPath()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>readmePath</code></td><td><span class="sig">String readmePath()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>pieceName</code></td><td><span class="sig">String pieceName()</span></td><td class="desc">---- Accessors ----------------------------------------------------------</td></tr>
<tr><td><code>dir</code></td><td><span class="sig">String dir()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>c</code></td><td><span class="sig">String c()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>cpp</code></td><td><span class="sig">String cpp()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>config</code></td><td><span class="sig">String config()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>configFile</code></td><td><span class="sig">String configFile()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>readmeText</code></td><td><span class="sig">String readmeText()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hasConfig</code></td><td><span class="sig">boolean hasConfig()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hasReadme</code></td><td><span class="sig">boolean hasReadme()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slossensitivityfetch">SLOSSensitivityFetch <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLOSSensitivityFetch.sleela)</span></h2>
<div data-u="slossensitivityfetch slossensitivityfetch">
<h3 id="SLOSSensitivityFetch">SLOSSensitivityFetch <span class="pill">class</span></h3>
<p class="desc">Defines SLOSSensitivityFetch -- the OPT-IN, per-user downloader</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>MODE_SHALLOW</code></td><td><span class="sig">static final int MODE_SHALLOW = 0</span></td><td class="desc">Fetch depth/mode tags. --depth 1 --single-branch (default)</td></tr>
<tr><td><code>MODE_FULL</code></td><td><span class="sig">static final int MODE_FULL = 1</span></td><td class="desc">full history</td></tr>
<tr><td><code>src</code></td><td><span class="sig">SLOSSensitivitySource src</span></td><td class="desc">the reference (field; wired by configure())</td></tr>
<tr><td><code>mode</code></td><td><span class="sig">int mode</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>lastExit</code></td><td><span class="sig">int lastExit</span></td><td class="desc">exit code of the most recent fetch (-1 if none run)</td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>useSource</code></td><td><span class="sig">void useSource(SLOSSensitivitySource source)</span></td><td class="desc">Point at a specific reference instead of the default.</td></tr>
<tr><td><code>setMode</code></td><td><span class="sig">void setMode(int m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>source</code></td><td><span class="sig">SLOSSensitivitySource source()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>cloneCommand</code></td><td><span class="sig">String cloneCommand(String destDir)</span></td><td class="desc">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).</td></tr>
<tr><td><code>pinCommand</code></td><td><span class="sig">String pinCommand(String destDir)</span></td><td class="desc">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.</td></tr>
<tr><td><code>fetch</code></td><td><span class="sig">int fetch(String destRoot, boolean force)</span></td><td class="desc">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.</td></tr>
<tr><td><code>fetchShallow</code></td><td><span class="sig">int fetchShallow(String destRoot)</span></td><td class="desc">Convenience: shallow fetch (the safe default).</td></tr>
<tr><td><code>fetchComplete</code></td><td><span class="sig">int fetchComplete(String destRoot)</span></td><td class="desc">Convenience: full fetch pinned to the reference commit.</td></tr>
<tr><td><code>lastExitCode</code></td><td><span class="sig">int lastExitCode()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>succeeded</code></td><td><span class="sig">boolean succeeded()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>probe</code></td><td><span class="sig">int probe()</span></td><td class="desc">Verify the warehouse is reachable without downloading it (git ls-remote). Returns 0 when the branch is resolvable. Cheap pre-flight for a GUI.</td></tr>
<tr><td><code>shapePath</code></td><td><span class="sig">String shapePath(String destRoot, String shape)</span></td><td class="desc">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.</td></tr>
<tr><td><code>componentPath</code></td><td><span class="sig">String componentPath(String destRoot, String shape, String component)</span></td><td class="desc">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.</td></tr>
<tr><td><code>descriptorPath</code></td><td><span class="sig">String descriptorPath(String destRoot)</span></td><td class="desc">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.</td></tr>
</table>
</div>
<h2 class="section" data-u="slossensitivitysource">SLOSSensitivitySource <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLOSSensitivitySource.sleela)</span></h2>
<div data-u="slossensitivitysource slossensitivitysource">
<h3 id="SLOSSensitivitySource">SLOSSensitivitySource <span class="pill">class</span></h3>
<p class="desc">Defines SLOSSensitivitySource -- the zero-payload REFERENCE to</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>name</code></td><td><span class="sig">String name</span></td><td class="desc">Warehouse identity.</td></tr>
<tr><td><code>owner</code></td><td><span class="sig">String owner</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>repo</code></td><td><span class="sig">String repo</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>url</code></td><td><span class="sig">String url</span></td><td class="desc">https clone URL</td></tr>
<tr><td><code>branch</code></td><td><span class="sig">String branch</span></td><td class="desc">default branch</td></tr>
<tr><td><code>pinnedCommit</code></td><td><span class="sig">String pinnedCommit</span></td><td class="desc">exact revision for reproducible fetches</td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc">Configure with the known OS.Sensitivity.III warehouse reference. The pinned commit is the current main tip; callers may repin with pin(commit).</td></tr>
<tr><td><code>descriptorFile</code></td><td><span class="sig">String descriptorFile()</span></td><td class="desc">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.</td></tr>
<tr><td><code>descriptorPath</code></td><td><span class="sig">String descriptorPath(String destRoot)</span></td><td class="desc">On-disk path to the descriptor after a fetch into destRoot.</td></tr>
<tr><td><code>pin</code></td><td><span class="sig">void pin(String commit)</span></td><td class="desc">Repin to a specific revision (keeps fetches reproducible).</td></tr>
<tr><td><code>identity</code></td><td><span class="sig">String identity()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>cloneUrl</code></td><td><span class="sig">String cloneUrl()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>defaultBranch</code></td><td><span class="sig">String defaultBranch()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>commit</code></td><td><span class="sig">String commit()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>shapeDir</code></td><td><span class="sig">String shapeDir(String shape)</span></td><td class="desc">---- 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.</td></tr>
<tr><td><code>providesShape</code></td><td><span class="sig">boolean providesShape(String shape)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>componentDir</code></td><td><span class="sig">String componentDir(String component)</span></td><td class="desc">---- 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.</td></tr>
<tr><td><code>providesComponent</code></td><td><span class="sig">boolean providesComponent(String component)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>shapeComponentDir</code></td><td><span class="sig">String shapeComponentDir(String shape, String component)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>providesShapeComponent</code></td><td><span class="sig">boolean providesShapeComponent(String shape, String component)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>dirFor</code></td><td><span class="sig">String dirFor(String shape, String component)</span></td><td class="desc">dirFor(shape, component): the warehouse path "<shape>/<component>", or "" if either the shape or the component is unknown.</td></tr>
<tr><td><code>downloadabilityNote</code></td><td><span class="sig">String downloadabilityNote(String part)</span></td><td class="desc">---- 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.</td></tr>
<tr><td><code>referenceSheet</code></td><td><span class="sig">String referenceSheet()</span></td><td class="desc">A newline-separated reference sheet a tool or README can print.</td></tr>
</table>
</div>
<h2 class="section" data-u="slosshape">SLOSShape <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLOSShape.sleela)</span></h2>
<div data-u="slosshape slosshape">
<h3 id="SLOSShape">SLOSShape <span class="pill">class</span></h3>
<p class="desc">Defines SLOSShape — the design-time "shape" an OS being</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>SHAPE_LINUX</code></td><td><span class="sig">static final int SHAPE_LINUX = 0</span></td><td class="desc">Canonical shape ordinals.</td></tr>
<tr><td><code>SHAPE_WINDOWS</code></td><td><span class="sig">static final int SHAPE_WINDOWS = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SHAPE_MACOS</code></td><td><span class="sig">static final int SHAPE_MACOS = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>shape</code></td><td><span class="sig">int shape</span></td><td class="desc">one of SHAPE_*</td></tr>
<tr><td><code>label</code></td><td><span class="sig">String label</span></td><td class="desc">"Linux" / "Windows" / "macOS"</td></tr>
<tr><td><code>configured</code></td><td><span class="sig">int configured</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>linux</code></td><td><span class="sig">void linux()</span></td><td class="desc">---- Construction -------------------------------------------------------</td></tr>
<tr><td><code>windows</code></td><td><span class="sig">void windows()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>macos</code></td><td><span class="sig">void macos()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String name)</span></td><td class="desc">Choose by name; defaults to Linux for an unrecognised label.</td></tr>
<tr><td><code>isLinux</code></td><td><span class="sig">boolean isLinux()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isWindows</code></td><td><span class="sig">boolean isWindows()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isMac</code></td><td><span class="sig">boolean isMac()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ordinal</code></td><td><span class="sig">int ordinal()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>name</code></td><td><span class="sig">String name()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>pathSeparator</code></td><td><span class="sig">String pathSeparator()</span></td><td class="desc">---- Per-family defaults the composed specs read ----------------------- The path separator convention for this shape.</td></tr>
<tr><td><code>listSeparator</code></td><td><span class="sig">String listSeparator()</span></td><td class="desc">The PATH-list separator convention for this shape.</td></tr>
<tr><td><code>initManager</code></td><td><span class="sig">String initManager()</span></td><td class="desc">The name of the first user-space process / service manager.</td></tr>
<tr><td><code>bootStyle</code></td><td><span class="sig">String bootStyle()</span></td><td class="desc">The default firmware/boot style for this shape.</td></tr>
<tr><td><code>rootFilesystem</code></td><td><span class="sig">String rootFilesystem()</span></td><td class="desc">The default root-filesystem format for this shape.</td></tr>
<tr><td><code>desktopSession</code></td><td><span class="sig">String desktopSession()</span></td><td class="desc">The default desktop/session shell for this shape.</td></tr>
<tr><td><code>systemRoot</code></td><td><span class="sig">String systemRoot()</span></td><td class="desc">The conventional system-root directory for this shape.</td></tr>
<tr><td><code>executableExtension</code></td><td><span class="sig">String executableExtension()</span></td><td class="desc">The conventional installed-executable extension for this shape.</td></tr>
</table>
</div>
<h2 class="section" data-u="slpackageset">SLPackageSet <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLPackageSet.sleela)</span></h2>
<div data-u="slpackageset slpackageset">
<h3 id="SLPackageSet">SLPackageSet <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>manifest</code></td><td><span class="sig">String manifest</span></td><td class="desc">newline-separated "name version" lines</td></tr>
<tr><td><code>count</code></td><td><span class="sig">int count</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>configured</code></td><td><span class="sig">int configured</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>add</code></td><td><span class="sig">void add(String name, String version)</span></td><td class="desc">Add a package with an explicit version.</td></tr>
<tr><td><code>addLatest</code></td><td><span class="sig">void addLatest(String name)</span></td><td class="desc">Add a package at an unpinned/"latest" version.</td></tr>
<tr><td><code>baseSeedForShape</code></td><td><span class="sig">void baseSeedForShape(SLOSShape shape)</span></td><td class="desc">Seed the base-system packages a shape needs before any layering.</td></tr>
<tr><td><code>packages</code></td><td><span class="sig">String packages()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>packageCount</code></td><td><span class="sig">int packageCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isEmpty</code></td><td><span class="sig">boolean isEmpty()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slpath">SLPath <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLPath.sleela)</span></h2>
<div data-u="slpath slpath">
<h3 id="SLPath">SLPath <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>value</code></td><td><span class="sig">String value</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String p)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>text</code></td><td><span class="sig">String text()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>separator</code></td><td><span class="sig">String separator()</span></td><td class="desc">The host path separator: "\\" on Windows, "/" elsewhere.</td></tr>
<tr><td><code>listSeparator</code></td><td><span class="sig">String listSeparator()</span></td><td class="desc">The host entry (PATH) separator: ";" on Windows, ":" elsewhere.</td></tr>
<tr><td><code>join</code></td><td><span class="sig">String join(String child)</span></td><td class="desc">Join a child segment onto this path using the host separator; returns the combined path text.</td></tr>
<tr><td><code>append</code></td><td><span class="sig">String append(String child)</span></td><td class="desc">Append in place and return the new path text.</td></tr>
<tr><td><code>joinList</code></td><td><span class="sig">String joinList(String a, String b)</span></td><td class="desc">Build a PATH-style list string from two entries using the host list separator (";" on Windows, ":" elsewhere).</td></tr>
<tr><td><code>exists</code></td><td><span class="sig">boolean exists()</span></td><td class="desc">True when this path exists on the host filesystem.</td></tr>
</table>
</div>
<h2 class="section" data-u="slpermissions">SLPermissions <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLPermissions.sleela)</span></h2>
<div data-u="slpermissions slpermissions">
<h3 id="SLPermissions">SLPermissions <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>path</code></td><td><span class="sig">String path</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String p)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>exists</code></td><td><span class="sig">boolean exists()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>readable</code></td><td><span class="sig">boolean readable()</span></td><td class="desc">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.</td></tr>
<tr><td><code>writable</code></td><td><span class="sig">boolean writable()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>executable</code></td><td><span class="sig">boolean executable()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>posixModel</code></td><td><span class="sig">boolean posixModel()</span></td><td class="desc">Whether the host uses the POSIX mode-bit model (vs. Windows ACLs).</td></tr>
</table>
</div>
<h2 class="section" data-u="slprocess">SLProcess <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLProcess.sleela)</span></h2>
<div data-u="slprocess slprocess">
<h3 id="SLProcess">SLProcess <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>STATE_NEW</code></td><td><span class="sig">static final int STATE_NEW = 0</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>STATE_RUNNING</code></td><td><span class="sig">static final int STATE_RUNNING = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>STATE_EXITED</code></td><td><span class="sig">static final int STATE_EXITED = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>STATE_FAILED</code></td><td><span class="sig">static final int STATE_FAILED = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>command</code></td><td><span class="sig">String command</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>handle</code></td><td><span class="sig">int handle</span></td><td class="desc">VM-local process handle (-1 = none)</td></tr>
<tr><td><code>state</code></td><td><span class="sig">int state</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>exitCode</code></td><td><span class="sig">int exitCode</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String cmd)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>runSync</code></td><td><span class="sig">int runSync()</span></td><td class="desc">Run synchronously: block until the process exits, recording the exit code. Returns the exit code (0 == success).</td></tr>
<tr><td><code>start</code></td><td><span class="sig">boolean start()</span></td><td class="desc">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()).</td></tr>
<tr><td><code>wait</code></td><td><span class="sig">int wait()</span></td><td class="desc">Block for a started process and collect its exit code; releases the handle.</td></tr>
<tr><td><code>kill</code></td><td><span class="sig">boolean kill()</span></td><td class="desc">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.</td></tr>
<tr><td><code>close</code></td><td><span class="sig">void close()</span></td><td class="desc">Release a started-but-unwaited process without blocking.</td></tr>
<tr><td><code>running</code></td><td><span class="sig">boolean running()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>succeeded</code></td><td><span class="sig">boolean succeeded()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>status</code></td><td><span class="sig">int status()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>processState</code></td><td><span class="sig">int processState()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slserviceset">SLServiceSet <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLServiceSet.sleela)</span></h2>
<div data-u="slserviceset slserviceset">
<h3 id="SLServiceSet">SLServiceSet <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>manager</code></td><td><span class="sig">String manager</span></td><td class="desc">"systemd" / "ServiceControlManager" / "launchd"</td></tr>
<tr><td><code>units</code></td><td><span class="sig">String units</span></td><td class="desc">newline-separated "name mode" lines (mode: boot|ondemand)</td></tr>
<tr><td><code>count</code></td><td><span class="sig">int count</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>configured</code></td><td><span class="sig">int configured</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String svcManager)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>addUnit</code></td><td><span class="sig">void addUnit(String name, String mode)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>enableAtBoot</code></td><td><span class="sig">void enableAtBoot(String name)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>enableOnDemand</code></td><td><span class="sig">void enableOnDemand(String name)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>forShape</code></td><td><span class="sig">void forShape(SLOSShape shape)</span></td><td class="desc">Seed the baseline services a shape brings up, under its own manager.</td></tr>
<tr><td><code>serviceManager</code></td><td><span class="sig">String serviceManager()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>unitManifest</code></td><td><span class="sig">String unitManifest()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>serviceCount</code></td><td><span class="sig">int serviceCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hasServices</code></td><td><span class="sig">boolean hasServices()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slsourcedropper">SLSourceDropper <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/os-creator/SLSourceDropper.sleela)</span></h2>
<div data-u="slsourcedropper slsourcedropper">
<h3 id="SLSourceDropper">SLSourceDropper <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>drop</code></td><td><span class="sig">void drop(SLOSModel m, SLOSDevTree tree)</span></td><td class="desc">Drop the reconstructable SLeeLa source and a provenance README into the tree.</td></tr>
<tr><td><code>modelSource</code></td><td><span class="sig">String modelSource(SLOSModel m)</span></td><td class="desc">A minimal, runnable SLeeLa program that reconstructs this model and re-runs OS Creator(TM) to regenerate the tree.</td></tr>
<tr><td><code>provenance</code></td><td><span class="sig">String provenance(SLOSModel m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slssd">SLSSD <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/ssd/SLSSD.sleela)</span></h2>
<div data-u="slssd slssd">
<h3 id="SLSSD">SLSSD <span class="pill">class</span> <span class="muted">extends <code>SLHardwareComponent</code></span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>IF_SATA3</code></td><td><span class="sig">static final int IF_SATA3 = 0</span></td><td class="desc">Interface ordinals. 6 Gb/s</td></tr>
<tr><td><code>IF_NVME_PCIE3</code></td><td><span class="sig">static final int IF_NVME_PCIE3 = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>IF_NVME_PCIE4</code></td><td><span class="sig">static final int IF_NVME_PCIE4 = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>IF_NVME_PCIE5</code></td><td><span class="sig">static final int IF_NVME_PCIE5 = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>NAND_SLC</code></td><td><span class="sig">static final int NAND_SLC = 1</span></td><td class="desc">NAND cell types.</td></tr>
<tr><td><code>NAND_MLC</code></td><td><span class="sig">static final int NAND_MLC = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>NAND_TLC</code></td><td><span class="sig">static final int NAND_TLC = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>NAND_QLC</code></td><td><span class="sig">static final int NAND_QLC = 4</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>iface</code></td><td><span class="sig">int iface</span></td><td class="desc">IF_*</td></tr>
<tr><td><code>formFactor</code></td><td><span class="sig">String formFactor</span></td><td class="desc">"2.5\"", "M.2 2280", "U.2", "AIC"</td></tr>
<tr><td><code>nand</code></td><td><span class="sig">int nand</span></td><td class="desc">NAND_*</td></tr>
<tr><td><code>capacityGb</code></td><td><span class="sig">int capacityGb</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>seqReadMBps</code></td><td><span class="sig">int seqReadMBps</span></td><td class="desc">representative sequential read</td></tr>
<tr><td><code>seqWriteMBps</code></td><td><span class="sig">int seqWriteMBps</span></td><td class="desc">representative sequential write</td></tr>
<tr><td><code>blockBytes</code></td><td><span class="sig">int blockBytes</span></td><td class="desc">logical block size (typically 512 or 4096)</td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String manufacturer, String partName, int interfaceKind, int capacityGigabytes)</span></td><td class="desc">Configure from manufacturer, model, interface, and capacity. The interface preset fills representative throughput and form factor; refine afterward.</td></tr>
<tr><td><code>configureByName</code></td><td><span class="sig">void configureByName(String manufacturer, String partName, String ifName, int capacityGb)</span></td><td class="desc">Configure by interface name ("SATA", "PCIe3", "PCIe4", "PCIe5").</td></tr>
<tr><td><code>setNand</code></td><td><span class="sig">void setNand(int cellType)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setFormFactor</code></td><td><span class="sig">void setFormFactor(String ff)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setThroughput</code></td><td><span class="sig">void setThroughput(int readMBps, int writeMBps)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isNvme</code></td><td><span class="sig">boolean isNvme()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>interfaceName</code></td><td><span class="sig">String interfaceName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>nandName</code></td><td><span class="sig">String nandName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>form</code></td><td><span class="sig">String form()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>capacityGigabytes</code></td><td><span class="sig">int capacityGigabytes()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>readMBps</code></td><td><span class="sig">int readMBps()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>writeMBps</code></td><td><span class="sig">int writeMBps()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>blockSize</code></td><td><span class="sig">int blockSize()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>capacityBlocks</code></td><td><span class="sig">int capacityBlocks()</span></td><td class="desc">Capacity as VM block count for the given block size — what SLMachineModel hands the block store when this SSD is the boot disk.</td></tr>
</table>
</div>
<h2 class="section" data-u="slssdcatalog">SLSSDCatalog <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/ssd/SLSSDCatalog.sleela)</span></h2>
<div data-u="slssdcatalog slssdcatalog">
<h3 id="SLSSDCatalog">SLSSDCatalog <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>nvme4</code></td><td><span class="sig">SLSSD nvme4(String manufacturer, int capacityGb)</span></td><td class="desc">A flagship NVMe PCIe 4.0 drive from a named manufacturer.</td></tr>
<tr><td><code>nvme5</code></td><td><span class="sig">SLSSD nvme5(String manufacturer, int capacityGb)</span></td><td class="desc">A flagship NVMe PCIe 5.0 drive from a named manufacturer.</td></tr>
<tr><td><code>sata</code></td><td><span class="sig">SLSSD sata(String manufacturer, int capacityGb)</span></td><td class="desc">A SATA III 2.5" drive from a named manufacturer.</td></tr>
<tr><td><code>drive</code></td><td><span class="sig">SLSSD drive(String manufacturer, String ifName, int capacityGb)</span></td><td class="desc">Build an SSD by interface name from any manufacturer.</td></tr>
<tr><td><code>known</code></td><td><span class="sig">boolean known(String manufacturer)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>nvme5Part</code></td><td><span class="sig">String nvme5Part(String mfr)</span></td><td class="desc">---- Representative model names ----------------------------------------</td></tr>
<tr><td><code>nvmePart</code></td><td><span class="sig">String nvmePart(String mfr)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>sataPart</code></td><td><span class="sig">String sataPart(String mfr)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>partFor</code></td><td><span class="sig">String partFor(String mfr, String ifName)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slsupportdownloader">SLSupportDownloader <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLSupportDownloader.sleela)</span></h2>
<div data-u="slsupportdownloader slsupportdownloader">
<h3 id="SLSupportDownloader">SLSupportDownloader <span class="pill">class</span></h3>
<p class="desc">Defines SLSupportDownloader — the resilient fallback downloader</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>PRIO_AUTHORITATIVE</code></td><td><span class="sig">static final int PRIO_AUTHORITATIVE = 0</span></td><td class="desc">Priority ordinals (lower = tried first; by likelihood of a final/edu ref).</td></tr>
<tr><td><code>PRIO_OFFICIAL_MIRROR</code></td><td><span class="sig">static final int PRIO_OFFICIAL_MIRROR = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>PRIO_COLLEGE</code></td><td><span class="sig">static final int PRIO_COLLEGE = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>PRIO_ARCHIVE</code></td><td><span class="sig">static final int PRIO_ARCHIVE = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>configured</code></td><td><span class="sig">int configured</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>kernelPrimary</code></td><td><span class="sig">String kernelPrimary()</span></td><td class="desc">Linux kernel source mirrors.</td></tr>
<tr><td><code>kernelSupport</code></td><td><span class="sig">String kernelSupport(int prio)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>packagePrimary</code></td><td><span class="sig">String packagePrimary()</span></td><td class="desc">Ubuntu/Debian package archive mirrors.</td></tr>
<tr><td><code>packageSupport</code></td><td><span class="sig">String packageSupport(int prio)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>firmwarePrimary</code></td><td><span class="sig">String firmwarePrimary()</span></td><td class="desc">linux-firmware source mirrors.</td></tr>
<tr><td><code>firmwareSupport</code></td><td><span class="sig">String firmwareSupport(int prio)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>upstreamPrimary</code></td><td><span class="sig">String upstreamPrimary()</span></td><td class="desc">The upstream Determinant distro mirrors.</td></tr>
<tr><td><code>upstreamSupport</code></td><td><span class="sig">String upstreamSupport(int prio)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>winePrimary</code></td><td><span class="sig">String winePrimary()</span></td><td class="desc">Wine runtime mirrors.</td></tr>
<tr><td><code>wineSupport</code></td><td><span class="sig">String wineSupport(int prio)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>qemuPrimary</code></td><td><span class="sig">String qemuPrimary()</span></td><td class="desc">QEMU runtime mirrors.</td></tr>
<tr><td><code>qemuSupport</code></td><td><span class="sig">String qemuSupport(int prio)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>supportUrl</code></td><td><span class="sig">String supportUrl(String kind, int prio)</span></td><td class="desc">---- 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.</td></tr>
<tr><td><code>knownKind</code></td><td><span class="sig">boolean knownKind(String kind)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>priorityName</code></td><td><span class="sig">String priorityName(int prio)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>rankedList</code></td><td><span class="sig">String rankedList(String kind)</span></td><td class="desc">The ranked list "<priority> <url>" for a kind (primary first, archive last).</td></tr>
<tr><td><code>add</code></td><td><span class="sig">String add(String acc, String line)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>fetchWithFallback</code></td><td><span class="sig">String fetchWithFallback(String kind, String dest)</span></td><td class="desc">---- 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`.</td></tr>
<tr><td><code>isGitKind</code></td><td><span class="sig">boolean isGitKind(String kind)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>firstReachable</code></td><td><span class="sig">String firstReachable(String kind)</span></td><td class="desc">---- 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.</td></tr>
<tr><td><code>reachable</code></td><td><span class="sig">boolean reachable(String kind, String url)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ready</code></td><td><span class="sig">boolean ready()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slswapconfig">SLSwapConfig <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLSwapConfig.sleela)</span></h2>
<div data-u="slswapconfig slswapconfig">
<h3 id="SLSwapConfig">SLSwapConfig <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>kind</code></td><td><span class="sig">String kind</span></td><td class="desc">"file" / "partition" / "zram" / "zswap" / "pagefile" / "dynamic" / "none"</td></tr>
<tr><td><code>host</code></td><td><span class="sig">String host</span></td><td class="desc">the OS family this swap belongs to</td></tr>
<tr><td><code>sizeMb</code></td><td><span class="sig">int sizeMb</span></td><td class="desc">swap size in MB (0 = auto / RAM-relative)</td></tr>
<tr><td><code>ramMultipleTenths</code></td><td><span class="sig">int ramMultipleTenths</span></td><td class="desc">size as a multiple of RAM, in tenths (e.g. 10 = 1.0x RAM); 0 = use sizeMb</td></tr>
<tr><td><code>swappiness</code></td><td><span class="sig">int swappiness</span></td><td class="desc">0..100 reclaim aggressiveness (Linux vm.swappiness)</td></tr>
<tr><td><code>compAlgo</code></td><td><span class="sig">String compAlgo</span></td><td class="desc">compression algorithm for zram/zswap ("lzo","lz4","zstd"), else ""</td></tr>
<tr><td><code>compLevel</code></td><td><span class="sig">int compLevel</span></td><td class="desc">compression quality/level (algorithm-dependent), 0 = default</td></tr>
<tr><td><code>priority</code></td><td><span class="sig">int priority</span></td><td class="desc">swap priority (higher = preferred); -1 = default</td></tr>
<tr><td><code>configured</code></td><td><span class="sig">int configured</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String swapKind, int sizeMegabytes, int swappinessValue)</span></td><td class="desc">Configure explicitly. compAlgo/compLevel apply only to zram/zswap.</td></tr>
<tr><td><code>norm</code></td><td><span class="sig">String norm(String k)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>clamp0to100</code></td><td><span class="sig">int clamp0to100(int v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>forShape</code></td><td><span class="sig">void forShape(SLOSShape shape)</span></td><td class="desc">Seed the family default: Linux a swap file at 1.0x RAM, swappiness 60; Windows a system-managed pagefile; macOS dynamic swap files.</td></tr>
<tr><td><code>setSizeMb</code></td><td><span class="sig">void setSizeMb(int mb)</span></td><td class="desc">---- 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.</td></tr>
<tr><td><code>setSizeRamMultiple</code></td><td><span class="sig">void setSizeRamMultiple(int tenths)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setSwappiness</code></td><td><span class="sig">void setSwappiness(int v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setPriority</code></td><td><span class="sig">void setPriority(int p)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setCompression</code></td><td><span class="sig">void setCompression(String algo, int level)</span></td><td class="desc">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.</td></tr>
<tr><td><code>isCompressed</code></td><td><span class="sig">boolean isCompressed()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isValid</code></td><td><span class="sig">boolean isValid()</span></td><td class="desc">---- 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.</td></tr>
<tr><td><code>validForShape</code></td><td><span class="sig">boolean validForShape(SLOSShape shape)</span></td><td class="desc">Is this kind valid for the host family? zram/zswap/file/partition are Linux; pagefile is Windows; dynamic is macOS; none is universal.</td></tr>
<tr><td><code>swapKind</code></td><td><span class="sig">String swapKind()</span></td><td class="desc">---- Accessors ------------------------------------------------------</td></tr>
<tr><td><code>swapSizeMb</code></td><td><span class="sig">int swapSizeMb()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>swappinessValue</code></td><td><span class="sig">int swappinessValue()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>compression</code></td><td><span class="sig">String compression()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>compressionLevel</code></td><td><span class="sig">int compressionLevel()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>sizeText</code></td><td><span class="sig">String sizeText()</span></td><td class="desc">A human size description.</td></tr>
<tr><td><code>tenths</code></td><td><span class="sig">String tenths(int t)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>emitLinux</code></td><td><span class="sig">String emitLinux()</span></td><td class="desc">---- Emission ------------------------------------------------------- The Linux fstab entry (file/partition) or the systemd/zram-generator line (zram), plus a vm.swappiness sysctl. Empty for kind "none".</td></tr>
<tr><td><code>prioOpt</code></td><td><span class="sig">String prioOpt()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>algoOrDefault</code></td><td><span class="sig">String algoOrDefault()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>emitForShape</code></td><td><span class="sig">String emitForShape(SLOSShape shape)</span></td><td class="desc">The per-shape swap note the generator/creator records.</td></tr>
<tr><td><code>summary</code></td><td><span class="sig">String summary()</span></td><td class="desc">A compact summary line.</td></tr>
</table>
</div>
<h2 class="section" data-u="sltoolchainemitter">SLToolchainEmitter <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/os-creator/SLToolchainEmitter.sleela)</span></h2>
<div data-u="sltoolchainemitter sltoolchainemitter">
<h3 id="SLToolchainEmitter">SLToolchainEmitter <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>intToStr</code></td><td><span class="sig">String intToStr(int v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>emitMakefile</code></td><td><span class="sig">String emitMakefile(SLOSModel m, boolean withDesktop)</span></td><td class="desc">The top-level Makefile that builds all pieces and authors the ISO.</td></tr>
<tr><td><code>emitBuildSh</code></td><td><span class="sig">String emitBuildSh(SLOSModel m)</span></td><td class="desc">POSIX build driver (Linux / macOS shapes).</td></tr>
<tr><td><code>emitBuildPs1</code></td><td><span class="sig">String emitBuildPs1(SLOSModel m)</span></td><td class="desc">PowerShell build driver (Windows shape).</td></tr>
<tr><td><code>emitOsConf</code></td><td><span class="sig">String emitOsConf(SLOSModel m)</span></td><td class="desc">The global os.conf config carrying the model identity.</td></tr>
<tr><td><code>isoName</code></td><td><span class="sig">String isoName(SLOSModel m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="sluefiemitter">SLUEFIEmitter <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/os-creator/SLUEFIEmitter.sleela)</span></h2>
<div data-u="sluefiemitter sluefiemitter">
<h3 id="SLUEFIEmitter">SLUEFIEmitter <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>emit</code></td><td><span class="sig">SLOSPiece emit(SLOSModel m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>loaderImage</code></td><td><span class="sig">String loaderImage(String loader)</span></td><td class="desc">Map a loader name to its EFI image filename.</td></tr>
<tr><td><code>boolLit</code></td><td><span class="sig">String boolLit(boolean b)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="sluefifirmware">SLUEFIFirmware <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/uefi/SLUEFIFirmware.sleela)</span></h2>
<div data-u="sluefifirmware sluefifirmware">
<h3 id="SLUEFIFirmware">SLUEFIFirmware <span class="pill">class</span> <span class="muted">extends <code>SLHardwareComponent</code></span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>specRevision</code></td><td><span class="sig">String specRevision</span></td><td class="desc">UEFI spec revision, e.g. "2.10"</td></tr>
<tr><td><code>secureBoot</code></td><td><span class="sig">int secureBoot</span></td><td class="desc">1 if Secure Boot is supported</td></tr>
<tr><td><code>csm</code></td><td><span class="sig">int csm</span></td><td class="desc">1 if a Compatibility Support Module (legacy BIOS) exists</td></tr>
<tr><td><code>bootServices</code></td><td><span class="sig">int bootServices</span></td><td class="desc">1 if boot services present (always, modeled)</td></tr>
<tr><td><code>runtimeServices</code></td><td><span class="sig">int runtimeServices</span></td><td class="desc">1 if runtime services present</td></tr>
<tr><td><code>espLabel</code></td><td><span class="sig">String espLabel</span></td><td class="desc">EFI System Partition label it reads</td></tr>
<tr><td><code>configured2</code></td><td><span class="sig">int configured2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String vendor, String product, String revision)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ami</code></td><td><span class="sig">void ami()</span></td><td class="desc">Named presets for the common firmware vendors.</td></tr>
<tr><td><code>insyde</code></td><td><span class="sig">void insyde()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>phoenix</code></td><td><span class="sig">void phoenix()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>tianocore</code></td><td><span class="sig">void tianocore()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>coreboot</code></td><td><span class="sig">void coreboot()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>configureByVendor</code></td><td><span class="sig">void configureByVendor(String vendor)</span></td><td class="desc">Choose by vendor name; defaults to TianoCore (the reference/open firmware).</td></tr>
<tr><td><code>enableSecureBoot</code></td><td><span class="sig">void enableSecureBoot(boolean on)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>enableCsm</code></td><td><span class="sig">void enableCsm(boolean on)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>uefiRevision</code></td><td><span class="sig">String uefiRevision()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>supportsSecureBoot</code></td><td><span class="sig">boolean supportsSecureBoot()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hasCsm</code></td><td><span class="sig">boolean hasCsm()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hasRuntimeServices</code></td><td><span class="sig">boolean hasRuntimeServices()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>esp</code></td><td><span class="sig">String esp()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>canLaunch</code></td><td><span class="sig">boolean canLaunch(String loaderName)</span></td><td class="desc">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.</td></tr>
</table>
</div>
<h2 class="section" data-u="slusbcatalog">SLUSBCatalog <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/usb/SLUSBCatalog.sleela)</span></h2>
<div data-u="slusbcatalog slusbcatalog">
<h3 id="SLUSBCatalog">SLUSBCatalog <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>controller</code></td><td><span class="sig">SLUSBDevice controller(String vendor, String genName, int ports)</span></td><td class="desc">A USB host controller (root hub) from a named vendor at a generation.</td></tr>
<tr><td><code>hub</code></td><td><span class="sig">SLUSBDevice hub(String vendor, String genName, int ports)</span></td><td class="desc">A USB hub from a named vendor.</td></tr>
<tr><td><code>hid</code></td><td><span class="sig">SLUSBDevice hid(String vendor, String part)</span></td><td class="desc">A HID device (keyboard/mouse), typically USB 2.0 Type-A.</td></tr>
<tr><td><code>flashDrive</code></td><td><span class="sig">SLUSBDevice flashDrive(String vendor, String part, String genName)</span></td><td class="desc">A mass-storage flash drive at a given generation.</td></tr>
<tr><td><code>knownController</code></td><td><span class="sig">boolean knownController(String vendor)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>controllerPart</code></td><td><span class="sig">String controllerPart(String vendor)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slusbdevice">SLUSBDevice <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/usb/SLUSBDevice.sleela)</span></h2>
<div data-u="slusbdevice slusbdevice">
<h3 id="SLUSBDevice">SLUSBDevice <span class="pill">class</span> <span class="muted">extends <code>SLHardwareComponent</code></span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>USB_1_1</code></td><td><span class="sig">static final int USB_1_1 = 0</span></td><td class="desc">Specification-generation ordinals. Full Speed, 12 Mb/s</td></tr>
<tr><td><code>USB_2_0</code></td><td><span class="sig">static final int USB_2_0 = 1</span></td><td class="desc">High Speed, 480 Mb/s</td></tr>
<tr><td><code>USB_3_2G1</code></td><td><span class="sig">static final int USB_3_2G1 = 2</span></td><td class="desc">5 Gb/s (formerly USB 3.0)</td></tr>
<tr><td><code>USB_3_2G2</code></td><td><span class="sig">static final int USB_3_2G2 = 3</span></td><td class="desc">10 Gb/s (formerly USB 3.1)</td></tr>
<tr><td><code>USB_3_2G2X2</code></td><td><span class="sig">static final int USB_3_2G2X2 = 4</span></td><td class="desc">20 Gb/s</td></tr>
<tr><td><code>USB4</code></td><td><span class="sig">static final int USB4 = 5</span></td><td class="desc">40 Gb/s</td></tr>
<tr><td><code>UC_HID</code></td><td><span class="sig">static final int UC_HID = 1</span></td><td class="desc">Device-class ordinals (USB class codes, abbreviated set).</td></tr>
<tr><td><code>UC_MASS</code></td><td><span class="sig">static final int UC_MASS = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>UC_HUB</code></td><td><span class="sig">static final int UC_HUB = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>UC_AUDIO</code></td><td><span class="sig">static final int UC_AUDIO = 4</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>UC_VIDEO</code></td><td><span class="sig">static final int UC_VIDEO = 5</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>UC_CONTROLLER</code></td><td><span class="sig">static final int UC_CONTROLLER = 6</span></td><td class="desc">host controller / root hub</td></tr>
<tr><td><code>generation</code></td><td><span class="sig">int generation</span></td><td class="desc">USB_*</td></tr>
<tr><td><code>usbClass</code></td><td><span class="sig">int usbClass</span></td><td class="desc">UC_*</td></tr>
<tr><td><code>rateMbps</code></td><td><span class="sig">int rateMbps</span></td><td class="desc">signalling rate in Mb/s</td></tr>
<tr><td><code>connector</code></td><td><span class="sig">String connector</span></td><td class="desc">"Type-A" / "Type-B" / "Type-C" / "Micro-B"</td></tr>
<tr><td><code>powerDelivery</code></td><td><span class="sig">int powerDelivery</span></td><td class="desc">1 if USB-PD capable</td></tr>
<tr><td><code>maxPorts</code></td><td><span class="sig">int maxPorts</span></td><td class="desc">for hubs/controllers</td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String manufacturer, String partName, int gen, int cls)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>configureByName</code></td><td><span class="sig">void configureByName(String manufacturer, String partName, String genName, int cls)</span></td><td class="desc">Configure by generation name ("USB1.1","USB2.0","USB3.2G1","USB3.2G2","USB3.2G2x2","USB4").</td></tr>
<tr><td><code>setConnector</code></td><td><span class="sig">void setConnector(String c)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setPorts</code></td><td><span class="sig">void setPorts(int ports)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>generationName</code></td><td><span class="sig">String generationName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>usbClassName</code></td><td><span class="sig">String usbClassName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>signallingRateMbps</code></td><td><span class="sig">int signallingRateMbps()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>connectorType</code></td><td><span class="sig">String connectorType()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hasPowerDelivery</code></td><td><span class="sig">boolean hasPowerDelivery()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>portCount</code></td><td><span class="sig">int portCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isController</code></td><td><span class="sig">boolean isController()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slvideocard">SLVideoCard <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/video-cards/SLVideoCard.sleela)</span></h2>
<div data-u="slvideocard slvideocard">
<h3 id="SLVideoCard">SLVideoCard <span class="pill">class</span> <span class="muted">extends <code>SLHardwareComponent</code></span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>GPU_NVIDIA</code></td><td><span class="sig">static final int GPU_NVIDIA = 0</span></td><td class="desc">GPU vendor ordinals.</td></tr>
<tr><td><code>GPU_AMD</code></td><td><span class="sig">static final int GPU_AMD = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>GPU_INTEL</code></td><td><span class="sig">static final int GPU_INTEL = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>VRAM_GDDR6</code></td><td><span class="sig">static final int VRAM_GDDR6 = 0</span></td><td class="desc">Video-memory type ordinals.</td></tr>
<tr><td><code>VRAM_GDDR6X</code></td><td><span class="sig">static final int VRAM_GDDR6X = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>VRAM_GDDR7</code></td><td><span class="sig">static final int VRAM_GDDR7 = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>VRAM_HBM</code></td><td><span class="sig">static final int VRAM_HBM = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>gpuVendor</code></td><td><span class="sig">int gpuVendor</span></td><td class="desc">GPU_*</td></tr>
<tr><td><code>architecture</code></td><td><span class="sig">String architecture</span></td><td class="desc">e.g. "Ada Lovelace", "RDNA 3", "Xe-HPG"</td></tr>
<tr><td><code>pcieGen</code></td><td><span class="sig">int pcieGen</span></td><td class="desc">PCIe generation (3,4,5)</td></tr>
<tr><td><code>pcieLanes</code></td><td><span class="sig">int pcieLanes</span></td><td class="desc">typically 16</td></tr>
<tr><td><code>vramMb</code></td><td><span class="sig">int vramMb</span></td><td class="desc">video memory in MB</td></tr>
<tr><td><code>vramType</code></td><td><span class="sig">int vramType</span></td><td class="desc">VRAM_*</td></tr>
<tr><td><code>hdmiPorts</code></td><td><span class="sig">int hdmiPorts</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>displayPorts</code></td><td><span class="sig">int displayPorts</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>boardPowerW</code></td><td><span class="sig">int boardPowerW</span></td><td class="desc">typical board power (TGP) in watts</td></tr>
<tr><td><code>vulkan</code></td><td><span class="sig">int vulkan</span></td><td class="desc">1 if Vulkan supported</td></tr>
<tr><td><code>direct3d</code></td><td><span class="sig">int direct3d</span></td><td class="desc">1 if Direct3D 12 supported</td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure(String vendorName, String partName, int vendorOrdinal, int vramMegabytes)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>configureByVendor</code></td><td><span class="sig">void configureByVendor(String vendorName, String partName, int vramMb)</span></td><td class="desc">Configure by vendor name ("NVIDIA"/"AMD"/"Intel").</td></tr>
<tr><td><code>setArchitecture</code></td><td><span class="sig">void setArchitecture(String arch)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setPcie</code></td><td><span class="sig">void setPcie(int gen, int lanes)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setVram</code></td><td><span class="sig">void setVram(int megabytes, int type)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setOutputs</code></td><td><span class="sig">void setOutputs(int hdmi, int dp)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setBoardPower</code></td><td><span class="sig">void setBoardPower(int watts)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>vendorName</code></td><td><span class="sig">String vendorName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>architectureName</code></td><td><span class="sig">String architectureName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>pcieGeneration</code></td><td><span class="sig">int pcieGeneration()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>lanes</code></td><td><span class="sig">int lanes()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>vramMegabytes</code></td><td><span class="sig">int vramMegabytes()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>vramTypeName</code></td><td><span class="sig">String vramTypeName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>outputsTotal</code></td><td><span class="sig">int outputsTotal()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>boardPower</code></td><td><span class="sig">int boardPower()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>supportsVulkan</code></td><td><span class="sig">boolean supportsVulkan()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>supportsDirect3D</code></td><td><span class="sig">boolean supportsDirect3D()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slvideocardcatalog">SLVideoCardCatalog <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/video-cards/SLVideoCardCatalog.sleela)</span></h2>
<div data-u="slvideocardcatalog slvideocardcatalog">
<h3 id="SLVideoCardCatalog">SLVideoCardCatalog <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>geforce</code></td><td><span class="sig">SLVideoCard geforce(String model, int vramMb)</span></td><td class="desc">A GeForce/RTX card by model, e.g. geforce("RTX 4090", 24576).</td></tr>
<tr><td><code>radeon</code></td><td><span class="sig">SLVideoCard radeon(String model, int vramMb)</span></td><td class="desc">A Radeon RX card by model, e.g. radeon("RX 7900 XTX", 24576).</td></tr>
<tr><td><code>arc</code></td><td><span class="sig">SLVideoCard arc(String model, int vramMb)</span></td><td class="desc">An Intel Arc card by model, e.g. arc("A770", 16384).</td></tr>
<tr><td><code>card</code></td><td><span class="sig">SLVideoCard card(String vendor, String model, int vramMb)</span></td><td class="desc">Build any card by vendor + model name.</td></tr>
<tr><td><code>knownVendor</code></td><td><span class="sig">boolean knownVendor(String vendor)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>knownBoardPartner</code></td><td><span class="sig">boolean knownBoardPartner(String partner)</span></td><td class="desc">Board partners that ship these GPUs (for identity/branding).</td></tr>
<tr><td><code>nvPower</code></td><td><span class="sig">int nvPower(String model)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slwindowsos">SLWindowsOS <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLWindowsOS.sleela)</span></h2>
<div data-u="slwindowsos slwindowsos">
<h3 id="SLWindowsOS">SLWindowsOS <span class="pill">class</span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>configure</code></td><td><span class="sig">void configure()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isHost</code></td><td><span class="sig">boolean isHost()</span></td><td class="desc">True when the running host is actually Windows.</td></tr>
<tr><td><code>cmd</code></td><td><span class="sig">int cmd(String commandLine)</span></td><td class="desc">---- Shells ------------------------------------------------------------- Run a command through cmd.exe (osRun already routes through cmd.exe on Windows). Returns the exit code.</td></tr>
<tr><td><code>powershell</code></td><td><span class="sig">int powershell(String script)</span></td><td class="desc">Run a command through PowerShell. Returns the exit code.</td></tr>
<tr><td><code>startCmd</code></td><td><span class="sig">SLProcess startCmd(String commandLine)</span></td><td class="desc">Start a background command via the process bridge; returns an SLProcess.</td></tr>
<tr><td><code>userProfile</code></td><td><span class="sig">String userProfile()</span></td><td class="desc">---- Windows environment entries ---------------------------------------</td></tr>
<tr><td><code>appData</code></td><td><span class="sig">String appData()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>localAppData</code></td><td><span class="sig">String localAppData()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>systemRoot</code></td><td><span class="sig">String systemRoot()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>programFiles</code></td><td><span class="sig">String programFiles()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>comSpec</code></td><td><span class="sig">String comSpec()</span></td><td class="desc">path to cmd.exe</td></tr>
<tr><td><code>computerName</code></td><td><span class="sig">String computerName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>separator</code></td><td><span class="sig">String separator()</span></td><td class="desc">---- Paths (backslash world) -------------------------------------------</td></tr>
<tr><td><code>join</code></td><td><span class="sig">String join(String base, String child)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>onDrive</code></td><td><span class="sig">String onDrive(String driveLetter, String rest)</span></td><td class="desc">Build a drive-rooted path, e.g. drive 'C' -> "C:\\...".</td></tr>
<tr><td><code>exists</code></td><td><span class="sig">boolean exists(String path)</span></td><td class="desc">---- Filesystem / identity (through the real OS) ------------------------</td></tr>
<tr><td><code>makeDir</code></td><td><span class="sig">boolean makeDir(String path)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>tempDir</code></td><td><span class="sig">String tempDir()</span></td><td class="desc">honours TMP/TEMP via GetTempPath</td></tr>
<tr><td><code>hostName</code></td><td><span class="sig">String hostName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>userName</code></td><td><span class="sig">String userName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slwindowsosmodel">SLWindowsOSModel <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/SLWindowsOSModel.sleela)</span></h2>
<div data-u="slwindowsosmodel slwindowsosmodel">
<h3 id="SLWindowsOSModel">SLWindowsOSModel <span class="pill">class</span> <span class="muted">extends <code>SLOSModel</code></span></h3>
<p class="desc">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.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>build</code></td><td><span class="sig">void build(String name, String ver)</span></td><td class="desc">Build a Windows-shaped model with the given product name/version on amd64.</td></tr>
<tr><td><code>buildMultiArch</code></td><td><span class="sig">void buildMultiArch(String name, String ver)</span></td><td class="desc">Build a multi-arch Windows model (adds arm64 to the primary amd64 target).</td></tr>
</table>
</div>
<h2 class="section" data-u="windows-creator">windows-creator <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/operating-system/examples/windows/windows-creator.sleela)</span></h2>
<div data-u="windows-creator model">
<h3 id="Model">Model <span class="pill struct">struct</span></h3>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
</div>
<div data-u="windows-creator windowscreator">
<h3 id="WindowsCreator">WindowsCreator <span class="pill">class</span></h3>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>windows</code></td><td><span class="sig">Model windows(String name, String version)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>identity</code></td><td><span class="sig">String identity(Model m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>readyToCompile</code></td><td><span class="sig">boolean readyToCompile(Model m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>packageRepo</code></td><td><span class="sig">String packageRepo(Model m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>kernelSrc</code></td><td><span class="sig">String kernelSrc(Model m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>configHeader</code></td><td><span class="sig">String configHeader(Model m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>baseDrivers</code></td><td><span class="sig">String baseDrivers(Model m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>downloads</code></td><td><span class="sig">String downloads(Model m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>settings</code></td><td><span class="sig">String settings(Model m)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>compat</code></td><td><span class="sig">String compat(Model m)</span></td><td class="desc">Windows has no FS-level interpreter; it runs a Linux guest via WSL2.</td></tr>
<tr><td><code>banner</code></td><td><span class="sig">void banner(String t)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>main</code></td><td><span class="sig">void main()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<script>function flt(q){q=q.toLowerCase();document.querySelectorAll('[data-u]').forEach(function(el){el.style.display = el.getAttribute('data-u').indexOf(q)>=0||q==''?'':'none';});}</script>
<footer>
Generated by <code>tools/generate-sleeladoc-api.py</code> from the live
<code>/lib</code> tree on 2026-11-14 09:11 UTC.
SleelaDoc — the SLeeLa documentation brand. SLeeLa — MEARVK LLC · Max Rupplin · UNCW, NCSU, Harvard · 2026 · George Soros 2507-2608.
</footer>
</main>
</div>
</body>
</html>