A Go package for implementing a FUSE file system (fork with 'almost' zero-copy read/write)
Go to file
Aaron Jacobs 563f47c299 Deleted a broken FreeBSD file. 2015-07-27 11:49:13 +10:00
fsutil Fixed fdatasync build errors on linux. 2015-03-24 12:32:56 +11:00
fuseops Added support for init ops. 2015-07-24 16:35:14 +10:00
fusetesting Reference package syncutil in its new location. 2015-06-15 08:27:39 +10:00
fuseutil Killed the stale random delays feature. 2015-07-16 10:55:38 +10:00
internal Deleted a broken FreeBSD file. 2015-07-27 11:49:13 +10:00
samples Don't rely on fuseshim for errors. 2015-07-24 14:02:55 +10:00
.gitignore Initial commit 2015-02-27 08:52:22 +11:00
.travis.yml Enabled Travis CI. 2015-07-21 21:55:40 +10:00
LICENSE Upated the license file. 2015-07-24 15:40:31 +10:00
README.md Added callouts to the samples. 2015-03-24 16:41:03 +11:00
connection.go Added support for init ops. 2015-07-24 16:35:14 +10:00
doc.go Added a callout to fuseutil.NewFileSystemServer. 2015-03-25 09:18:56 +11:00
errors.go Don't rely on fuseshim for errors. 2015-07-24 14:02:55 +10:00
mount_config.go MountConfig.toOptionsString 2015-07-24 16:09:15 +10:00
mount_darwin.go Removed a TODO that doesn't belong to me. 2015-07-24 16:36:40 +10:00
mount_linux.go Gave mount a makeover. 2015-07-24 16:18:07 +10:00
mounted_file_system.go Use the mount helper in Mount. 2015-07-24 15:56:54 +10:00
unmount.go Fixed unmount.go. 2015-07-24 16:20:44 +10:00
unmount_linux.go Fixed a build error on Linux. 2015-07-24 16:22:33 +10:00
unmount_std.go Fixed unmount_std.go. 2015-07-24 16:21:18 +10:00

README.md

GoDoc

This package allows for writing and mounting user-space file systems from Go. It is a wrapper around bazil.org/fuse, which does the heavy lifting. It does not make use of the bazil.org/fuse/fs sub-package, which allows for something like an object-orientend representation of files and directories, and contains a decent amount of canned behavior.

The chief improvements and/or differences from the bazil.org packages are:

  • No surprises in the form of magic/default behaviors. You must provide an implementation for every method in the interface. Embed a fuseutil.NotImplementedFileSystem struct to have default implementations that return ENOSYS.

  • Every method, struct, and field is thoroughly documented. This may help you get your bearings in the world of FUSE, the Linux VFS, traditional file system implementations, etc., all of which tend to be very poorly documented.

  • Support for arbitrary offsets in directory entries returned by ReadDir. (The bazil.org package assumes that offsets must be counts of bytes.)

The very large disadvantage over using the bazil.org packages is that many features have not yet been exposed.

Make sure to see the sub-packages of the samples package.