Struct VfsEntry

pub struct VfsEntry {
    parent: RwLock<Weak<VfsEntry>>,
    name: String,
    node: Arc<dyn VfsNode>,
    children: RwLock<BTreeMap<String, Weak<VfsEntry>>>,
}

VfsEntry represents a node in the VFS path hierarchy (similar to Linux dentry)

This structure represents the VFS’s in-memory filesystem hierarchy graph. It serves as:

• A “name” representation within a directory
• A “link” that constructs parent-child relationships in the VFS graph
• A cache for fast re-access to already resolved paths

VfsEntry is designed to be thread-safe and can be shared across threads.

Fields

parent: RwLock<Weak<VfsEntry>>

Weak reference to parent VfsEntry (prevents circular references)

name: String

Name of this VfsEntry (e.g., “user”, “file.txt”)

node: Arc<dyn VfsNode>

Reference to the corresponding file entity (VfsNode)

children: RwLock<BTreeMap<String, Weak<VfsEntry>>>

Cache of child VfsEntries for fast lookup (using Weak to prevent memory leaks)

Implementations

impl VfsEntry

pub fn new( parent: Option<Weak<VfsEntry>>, name: String, node: Arc<dyn VfsNode>, ) -> Arc<Self>

Create a new VfsEntry

pub fn name(&self) -> &String

Get the name of this entry

pub fn node(&self) -> Arc<dyn VfsNode>

Get the VfsNode for this entry

pub fn parent(&self) -> Option<Arc<VfsEntry>>

Get parent VfsEntry if it exists

pub fn set_parent(&self, parent: Weak<VfsEntry>)

pub fn add_child(self: &Arc<Self>, name: String, child: Arc<VfsEntry>)

Add a child to the cache

pub fn get_child(&self, name: &String) -> Option<Arc<VfsEntry>>

Get a child from the cache

pub fn remove_child(&self, name: &String) -> Option<Arc<VfsEntry>>

Remove a child from the cache

pub fn cleanup_cache(&self)

Clean up expired weak references in the cache

Trait Implementations

impl Clone for VfsEntry

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for VfsEntry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.