Tokio-based asynchronous filesystems library using 9P2000.L protocol, an extended variant of 9P from Plan 9.
Use Rust nightly.
Add the following to your crate:
extern crate rs9p;unpfs is the reference implementation of a file server which exports your filesystem.
You can build unpfs with the following commands below:
cd example/unpfs/
cargo build --verbose --releaseand run unpfs with the following command to export /exportdir:
# TCP
cargo run --release 'tcp!0.0.0.0!564' /exportdir
# or
./target/release/unpfs 'tcp!0.0.0.0!564' /exportdir
# Unix domain socket:
# port number is a suffix to the unix domain socket
# 'unix!/tmp/unpfs-socket!n' creates `/tmp/unpfs-socket:n`
cargo run --release 'unix!/tmp/unpfs-socket!0' /exportdirYou are now ready to import/mount the remote filesystem.
Let's mount it at /mountdir:
# TCP
sudo mount -t 9p -o version=9p2000.L,trans=tcp,port=564,uname=$USER 127.0.0.1 /mountdir
# Unix domain socket
sudo mount -t 9p -o version=9p2000.L,trans=unix,uname=$USER /tmp/unpfs-socket:0 /mountdir| Mount option | Value |
|---|---|
| version | must be "9p2000.L" |
| trans | an alternative v9fs transport. "tcp" or "unix" |
| port | port to connect to on the remote server |
| uname | user name to attempt mount as on the remote server |
See v9fs documentation for more details.
rust-9p is distributed under the BSD 3-Clause License. See LICENSE for details.