rfuse 1.2.3 → 2.0.0.ffilibfuse

data/lib/rfuse.rb

@@ -1,645 +1,430 @@
+# frozen_string_literal: true
+
 require 'fcntl'
-require 'rfuse/version'
-require 'rfuse/rfuse'
-require 'rfuse/compat'
+require_relative 'rfuse/version'
+require_relative 'rfuse/rfuse'
+require_relative 'rfuse/compat'
+require_relative 'rfuse/stat'
+require_relative 'rfuse/statvfs'
+require_relative 'rfuse/flock'
 
 # Ruby FUSE (Filesystem in USErspace) binding
 module RFuse
 
-    # @private
-    # Used by listxattr
-    def self.packxattr(xattrs)
-        case xattrs
-        when Array
-            xattrs.join("\000").concat("\000")
-        when String
-            #assume already \0 separated list of keys
-            xattrs
-        else
-            raise Error, ":listxattr must return Array or String, got #{xattrs.inspect}"
-        end
+  class Error < StandardError; end
+
+  # @private
+  # Used by listxattr
+  def self.packxattr(xattrs)
+    case xattrs
+    when Array
+      xattrs.join("\000").concat("\000")
+    when String
+      # assume already \0 separated list of keys
+      xattrs
+    else
+      raise Error, ":listxattr must return Array or String, got #{xattrs.inspect}"
+    end
+  end
+
+  # Parse mount arguments and options
+  #
+  # @param [Array<String>] argv
+  #        normalised fuse options
+  #
+  # @param [Array<Symbol>] local_opts local options
+  #        if these are found in the argv entry following "-o" they are removed
+  #        from argv, ie so argv is a clean set of options that can be passed
+  #        to {RFuse::Fuse} or {RFuse::FuseDelegator}
+  #
+  #
+  # @return [Hash<Symbol,String|Boolean>]
+  #         the extracted options
+  #
+  # @since 1.0.3
+  #
+  # Fuse itself will normalise arguments
+  #
+  #     mount -t fuse </path/to/fs.rb>#<device> mountpoint [options...]
+  #     mount.fuse </path/to/fs.rb>#<device> mountpoint [options...]
+  #
+  # both result in the following command execution
+  #
+  #     /path/to/fs.rb [device] mountpoint [-h] [-d] [-o [opt,optkey=value,...]]
+  #
+  # which this method will parse into a Hash with the following special keys
+  #
+  #  * `:device` - the optional mount device, removed from argv if present
+  #  * `:mountpoint` - required mountpoint
+  #  * `:help` - if -h was supplied - will print help text (and not mount the filesystem!)
+  #  * `:debug` - if -d (or -o debug) was supplied - will print debug output from the underlying FUSE library
+  #
+  # and any other supplied options.
+  #
+  # @example
+  #   argv = [ "some/device", "/mnt/point", "-h", "-o", "debug,myfs=aValue" ]
+  #   options = RFuse.parse_options(argv,:myfs)
+  #
+  #   # options ==
+  #   { :device => "some/device",
+  #     :mountpoint => "/mnt/point",
+  #     :help => true,
+  #     :debug => true,
+  #     :myfs => "aValue"
+  #   }
+  #   # and argv ==
+  #   [ "/mnt/point","-h","-o","debug" ]
+  #
+  #   fs = create_filesystem(options)
+  #   fuse = RFuse::FuseDelegator.new(fs,*ARGV)
+  #
+  def self.parse_options(argv, *local_opts, desc: nil, exec: $0)
+
+    def desc.fuse_help
+      self
+    end if desc && !desc.empty?
+
+    argv.unshift(exec) unless argv.size >= 2 && argv[0..1].none? { |a| a.start_with?('-') }
+    run_args = FFI::Libfuse::Main.fuse_parse_cmdline(*argv, handler: desc)
+
+    run_args[:help] = true if run_args[:show_help] # compatibility
+
+    device_opts = { 'subtype=' => :device, 'fsname=' => :device }
+    local_opt_conf = local_opts.each.with_object(device_opts) do |o, conf|
+      conf.merge!({ "#{o}=" => o.to_sym, "#{o}" => o.to_sym })
     end
 
