Skip to content
No-nonsense, actually-working Java bindings to FUSE using JNA.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
.settings Initial structure is in place, nothing works yet, lots of debugging code Jan 15, 2012
lib/jna switch to mavenCentral for dependencies Aug 20, 2013
res Add dump-stat script Oct 19, 2013
src/main Limit filenames to 255 characters in Mac OS X (see issue #58). Nov 1, 2016
.classpath Fix examples script and Eclipse classpath to work with JNA coming fro… Nov 10, 2013
.gitignore Fix examples script and Eclipse classpath to work with JNA coming fro… Nov 10, 2013
LICENSE Update gdrivefs repository URL. Mar 6, 2016
build.gradle LINUX ARM compatibility Feb 7, 2015

Build Status

The straight dope

Grab it

git clone git://

Run it

fuse-jna/examples/ ~/hellofs

You now have a test filesystem in ~/hellofs. You'll find a file called hello.txt in there.

There's another example filesystem that you can use, which is writable:

fuse-jna/examples/ ~/memoryfs

Make your own filesystem

  1. Subclass net.fusejna.FuseFilesystem and override the methods you need (For convenience, there is an adapter called FuseFilesystemAdapterFull).

  2. Create an instance of your subclass, then call .mount(mountpoint) on it.

  3. The filesystem will be unmounted automatically at JVM shutdown time if possible. You can unmount it at runtime using .unmount().

  4. ???

  5. Profit.

  6. (Bonus) You can get logging for free by calling .log(true) or .log(myLogger) on the filesystem instance.

The longer stuff

The idea

fuse-jna was born out of the desire for no-compilation-required, no-bullshit, actually-working bindings to the FUSE library.

Originally built to make the OS X/Linux port of SrcDemo² possible, it was separated into its own library because I figured others would benefit from it.

I like Python, and I like using when writing FUSE filesystems in Python. Thanks to ctypes, it comes in just one file and that's all you need for nice 'n' straight Python bindings. The goal of fuse-jna is to bring FUSE bindings to Java with the same simplicity.

To do that, it uses JNA, which itself was inspired by Python's ctypes in terms of ease-of-use.

"Help! It's too slow!"

First and foremost, this library uses JNA for bindings, rather than JNI. Do not expect native performance. If you need native performance, look elsewhere.

This being said, you can greatly increase throughput by preventing FUSE from chunking writes in tiny blocks, tweaking some JVM parameters, etc. See issue 31 for details.

Other fuse libraries have popped up that use JNR instead of JNA. You might want to use them instead: javafs, jnr-fuse.


Following, fuse-jna should work with:

  • OS X with MacFUSE/fuse4x/OSXFUSE on Intel architectures
  • Linux with FUSE on Intel, ARM, and PowerPC architectures
  • FreeBSD with FUSE on Intel architectures

Projects using fuse-jna

Feel free to open an issue to get your project added here.


fuse-jna is licensed under the BSD 2-Clause License. JNA is licensed under the LGPL v2.1.

You can’t perform that action at this time.