hrr_rb_mount 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7e40e0f523c2e10f4590e65254da3c1533347ddc07bd085543d331434b221449
-  data.tar.gz: 557b4ac323a0c85c71e077fc87d85c1e6f23d29886b442c4ae0a45e40104526a
+  metadata.gz: ecb4bf5f144d93726b82b23785d8cbfcde2892f0f645f71425d3741c4ccc3ab6
+  data.tar.gz: 167e967e7026848a6839af9f0670e1b9aa72963fa6ff21ebe0947fd999dceb8a
 SHA512:
-  metadata.gz: a2b316d880055d67c37d9e9230a36df9f6abb8d585fcc5cd9bd27f15a859c92734b4676047d21f7e96a64d14615ae02bdf5dde48434a6be43afbd3451aebccea
-  data.tar.gz: cbe8545e911c7cdfc686ad545f22a85d62c01a5e727b3616786b4d8e5447a451cc2a2a0891613478e4b137b61b415b09179eb462362622734b80df82310c22b4
+  metadata.gz: ee7784f5c20e20944462e966573aab063ccd903156fb03c4a42ff4221c32d572083803a502f75670f91a9603b898194fe7b133a1329a449c2900dc965503ba83
+  data.tar.gz: 9a3ace10fcf53e160deb71cec6b4d3cb59fcf2305c711c30ba78ca2530a574270a31c6969ea019ccbd10405f4cfc8f0479325f4243117bde45fd4361bbf44054

data/.travis.yml

@@ -1,7 +1,6 @@
 ---
 language: ruby
 cache: bundler
-rvm:
 rvm:
   - 2.0
   - 2.1
@@ -23,8 +22,8 @@ before_install:
 install:
   - bundle install
 before_script:
-  - sudo env RBENV_VERSION="${RBENV_VERSION}" PATH="${RBENV_ROOT}/shims:${RBENV_ROOT}/bin:${PATH}" bundle exec rake clean clobber
+  - sudo env RBENV_VERSION="${RBENV_VERSION}" PATH="${RBENV_ROOT}/shims:${RBENV_ROOT}/bin:${PATH}" bundle exec rake clean
 script:
   - sudo env RBENV_VERSION="${RBENV_VERSION}" PATH="${RBENV_ROOT}/shims:${RBENV_ROOT}/bin:${PATH}" bundle exec rake compile spec
 after_script:
-  - sudo env RBENV_VERSION="${RBENV_VERSION}" PATH="${RBENV_ROOT}/shims:${RBENV_ROOT}/bin:${PATH}" bundle exec rake clean clobber
+  - sudo env RBENV_VERSION="${RBENV_VERSION}" PATH="${RBENV_ROOT}/shims:${RBENV_ROOT}/bin:${PATH}" bundle exec rake clean

data/README.md

@@ -41,6 +41,10 @@ flags = HrrRbMount::NOEXEC
 HrrRbMount.mount "tmpfs", "/path/to/target", "tmpfs", flags, "size=1M" # => 0
 HrrRbMount.mountpoint? "/path/to/target"                               # => true
 HrrRbMount.umount "/path/to/target"                                    # => 0