-    # Parse mount arguments and options
-    #
-    # @param [Array<String>] argv
-    #        normalised fuse options
-    #
-    # @param [Array<Symbol>] local_opts local options
-    #        if these are found in the argv entry following "-o" they are removed
-    #        from argv, ie so argv is a clean set of options that can be passed
-    #        to {RFuse::Fuse} or {RFuse::FuseDelegator}
-    #
-    #
-    # @return [Hash<Symbol,String|Boolean>]
-    #         the extracted options
-    #
-    # @since 1.0.3
-    #
-    # Fuse itself will normalise arguments
-    #
-    #     mount -t fuse </path/to/fs.rb>#<device> mountpoint [options...]
-    #     mount.fuse </path/to/fs.rb>#<device> mountpoint [options...]
-    #
-    # both result in the following command execution
-    #
-    #     /path/to/fs.rb [device] mountpoint [-h] [-d] [-o [opt,optkey=value,...]]
-    #
-    # which this method will parse into a Hash with the following special keys
-    #
-    #  * `:device` - the optional mount device, removed from argv if present
-    #  * `:mountpoint` - required mountpoint
-    #  * `:help` - if -h was supplied - will print help text (and not mount the filesystem!)
-    #  * `:debug` - if -d (or -o debug) was supplied - will print debug output from the underlying FUSE library
-    #
-    # and any other supplied options.
-    #
-    # @example
-    #   ARGV = [ "some/device", "/mnt/point", "-h", "-o", "debug,myfs=aValue" ]
-    #   options = RFuse.parse_options(ARGV,:myfs)
-    #
-    #   # options ==
-    #   { :device => "some/device",
-    #     :mountpoint => "/mnt/point",
-    #     :help => true,
-    #     :debug => true,
-    #     :myfs => "aValue"
-    #   }
-    #   # and ARGV ==
-    #   [ "/mnt/point","-h","-o","debug" ]
-    #
-    #   fs = create_filesystem(options)
-    #   fuse = RFuse::FuseDelegator.new(fs,*ARGV)
-    #
-    def self.parse_options(argv,*local_opts)
-        result = Hash.new(nil)
-
-        first_opt_index = (argv.find_index() { |opt| opt =~ /^-.*/ } || argv.length )
-
-        result[:device] = argv.shift if first_opt_index > 1
-        result[:mountpoint] = argv[0] if argv.length > 0
-
-        if argv.include?("-h")
-            result[:help]  =  true
-        end
+    fuse_args = run_args.delete(:args)
 
-        if argv.include?("-d")
-            result[:debug] = true
-        end
+    fuse_args.parse!(local_opt_conf, run_args, **{}) do |key:, value:, data:, **_|
+      data[key] = value
+      key == :device ? :keep : :discard
+    end
 
