Haskell bindings for the FUSE library
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
System
examples
.gitignore
CHANGELOG.md
CONTRIBUTORS
HFuse.cabal
LICENSE
README.md
Setup.lhs

README.md

Haskell FUSE API

Filesystem in Userspace ("FUSE") makes it possible to implement a filesystem as a userspace program.

This library is the Haskell binding to this library.

License

BSD 3-Clause

Information

Installation

All of the usual methods for installation will be supported. For Mac OS X, you must install OSXFuse first.

Installation via Hackage

cabal install hfuse

Installation for development

Can either be handled via Hackage

cabal unpack hfuse
cd HFuse-0.2.5.0
cabal sandbox init
cabal install --only-dependencies
cabal install -fdeveloper

Or the library can be installed via Github repo

git clone git://github.com/m15k/hfuse
cd hfuse
cabal sandbox init
cabal install --only-dependencies
cabal install -fdeveloper

NOTE!

  • To use the sandboxes feature in Cabal your version must be higher than 1.18. highly recommended

Development

To get a feel for HFuse, there are a number of example applications. They can be built by supplying the -fdeveloper configuration flag to Cabal.

git clone https://github.com/m15k/hfuse

Examples

HelloFS is as basic as you get. Haskell version of the canonical example from the FUSE project. Once compiled here is how you run HelloFS.

$ mkdir ~/fuseTest
$ ./HelloFS ~/fuseTest

This creates a file in the fuseTest directory. Now to test the application.

$ cat ~/fuseTest/hello
Hello World, HFuse!

To unmount issue the following command:

$ fusermount -u ~/fuseTest

Other Samples

There are other projects on hackage which use HFuse as a dependency. Check these out for a possibly richer experience than what is included with the examples folder.

If you lack for inspiration the FUSE Wiki have amassed quite the list of links to downstream projects.

Contributions

Help is always welcome. Pull requests are appreciated.

If you run into any problems or bugs, please report the issue on Github

RoadMap

I would like to create the following examples:

  • MemoryFS.hs := In-memory file system
  • VBoxFS.hs := Mount VirtualBox disks as filesystem
  • SSHFS.hs := SSH file system