HFuse: HFuse is a binding for the Linux FUSE library.

[ bsd3, library, system ] [ Propose Tags ]

Bindings for the FUSE library, compatible with Linux, OSXFUSE and FreeBSD.


[Skip to Readme]

Modules

[Index]

Flags

Automatic Flags
NameDescriptionDefault
developerDisabled

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.2.1, 0.2.2, 0.2.3, 0.2.4, 0.2.4.1, 0.2.4.2, 0.2.4.3, 0.2.4.4, 0.2.4.5, 0.2.5.0
Change log CHANGELOG.md
Dependencies base (>=4 && <5), bytestring, HFuse, unix [details]
License BSD-3-Clause
Author Jeremy Bobbio
Maintainer Montez Fitzpatrick <montezf@gmail.com>
Category System
Home page https://github.com/m15k/hfuse
Source repo head: git clone https://github.com/m15k/hfuse.git
Uploaded by M15K at 2018-01-15T19:41:45Z
Distributions NixOS:0.2.5.0
Reverse Dependencies 3 direct, 0 indirect [details]
Executables HelloFS
Downloads 10725 total (23 in the last 30 days)
Rating 1.75 (votes: 1) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2018-01-15 [all 1 reports]

Readme for HFuse-0.2.5.0

[back to package description]

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