-        opt_index = ( argv.find_index("-o") || -1 ) + 1
+    argv.replace(fuse_args.argv)
+    # The first arg is actually the device and ignored in future calls to parse opts
+    # (eg during fuse_new, but rfuse used to return the mountpoint here.
+    argv[0] = run_args[:mountpoint]
+
+    run_args
+  end
+
+  # Generate a usage string
+  #
+  # @param [String] device a description of how the device field should be used
+  # @param [String] exec the executable
+  # @return [String] the usage string
+  def self.usage(device = nil, exec = File.basename($PROGRAM_NAME))
+    "Usage:\n     #{exec} #{device} mountpoint [-h] [-d] [-o [opt,optkey=value,...]]\n"
+  end
+
+  # Convenience method to launch a fuse filesystem, with nice usage messages and default signal traps
+  #
+  # @param [Array<String>] argv command line arguments
+  # @param [Array<Symbol>] extra_options list of additional options
+  # @param [String] extra_options_usage describing additional option usage
+  # @param [String] device a description of the device field
+  # @param [String] exec the executable file
+  #
+  # @yieldparam [Hash<Symbol,String>] options See {.parse_options}
+  # @yieldparam [Array<String>] argv Cleaned argv See {.parse_options}
+  #
+  # @yieldreturn [Class<Fuse>]
+  #   a subclass of {Fuse} that implements your filesystem. Will receive `.new(*extra_options,*argv)`
+  #
+  # @yieldreturn [Class]
+  #   a class that implements {FuseDelegator::FUSE_METHODS}. Will receive `.new(*extra_options)`
+  #   and the resulting instance sent with `*argv` to {FuseDelegator}
+  #
+  # @yieldreturn [Fuse]
+  #   Your initialised (and therefore already mounted) filesystem
+  #
+  # @yieldreturn [Object]
+  #   An object that implements the {Fuse} methods, to be passed with `*argv` to {FuseDelegator}
+  #
+  # @yieldreturn [Error]
+  #   raise {Error} with appropriate message for invalid options
+  #
+  # @since 1.1.0
+  #
+  # @example
+  #
+  #   class MyFuse < Fuse
+  #      def initialize(myfs,*argv)
+  #         @myfs = myfs # my filesystem local option value
+  #         super(*argv)
+  #      end
+  #      # ... implementations for filesystem methods ...
+  #   end
+  #
+  #   class MyFSClass  # not a subclass of Fuse, FuseDelegator used
+  #      def initialize(myfs)
+  #       @myfs = myfs # my filesystem local option value
+  #      end
+  #      # ...
+  #   end
+  #
+  #   MY_OPTIONS = [ :myfs ]
+  #   OPTION_USAGE = "  -o myfs=VAL how to use the myfs option"
+  #   DEVICE_USAGE = "how to use device arg"
+  #
+  #   # Normally from the command line...
+  #   ARGV = [ "some/device", "/mnt/point", "-h", "-o", "debug,myfs=aValue" ]
+  #
+  #   RFuse.main(ARGV, MY_OPTIONS, OPTION_USAGE, DEVICE_USAGE, $0) do |options, argv|
+  #
+  #       # options ==
+  #          { :device => "some/device",
+  #            :mountpoint => "/mnt/point",
+  #            :help => true,
+  #            :debug => true,
+  #            :myfs => "aValue"
+  #          }
+  #
+  #       # ... validate options...
+  #       raise RFuse::Error, "Bad option" unless options[:myfs]
+  #
+  #       # return the filesystem class to be initialised by RFuse
+  #       MyFuse
+  #       # or
+  #       MyFSClass
+  #
+  #       # OR take full control over initialisation yourself and return the object
+  #       MyFuse.new(options[:myfs],*argv)
+  #       # or
+  #       MyFSClass.new(options[:myfs])
+  #
+  #   end
+  #
+  def self.main(argv = ARGV.dup, extra_options = [], extra_options_usage = nil, device = nil, exec = File.basename($PROGRAM_NAME))
+    begin
+      fuse_help = ['Filesystem options:',extra_options_usage,device,''].compact.join("\n")
+
+      options = parse_options(argv, *extra_options, desc: extra_options_usage && fuse_help, exec: exec)
+
+      unless options[:mountpoint]
+        warn "rfuse: failed, no mountpoint provided"
+        puts usage(device,exec)
+        return nil
+      end
+
+      fs = yield options, argv
+
+      raise Error, 'no filesystem provided' unless fs
+
+      # create can pass the extra options to a constructor so order and existence is important.
+      fs_options = extra_options.each_with_object({}) { |k,h| h[k] = options.delete(k) }
+      fuse = create(argv: argv, fs: fs, options: fs_options)
+
+      return nil if options[:show_help] || options[:show_version]
+
+      raise Error, "filesystem #{fs} not mounted" unless fuse&.mounted?
+
+      fuse.run(**options)
+    rescue Error => e
+      # These errors are produced generally because the user passed bad arguments etc..
+      puts usage(device, exec) unless options[:help]
+      warn "rfuse failed: #{e.message}"
+      nil
+    rescue StandardError => e
+      # These are other errors related the yield block
+      warn e.message
+      warn e.backtrace.join("\n")
+    end
+  end
+
+  # @private
+  # Helper to create a {Fuse} from variety of #{.main} yield results
+  def self.create(fs:, argv: [], options: {})
+    if fs.is_a?(Fuse)
+      fs
+    elsif fs.is_a?(Class)
+      if Fuse > fs
+        fs.new(*options.values, *argv)
+      else
+        delegate = fs.new(*options.values)
+        FuseDelegator.new(delegate, *argv)
+      end
+    elsif fs
+      FuseDelegator.new(fs, *argv)
+    end
+  end
 
-        if opt_index > 1 && opt_index < argv.length
-            options = argv[opt_index].split(",")
+  class Fuse
 
-            options.delete_if() do |opt|
-                opt.strip!
+    attr_reader :mountpoint
+    alias mountname mountpoint
 
-                opt,value = opt.split("=",2)
-                value = true unless value
-                opt_sym = opt.to_sym
-                result[opt_sym] = value
+    def initialize(mountpoint, *argv)
+      @mountpoint = mountpoint
+      @fuse = FFI::Libfuse::Main.fuse_create(mountpoint, *argv, operations: self, private_data: self)
+    end
 
-                #result of delete if
-                local_opts.include?(opt_sym)
-            end
+    #    Is the filesystem successfully mounted
+    #
+    #    @return [Boolean] true if mounted, false otherwise
+    def mounted?
+      @fuse && @fuse.mounted?
+    end
 
-            if options.empty?
-                argv.slice!(opt_index - 1,2)
-            else
-                argv[opt_index] = options.join(",")
-            end
-        end
+    # Convenience method to run a mounted filesystem to completion.
+    #
+    # @param [Array<String|Integer>] signals list of signals to handle.
+    #   Default is all available signals. See {#trap_signals}
+    #
+    # @return [void]
+    # @since 1.1.0
+    # @see RFuse.main
+    def run(signals = Signal.list.keys, **run_args)
+      raise Error, 'not mounted' unless @fuse
+      trap_signals(*signals)
+      @fuse.run(traps: @traps, **run_args)
+    end
 
