DiskVFS mounts a directory on the host: every file and folder under root
appears under the mount, and reads and writes go to the real files. It needs
no credentials; see the Disk page.
Install
Configure
capacity="1GB" caps the bytes the root may hold; see
capacity. A mount takes MountMode.READ,
WRITE or EXEC.
Fields
Layout
root: with root="./files", /data/reports/q1.csv is
the file ./files/reports/q1.csv.
Behavior
- Root boundary: a path such as
../../etc/passwdis rejected; every path resolves insideroot. - One mount per folder: a second disk mount whose
rootresolves to a folder already mounted is refused; a folder inside one is fine. - Folder versions: they assume a local POSIX filesystem, where adding,
renaming or removing an entry moves the folder’s change time. Set
folder_versions=Falsefor a network or FUSE root (NFS, SMB, rclone, s3fs, Mirage’s own FUSE). A folder changed in the last 2 seconds gets no version and is re-listed until it has been quiet that long. - Snapshots: a snapshot carries the mount’s files, and loading it restores them.
VFS.md
The VFS.md an agent reads with Disk mounted at/<path>.
<mode> is the mount’s mode: read, write or exec. The commands shown are
those of a write mount.
- Rendered
- Raw
Virtual Filesystem
Supported Unix Commands for VFSUnix commands work on each path as on a local filesystem, as far as the path supports them:
Limitations of Unix Commands for VFSWhere a path differs from a local filesystem:
Run
man <cmd> or <cmd> --help for one command’s usage.