suzuna 0.0.1-freebsd

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: fd5ab88833f46fc0c494ddfa17de68c30a41675a
+  data.tar.gz: c0f42f43c647683708e60c98511ff5ba3188b803
+SHA512:
+  metadata.gz: 134e68effecf0a1f35173b638abaae7307bf969fa81ab5107f1cea8528509eb6fff3cea8f1c6090b7ed1d5ee7b9249d9f4cbfa5b47a3bdbb60645e20d457d1d9
+  data.tar.gz: 8e28be08ec031f7079985be4cd6d2cb1a976906efa2d5848f2d45fba61a5632c07f3c635783740a6fb5d6ffda8d0afb4e59aef061d166923bd829d4db18cde86

data/LICENSE.md

@@ -0,0 +1,35 @@
+# suzuna License (2-clause BSD License)
+
+----
+
+Copyright (c) 2014, dearblue
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1.  Redistributions of source code must retain the above copyright notice,
+    this list of conditions and the following disclaimer.
+
+2.  Redistributions in binary form must reproduce the above copyright
+    notice, this list of conditions and the following disclaimer in the
+    documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
+OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
+
+----
+
+In Japanese.
+
+日本語訳については次のページが参考になるでしょう:
+http://www.freebsd.org/ja/copyright/freebsd-license.html

data/README.md