-        result
+    def loop
+      run([] ,single_thread: true, foreground: true)
     end
 
-    # Generate a usage string
-    #
-    # @param [String] device a description of how the device field should be used
-    # @param [String] exec the executable
-    # @return [String] the usage string
-    def self.usage(device=nil,exec=File.basename($0))
-        "Usage:\n     #{exec} #{device} mountpoint [-h] [-d] [-o [opt,optkey=value,...]]\n"
+    # Stop processing
+    def exit
+      @fuse&.exit&.join
     end
+    alias :unmount :exit
 
-    # Convenience method to launch a fuse filesystem, with nice usage messages and default signal traps
+    # Set traps
     #
-    # @param [Array<String>] argv command line arguments
-    # @param [Array<Symbol>] extra_options list of additional options
-    # @param [String] extra_options_usage describing additional option usage
-    # @param [String] device a description of the device field
-    # @param [String] exec the executable file
+    # The filesystem supports a signal by providing a `sig<name>` method. eg {#sigint}
     #
-    # @yieldparam [Hash<Symbol,String>] options See {.parse_options}
-    # @yieldparam [Array<String>] argv Cleaned argv See {.parse_options}
+    # The fuse {#loop} is notified of the signal via the self-pipe trick, and calls the corresponding
+    #   `sig<name>` method, after any current filesystem operation completes.
     #
-    # @yieldreturn [Class<Fuse>]
-    #   a subclass of {Fuse} that implements your filesystem. Will receive `.new(*extra_options,*argv)`
+    # This method will not override traps that have previously been set to something other than "DEFAULT"
     #
-    # @yieldreturn [Class]
-    #   a class that implements {FuseDelegator::FUSE_METHODS}. Will receive `.new(*extra_options)`
-    #   and the resulting instance sent with `*argv` to {FuseDelegator}
+    # Note: {Fuse} itself provides {#sigterm} and {#sigint}.
     #
-    # @yieldreturn [Fuse]
-    #   Your initialised (and therefore already mounted) filesystem
+    # @param [Array<String>] signames
+    #   List of signal names to set traps for, if the filesystem has methods to handle them.
+    #   Use `Signal.list.keys` to try all available signals.
     #
-    # @yieldreturn [Object]
-    #   An object that implements the {Fuse} methods, to be passed with `*argv` to {FuseDelegator}
-    #
-    # @yieldreturn [Error]
-    #   raise {Error} with appropriate message for invalid options
+    # @return [Array<String>] List of signal names that traps have been set for.
     #
     # @since 1.1.0
     #
     # @example
-    #
-    #   class MyFuse < Fuse
-    #      def initialize(myfs,*argv)
-    #         @myfs = myfs # my filesystem local option value
-    #         super(*argv)
+    #   class MyFS < Fuse
+    #      def sighup()
+    #          # do something on HUP signal
     #      end
-    #      # ... implementations for filesystem methods ...
     #   end
     #
-    #   class MyFSClass  # not a subclass of Fuse, FuseDelegator used
-    #      def initialize(myfs)
-    #       @myfs = myfs # my filesystem local option value
-    #      end
-    #      # ...
-    #   end
-    #
-    #   MY_OPTIONS = [ :myfs ]
-    #   OPTION_USAGE = "  -o myfs=VAL how to use the myfs option"
-    #   DEVICE_USAGE = "how to use device arg"
-    #
-    #   # Normally from the command line...
-    #   ARGV = [ "some/device", "/mnt/point", "-h", "-o", "debug,myfs=aValue" ]
-    #
-    #   RFuse.main(ARGV, MY_OPTIONS, OPTION_USAGE, DEVICE_USAGE, $0) do |options, argv|
-    #
-    #       # options ==
-    #          { :device => "some/device",
-    #            :mountpoint => "/mnt/point",
-    #            :help => true,
-    #            :debug => true,
-    #            :myfs => "aValue"
-    #          }
-    #
-    #       # ... validate options...
-    #       raise RFuse::Error, "Bad option" unless options[:myfs]
-    #
-    #       # return the filesystem class to be initialised by RFuse
-    #       MyFuse
-    #       # or
-    #       MyFSClass
-    #
-    #       # OR take full control over initialisation yourself and return the object
-    #       MyFuse.new(options[:myfs],*argv)
-    #       # or
-    #       MyFSClass.new(options[:myfs])
+    #   fuse = MyFS.new(*args)
     #
+    #   if fuse.mounted?
+    #       # Below will result in (effectively) Signal.trap("HUP") { fuse.sighup() }
+    #       fuse.trap_signals("HUP","USR1") # ==> ["HUP"]
+    #       fuse.loop()
     #   end
     #
