Struct OverlayNode

pub struct OverlayNode {
    name: String,
    overlay_fs: RwLock<Option<Arc<OverlayFS>>>,
    path: String,
    file_type: FileType,
    file_id: u64,
}

A composite node that represents a file/directory across overlay layers

OverlayNode serves as a virtual representation of a file or directory that may exist in one or more layers of the overlay filesystem. It handles the resolution of operations across these layers according to overlay semantics.

Design

Each OverlayNode represents a specific path in the overlay and delegates operations to the appropriate underlying filesystem layers. The node itself doesn’t store file content but rather coordinates access to the real nodes in the upper and lower layers.

Fields

name: String

Node name

overlay_fs: RwLock<Option<Arc<OverlayFS>>>

Reference to overlay filesystem

path: String

Path in the overlay

file_type: FileType

File type (resolved from layers)

file_id: u64

File ID

Implementations

impl OverlayNode

pub fn new( name: String, path: String, file_type: FileType, file_id: u64, ) -> Arc<Self>

pub fn set_overlay_fs(&self, fs: Arc<OverlayFS>)

Trait Implementations

impl Clone for OverlayNode

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl VfsNode for OverlayNode

fn id(&self) -> u64

Returns the unique identifier in the filesystem

fn filesystem(&self) -> Option<Weak<dyn FileSystemOperations>>

Returns a (Weak) reference to the filesystem this node belongs to

fn metadata(&self) -> Result<FileMetadata, FileSystemError>

Get metadata for this node

fn as_any(&self) -> &dyn Any

Helper for downcasting

fn file_type(&self) -> Result<FileType, FileSystemError>

Get the file type of this node

fn is_directory(&self) -> Result<bool, FileSystemError>

Returns true if this node is a directory

fn is_symlink(&self) -> Result<bool, FileSystemError>

Returns true if this node is a symbolic link

fn read_link(&self) -> Result<String, FileSystemError>

Read the target of a symbolic link (returns error if not a symlink)