Skip to main content

Crate arcbox_fs

Crate arcbox_fs 

Source
Expand description

§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::NegativeCache;
pub use cache::NegativeCacheConfig;
pub use cache::NegativeCacheStats;
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.