-    def self.main(argv=ARGV,extra_options=[],extra_options_usage=nil,device=nil,exec=File.basename($0))
-
-        options = parse_options(argv,*extra_options)
-
-        unless options[:mountpoint]
-            $stderr.puts "rfuse: failed, no mountpoint provided"
-            puts usage(device,exec)
-            return nil
-        end
-
-        if options[:help]
-            puts usage(device,exec)
-            # TODO: In Fuse 3.0 this looks like it will move to $stdout
-            help_io = STDERR
-            help_io.puts "Fuse options: (#{FUSE_MAJOR_VERSION}.#{FUSE_MINOR_VERSION})"
-            help_io.puts "    -h                     help - print this help output"
-            help_io.puts "    -d |-o debug           enable internal FUSE debug output"
-            help_io.puts ""
-            help_io.flush()
-
-            # Cause Fuse kernel Options to print, but don't actually start a filesystem
-            Fuse.new(*argv)
-
-            if extra_options_usage
-                help_io.puts "Filesystem options:"
-                help_io.puts extra_options_usage
-            end
-
-            return nil
-        end
-
-        begin
-            fs = yield options,argv
-
-            raise Error, "no filesystem provided" unless fs
-
-            fuse = create(fs,argv,options,extra_options)
-
-            raise Error, "filesystem #{fs} not mounted" unless fuse && fuse.mounted?
-
-            fuse.run
-        rescue Error => fuse_ex
-            # These errors are produced generally because the user passed bad arguments etc..
-            puts usage(device,exec) unless options[:help]
-            $stderr.puts "rfuse failed: #{fuse_ex.message}"
-            return nil
-        rescue => ex
-            # These are other errors related the yield block
-            $stderr.puts ex.message
-            $stderr.puts ex.backtrace.join("\n")
-        end
+    def trap_signals(*signames)
+      signames = signames.map { |n| n.to_s.upcase }.map { |n| n.start_with?('SIG') ? n[3..-1] : n }
+      signames.keep_if { |n| Signal.list[n] && respond_sigmethod?(sigmethod(n)) }
 
+      @traps ||= {}
+      @traps.merge!(signames.map { |n| [ n, ->() { call_sigmethod(sigmethod(n)) }]}.to_h)
+      @traps.keys
     end
 
+    private
 
-    # @private
-    # Helper to create a {Fuse} from variety of #{.main} yield results
-    def self.create(fs, argv=[], options = {}, extra_options = [])
-        if fs.kind_of?(Fuse)
-            fs
-        elsif fs.is_a?(Class)
-            extra_option_values = extra_options.map { |o| options[o] }
-            if Fuse > fs
-                fs.new(*extra_option_values,*argv)
-            else
-                delegate = fs.new(*extra_option_values)
-                FuseDelegator.new(delegate,*argv)
-            end
-        elsif fs
-            FuseDelegator.new(fs,*argv)
-        end
+    def respond_sigmethod?(sigmethod)
+      respond_to?(sigmethod)
+    end
+
+    def sigmethod(signame)
+      "sig#{signame.downcase}".to_sym
     end
 
