lib.rs

#![allow(unused_imports)]
#![allow(clippy::byte_char_slices)]
#![allow(clippy::needless_range_loop)]
#![allow(clippy::manual_contains)]
#![allow(clippy::while_let_loop)]
#![allow(clippy::if_same_then_else)]
#![allow(clippy::question_mark)]
#![allow(dead_code)]
#![allow(clippy::drop_non_drop)]
#![allow(clippy::while_let_on_iterator)]
#![allow(clippy::single_match)]
#![allow(clippy::ifs_same_cond)]
#![allow(clippy::needless_late_init)]
#![allow(clippy::needless_question_mark)]
#![allow(clippy::explicit_iter_loop)]
#![allow(clippy::manual_range_contains)]
#![allow(clippy::large_enum_variant)]
#![allow(unused_variables)]
#![allow(unused_mut)]
#![allow(unused_doc_comments)]
#![allow(clippy::field_reassign_with_default)]
#![allow(clippy::too_many_arguments)]
#![allow(clippy::write_with_newline)]
#![allow(clippy::manual_div_ceil)]
#![allow(clippy::manual_is_multiple_of)]
#![allow(clippy::ptr_arg)]
#![allow(clippy::string_lit_as_bytes)]
#![allow(clippy::new_without_default)]
#![allow(clippy::search_is_some)]
//! Virtual File System (VFS) Layer
//!
//! This module provides a unified interface for different filesystems:
//! - Device filesystem (devfs) for /dev
//! - RAM filesystem (ramfs) for temporary storage
//! - Future: disk-based filesystems
//!
//! # Architecture
//!
//! ```text
//! +-------------------+
//! |   Syscalls        |  sys_open, sys_read, sys_write, sys_stat, etc.
//! +-------------------+
//!          |
//!          v
//! +-------------------+
//! |   VFS Manager     |  Path resolution, mount table, caching
//! +-------------------+
//!          |
//!    +-----+-----+
//!    |           |
//!    v           v
//! +------+   +-------+
//! | devfs|   | ramfs |   FileSystem trait implementations
//! +------+   +-------+
//! ```
//!
//! # Usage
//!
//! ```rust,ignore
//! // Initialize VFS (sets up devfs at /dev)
//! vfs::init();
//!
//! // Open a device file
//! let fd = vfs::open("/dev/null", OpenFlags::new(OpenFlags::O_RDWR))?;
//!
//! // Get file status
//! let stat = vfs::stat("/dev/console")?;
//! ```

#![no_std]
#![feature(allocator_api)]
extern crate alloc;

// Tests that perturb shared heap admission or assert exact class charges must
// share this lock even when their fixtures span several filesystem modules.
#[cfg(test)]
pub(crate) static HEAP_TEST_LOCK: spin::Mutex<()> = spin::Mutex::new(());

#[macro_use]
extern crate drivers;
#[macro_use]
extern crate klog;

#[cfg(all(test, feature = "host_harness"))]
mod allocation_probe;
pub mod cgroupfs;
mod context;
pub mod devfs;
pub mod ext2;
mod identity;
pub mod initramfs;
pub mod manager;
pub mod mount_namespace;
mod path;
pub mod procfs;
pub mod ramfs;
mod topology;
pub mod traits;
pub mod types;

// Re-exports for convenience
pub use cgroupfs::CgroupFs;
pub use devfs::DevFs;
pub use ext2::{Ext2Fs, Ext2Inode};
pub use initramfs::Initramfs;
pub use manager::{
    init, mount, normalize_path, open, readdir, register_block_device, split_path, stat, umount,
    VFS,
};
pub use procfs::ProcFs;
pub use ramfs::{RamFs, RamFsInode};
pub use traits::{
    FileHandle, FileSystem, Inode, PreparedFileHandle, SharedFileOffset, WeakSharedFileOffset,
};
pub use types::{DirEntry, FileMode, FileType, FsError, OpenFlags, SeekWhence, Stat, TimeSpec};

// Mount namespace re-exports
pub use mount_namespace::{
    add_mount, clone_namespace, copy_mounts, get_mount, init as mount_ns_init, remove_mount, Mount,
    MountFlags, MountNamespace, MountNsError, MAX_MNT_NS_LEVEL, ROOT_MNT_NAMESPACE,
};

/// Initialize the VFS subsystem
///
/// This sets up:
/// - The global VFS instance
/// - Device filesystem mounted at /dev
/// - Standard device files (null, zero, console)
pub fn vfs_init() {
    manager::init();
    klog_always!("VFS subsystem initialized");
}