<< SLeeLa Standard Library Definition. Definition: VM-facing OSLS binding and marshalling contract. The existing OP_OS_* VM system-call bridge and the typed osls_* ABI adapter are registered here. OSLS records cross the VM boundary as bounded JSON Strings. >> #sleela 2.5 material; class SLOsSupportVMBridge { < ---- Descriptive metadata (version 1.11 nested-friendly accessors) ---- > << Eleven catalogued attributes with getter/setter pairs, so a GUI, loader, or catalog can read and (where appropriate) override each record. Values are faithful to the subject's real origin where publicly known. >> String metaVersion = "1.0.0"; int metaId = 0; String metaAuthor = "mearvk"; String metaDate = "2026-11-05"; String metaCopyright = "Copyright mearvk LLC"; String metaTrademark = "none"; String metaCorporation = "mearvk LLC"; < metaOrigin: National | | International | Galactic > String metaOrigin = "International"; String metaBirthDate = "2026-11-05"; < metaScienceRating: maturity/robustness on a 1..10 scale > int metaScienceRating = 8; < metaNationalSchedule: a real, citable instrument or "none" > String metaNationalSchedule = "none"; String getMetaVersion() { return metaVersion; } void setMetaVersion(String value) { metaVersion = value; } int getMetaId() { return metaId; } void setMetaId(int value) { metaId = value; } String getMetaAuthor() { return metaAuthor; } void setMetaAuthor(String value) { metaAuthor = value; } String getMetaDate() { return metaDate; } void setMetaDate(String value) { metaDate = value; } String getMetaCopyright() { return metaCopyright; } void setMetaCopyright(String value) { metaCopyright = value; } String getMetaTrademark() { return metaTrademark; } void setMetaTrademark(String value) { metaTrademark = value; } String getMetaCorporation() { return metaCorporation; } void setMetaCorporation(String value) { metaCorporation = value; } String getMetaOrigin() { return metaOrigin; } void setMetaOrigin(String value) { metaOrigin = value; } String getMetaBirthDate() { return metaBirthDate; } void setMetaBirthDate(String value) { metaBirthDate = value; } int getMetaScienceRating() { return metaScienceRating; } void setMetaScienceRating(int value) { metaScienceRating = value; } String getMetaNationalSchedule() { return metaNationalSchedule; } void setMetaNationalSchedule(String value) { metaNationalSchedule = value; } String bridgeVersion = "1.0.0"; String vmNamespace = "std.os"; String nativeNamespace = "osls"; String runtimeNamespace = "osls_runtime"; String moduleNamespace = "sl_native"; String dispatchBoundary = "SleelaVMSystemCallBridge / OP_OS_* and OP_OSLS_CALL"; String getBridgeVersion() { return bridgeVersion; } String getVMNamespace() { return vmNamespace; } String getNativeNamespace() { return nativeNamespace; } String getDispatchBoundary() { return dispatchBoundary; } < Stable conceptual stages of a VM-to-host operation. > SLList getBridgeStages() { SLList out = new SLList(); out.add("SLeeLaSourceCall"); out.add("VMOpcodeOrNativeBindingSelection"); out.add("VMTypeCheck"); out.add("VMCallDescriptorLookup"); out.add("ArgumentValidation"); out.add("UTF8AndBufferMarshalling"); out.add("NativeABIDispatch"); out.add("PlatformBackendDispatch"); out.add("HostOSPermissionCheck"); out.add("NativeResultNormalization"); out.add("VMValueConstruction"); out.add("VMExceptionOrStatusPropagation"); return out; } < VM-visible operation groups. > SLList getVMElementTerms() { SLList out = new SLList(); out.add("OSHost"); out.add("OSProcess"); out.add("OSEnvironment"); out.add("OSFileSystem"); out.add("OSPath"); out.add("OSVolume"); out.add("OSCPU"); out.add("OSMemory"); out.add("OSClock"); out.add("OSTimeZone"); out.add("OSNetwork"); out.add("OSSocket"); out.add("OSScheduler"); out.add("OSTimer"); out.add("OSRuntime"); out.add("OSModule"); out.add("OSCapabilities"); out.add("OSError"); return out; } < Portable status mapping; numeric values match osls_status in osls.h. > SLList getStatusTerms() { SLList out = new SLList(); out.add("OSLS_OK=0"); out.add("OSLS_INVALID_ARGUMENT=1"); out.add("OSLS_BUFFER_TOO_SMALL=2"); out.add("OSLS_SYSTEM_ERROR=3"); out.add("OSLS_NOT_FOUND=4"); out.add("OSLS_UNSUPPORTED=5"); return out; } < ABI data types that the VM marshaller must understand explicitly. > SLList getMarshallerTerms() { SLList out = new SLList(); out.add("Int32"); out.add("UInt32"); out.add("Int64"); out.add("UInt64"); out.add("SizeT"); out.add("Utf8String"); out.add("Utf8Buffer"); out.add("FixedWidthRecord"); out.add("OpaqueHandle"); out.add("CallbackToken"); out.add("BorrowedPayload"); out.add("StatusCode"); return out; } < The currently declared C ABI entry points available for registration. > SLList getRegisteredSymbolCandidates() { SLList out = new SLList(); out.add("osls_cron_next_after"); out.add("osls_cron_validate"); out.add("osls_enumerate_environment"); out.add("osls_enumerate_processes"); out.add("osls_get_cpu_info"); out.add("osls_get_environment_value"); out.add("osls_get_file_info"); out.add("osls_get_network_interfaces"); out.add("osls_get_process_info"); out.add("osls_get_system_info"); out.add("osls_get_timezone_info"); out.add("osls_list_directory"); out.add("osls_runtime_create"); out.add("osls_runtime_destroy"); out.add("osls_runtime_emit"); out.add("osls_runtime_pending"); out.add("osls_runtime_post"); out.add("osls_runtime_run_one"); out.add("osls_runtime_subscribe"); out.add("osls_runtime_unsubscribe"); out.add("sl_native_abi_version"); out.add("sl_native_close"); out.add("sl_native_loader_error"); out.add("sl_native_open"); out.add("sl_native_run"); out.add("sl_native_run_module"); out.add("sl_native_status_string"); return out; } < Mandatory guardrails for VM/native dispatch. > SLList getDispatchRules() { SLList out = new SLList(); out.add("NoImplicitPrivilegeElevation"); out.add("NoKernelOrSyscallInterception"); out.add("NoUnapprovedCrossProcessAccess"); out.add("NoImplicitProcessLaunch"); out.add("NoImplicitFilesystemMutation"); out.add("NoTrustBasedExecutionAuthorization"); out.add("NativeModuleRunsInProcess"); out.add("HostOSRemainsAuthority"); out.add("ExplicitCapabilityCheck"); out.add("ExplicitPermissionFailure"); out.add("DeterministicHandleOwnership"); out.add("CallbackLifetimeIsBounded"); out.add("TypedBindingIdValidation"); out.add("BoundedJSONResultMarshalling"); out.add("NoRawNativePointersInVMValues"); return out; } << Existing VM OS system calls are dispatched through OP_OS_* (103..123). The 12 osls_* calls are now registered through OP_OSLS_CALL (155), with typed argument validation and bounded JSON result marshalling. >> boolean isCoreOSOpcodeBridgeImplemented() { return true; } boolean isOSLSAbiAdapterRegistered() { return true; } SLList getCoreOSOpcodeTerms() { SLList out = new SLList(); out.add("OP_OS_PLATFORM=103"); out.add("OP_OS_CAPABILITY=104"); out.add("OP_OS_GETENV=105"); out.add("OP_OS_SETENV=106"); out.add("OP_OS_CWD=107"); out.add("OP_OS_CHDIR=108"); out.add("OP_OS_HOSTNAME=109"); out.add("OP_OS_USERNAME=110"); out.add("OP_OS_TEMPDIR=111"); out.add("OP_OS_PID=112"); out.add("OP_OS_EXISTS=113"); out.add("OP_OS_ISDIR=114"); out.add("OP_OS_FILESIZE=115"); out.add("OP_OS_MKDIR=116"); out.add("OP_OS_REMOVE=117"); out.add("OP_OS_RENAME=118"); out.add("OP_OS_RUN=119"); out.add("OP_OS_SPAWN=120"); out.add("OP_OS_WAIT=121"); out.add("OP_OS_KILL=122"); out.add("OP_OS_PCLOSE=123"); out.add("OP_OSLS_CALL=155"); return out; } << Portable grouping + current VM operation + source built-in + opcode. The delimiter is a catalogue convention, not a runtime wire format. >> SLList getExistingVMElementBindings() { SLList out = new SLList(); out.add("HostIdentity|platform|osPlatform|OP_OS_PLATFORM=103|Implemented|ReadOnlyQuery"); out.add("OSLS|systemInfo|oslsSystemInfo|OP_OSLS_CALL=155/id0|Implemented|ReadOnlyQuery"); out.add("OSLS|processInfo|oslsProcessInfo|OP_OSLS_CALL=155/id1|Implemented|ReadOnlyQuery"); out.add("OSLS|enumerateProcesses|oslsEnumerateProcesses|OP_OSLS_CALL=155/id2|Implemented|ReadOnlyEnumeration"); out.add("OSLS|getEnvironmentValue|oslsGetEnvironmentValue|OP_OSLS_CALL=155/id3|Implemented|ReadOnlyQuery"); out.add("OSLS|enumerateEnvironment|oslsEnumerateEnvironment|OP_OSLS_CALL=155/id4|Implemented|ReadOnlyEnumeration"); out.add("OSLS|getFileInfo|oslsGetFileInfo|OP_OSLS_CALL=155/id5|Implemented|ReadOnlyQuery"); out.add("OSLS|listDirectory|oslsListDirectory|OP_OSLS_CALL=155/id6|Implemented|ReadOnlyEnumeration"); out.add("OSLS|getCPUInfo|oslsGetCPUInfo|OP_OSLS_CALL=155/id7|Implemented|ReadOnlyQuery"); out.add("OSLS|getTimezoneInfo|oslsGetTimezoneInfo|OP_OSLS_CALL=155/id8|Implemented|ReadOnlyQuery"); out.add("OSLS|getNetworkInterfaces|oslsGetNetworkInterfaces|OP_OSLS_CALL=155/id9|Implemented|ReadOnlyEnumeration"); out.add("OSLS|cronValidate|oslsCronValidate|OP_OSLS_CALL=155/id10|Implemented|ReadOnlyQuery"); out.add("OSLS|cronNextAfter|oslsCronNextAfter|OP_OSLS_CALL=155/id11|Implemented|ReadOnlyQuery"); out.add("OSLS|getMemoryInfo|oslsGetMemoryInfo|OP_OSLS_CALL=155/id12|Implemented|ReadOnlyQuery"); out.add("OSLS|getAvailableMemory|oslsGetAvailableMemory|OP_OSLS_CALL=155/id13|Implemented|ReadOnlyQuery"); out.add("OSLS|getDiskSpace|oslsGetDiskSpace|OP_OSLS_CALL=155/id14|Implemented|ReadOnlyQuery"); out.add("OSLS|getVolumeInfo|oslsGetVolumeInfo|OP_OSLS_CALL=155/id15|Implemented|ReadOnlyQuery"); out.add("OSLS|getSystemLoad|oslsGetSystemLoad|OP_OSLS_CALL=155/id16|Implemented|ReadOnlyQuery"); out.add("OSLS|getCapabilities|oslsGetCapabilities|OP_OSLS_CALL=155/id17|Implemented|ReadOnlyQuery"); out.add("OSLS|getRuntimeInfo|oslsGetRuntimeInfo|OP_OSLS_CALL=155/id18|Implemented|ReadOnlyQuery"); out.add("OSLS|getNativeError|oslsGetNativeError|OP_OSLS_CALL=155/id19|Implemented|ReadOnlyQuery"); out.add("OSLS|pathNormalize|oslsPathNormalize|OP_OSLS_CALL=155/id20|Implemented|ReadOnlyQuery"); out.add("OSLS|pathJoin|oslsPathJoin|OP_OSLS_CALL=155/id21|Implemented|ReadOnlyQuery"); out.add("OSLS|pathResolve|oslsPathResolve|OP_OSLS_CALL=155/id22|Implemented|ReadOnlyQuery"); out.add("OSLS|getPathInfo|oslsGetPathInfo|OP_OSLS_CALL=155/id23|Implemented|ReadOnlyQuery"); out.add("OSLS|networkResolve|oslsNetworkResolve|OP_OSLS_CALL=155/id24|Implemented|ReadOnlyQuery"); out.add("CapabilityDiscovery|supports|osCapability|OP_OS_CAPABILITY=104|Implemented|ReadOnlyQuery"); out.add("Environment|getEnv|osGetEnv|OP_OS_GETENV=105|Implemented|ReadOnlyQuery"); out.add("Environment|setEnv|osSetEnv|OP_OS_SETENV=106|Implemented|StateChangingOperation"); out.add("PathManagement|currentDir|osCurrentDir|OP_OS_CWD=107|Implemented|ReadOnlyQuery"); out.add("PathManagement|changeDir|osChangeDir|OP_OS_CHDIR=108|Implemented|StateChangingOperation"); out.add("HostIdentity|hostName|osHostName|OP_OS_HOSTNAME=109|Implemented|ReadOnlyQuery"); out.add("HostIdentity|userName|osUserName|OP_OS_USERNAME=110|Implemented|ReadOnlyQuery"); out.add("FileSystem|tempDir|osTempDir|OP_OS_TEMPDIR=111|Implemented|ReadOnlyQuery"); out.add("ProcessInspection|processId|osProcessId|OP_OS_PID=112|Implemented|ReadOnlyQuery"); out.add("FileSystem|exists|osExists|OP_OS_EXISTS=113|Implemented|ReadOnlyQuery"); out.add("FileSystem|isDir|osIsDir|OP_OS_ISDIR=114|Implemented|ReadOnlyQuery"); out.add("FileSystem|fileSize|osFileSize|OP_OS_FILESIZE=115|Implemented|ReadOnlyQuery"); out.add("FileSystem|makeDir|osMakeDir|OP_OS_MKDIR=116|Implemented|StateChangingOperation"); out.add("FileSystem|remove|osRemove|OP_OS_REMOVE=117|Implemented|StateChangingOperation"); out.add("FileSystem|rename|osRename|OP_OS_RENAME=118|Implemented|StateChangingOperation"); out.add("ProcessControl|run|osRun|OP_OS_RUN=119|Implemented|StateChangingOperation"); out.add("ProcessControl|spawn|osSpawn|OP_OS_SPAWN=120|Implemented|StateChangingOperation"); out.add("ProcessControl|waitFor|osWait|OP_OS_WAIT=121|Implemented|BlockingOperation"); out.add("ProcessControl|kill|osKill|OP_OS_KILL=122|Implemented|StateChangingOperation"); out.add("ProcessControl|closeProcess|osProcessClose|OP_OS_PCLOSE=123|Implemented|StateChangingOperation"); return out; } SLList getCoreOSBridgeGroups() { SLList out = new SLList(); out.add("HostIdentity"); out.add("Environment"); out.add("PathManagement"); out.add("FileSystem"); out.add("ProcessInspection"); out.add("ProcessControl"); out.add("CapabilityDiscovery"); out.add("CPUArchitecture"); out.add("TimeZoneCalendar"); out.add("NetworkInterfaces"); out.add("Scheduling"); return out; } }