Expand description
hyprstream-vfs-server — serve a hyprstream VFS [Namespace] to a Cloud
Hypervisor guest over vhost-user-fs.
This crate is the down half of the bidirectional FileSystem ↔ Mount
bridge from the converged FS/VFS design (FS-A, #362). FS-C built the up
adapter ([hyprstream_vfs::FuseFileSystemMount]) that exposes a
fuse_backend_rs FileSystem (RAFS / OverlayFs / Passthrough) as a VFS
Mount. This crate builds the down adapter
(VfsFileSystem) that exposes a whole VFS Namespace
as a fuse_backend_rs FileSystem, and wires fuse_backend_rs’s FUSE
protocol engine to a vhost-user-fs server (serve) so Cloud Hypervisor can
mount it as a virtio-fs share.
Cloud Hypervisor (virtio-fs / vhost-user-fs device)
→ vhost-user-backend (Unix-socket transport + vring loop) — server.rs
→ fuse_backend_rs::Server (FUSE protocol engine)
→ VfsFileSystem (Namespace → FileSystem down-adapter) — filesystem.rs
→ Namespace mounts (Mount read/write + FsMount writes, Subject-per-call)serve_local is the non-VM counterpart (#653): the same VfsFileSystem
down-adapter, mounted at a host directory via fuse_backend_rs’s fusedev
transport (kernel /dev/fuse) instead of vhost-user-fs. This is what lets
non-VM sandbox backends — podman run --rootfs <dir> (#617), systemd-nspawn --directory=<dir> — consume the same composed per-sandbox namespace
(SandboxFs::compose/into_filesystem, #641/#365) the kata/CH path uses,
rather than side-channeling their own image provisioning:
podman / systemd-nspawn (plain POSIX directory)
→ kernel /dev/fuse (fusedev transport) — server.rs::serve_local
→ fuse_backend_rs::Server (same FUSE protocol engine)
→ VfsFileSystem (same down-adapter, unmodified)
→ Namespace mountsThe crate is native-only (Linux): vhost-user-fs and fuse_backend_rs’s
virtio transport are not available on wasm, and the whole point is serving a
VMM (or, for serve_local, a real kernel FUSE mount). It is genuinely
Send + Sync — no wasm unsafe impl Send.
Structs§
- VfsBackend
- The vhost-user backend hosting a
VfsFileSystem[Server]. - VfsFile
System - The down-adapter: a
fuse_backend_rs[FileSystem] over a VFS [Namespace].
Functions§
- serve
- Serve
fsover the vhost-user-fs Unix socket atsocket_path, blocking until the daemon exits (the VMM disconnects orexit_eventis signalled). - serve_
local - Mount
fsatmountpointas a real host directory via the kernelfusedevtransport (/dev/fuse), blocking until the mount is torn down (unmounted, or the kernel closes the FUSE device).