项目作者: mingforpc

项目描述 :
一个纯Golang的libfuse实现
高级语言: Go
项目地址: git://github.com/mingforpc/fuse-go.git
创建时间: 2018-11-13T07:29:41Z
项目社区:https://github.com/mingforpc/fuse-go

开源协议:Apache License 2.0

下载


fuse-go

License
Coverage

一个纯Golang的libfuse实现,目前相当于实现了libfuse中的low level接口。

如何使用

  • fuse.Session是启动和管理整个Fuse运行周期的结构体,所以这个类的实例是必须要有的。
  • fuse.mount中是挂载目录的函数封装,主要是mountumount,具体实现其实是使用了fusermount的。
  • fuse.FuseOpt是保存用户实现的方法的结构体,然后将其传入fuse.Session中。
  • fuse.util中目前提供了两工具类:
    • FusePathManager是一个key: inode,val: filepath的字典
    • NotExistManager是用来缓存那些文件路径不存在的,可以设置一个超时时间

要实现的文件操作接口,可以查看opt_h.go,如果有些接口不需要实现,则直接不赋值(nil)即可。

示例代码

  1. import (
  2. "github.com/mingforpc/fuse-go/fuse"
  3. "github.com/mingforpc/fuse-go/fuse/mount"
  4. )
  5. ......
  6. var getattr = func(req fuse.Req, nodeid uint64) (fsStat *fuse.Stat, result int32) {
  7. ......
  8. return fsStat, result
  9. }
  10. ......
  11. func main() {
  12. ......
  13. opts := fuse.Opt{}
  14. opts.Getattr = &getattr
  15. opts.Opendir = &opendir
  16. opts.Readdir = &readdir
  17. opts.Releasedir = &release
  18. opts.Release = &release
  19. opts.Lookup = &lookup
  20. opts.Open = &open
  21. opts.Read = &read
  22. opts.Mkdir = &mkdir
  23. opts.Create = &create
  24. opts.Setattr = &setattr
  25. opts.Write = &write
  26. opts.Unlink = &unlink
  27. opts.Rmdir = &rmdir
  28. opts.Rename = &rename
  29. opts.Setxattr = &setxattr
  30. opts.Getxattr = &getxattr
  31. opts.Listxattr = &listxattr
  32. opts.Removexattr = &removexattr
  33. ......
  34. se := fuse.NewFuseSession(cg.Mountpoint, &opts, 1024)
  35. ......
  36. err := mount.Mount(se)
  37. ......
  38. se.FuseLoop()
  39. ......
  40. }

原理

通过对/dev/fuse读写,获得内核fuse传过来的文件操作。

详细可以看看fuse/kernel/中的代码。

/dev/fuse交互的请求响应格式,可以参考我的博文FUSE协议解析

Mount部分的代码,为了实现普通用户可以直接Mount,调用了/bin/fusermount(可能需要安装libfuse后才有),Mount的代码主要复制go-fuse,然后自己做了小修改

例子

example中有一个hello的简单例子,具体使用是go build后,hello -mp {挂载的目录}

更详细的例子可以参考我下面的hadoop-fs

https://github.com/mingforpc/hadoop-fs

TODO(按优先级排序)

  • errno中的错误代码需要完善(急)(2018/12/21,已在errno中添加基本的错误代码)
  • 修改好注释和调整结构(2018/12/24)
  • 完成example中的例子(2018/12/29)
  • 发现Close()会存在block的情况,需要解决(急)(2019/1/3)
  • test中添加测试用例(2018/1/14, 大部分函数已经有测试)
  • 测试各个系统上的兼容性(目前只在64位Ubuntu上进行)
  • 完善evloop相关的操作
  • 提供一些管理inodepath的工具类
  • 实现一个高级接口

联系我

如果有什么问题直接联系我指出,万分感谢!

邮箱: jianmingforpc@gmail.com