runshare 0.1.0

metadata

@@ -0,0 +1,231 @@
+--- !ruby/object:Gem::Specification
+name: runshare
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ivan Prisyazhnyy
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2021-11-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.17'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.17'
+- !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: rake-compiler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: |
+  # ruby unshare (runshare)
+
+  This tool allows to unshare Linux namespaces.
+  The implementation is similar to the unshare(1) tool.
+
+  ## Installation
+
+  Add this line to your application's Gemfile:
+
+  ```ruby
+      gem 'runshare'
+  ```
+
+  And then execute:
+
+      $ bundle
+
+  Or install it yourself as:
+
+      $ gem install runshare
+
+  ## Usage
+
+      > require "runshare"
+      > RUnshare::unshare
+
+  For example:
+
+      cat > test.rb
+
+      require "runshare"
+
+      pid = RUnshare::unshare(
+        :clone_newpid    => true,
+        :clone_newns     => true,
+        :clone_newcgroup => true,
+        :clone_newipc    => true,
+        :clone_newuts    => true,
+        :clone_newnet    => true,
+        :clone_newtime   => true,
+        :fork            => true,
+        :mount_proc      => "/proc",
+        # docker export $(docker create hello-world) | tar -xf - -C rootfs
+        :root            => "/tmp/rootfs"
+      )
+
+      if pid == 0
+        # child
+        puts "--- #{Process.pid}"
+        if system("/hello") != true
+          raise "bad"
+        end
+        puts "--- done"
+      else
+        # parent
+        puts "-- unshare=#{pid}, pid=#{Process.pid}"
+        puts "-- exit=#{Process.waitpid(pid)}"
+      end
+
+      ^D
+
+      sudo ruby -I ./lib ./test.rb
+
+  ## Quick start
+
+      $ rake compile && echo 'require "runshare"; RUnshare::unshare(:clone_newuts => true)' | irb
+      install -c tmp/x86_64-linux/runshare/2.4.10/runshare.so lib/runshare/runshare.so
+      cp tmp/x86_64-linux/runshare/2.4.10/runshare.so tmp/x86_64-linux/stage/lib/runshare/runshare.so
+      Switch to inspect mode.
+      require "runshare"; RUnshare::unshare
+
+  ## Ruby <2.5
+
+  If your app is single threaded and you are observing:
+
+      eval:1: warning: pthread_create failed for timer: Invalid argument, scheduling broken
+
+  Just ignore it with some degree of bravity. You also
+  can silence it by setting:
+
+      $VERBOSE = nil
+
+  ## Development
+
+  After checking out the repo, run `bin/setup` to install dependencies.
+  Then, run `rake spec` to run the tests.
+  You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+  To install this gem onto your local machine, run `bundle exec rake install`.
+  To release a new version, update the version number in `version.rb`,
+  and then run `bundle exec rake release`, which will create a git tag
+  for the version, push git commits and tags, and push the `.gem` file
+  to [rubygems.org](https://rubygems.org).
+
+  ## Contributing
+
+  Bug reports and pull requests are welcome on GitHub at https://github.com/sitano/runshare.
+  This project is intended to be a safe, welcoming space for collaboration,
+  and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+  ## License
+
+  The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+email:
+- john.koepi@gmail.com
+executables: []
+extensions:
+- ext/runshare/extconf.rb
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- ext/runshare/extconf.rb
+- ext/runshare/include/all-io.h
+- ext/runshare/include/c.h
+- ext/runshare/include/caputils.h
+- ext/runshare/include/namespace.h
+- ext/runshare/include/pathnames.h
+- ext/runshare/include/pwdutils.h
+- ext/runshare/include/signames.h
+- ext/runshare/include/strutils.h
+- ext/runshare/runshare.c
+- ext/runshare/unshare.c
+- ext/runshare/unshare.h
+- lib/runshare.rb
+- lib/runshare/version.rb
+- runshare.gemspec
+homepage: https://github.com/sitano/runshare
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/sitano/runshare
+  source_code_uri: https://github.com/sitano/runshare
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project:
+rubygems_version: 2.6.14.4
+signing_key:
+specification_version: 4
+summary: This tool allows to unshare Linux namespaces.
+test_files: []