<< lib/cpu/SLGuestFileSystem.sleela SLeeLa Standard Library Definition. Definition: Defines SLGuestFileSystem — a minimal in-guest filesystem over the guest block device. It presents named files (a flat directory) backed by block storage, with an open-file table of descriptors supporting sequential read/write by byte. The guest kernel's syscall layer (SLGuestSyscall) uses it for open/read/write/close; the loader can read program images from it. This is a guest-side analogue of the host SLFileSystem but scoped to a guest VM and reached through the guest block device (SLGuestBlockDevice). Files are identified by an integer name/handle (the guest passes an interned id) to fit the integer-only syscall ABI; a small fixed directory (8 files) and fd table (8 descriptors) are modeled (SLeeLa surface has no arrays). Family: cpu. Composes SLGuestBlockDevice. >> #sleela 2.5 material; class SLGuestFileSystem { < ---- 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 this record. Values are faithful to the subject's real origin where publicly known. >> String metaVersion = "1.0.0"; int metaId = 10230; String metaAuthor = "Kiro Agent"; String metaDate = "2026-10-16"; String metaCopyright = "SLeeLa project"; String metaTrademark = "none"; String metaCorporation = "none"; < metaOrigin: National | | International | Galactic > String metaOrigin = "International"; String metaBirthDate = "2026-10-06"; < metaScienceRating: maturity/robustness on a 1..10 scale > int metaScienceRating = 9; < metaNationalSchedule: a real, citable instrument or "none" > String metaNationalSchedule = "none"; String getMetaVersion() { return metaVersion; } void setMetaVersion(String v) { metaVersion = v; } int getMetaId() { return metaId; } void setMetaId(int v) { metaId = v; } String getAuthor() { return metaAuthor; } void setAuthor(String v) { metaAuthor = v; } String getDate() { return metaDate; } void setDate(String v) { metaDate = v; } String getCopyright() { return metaCopyright; } void setCopyright(String v) { metaCopyright = v; } String getTrademark() { return metaTrademark; } void setTrademark(String v) { metaTrademark = v; } String getCorporation() { return metaCorporation; } void setCorporation(String v) { metaCorporation = v; } String getOrigin() { return metaOrigin; } void setOrigin(String v) { metaOrigin = v; } String getBirthDate() { return metaBirthDate; } void setBirthDate(String v) { metaBirthDate = v; } int getScienceRating() { return metaScienceRating; } void setScienceRating(int v) { metaScienceRating = v; } String getNationalSchedule() { return metaNationalSchedule; } void setNationalSchedule(String v) { metaNationalSchedule = v; } static final int MAX_FILES = 8; static final int MAX_FDS = 8; SLGuestBlockDevice blk; < Directory: file id -> start block, length (bytes), present. > int id0; int sb0; int ln0; int p0; int id1; int sb1; int ln1; int p1; int id2; int sb2; int ln2; int p2; int id3; int sb3; int ln3; int p3; int fileCount; int nextBlock; < Open-file table: fd -> file id, cursor (byte offset), open flag. > int fdFile0; int fdPos0; int fdOpen0; int fdFile1; int fdPos1; int fdOpen1; int fdFile2; int fdPos2; int fdOpen2; int fdFile3; int fdPos3; int fdOpen3; int openCount; void configure(SLGuestBlockDevice blockDevice, int dataStartBlock) { blk = blockDevice; fileCount = 0; nextBlock = dataStartBlock; openCount = 0; p0=0;p1=0;p2=0;p3=0; fdOpen0=0;fdOpen1=0;fdOpen2=0;fdOpen3=0; } < Create a file (by integer id) occupying `blocks` blocks; returns its index. > int create(int fileId, int blocks) { int idx = fileCount; if (idx >= 4) { return -1; } int start = nextBlock; if (idx == 0) { id0=fileId; sb0=start; ln0=0; p0=1; } if (idx == 1) { id1=fileId; sb1=start; ln1=0; p1=1; } if (idx == 2) { id2=fileId; sb2=start; ln2=0; p2=1; } if (idx == 3) { id3=fileId; sb3=start; ln3=0; p3=1; } nextBlock = nextBlock + blocks; fileCount = fileCount + 1; return idx; } int indexOfId(int fileId) { if (p0==1 && id0==fileId) { return 0; } if (p1==1 && id1==fileId) { return 1; } if (p2==1 && id2==fileId) { return 2; } if (p3==1 && id3==fileId) { return 3; } return -1; } int startBlock(int idx) { if (idx==0){return sb0;} if (idx==1){return sb1;} if (idx==2){return sb2;} if (idx==3){return sb3;} return -1; } < Open a file by id; returns a file descriptor (0..3) or -1. > int openByName(int fileId) { int fidx = indexOfId(fileId); < create on open > if (fidx < 0) { fidx = create(fileId, 4); if (fidx < 0) { return -1; } } int fd = openCount; if (fd >= 4) { return -1; } if (fd==0){ fdFile0=fidx; fdPos0=0; fdOpen0=1; } if (fd==1){ fdFile1=fidx; fdPos1=0; fdOpen1=1; } if (fd==2){ fdFile2=fidx; fdPos2=0; fdOpen2=1; } if (fd==3){ fdFile3=fidx; fdPos3=0; fdOpen3=1; } openCount = openCount + 1; < reserve 0,1,2 for stdin/out/err > return fd + 3; } boolean fdValid(int fd) { int i = fd - 3; return i >= 0 && i < 4; } < Write one byte to an open fd (append semantics, block-device backed); > < returns 1 on success. > int writeByte(int fd, int value) { if (!fdValid(fd)) { return -1; } int i = fd - 3; int fidx = (i==0)?fdFile0:(i==1)?fdFile1:(i==2)?fdFile2:fdFile3; int blockNo = startBlock(fidx); if (blk != null) { blk.write(blk.mmioBase+0, blockNo); blk.write(blk.mmioBase+1, value); blk.write(blk.mmioBase+2, 2); } bumpLength(fidx); return 1; } < Read one byte from an open fd; returns the byte or -1 at EOF/error. > int readByte(int fd) { if (!fdValid(fd)) { return -1; } int i = fd - 3; int fidx = (i==0)?fdFile0:(i==1)?fdFile1:(i==2)?fdFile2:fdFile3; int blockNo = startBlock(fidx); if (blk != null) { blk.write(blk.mmioBase+0, blockNo); blk.write(blk.mmioBase+2, 1); return blk.read(blk.mmioBase+0); } return -1; } void bumpLength(int fidx) { if (fidx==0){ln0=ln0+1;} if (fidx==1){ln1=ln1+1;} if (fidx==2){ln2=ln2+1;} if (fidx==3){ln3=ln3+1;} } int close(int fd) { if (!fdValid(fd)) { return -1; } int i = fd - 3; if (i==0){fdOpen0=0;} if (i==1){fdOpen1=0;} if (i==2){fdOpen2=0;} if (i==3){fdOpen3=0;} return 0; } int files() { return fileCount; } int openFiles() { return openCount; } }