-    public
-
-    class Fuse
-
-        # Convenience method to run a mounted filesystem to completion.
-        #
-        # @param [Array<String|Integer>] signals list of signals to handle.
-        #   Default is all available signals. See {#trap_signals}
-        #
-        # @return [void]
-        # @since 1.1.0
-        # @see RFuse.main
-        def run(signals=Signal.list.keys)
-            if mounted?
-                begin
-                    traps = trap_signals(*signals)
-                    self.loop()
-                ensure
-                    traps.each { |t| Signal.trap(t,"DEFAULT") }
-                    unmount()
-                end
-            end
-        end
-
-        # Main processing loop
-        #
-        # Use {#exit} to stop processing (or externally call fusermount -u)
-        #
-        # Other ruby threads can continue while loop is running, however
-        # no thread can operate on the filesystem itself (ie with File or Dir methods)
-        #
-        # @return [void]
-        # @raise [RFuse::Error] if already running or not mounted
-        def loop()
-            raise RFuse::Error, "Already running!" if @running
-            raise RFuse::Error, "FUSE not mounted" unless mounted?
-            @running = true
-            while @running do
-                begin
-                    ready, ignore, errors  = IO.select([@fuse_io,@pr],[],[@fuse_io])
-
-                    if ready.include?(@pr)
-
-                        signo = @pr.read_nonblock(1).unpack("c")[0]
-
-                        # Signal.signame exist in Ruby 2, but returns horrible errors for non-signals in 2.1.0
-                        if (signame = Signal.list.invert[signo])
-                            call_sigmethod(sigmethod(signame))
-                        end
-
-                    elsif errors.include?(@fuse_io)
-
-                        @running = false
-                        raise RFuse::Error, "FUSE error"
-
-                    elsif ready.include?(@fuse_io)
-                        if process() < 0
-                            # Fuse has been unmounted externally
-                            # TODO: mounted? should now return false
-                            # fuse_exited? is not true...
-                            @running = false
-                        end
-                    end
-                rescue Errno::EWOULDBLOCK, Errno::EAGAIN
-                    #oh well...
-                end
-            end
-        end
-
-        # Stop processing {#loop}
-        # eg called from signal handlers, or some other monitoring thread
-        def exit
-            @running = false
-            send_signal(-1)
-        end
-
-        # Set traps
-        #
-        # The filesystem supports a signal by providing a `sig<name>` method. eg {#sigint}
-        #
-        # The fuse {#loop} is notified of the signal via the self-pipe trick, and calls the corresponding
-        #   `sig<name>` method, after any current filesystem operation completes.
-        #
-        # This method will not override traps that have previously been set to something other than "DEFAULT"
-        #
-        # Note: {Fuse} itself provides {#sigterm} and {#sigint}.
-        #
-        # @param [Array<String>] signames
-        #   List of signal names to set traps for, if the filesystem has methods to handle them.
-        #   Use `Signal.list.keys` to try all available signals.
-        #
-        # @return [Array<String>] List of signal names that traps have been set for.
-        #
-        # @since 1.1.0
-        #
-        # @example
-        #   class MyFS < Fuse
-        #      def sighup()
-        #          # do something on HUP signal
-        #      end
-        #   end
-        #
-        #   fuse = MyFS.new(*args)
-        #
-        #   if fuse.mounted?
-        #       # Below will result in (effectively) Signal.trap("HUP") { fuse.sighup() }
-        #       fuse.trap_signals("HUP","USR1") # ==> ["HUP"]
-        #       fuse.loop()
-        #   end
-        #
-        def trap_signals(*signames)
-            signames.map { |n| n.to_s.upcase }.map { |n| n.start_with?("SIG") ? n[3..-1] : n }.select do |signame|
-                next false unless respond_sigmethod?(sigmethod(signame)) && signo = Signal.list[signame]
-
-                next true if (prev = Signal.trap(signo) { |signo| send_signal(signo) }) == "DEFAULT"
-
-                Signal.trap(signo,prev)
-                false
-            end
-        end
-
-        # Default signal handler to exit on TERM/INT
-        # @return [void]
-        # @see #trap_signals
-        def sigterm
-            @running = false
-        end
-        alias :sigint :sigterm
-
-        private
-
-        # Called by the C iniitialize
-        # afer the filesystem has been mounted successfully
-        def ruby_initialize
-            @running = false
-
-            # Self-pipe for handling signals and exit
-            @pr,@pw = IO.pipe()
-
-            # The FD was created by FUSE so we don't want
-            # ruby to do anything with it during GC
-            @fuse_io = IO.for_fd(fd(),"r",:autoclose => false)
-        end
-
-        # Called by C unmount before doing all the FUSE stuff
-        def ruby_unmount
-            @pr.close if @pr && !@pr.closed?
-            @pw.close if @pw && !@pw.closed?
-
-            # Ideally we want this IO to avoid autoclosing at GC, but
-            # in Ruby 1.8 we have no way to do that. A work around is to close
-            # the IO here. FUSE won't necessarily like that but it is the best
-            # we can do
-            @fuse_io.close() if @fuse_io && !@fuse_io.closed? && @fuse_io.autoclose?
-        end
-
-        def call_sigmethod(sigmethod)
-            send(sigmethod)
-        end
-
-        def respond_sigmethod?(sigmethod)
-            respond_to?(sigmethod)
-        end
-
-        def sigmethod(signame)
-           "sig#{signame.downcase}".to_sym
-        end
-
-        def send_signal(signo)
-            @pw.write([signo].pack("c")) unless !@pw || @pw.closed?
-        end
+    def call_sigmethod(sigmethod)
+      send(sigmethod)
     end
 
