Home /Modules/impl/README.md

README.md

impl/fileio/README.md · 59 line(s) · markdown

<img align="right" src="https://github.com/mearvk/SLeeLa/blob/master/images/debian/debian-logo.png" width="75" height="75" alt="SLeeLa">

<img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela/sleela-logo-004.jpg" alt="SLeeLa">

SLeeLa File I/O Subsystem

SLeeLa 1.1 provides a common file and pipe API with an OS-aware native backend. The source-level operations remain stable while the implementation uses the native transport of the host operating system.

Platform backends

The Windows named-pipe implementation is the NPFS-side counterpart of the Linux FIFO implementation. Linux does not expose a Windows NPFS filesystem.

Primitives

Raw host descriptors/handles never become Sleela values. The runtime assigns a bounded VM-local handle, currently limited to 256 simultaneous file handles.

Platform choice

The native platform is detected automatically. SLEELA_IO_PLATFORM=auto is the default. SLEELA_IO_PLATFORM=linux or SLEELA_IO_PLATFORM=windows may be used to declare the intended target; a non-native request is rejected rather than silently emulated.

The C backend exposes slio_platform() and slio_platform_name() for platform-aware diagnostics.

Verification

The verified Makefile builds core/sleela_io.c and runs the dedicated test-io-platform smoke test. The existing SHA-256 verification barrier still runs before compilation and diagnostics.

See ../FILEIO.md for the full API, examples, lifecycle rules, platform semantics, and the Linux-vs-Windows NPFS distinction.