+
+HrrRbMount.bind "/path/to/source", "/path/to/target" # => 0
+HrrRbMount.make_private "/path/to/target"            # => 0
+HrrRbMount.remount "/path/to/target", flags          # => 0
 ```
 
 ## Development

data/ext/hrr_rb_mount/hrr_rb_mount.c

@@ -7,7 +7,7 @@ VALUE rb_mHrrRbMountConst;
 /*
  * A wrapper around mount system call.
  *
- * == Synopsis:
+ * @example
  *   HrrRbMount.mount "source", "target", "filesystemtype", mountflags, "data" # => 0
  *
  * @overload mount(source, target, filesystemtype, mountflags=0, data="") => 0
@@ -29,9 +29,9 @@ hrr_rb_mount_mount(int argc, VALUE *argv, VALUE self)
 
   source         = StringValueCStr(argv[0]);
   target         = StringValueCStr(argv[1]);
-  filesystemtype = StringValueCStr(argv[2]);
+  filesystemtype = NIL_P(argv[2]) ? NULL : StringValueCStr(argv[2]);
   mountflags     = argc < 4 ? 0 : NUM2ULONG(argv[3]);
-  data           = argc < 5 ? "" : StringValueCStr(argv[4]);
+  data           = argc < 5 ? NULL : StringValueCStr(argv[4]);
 
   if (mount(source, target, filesystemtype, mountflags, data) < 0)
     rb_sys_fail("mount");
@@ -42,7 +42,7 @@ hrr_rb_mount_mount(int argc, VALUE *argv, VALUE self)
 /*
  * A wrapper around umount system call.
  *
- * == Synopsis:
+ * @example
  *   HrrRbMount.umount "target", flags # => 0
  *
  * @overload umount(target, flags=0) => 0

data/lib/hrr_rb_mount.rb

@@ -3,7 +3,7 @@ require "hrr_rb_mount/hrr_rb_mount"
 
 # A wrapper around mount and umount. See mount(2) and umount(2) for details.
 #
-# == Synopsis:
+# @example
 #   require "hrr_rb_mount"
 #
 #   flags = HrrRbMount::NOEXEC
@@ -20,6 +20,161 @@ module HrrRbMount
   # The path to /proc/self/mountinfo.
   PROC_MOUNTINFO_PATH = "/proc/self/mountinfo"
 
+  # A wrapper around mount --remount mountpoint command.
+  #
+  # @example
+  #   HrrRbMount.remount "mountpoint" # => 0
+  #
+  # @param mountpoint [String] The location (a directory or file) specified by the pathname.
+  # @param mountflags [Integer] The umount operation is performed depending on the bits specified in the mountflags.
+  # @param data [String] Per filesystem options.
+  # @return [Integer] 0.
+  # @raise [Errno::EXXX] A SystemCallError is raised when the operation failed.
+  def self.remount mountpoint, mountflags=0, data=""
+    mount "none", mountpoint, nil, REMOUNT | mountflags, data
+  end
+
+  # A wrapper around mount --move source target command.
+  #
+  # @example
+  #   HrrRbMount.move "source", "target" # => 0
+  #
+  # @param source [String] The pathname referring to a device or a pathname of a directory or file, or a dummy string.
+  # @param target [String] The location (a directory or file) specified by the pathname.
+  # @param mountflags [Integer] The umount operation is performed depending on the bits specified in the mountflags.
+  # @param data [String] Per filesystem options.
+  # @return [Integer] 0.
+  # @raise [Errno::EXXX] A SystemCallError is raised when the operation failed.
+  def self.move source, target, mountflags=0, data=""
+    mount source, target, nil, MOVE | mountflags, data
+  end
+
+  # A wrapper around mount --bind source target command.
+  #
+  # @example
+  #   HrrRbMount.bind "source", "target" # => 0
+  #
+  # @param source [String] The pathname referring to a device or a pathname of a directory or file, or a dummy string.
+  # @param target [String] The location (a directory or file) specified by the pathname.
+  # @param mountflags [Integer] The mount operation is performed depending on the bits specified in the mountflags.
+  # @param data [String] Per filesystem options.
+  # @return [Integer] 0.
+  # @raise [Errno::EXXX] A SystemCallError is raised when the operation failed.
+  def self.bind source, target, mountflags=0, data=""
+    mount source, target, nil, BIND | mountflags, data
+  end
+
+  # A wrapper around mount --rbind source target command.
+  #
+  # @example
+  #   HrrRbMount.rbind "source", "target" # => 0
+  #
+  # @param source [String] The pathname referring to a device or a pathname of a directory or file, or a dummy string.
+  # @param target [String] The location (a directory or file) specified by the pathname.
+  # @param mountflags [Integer] The mount operation is performed depending on the bits specified in the mountflags.
+  # @param data [String] Per filesystem options.
+  # @return [Integer] 0.
+  # @raise [Errno::EXXX] A SystemCallError is raised when the operation failed.
+  def self.rbind source, target, mountflags=0, data=""
+    mount source, target, nil, BIND | REC | mountflags, data
+  end
+
+  # A wrapper around mount --make-shared mountpoint command.
+  #
+  # @example
+  #   HrrRbMount.make_shared "mountpoint" # => 0
+  #
+  # @param mountpoint [String] The location (a directory or file) specified by the pathname.
+  # @return [Integer] 0.
+  # @raise [Errno::EXXX] A SystemCallError is raised when the operation failed.
+  def self.make_shared mountpoint
+    mount "none", mountpoint, nil, SHARED
+  end
+
+  # A wrapper around mount --make-slave mountpoint command.
+  #
+  # @example
+  #   HrrRbMount.make_slave "mountpoint" # => 0
+  #
+  # @param mountpoint [String] The location (a directory or file) specified by the pathname.
+  # @return [Integer] 0.
+  # @raise [Errno::EXXX] A SystemCallError is raised when the operation failed.
+  def self.make_slave mountpoint
+    mount "none", mountpoint, nil, SLAVE
+  end
+
+  # A wrapper around mount --make-private mountpoint command.
+  #
+  # @example
+  #   HrrRbMount.make_private "mountpoint" # => 0
+  #
+  # @param mountpoint [String] The location (a directory or file) specified by the pathname.
+  # @return [Integer] 0.
+  # @raise [Errno::EXXX] A SystemCallError is raised when the operation failed.
+  def self.make_private mountpoint
+    mount "none", mountpoint, nil, PRIVATE
+  end
+
+  # A wrapper around mount --make-unbindable mountpoint command.
+  #
+  # @example
+  #   HrrRbMount.make_unbindable "mountpoint" # => 0
+  #
+  # @param mountpoint [String] The location (a directory or file) specified by the pathname.
+  # @return [Integer] 0.
+  # @raise [Errno::EXXX] A SystemCallError is raised when the operation failed.
+  def self.make_unbindable mountpoint
+    mount "none", mountpoint, nil, UNBINDABLE
+  end
+
+  # A wrapper around mount --make-rshared mountpoint command.
+  #
+  # @example
+  #   HrrRbMount.make_rshared "mountpoint" # => 0
+  #
+  # @param mountpoint [String] The location (a directory or file) specified by the pathname.
+  # @return [Integer] 0.
+  # @raise [Errno::EXXX] A SystemCallError is raised when the operation failed.
+  def self.make_rshared mountpoint
+    mount "none", mountpoint, nil, REC | SHARED
+  end
+
+  # A wrapper around mount --make-rslave mountpoint command.
+  #
+  # @example
+  #   HrrRbMount.make_rslave "mountpoint" # => 0
+  #
+  # @param mountpoint [String] The location (a directory or file) specified by the pathname.
+  # @return [Integer] 0.
+  # @raise [Errno::EXXX] A SystemCallError is raised when the operation failed.
+  def self.make_rslave mountpoint
+    mount "none", mountpoint, nil, REC | SLAVE
+  end
+
+  # A wrapper around mount --make-rprivate mountpoint command.
+  #
+  # @example
+  #   HrrRbMount.make_rprivate "mountpoint" # => 0
+  #
+  # @param mountpoint [String] The location (a directory or file) specified by the pathname.
+  # @return [Integer] 0.
+  # @raise [Errno::EXXX] A SystemCallError is raised when the operation failed.
+  def self.make_rprivate mountpoint
+    mount "none", mountpoint, nil, REC | PRIVATE
+  end
+
+  # A wrapper around mount --make-runbindable mountpoint command.
+  #
+  # @example
+  #   HrrRbMount.make_runbindable "mountpoint" # => 0
+  #
+  # @param mountpoint [String] The location (a directory or file) specified by the pathname.
+  # @return [Integer] 0.
+  # @raise [Errno::EXXX] A SystemCallError is raised when the operation failed.
+  def self.make_runbindable mountpoint
+    mount "none", mountpoint, nil, REC | UNBINDABLE
+  end
+
   # Returns true if the target directory or file is a mountpoint. Otherwise, returns false.
   #
   # Internally, uses /proc/self/mountinfo file to detect if the target is a mountpoint.
@@ -27,7 +182,7 @@ module HrrRbMount
   # When the file is not available, then uses stat(2).
   # In this case, bind mount is not able to be detected.
   #
-  # == Synopsis:
+  # @example
   #   HrrRbMount.mountpoint? "/proc"   # => true
   #   HrrRbMount.mountpoint? "/proc/1" # => false
   #

data/lib/hrr_rb_mount/version.rb

@@ -1,3 +1,3 @@
 module HrrRbMount
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hrr_rb_mount
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - hirura
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-03-09 00:00:00.000000000 Z
+date: 2020-03-22 00:00:00.000000000 Z
 dependencies: []
 description: A wrapper around mount and umount for CRuby
 email: