4 releases

✓ Uses Rust 2018 edition

0.2.1 Dec 2, 2019
0.2.0 Nov 30, 2019
0.1.1 Nov 18, 2019
0.1.0 Nov 16, 2019

#93 in Filesystem

21 downloads per month
Used in 1 crate

MIT/Apache

145KB
4.5K SLoC

polyfuse

A FUSE (Filesystem in Userspace) framework for Rust.


polyfuse is a framework for implementing filesystems based on Filesystem in Userspace (FUSE) in Rust.

The goal of this project is to provide a Rust FUSE library that has a high affinity with the async/.await syntax stabilized in Rust 1.39.

Installation

Add a dependency to your package using cargo-edit as follows:

$ cargo add polyfuse@0.2

To run FUSE daemon, it is necessary to choose appropriate supporting package according to the asynchronous runtime to be used. Currently, polyfuse only provides a support for the tokio and adding support for async-std is a future work.

Platform Requirements

Currently, polyfuse only supports the Linux platforms with the FUSE ABI version is 7.23 or higher. The required kernel version is Linux 3.15 or later.

Adding support for other Unix platform running FUSE (FreeBSD, macOS, and so on) is a future work.

In order to establish the connection with the FUSE kernel driver, the command fusermount must be installed on the platform where the filesystem runs. This binary is typically including in the fuse package provided by the distribution's package system.

On Debian/Ubuntu or other APT based distributions:

$ sudo apt-get install fuse

On Fedora/RHEL or other RPM based distributions:

$ sudo dnf install fuse

On Arch Linux or other Pacman based distributions:

$ sudo pacman -S fuse2

License

This library is licensed under either of

at your option.

Dependencies

~2.5MB
~46K SLoC