@@ -0,0 +1,140 @@
+# suzuna (スズナ)
+
+The suzuna is a ruby library that provides an infrastructure for virtualized block devices.
+
+"suzuna" is means "Turnip" in japanese.
+
+----
+
+(in Japanese)
+
+suzuna は ruby 拡張ライブラリで、仮想ブロックデバイス基盤を提供します。
+
+名称は春の七種の一つである『スズナ』から取りました。
+
+----
+
+* product name: suzuna (スズナ / 菘 / カブ / Turnip)
+* author: dearblue &lt;<dearblue@users.sourceforge.jp>&gt;
+* license: 2-clause BSD License (二条項 BSD ライセンス)
+* software quarity: PROTOTYPE
+* users: rubyist
+* release number: 0.0.1
+* memory usage: 1 MB +
+* installed size: under 1 MB
+* project page: &lt;http://sourceforge.jp/projects/rutsubo/&gt;
+* support ruby: ruby-2.0+ &lt;http://www.ruby-lang.org/&gt;
+* support platforms:
+    * FreeBSD (GEOM Gate / ggate) (ggatel only)
+* dependency libraries:
+    * ruby - gogyou-0.2+ &lt;https://rubygems.org/gems/gogyou&gt;
+
+
+## LIBRARY
+
+``require "suzuna"``
+
+
+## SYNOPSIS
+
+``module Suzuna``
+
+``module Suzuna::Template``
+
+``Suzuna.join(unit_object)``
+
+
+## DESCRIPTION
+
+suzuna は ruby で GEOM Gate を用いて GEOM クラスを書くためのライブラリです。
+
+``module Suzuna`` は、suzuna の名前空間として使われるモジュールです。
+
+``module Suzuna::Template`` は、I/O 要求処理を担当するクラスに ``include`` することを想定したモジュールです (必ず必要なモジュールではありません)。このモジュールには、I/O 要求処理に必要となるインスタンスメソッドが予め定義してあります。ただし ``raise NotImplementedError`` を発生させるだけのメソッドがあるので、このようなメソッドは利用者側で実装する必要があります。このあたりは [EXAMPLE](#label-EXAMPLE) が参考になると思います。
+
+``Suzuna.join(unit_object)`` は、I/O 要求処理オブジェクトを与えて実際に GEOM Gate オブジェクトを作成するためのメソッドです。***このメソッドはスレッドを停止させます。現在の実装では、このメソッドから返ってくる場面は例外が発生した時のみとなります。***
+
+
+## EXAMPLE
+
+以下は FreeBSD 上でローカルな GEOM Gate (ggate) を用いた、ruby による仮想ブロックデバイスプログラミングです。
+
+``` ruby:ruby
+#!ruby
+
+require "stringio"
+require "fattr"
+require "suzuna"
+
+class MyUnit
+  include Suzuna::Template
+
+  fattr(:mediasize) { @pool.size }
+  fattr sectorsize: 512,
+        timeout: 30,
+        flags: 0 # or Suzuna::G_GATE_FLAG_READONLY
+
+  def initialize
+    @pool = File.open("testsuzuna.img", File::BINARY | File::RDWR | File::CREAT)
+    @pool.truncate(80.MiB) unless @pool.size >= 80.MiB
+  end
+
+  def cleanup
+    @pool.flush rescue nil
+    @pool.close rescue nil
+  end
+
+  def read(offset, size, buf)
+    puts "#{File.basename caller(0, 1)[0]}: offset=#{offset}, size=#{size}"
+    @pool.pos = offset
+    @pool.read(size, buf)
+    buf.resize(size)
+    nil
+  end
+
+  def write(offset, buf)
+    puts "#{File.basename caller(0, 1)[0]}: offset=#{offset}, size=#{buf.bytesize}"
+    @pool.pos = offset
+    @pool.write(buf)
+    nil
+  end
+
+  def delete(offset, size)
+    puts "#{File.basename caller(0, 1)[0]}: offset=#{offset}, size=#{size}"
+    nil
+  end
+end
+
+Suzuna.join(MyUnit.new)
+```
+
+これを管理者権限で実行すると `/dev/ggate0` が作成されて、`/dev/ada0` や `/dev/da0` などと同様の扱いをすることが出来ます。
+
+停止させる場合は、`Ctrl+C` をするか、他の(擬似)端末から `$ sudo ggate -du0` と入力します。
+
+環境によっては ``/usr/local/lib/ruby/gems/2.1/gems/suzuna-0.0.1-freebsd/lib/suzuna.rb:in `initialize': No such file or directory @ rb_sysopen - /dev/ggctl (Errno::ENOENT)`` などと例外が出るかもしれません。この場合はカーネルに `geom_gate.ko` を読み込ませてから試して下さい。
+
+``` shell:shell
+$ sudo kldload geom_gate
+```
+
+
+## DEMERIT
+
+*   geom gate + ruby のため、実行性能はカーネルに置かれた geom オブジェクトよりもかなり劣ります。
+
+    個人・研究用途としては十分かもしれませんが、大規模な用途には向かないでしょう。
+
+*   geom gate ネットワークデーモンとしての機能は持っていません。
+
+    ``ggated`` を組み合わせて利用できるかもしれません (試していません)。
+
+*   現在の実装は、マルチスレッド化されていません。
+
+    I/O 要求の処理は単体のスレッドのみで行われます。
+
+## SEE ALSO
+
+*   [geom(4)](http://www.freebsd.org/cgi/man.cgi?sektion=4&query=geom),
+    [geom(8)](http://www.freebsd.org/cgi/man.cgi?sektion=8&query=geom),
+    [ggatel(8)](http://www.freebsd.org/cgi/man.cgi?sektion=8&query=ggatel)

data/Rakefile

@@ -0,0 +1,106 @@
+
+require "rake/clean"
+
+DOC = FileList["{README,LICENSE,CHANGELOG,Changelog}{,.ja}{,.txt,.rd,.rdoc,.md,.markdown}"] +
+      FileList["ext/**/{README,LICENSE,CHANGELOG,Changelog}{,.ja}{,.txt,.rd,.rdoc,.md,.markdown}"]
+#EXT = FileList["ext/**/*.{h,hh,c,cc,cpp,cxx}"] +
+#      FileList["ext/externals/**/*"]
+EXT = FileList["ext/**/*"]
+BIN = FileList["bin/*"]
+LIB = FileList["lib/**/*.rb"]
+SPEC = FileList["spec/**/*"]
+EXAMPLE = FileList["examples/**/*"]
+RAKEFILE = [File.basename(__FILE__), "gemstub.rb"]
+EXTRA = []
+
+load "gemstub.rb"
+
+EXTCONF = FileList["ext/extconf.rb"]
+EXTCONF.reject! { |n| !File.file?(n) }
+GEMSTUB.extensions += EXTCONF
+GEMSTUB.executables += FileList["bin/*"].map { |n| File.basename n }
+
+GEMFILE = "#{GEMSTUB.name}-#{GEMSTUB.version}.gem"
+GEMSPEC = "#{GEMSTUB.name}.gemspec"
+
+GEMSTUB.files += DOC + EXT + EXTCONF + BIN + LIB + SPEC + EXAMPLE + RAKEFILE + EXTRA
+GEMSTUB.rdoc_options ||= %w(--charset UTF-8)
+GEMSTUB.extra_rdoc_files += DOC + LIB + EXT.reject { |n| n.include?("/externals/") || !%w(.h .hh .c .cc .cpp .cxx).include?(File.extname(n)) }
+
+CLEAN << GEMSPEC
+CLOBBER << GEMFILE
+
+task :default => :all
+
+task :all => GEMFILE
+
+task :rdoc => DOC + EXT + LIB do
+  sh *(%w(rdoc) + GEMSTUB.rdoc_options + DOC + EXT + LIB)
+end
+
+file GEMFILE => DOC + EXT + EXTCONF + BIN + LIB + SPEC + EXAMPLE + RAKEFILE + [GEMSPEC] do
+  sh "gem build #{GEMSPEC}"
+end
+
+file GEMSPEC => RAKEFILE do
+  File.write(GEMSPEC, GEMSTUB.to_ruby, mode: "wb")
+end
+
+
+RUBYSET ||= nil
+
+if RUBYSET && !RUBYSET.empty? && !EXTCONF.empty?
+  RUBY_VERSIONS = RUBYSET.map do |ruby|
+    ver = `#{ruby} --disable gem -rrbconfig -e "puts RbConfig::CONFIG['ruby_version']"`.chomp
+    raise "failed ruby checking - ``#{ruby}''" unless $?.success?
+    [ver, ruby]
+  end
+  SOFILES_SET = RUBY_VERSIONS.map { |(ver, ruby)| ["lib/#{ver}/#{GEMSTUB.name}.so", ruby] }
+  SOFILES = SOFILES_SET.map { |(lib, ruby)| lib }
+  platforms = RUBYSET.map { |ruby| `#{ruby} -rubygems -e "puts Gem::Platform.local.to_s"`.chomp }
+  platforms.uniq!
+  platforms.compact!
+  unless platforms.size == 1
+    raise "wrong platforms (#{RUBYSET.inspect} => #{platforms.inspect})"
+  end
+
+  GEMSTUB_NATIVE = GEMSTUB.dup
+  GEMSTUB_NATIVE.files += SOFILES
+  GEMSTUB_NATIVE.platform = platforms[0]
+  GEMFILE_NATIVE = "#{GEMSTUB_NATIVE.name}-#{GEMSTUB_NATIVE.version}-#{GEMSTUB_NATIVE.platform}.gem"
+  GEMSPEC_NATIVE = "#{GEMSTUB_NATIVE.name}-#{GEMSTUB_NATIVE.platform}.gemspec"
+
+  task :all => [GEMFILE, :native]
+
+  task :native => GEMFILE_NATIVE
+
+  file GEMFILE_NATIVE => DOC + EXT + [EXTCONF] + BIN + LIB + SPEC + EXAMPLE + SOFILES + RAKEFILE + [GEMSPEC_NATIVE] do
+    sh "gem build #{GEMSPEC_NATIVE}"
+  end
+
+  file GEMSPEC_NATIVE => __FILE__ do
+    File.write(GEMSPEC_NATIVE, GEMSTUB_NATIVE.to_ruby, mode: "wb")
+  end
+
+  SOFILES_SET.each do |(soname, ruby)|
+    sodir = File.dirname(soname)
+    makefile = File.join(sodir, "Makefile")
+
+    CLEAN << GEMSPEC_NATIVE << sodir
+    CLOBBER << GEMFILE_NATIVE
+
+    directory sodir
+
+    file soname => [makefile] + EXT do
+      cd sodir do
+        sh "make"
+      end
+    end
+
+    file makefile => [sodir] + [EXTCONF] do
+      cd sodir do
+        sh "#{ruby} ../../#{EXTCONF} \"--ruby=#{ruby}\""
+      end
+    end
+  end
+end

data/examples/gate.rb

@@ -0,0 +1,47 @@
+#!ruby
+
+require "stringio"
+require "fattr"
+require "suzuna"
+
+class MyUnit
+  include Suzuna::Template
+
+  fattr(:mediasize) { @pool.size }
+  fattr sectorsize: 512,
+        timeout: 30,
+        flags: 0 # or Suzuna::G_GATE_FLAG_READONLY
+
+  def initialize
+    #@pool = StringIO.new(String.alloc(80.MiB))
+    @pool = File.open("testsuzuna.img", File::BINARY | File::RDWR | File::CREAT)
+    @pool.truncate(80.MiB) unless @pool.size >= 80.MiB
+  end
+
+  def cleanup
+    @pool.flush rescue nil
+    @pool.close rescue nil
+  end
+
+  def read(offset, size, buf)
+    puts "#{File.basename caller(0, 1)[0]}: offset=#{offset}, size=#{size}"
+    @pool.pos = offset
+    @pool.read(size, buf)
+    buf.resize(size)
+    nil
+  end
+
+  def write(offset, buf)
+    puts "#{File.basename caller(0, 1)[0]}: offset=#{offset}, size=#{buf.bytesize}"
+    @pool.pos = offset
+    @pool.write(buf)
+    nil
+  end
+
+  def delete(offset, size)
+    puts "#{File.basename caller(0, 1)[0]}: offset=#{offset}, size=#{size}"
+    nil
+  end
+end
+
+Suzuna.join(MyUnit.new)

data/gemstub.rb

@@ -0,0 +1,23 @@
+
+require_relative "lib/suzuna"
+
+GEMSTUB = Gem::Specification.new do |s|
+  s.name = "suzuna"
+  s.version = Suzuna::VERSION
+  s.platform = "freebsd"
+  s.summary = "Soft volume infrastructure for ruby"
+  s.description = <<EOS
+``suzuna'' is software volume infrastructure for ruby.
+
+Support platform is FreeBSD GEOM only.
+EOS
+  s.license = "2-clause BSD License"
+  s.author = "dearblue"
+  s.email = "dearblue@users.sourceforge.jp"
+  s.homepage = "http://sourceforge.jp/projects/rutsubo/"
+
+  s.required_ruby_version = ">= 2.0"
+  s.add_development_dependency "rspec", "~> 2.14"
+  s.add_development_dependency "rake", "~> 10.0"
+  s.add_runtime_dependency "gogyou", "~> 0.2"
+end

data/lib/suzuna.rb

@@ -0,0 +1,423 @@
+require "gogyou"
+
+module Suzuna
+  Suzuna = self
+  VERSION = Gem::Version.new "0.0.1"
+
+  G_GATE_CTL_NAME       = "/dev/ggctl"
+  G_GATE_TIMEOUT        = 0
+  G_GATE_UNIT_AUTO      = -1
+  G_GATE_PROVIDER_NAME  = "ggate"
+
+  G_GATE_FLAG_READWRITE = 0x0000
+  G_GATE_FLAG_READONLY  = 0x0001
+  G_GATE_FLAG_WRITEONLY = 0x0002
+  G_GATE_FLAG_DESTROY   = 0x1000
+  G_GATE_USERFLAGS      = G_GATE_FLAG_READONLY | G_GATE_FLAG_WRITEONLY
+
+  G_GATE_VERSION = 3
+
+  BIO_READ = 0x01
+  BIO_WRITE = 0x02
+  BIO_DELETE = 0x04
+
+  #
+  # suzuna 固有の例外が include しているモジュールです。
+  #
+  # rescue で一括して受け取るために用意されています。
+  #
+  module Exceptions
+  end
+
+  class DestroyedGate < Errno::ENXIO
+    include Exceptions
+  end
+
+  #
+  # I/O 要求処理の基本機能のみを実装したモジュールです。
+  #
+  # クラスやモジュールに include することを想定しています。
+  #
+  # 必要なインスタンスメソッドは include したクラスで再定義して下さい。
+  #
+  module Template
+    #
+    # このメソッドはデバイスの大きさを取得するために呼ばれます。
+    #
+    # /dev 以下に geom gate オブジェクトとして作成される前に呼ばれます。
+    #
+    # 戻り値として 0以上で sectorsize の整数倍となる整数を返して下さい。
+    #
+    def mediasize
+      raise NotImplementedError, "IMPLEMENT ME!  #mediasize -> integer"
+    end
+
+    #
+    # このメソッドはデバイスの読み書き特性を取得するために呼ばれます。
+    #
+    # /dev 以下に geom gate オブジェクトとして作成される前に呼ばれます。
+    #
+    # 戻り値として G_GATE_FLAG_READWRITE、G_GATE_FLAG_READONLY、G_GATE_FLAG_WRITEONLY のいずれかを返して下さい。
+    #
+    def flags
+      G_GATE_FLAG_READONLY
+    end
+
+    #
+    # このメソッドはデバイスのセクタサイズ (読み書きの最小単位) を取得するために呼ばれます。
+    #
+    # /dev 以下に geom gate オブジェクトとして作成される前に呼ばれます。
+    #
+    # 戻り値として正の整数値を返して下さい。
+    #
+    def sectorsize
+      512
+    end
+
+    #
+    # このメソッドはデバイスのテキスト情報を取得するために呼ばれます。
+    #
+    # /dev 以下に geom gate オブジェクトとして作成される前に呼ばれます。
+    #
+    # 戻り値として nil か 2048 バイト未満の文字列を返して下さい。
+    #
+    def info
+      "#{Suzuna}-#{VERSION} (powered by #{RUBY_ENGINE})"
+    end
+
+    #
+    # このメソッドはデバイスの要求処理の最大待機時間を取得するために呼ばれます。
+    #
+    # /dev 以下に geom gate オブジェクトとして作成される前に呼ばれます。
+    #
+    # 戻り値として正の整数値を返して下さい。0 は無制限とみなされます。
+    #
+    def timeout
+      60
+    end
+
+    #
+    # このメソッドはデバイスのユニット番号を取得するために呼ばれます。
+    #
+    # /dev 以下に geom gate オブジェクトとして作成される前に呼ばれます。
+    #
+    # 戻り値として正の整数値か、G_GATE_UNIT_AUTO を返して下さい。
+    #
+    def unit
+      G_GATE_UNIT_AUTO
+    end
+
+    #
+    # このメソッドは geom gate オブジェクトが破棄されたあとに呼ばれます。
+    #
+    # 仮想デバイスの終了処理などを目的として用意されています。
+    #
+    # 戻り値は無視されます。
+    #
+    def cleanup
+      nil
+    end
+
+    #
+    # このメソッドは geom gate オブジェクトに対して読み込み要求があった時に呼ばれます。
+    #
+    # 文字列オブジェクトである buf に読み込んだデータを転写して下さい。
+    #
+    # 戻り値として、処理の成否である Errno::EXXX クラスかそのインスタンス、errno の整数値を返して下さい。
+    # 正常な場合には、nil を返すことで Errno::NOERROR と認識されます。
+    #
+    def read(offset, size, buf)
+      raise NotImplementedError, "IMPLEMENT ME!  #read(offset, size, buf) -> errno"
+    end
+
+    #
+    # このメソッドは geom gate オブジェクトに対して書き込み要求があった時に呼ばれます。
+    #
+    # 文字列オブジェクトである buf を書き込む処理を行って下さい。
+    #
+    # 戻り値として、処理の成否である Errno::EXXX クラスかそのインスタンス、errno の整数値を返して下さい。
+    # 正常な場合には、nil を返すことで Errno::NOERROR と認識されます。
+    #
+    def write(offset, buf)
+      raise NotImplementedError, "IMPLEMENT ME!  #write(offset, buf) -> errno"
+    end
+
+    #
+    # このメソッドは geom gate オブジェクトに対してセクタの削除(解放)要求があった時に呼ばれます。
+    #
+    # 戻り値として、処理の成否である Errno::EXXX クラスかそのインスタンス、errno の整数値を返して下さい。
+    # 正常な場合には、nil を返すことで Errno::NOERROR と認識されます。
+    #
+    def delete(offset, size)
+      raise NotImplementedError, "IMPLEMENT ME!  #delete(offset, size) -> errno"
+    end
+  end
+
+  def self.join(unitobj)
+    unit = IOCTL::Create.post(unitobj.mediasize, unitobj.flags,
+                              sectorsize: unitobj.sectorsize, info: unitobj.info,
+                              timeout: unitobj.timeout, unit: unitobj.unit)
+
+    begin
+      mainloop(unitobj, unit)
+    ensure
+      IOCTL::Destroy.post(unit, true) rescue nil unless $!.kind_of?(DestroyedGate)
+      unitobj.cleanup
+    end
+  end
+
+  def self.mainloop(unitobj, unit)
+    ioc = IOCTL::IOReq.new
+    ioc.start.version = G_GATE_VERSION
+    ioc.start.unit = unit
+    bufsize = unitobj.sectorsize
+    buf = String.alloc(bufsize)
+    ioc.start.data = buf.to_ptr
+
+    while true
+      while true
+        ioc.start.data = buf.to_ptr
+        ioc.start.length = buf.bytesize
+        ioc.start.error = 0
+        begin
+          ioc.start.post
+        rescue Errno::ENXIO
+          raise DestroyedGate, "/dev/ggate#{unit}"
+        end
+
+        case ioc.start.error
+        when Errno::NOERROR::Errno
+          # nothing to do here
+        when Errno::ECANCELED::Errno, Errno::ENXIO::Errno
+          raise DestroyedGate, "/dev/ggate#{unit}"
+        when Errno::ENOMEM::Errno
+          buf.resize(bufsize = ioc.start.length)
+          unless buf.bytesize == bufsize
+            raise Errno::ENOMEM, <<-EOM.chomp
+#{G_GATE_CTL_NAME} (require size = #{bufsize}, but allocated size = #{buf.bytesize})
+            EOM
+          end
+          break
+        else
+          raise SystemCallError.new("#{G_GATE_CTL_NAME} (ioctl)", ioc.start.error)
+        end
+
+        catch(:break) do
+          begin
+            case ioc.start.cmd
+            when BIO_READ
+              if ioc.start.length > bufsize
+                buf.resize(bufsize = ioc.start.length)
+                unless buf.bytesize == bufsize
+                  ioc.done.error = Errno::ENOMEM::Errno
+                  throw :break
+                end
+              end
+              ioc.done.error = err2code(unitobj.read(ioc.start.offset, ioc.start.length, buf))
+              ioc.done.data = buf.to_ptr
+            when BIO_DELETE
+              ioc.done.error = err2code(unitobj.delete(ioc.start.offset, ioc.start.length))
+            when BIO_WRITE
+              buf.resize(ioc.start.length)
+              ioc.done.error = err2code(unitobj.write(ioc.start.offset, buf))
+              buf.resize(bufsize)
+              ioc.done.data = buf.to_ptr
+            else
+              ioc.done.error = Errno::EOPNOTSUPP::Errno
+            end
+          rescue BasicObject
+            ioc.done.error = Errno::EFAULT::Errno
+            raise
+          ensure
+            #p err: SystemCallError.new(ioc.done.error)
+            ioc.done.post
+          end
+        end
+      end
+    end
+
+    raise Exception, "!!BUG!! - SHALL NOT REACHED HERE!"
+  end
+
+  def self.err2code(err)
+    case err
+    when nil
+      Errno::NOERROR::Errno
+    when Class
+      err::Errno
+    when Integer
+      err.to_i
+    else
+      err.errno
+    end
+  end
+
+  module IOCTL
+    module IOC
+      IOCPARM_SHIFT = 13
+      IOCPARM_MASK = ~(~0 << IOCPARM_SHIFT)
+      IOC_IN = 0x80000000
+      IOC_OUT = 0x40000000
+      IOC_INOUT = IOC_IN | IOC_OUT
+
+      def _IOC(inout, group, num, len)
+        inout.to_i | ((len.to_i & IOCPARM_MASK) << 16) | (group.to_i << 8) | num.to_i
+      end
+
+      def _IOWR(g, n, t)
+        _IOC(IOC_INOUT, g.to_i, n.to_i, t.bytesize)
+      end
+    end
+
+    NAME_MAX = 255
+
+    G_GATE_INFOSIZE = 2048
+
+    GG_MODIFY_MEDIASIZE     = 0x01
+    GG_MODIFY_INFO          = 0x02
+    GG_MODIFY_READPROV      = 0x04
+    GG_MODIFY_READOFFSET    = 0x08
+
+    @@devfd = File.open(G_GATE_CTL_NAME, File::RDWR)
+
+    # :nodoc:
+    def self.ioctl(req, data)
+      @@devfd.ioctl(req, data)
+    end
+
+    module CommonModule
+      def post
+        IOCTL.ioctl(self.class::REQ, to_buffer)
+      end
+    end
+
+    extend Gogyou
+
+    typedef :uint64_t, :off_t
+
+    Create = struct {
+      uint   :version
+      off_t  :mediasize
+      uint   :sectorsize
+      uint   :flags
+      uint   :maxcount
+      uint   :timeout
+      char   :name, NAME_MAX
+      char   :info, G_GATE_INFOSIZE
+      char   :readprov, NAME_MAX
+      off_t  :readoffset
+      int    :unit
+    }
+
+    class Create
+      include CommonModule
+      extend IOC
+
+      REQ = _IOWR("m".ord, 0, self)
+
+      def self.post(mediasize, flags, sectorsize: 512, info: nil, timeout: G_GATE_TIMEOUT, unit: G_GATE_UNIT_AUTO)
+        ioc = IOCTL::Create.new
+        ioc.version = G_GATE_VERSION
+        ioc.unit = unit ? unit : G_GATE_UNIT_AUTO
+        ioc.mediasize = mediasize
+        ioc.sectorsize = sectorsize
+        ioc.timeout = timeout
+        ioc.flags = flags
+        ioc.maxcount = 0
+        ioc.info = info if info
+        ioc.post
+
+        if unit == G_GATE_UNIT_AUTO
+          puts "%s%u\n" % [G_GATE_PROVIDER_NAME, ioc.unit]
+        end
+
+        ioc.unit
+      end
+    end
+
+    Modify = struct {
+      uint      :version
+      int       :unit
+      uint32_t  :modify
+      off_t     :mediasize
+      char      :info, G_GATE_INFOSIZE
+      char      :readprov, NAME_MAX
+      off_t     :readoffset
+    }
+
+    class Modify
+      include CommonModule
+      extend IOC
+
+      REQ = _IOWR("m".ord, 1, self)
+    end
+
+    Destroy = struct {
+      uint   :version
+      int    :unit
+      int    :force
+      char   :name, NAME_MAX
+    }
+
+    class Destroy
+      include CommonModule
+      extend IOC
+
+      REQ = _IOWR("m".ord, 2, self)
+
+      def self.post(unit, force = false)
+        cmd = IOCTL::Destroy.new
+        cmd.version = G_GATE_VERSION
+        cmd.unit = unit
+        cmd.force = force ? 1 : 0
+        cmd.post
+      end
+    end
+
+    Cancel = struct {
+      uint       :version
+      int        :unit
+      uintptr_t  :seq
+      char       :name, NAME_MAX
+    }
+
+    class Cancel
+      include CommonModule
+      extend IOC
+
+      REQ = _IOWR("m".ord, 3, self)
+    end
+
+    CtlIO = struct {
+      uint       :version
+      int        :unit
+      uintptr_t  :seq
+      uint       :cmd
+      off_t      :offset
+      off_t      :length
+      uintptr_t  :data    # void *gctl_data
+      int        :error
+    }
+
+    class Start < CtlIO
+      include CommonModule
+      extend IOC
+
+      REQ = _IOWR("m".ord, 4, self)
+    end
+
+    class Done < CtlIO
+      include CommonModule
+      extend IOC
+
+      REQ = _IOWR("m".ord, 5, self)
+    end
+
+    IOReq = struct {
+      union {
+        Start :start
+        Done :done
+      }
+    }
+  end
+end

metadata

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification
+name: suzuna
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: freebsd
+authors:
+- dearblue
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-09-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.14'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: gogyou
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+description: |
+  ``suzuna'' is software volume infrastructure for ruby.
+
+  Support platform is FreeBSD GEOM only.
+email: dearblue@users.sourceforge.jp
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.md
+- README.md
+- lib/suzuna.rb
+files:
+- LICENSE.md
+- README.md
+- Rakefile
+- examples/gate.rb
+- gemstub.rb
+- lib/suzuna.rb
+homepage: http://sourceforge.jp/projects/rutsubo/
+licenses:
+- 2-clause BSD License
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.1
+signing_key: 
+specification_version: 3
+summary: Soft volume infrastructure for ruby
+test_files: []
+has_rdoc: