Crate arcbox_fs 

arcbox-fs

High-performance filesystem service for ArcBox.

This crate implements VirtioFS-based file sharing between host and guest, providing near-native file I/O performance.

Key Features

• Zero-copy: Direct memory mapping when possible
• Parallel I/O: Concurrent request handling
• Intelligent caching: Host-side metadata and data caching
• FUSE protocol: Compatible with standard virtiofs drivers

Architecture

Guest: mount -t virtiofs arcbox /mnt/arcbox
                   │
                   ▼
┌─────────────────────────────────────────┐
│              arcbox-fs                   │
│  ┌─────────────────────────────────┐   │
│  │         FuseServer               │   │
│  │  - Request dispatch              │   │
│  │  - Reply handling                │   │
│  └─────────────────────────────────┘   │
│  ┌─────────────────────────────────┐   │
│  │        PassthroughFs             │   │
│  │  - Direct host filesystem access │   │
│  │  - File handle management        │   │
│  └─────────────────────────────────┘   │
└─────────────────────────────────────────┘

Re-exports

pub use cache::AdaptiveTtlConfig;

pub use cache::NegativeCache;

pub use cache::NegativeCacheConfig;

pub use cache::NegativeCacheStats;

pub use cache::TtlRule;

pub use dispatcher::DispatcherConfig;

pub use dispatcher::FuseDispatcher;

pub use dispatcher::RequestContext;

pub use dispatcher::ResponseBuilder;

pub use error::FsError;

pub use error::Result;

pub use fuse::FuseAttr;

pub use fuse::FuseInHeader;

pub use fuse::FuseOpcode;

pub use fuse::FuseOutHeader;

pub use fuse::StatFs;

pub use passthrough::DirEntry;

pub use passthrough::FileType;

pub use passthrough::PassthroughConfig;

pub use passthrough::PassthroughFs;

pub use server::FsServer;

Modules

cache

Filesystem caching layer.

dispatcher

FUSE request dispatcher.

error

Error types for the filesystem service.

fuse

FUSE protocol implementation.

passthrough

Passthrough filesystem implementation.

server

Filesystem server implementation.

Structs

FsConfig

Filesystem configuration.

Enums

CacheProfile

Cache profile for a VirtioFS share.

Traits

DaxMapper

Trait for DAX (Direct Access) memory mapping between host files and guest IPA.