-    #This class is useful to make your filesystem implementation
-    #debuggable and testable without needing to mount an actual filesystem
-    #or inherit from {Fuse}
-    class FuseDelegator < Fuse
-
-        # Available fuse methods -see http://fuse.sourceforge.net/doxygen/structfuse__operations.html
-        #  Note :getdir and :utime are deprecated
-        #  :ioctl, :poll are not implemented in the C extension
-        FUSE_METHODS = [ :getattr, :readlink, :getdir, :mknod, :mkdir,
-            :unlink, :rmdir, :symlink, :rename, :link,
-            :chmod, :chown, :truncate, :utime, :open,
-            :create, :read, :write, :statfs, :flush,
-            :release, :fsync, :setxattr, :getxattr, :listxattr,:removexattr,
-            :opendir, :readdir, :releasedir, :fsycndir,
-            :init, :destroy, :access, :ftruncate, :fgetattr, :lock,
-            :utimens, :bmap, :ioctl, :poll ]
-
-        # @param [Object] fuse_object your filesystem object that responds to fuse methods
-        # @param [String] mountpoint existing directory where the filesystem will be mounted
-        # @param [String...] options fuse mount options (use "-h" to see a list)
-        #
-        # Create and mount a filesystem
-        #
-        def initialize(fuse_object,mountpoint,*options)
-            @fuse_delegate = fuse_object
-            define_fuse_methods(fuse_object)
-            @debug = false
-            self.debug=$DEBUG
-            super(mountpoint,options)
-        end
-
-        # USR1 sig handler - toggle debugging of fuse methods
-        # @return [void]
-        def sigusr1()
-            self.debug=!@debug
-        end
-
-        # RFuse Debugging status
-        #
-        # @note this is independent of the Fuse kernel module debugging enabled with the "-d" mount option
-        #
-        # @return [Boolean] whether debugging information should be printed to $stderr around each fuse method.
-        #    Defaults to $DEBUG
-        # @since 1.1.0
-        # @see #sigusr1
-        def debug?
-            @debug
-        end
-
-        # Set debugging on or off
-        # @param [Boolean] value enable or disable debugging
-        # @return [Boolean] the new debug value
-        # @since 1.1.0
-        def debug=(value)
-            value = value ? true : false
-            if @debug && !value
-                $stderr.puts "=== #{ self }.debug=false"
-            elsif !@debug && value
-                $stderr.puts "=== #{ self }.debug=true"
-            end
-            @debug = value
-        end
-
-        # @private
-        def to_s
-            "#{self.class.name}::#{@fuse_delegate}"
-        end
-        private
-
-        def define_fuse_methods(fuse_object)
-            FUSE_METHODS.each do |method|
-                if fuse_object.respond_to?(method)
-                    method_name = method.id2name
-                    instance_eval(<<-EOM, "(__FUSE_DELEGATE__)",1)
-                    def #{method_name} (*args,&block)
-                        begin
-                            $stderr.puts "==> \#{ self }.#{ method_name }(\#{args.inspect })" if debug?
-                            result = @fuse_delegate.send(:#{method_name},*args,&block)
-                            $stderr.puts "<== \#{ self }.#{ method_name }()"  if debug?
-                            result
-                        rescue => ex
-                            $@.delete_if{|s| /^\\(__FUSE_DELEGATE__\\):/ =~ s}
-                            $stderr.puts(ex.message) unless ex.respond_to?(:errno) || debug?
-                            Kernel::raise
-                        end
-                    end
-                    EOM
-                end
-            end
-        end
-
-        def call_sigmethod(sigmethod)
-            $stderr.puts "==> #{ self }.#{ sigmethod }()" if debug?
-            dlg = @fuse_delegate.respond_to?(sigmethod) ? @fuse_delegate : self
-            dlg.send(sigmethod)
-            $stderr.puts "<== #{ self }.#{ sigmethod }()"  if debug?
-        end
-
-        def respond_sigmethod?(sigmethod)
-            @fuse_delegate.respond_to?(sigmethod) || self.respond_to?(sigmethod)
-        end
-
-
-    end #class FuseDelegator
-
-    class Context
-        # @private
-        def to_s
-            "Context::u#{uid},g#{gid},p#{pid}"
-        end
+    def self.inherited(klass)
+      klass.include(Adapter) unless klass.ancestors.include?(Adapter)
     end
+  end
 
-    class Filler
-        # @private
-        def to_s
-            "Filler::[]"
-        end
+  # This class is useful to make your filesystem implementation
+  # debuggable and testable without needing to mount an actual filesystem
+  # or inherit from {Fuse}
+  class FuseDelegator < Fuse
+
+    # @param [Object] fuse_object your filesystem object that responds to fuse methods
+    # @param [String] mountpoint existing directory where the filesystem will be mounted
+    # @param [String...] options fuse mount options (use "-h" to see a list)
+    #
+    # Create and mount a filesystem
+    #
+    def initialize(fuse_object, mountpoint, *options)
+      @fuse_delegate = fuse_object
+      @debug = $DEBUG
+      super(mountpoint, *options)
+    end
+
+    # USR1 sig handler - toggle debugging of fuse methods
+    # @return [void]
+    def sigusr1
+      @debug = !debug?
+    end
+
+    def debug?
+      @debug
     end
 
-    class FileInfo
-        # @private
-        def to_s
-            "FileInfo::fh->#{fh}"
-        end
+    # @private
+    def to_s
+      "#{self.class.name}::#{@fuse_delegate}"
     end
 
-    # Helper class to return from :getattr method
-    class Stat
-        # Format mask
-        S_IFMT   = 0170000
-        # Directory
-        S_IFDIR  = 0040000
-        # Character device
-        S_IFCHR  = 0020000
-        # Block device
-        S_IFBLK  = 0060000
-        # Regular file
-        S_IFREG  = 0100000
-        # FIFO.
-        S_IFIFO  = 0010000
-        # Symbolic link
-        S_IFLNK  = 0120000
-        # Socket
-        S_IFSOCK = 0140000
-
-        # @param [Fixnum] mode file permissions
-        # @param [Hash<Symbol,Fixnum>] values initial values for other attributes
-        #
-        # @return [Stat] representing a directory
-        def self.directory(mode=0,values = { })
-            return self.new(S_IFDIR,mode,values)
-        end
-
-        # @param [Fixnum] mode file permissions
-        # @param [Hash<Symbol,Fixnum>] values initial values for other attributes
-        #
-        # @return [Stat] representing a regular file
-        def self.file(mode=0,values = { })
-            return self.new(S_IFREG,mode,values)
-        end
-
-        # @return [Integer] see stat(2)
-        attr_accessor :uid,:gid,:mode,:size, :dev,:ino,:nlink,:rdev,:blksize,:blocks
-
-        # @return [Integer, Time] see stat(2)
-        attr_accessor :atime,:mtime,:ctime
-
-        def initialize(type,permissions,values = { })
-            values[:mode] = ((type & S_IFMT) | (permissions & 07777))
-            @uid,@gid,@size,@mode,@atime,@mtime,@ctime,@dev,@ino,@nlink,@rdev,@blksize,@blocks = Array.new(13,0)
-            values.each_pair do |k,v|
-                instance_variable_set("@#{ k }",v)
-            end
-        end
+    def fuse_respond_to?(fuse_method)
+      return false unless @fuse_delegate.respond_to?(fuse_method)
+
+      m = @fuse_delegate.method(fuse_method)
+      m = m.super_method while m && FFI::Libfuse::Adapter.include?(m.owner)
+
+      m && true
     end
 
-    # Helper class to return from :statfs (eg for df output)
-    # All attributes are Integers and default to 0
-    class StatVfs
+    def respond_to_missing?(method, private=false)
+      FFI::Libfuse::FuseOperations.fuse_callbacks.include?(method) ? @fuse_delegate.respond_to?(method, private) : super
+    end
 
-        # @return [Integer]
-        attr_accessor :f_bsize,:f_frsize,:f_blocks,:f_bfree,:f_bavail
+    def method_missing(method_name, *args, &block)
+      return super unless FFI::Libfuse::FuseOperations.fuse_callbacks.include?(method_name) && @fuse_delegate.respond_to?(method_name)
+      begin
+        $stderr.puts "==> \#{ self }.#{method_name}(\#{args.inspect })" if debug?
+        result = @fuse_delegate.send(method_name,*args,&block)
+          $stderr.puts "<== \#{ self }.#{method_name}()"  if debug?
+        result
+      rescue => ex
+        $@.delete_if{|s| /^\\(__FUSE_DELEGATE__\\):/ =~ s}
+        $stderr.puts(ex.message) unless ex.respond_to?(:errno) || debug?
+        Kernel::raise
+      end
+    end
 
-        # @return [Integer]
-        attr_accessor :f_files,:f_ffree,:f_favail,:f_fsid,:f_flag,:f_namemax
+    def call_sigmethod(sigmethod)
+      warn "==> #{self}.#{sigmethod}()" if debug?
+      dlg = @fuse_delegate.respond_to?(sigmethod) ? @fuse_delegate : self
+      dlg.send(sigmethod)
+      warn "<== #{self}.#{sigmethod}()" if debug?
+    end
 
-        # values can be symbols or strings but drop the pointless f_ prefix
-        def initialize(values={ })
-            @f_bsize, @f_frsize, @f_blocks, @f_bfree, @f_bavail, @f_files, @f_ffree, @f_favail,@f_fsid, @f_flag,@f_namemax = Array.new(13,0)
-            values.each_pair do |k,v|
-                prefix = k.to_s.start_with?("f_") ? "" : "f_"
-                instance_variable_set("@#{prefix}#{k}",v)
-            end
-        end
+    def respond_sigmethod?(sigmethod)
+      @fuse_delegate.respond_to?(sigmethod) || respond_to?(sigmethod)
     end
-end #Module RFuse
+
+    # Remove Kernel:open etc..
+    FFI::Libfuse::FuseOperations.fuse_callbacks.each { |c| undef_method(c) rescue nil }
+  end
+
+end