Struct EngramFS 

pub struct EngramFS { /* private fields */ }

The EngramFS FUSE filesystem implementation

This provides a read-only view of decoded engram data as a standard POSIX filesystem. Files are decoded on-demand from the holographic representation and cached for efficient repeated access.

Implementations

impl EngramFS

pub fn new(read_only: bool) -> Self

Create a new EngramFS instance

Arguments

• read_only - Whether the filesystem is read-only (default: true for engrams)

pub fn add_file(&self, path: &str, data: Vec<u8>) -> Result<Ino, &'static str>

Add a file to the filesystem

Arguments

• path - Absolute path within the filesystem (e.g., “/foo/bar.txt”)
• data - File content bytes

Returns

The assigned inode number for the new file

pub fn lookup_path(&self, path: &str) -> Option<Ino>

Lookup a path and return its inode

pub fn get_attr(&self, ino: Ino) -> Option<FileAttr>

Get file attributes by inode

pub fn read_data(&self, ino: Ino, offset: u64, size: u32) -> Option<Vec<u8>>

Read file data

pub fn read_dir(&self, ino: Ino) -> Option<Vec<DirEntry>>

Read directory contents

pub fn lookup_entry(&self, parent_ino: Ino, name: &str) -> Option<Ino>

Lookup entry in directory by name

pub fn get_parent(&self, ino: Ino) -> Option<Ino>

Get parent inode for a given inode

pub fn file_count(&self) -> usize

Get total number of files

pub fn total_size(&self) -> u64

Get total size of all files

pub fn is_read_only(&self) -> bool

Check if filesystem is read-only

pub fn attr_ttl(&self) -> Duration

Get attribute TTL

pub fn entry_ttl(&self) -> Duration

Get entry TTL

pub fn add_symlink( &self, path: &str, target: String, ) -> Result<Ino, &'static str>

Add a symbolic link to the filesystem

Arguments

• path - Absolute path within the filesystem (e.g., “/lib/libc.so.6”)
• target - The symlink target path (can be relative or absolute)

Returns

The assigned inode number for the new symlink

pub fn add_device( &self, path: &str, is_char: bool, major: u32, minor: u32, data: Vec<u8>, ) -> Result<Ino, &'static str>

Add a device node to the filesystem (Option C: store device data)

Arguments

• path - Absolute path within the filesystem (e.g., “/dev/null”)
• is_char - true for character device, false for block device
• major - Major device number
• minor - Minor device number
• data - Device data content (Option C encoding)

Returns

The assigned inode number for the new device

pub fn add_fifo(&self, path: &str) -> Result<Ino, &'static str>

Add a FIFO (named pipe) to the filesystem

pub fn add_socket(&self, path: &str) -> Result<Ino, &'static str>

Add a Unix socket to the filesystem

pub fn read_symlink(&self, ino: Ino) -> Option<String>

Read symlink target

pub fn get_device(&self, ino: Ino) -> Option<DeviceNode>

Get device node info

pub fn symlink_count(&self) -> usize

Get total number of symlinks

pub fn device_count(&self) -> usize

Get total number of device nodes