Hackage :: [Package]

libfuse3: A Haskell binding for libfuse-3.x

[ library, mit, system ] [ Propose Tags ] [ Report a vulnerability ]

Bindings for libfuse, the FUSE userspace reference implementation, of version 3.x. Compatible with Linux.

[Skip to Readme]

Flags

Automatic Flags
NameDescriptionDefault
examplesDisabled

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 0.1.0.0, 0.1.1.0, 0.1.1.1, 0.1.2.0, 0.1.2.1, 0.2.0.0, 0.2.0.1
Change log CHANGELOG.md
Dependencies aeson, base (>=4.11 && <4.15), bytestring (>=0.10.8 && <0.11), clock (>=0.8 && <0.9), directory, filepath, libfuse3, linux-xattr (>=0.1 && <0.2), resourcet (>=1.2 && <1.3), time (>=1.6 && <1.10), unix (>=2.7 && <2.8) [details]
License MIT
Author yohashi
Maintainer yohashi <yohashi1991@gmail.com>
Category System
Source repo head: git clone https://github.com/matil019/haskell-libfuse3
Uploaded by yohashi at 2020-08-27T12:00:10Z
Distributions NixOS:0.2.0.1
Executables statjson, passthrough, null
Downloads 1105 total (19 in the last 30 days)
Rating 1.75 (votes: 1) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs uploaded by user [build log]
All reported builds failed as of 2020-08-27 [all 1 reports]

Readme for libfuse3-0.1.0.0

[back to package description]

libfuse3: A Haskell binding to libfuse-3.x

GitHub Actions

Important notes

  • Executables using libfuse3 should be compiled with the threaded runtime (-threaded).
  • Developed and tested on Linux only. Not tested on other UNIXes such as BSD and MacOS because I don't own them / machines to run them on.

Building from HEAD

This packages uses the ./configure script, but it is not checked into the git repository. To build the source checked out from git, you must generate it from configure.ac before invoking any of the cabal commands:

autoreconf -fiv
# cabal v2-build, etc.

You may have to install autotools or something like that with your system package manager.

Examples

There are two examples, null and passthrough in the example directory. These are the ports of the examples in the official libfuse. They should be good start points for writing your filesystems.

Enable the cabal flag to build them:

cabal v2-configure --flags=examples

Known issues and limitations

  • Can't stop the process and unmount with signals. You have to use fusermount -u to unmount.
  • Not all Haskell-friendly bindings to the FUSE operations are implemented yet, including but not limited to:
    • struct fuse_conn_info. The availability of filesystem capabilities such as FUSE_CAP_HANDLE_KILLPRIV can't be checked.
    • Setting the fields of struct fuse_file_info from the certain fuse operations.
  • Look for the TODO comments in the source tree for more specific topics.

If you are able to implement any of these, that would be very appreciated! Please open a PR to contribute.

  • libfuse: The reference implementation, to which this package binds
  • HFuse: The bindings to libfuse-2.x
    • libfuse3 is based on HFuse (with massive rewrites).
    • libfuse3 has more complete API and exposes internal (and unstable) API to allow workarounds.
  • fuse-rs: The Rust implementation of FUSE. Unlike this package, fuse-rs implements the FUSE protocol itself (i.e. replaces libfuse). See its README for overview.