zergling 0.0.1

data/CHANGELOG

@@ -0,0 +1 @@
+v0.0.1. Claims the 'zergling' gem name.

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2008 Victor Costan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/Manifest

@@ -0,0 +1,10 @@
+lib/zergling.rb
+lib/zergling/process.rb
+ext/zergling_geminstall_hook/extconf.rb
+CHANGELOG
+LICENSE
+bin/zerglingd
+bin/zergling
+README
+Rakefile
+Manifest

data/README

@@ -0,0 +1,61 @@
+INSTALL
+-
+
+on server and local machine:
+
+`gem sources -a http://gems.github.com`
+
+`sudo gem install coderrr-rtunnel`
+
+If you don't have root access on server, you can use either the rtunnel_server_linux binary (only works with linux), or extract the .tar.gz and use `rtunnel_server.rb` (all function the same)
+
+USAGE
+-
+
+on server (myserver.com):
+
+`rtunnel_server`
+
+on your local machine:
+
+`rtunnel_client -c myserver.com -f 4000 -t 3000`
+
+This would reverse tunnel myserver.com:4000 to localhost:3000 so that if you had a web server running at port 3000 on your local machine, anyone on the internet could access it by going to http://myserver.com:4000
+
+**News**
+
+  * 0.3.6 released, new protocol
+  * created gem for easier installation
+  * 0.2.1 released, minor bugfix, cmdline options change
+  * 0.2.0 released, much simpler
+  * 0.1.2 released
+  * Created rtunnel_server binary for linux so you don't need Ruby installed on the host you want to reverse tunnel from
+  * 0.1.1 released
+  * Added default control port of 19050, no longer have to specify this on client or server unless you care to change it
+
+RTunnel?
+-
+
+This client/server allow you to reverse tunnel traffic.  Reverse tunneling is useful if you want to run a server behind a NAT and you do not have the ability use port forwarding.  The specific reason I created this program was to reduce the pain of Facebook App development on a crappy internet connection that drops often.  ssh -R was not cutting it.
+
+**How does reverse tunneling work?**
+
+  * tunnel\_client makes connection to tunnel\_server (through NAT)
+  * tunnel_server listens on port X
+  * internet_user connects to port X on tunnel server
+  * tunnel\_server uses existing connection to tunnel internet user's request back to tunnel\_client
+  * tunnel_client connects to local server on port Y
+  * tunnel_client tunnels internet users connection through to local server
+
+or:
+
+  * establish connection: tunnel\_client --NAT--> tunnel\_server
+  * reverse tunnel: internet\_user -> tunnel_server --(NAT)--> tunnel\_client -> server\_running\_behind\_nat
+
+**How is this different than normal tunneling?**
+
+With tunneling, usually your connections are made in the same direction you create the tunnel connection.  With reverse tunneling, you tunnel your connections the opposite direction of which you made the tunnel connection.  So you initiate the tunnel with A -> B, but connections are tunneled from B -> A.
+
+**Why not just use ssh -R?**
+
+The same thing can be achieved with ssh -R, why not just use it?  A lot of ssh servers don't have the GatewayPorts sshd option set up to allow you to reverse tunnel.  If you are not in control of the server and it is not setup correctly then you are SOL.  RTunnel does not require you are in control of the server.  ssh -R has other annoyances.  When your connection drops and you try to re-initiate the reverse tunnel sometimes you get an address already in use error because the old tunnel process is still laying around.  This requires you to kill the existing sshd process.  RTunnel does not have this problem.

data/Rakefile

@@ -0,0 +1,25 @@
+require 'rubygems'
+gem 'echoe'
+require 'echoe'
+
+Echoe.new('zergling') do |p|
+  p.project = 'rails-pwnage' # rubyforge project
+  
+  p.author = 'Victor Costan'
+  p.email = 'victor@zergling.net'
+  p.summary = 'Umbrella for the software driving a computer in the Zerg system.'
+  p.url = 'http://www.zergling.net'
+  p.dependencies = ['zerg_support >=0.0.1']
+  p.eval = proc do |p|
+    p.default_executable = 'bin/zergling'
+  end
+  
+  p.need_tar_gz = true
+  p.need_zip = true
+  p.rdoc_pattern = /^(lib|bin|tasks|ext)|^BUILD|^README|^CHANGELOG|^TODO|^LICENSE|^COPYING$/  
+end
+
+if $0 == __FILE__
+  Rake.application = Rake::Application.new
+  Rake.application.run
+end

data/ext/zergling_geminstall_hook/extconf.rb

@@ -0,0 +1,13 @@
+# this file is invoked when the gem is installed
+# rubygems expects it to build a gem, so we need to work around that
+
+require 'rubygems'
+gem 'zerg_support'
+require 'zerg_support'
+
+Zerg::Support::Gems.ensure_on_path 'zergling'
+Zerg::Support::Gems.ensure_on_path 'zerglingd'
+# we really shouldn't be abusing rubygems' root; then again, the Debian
+# maintainers shouldn't be abusing the patience of Ruby developers
+
+Zerg::Support::Gems.emulate_extension_install 'zerg_setup'

data/lib/zergling/process.rb

@@ -0,0 +1,52 @@
+# Zerg process mangement
+
+begin
+  require 'sys/proctable'
+rescue Exception
+  # mock the sys-proctable gem if it is not available
+  
+  module Sys
+  end
+
+  module Sys::ProcTable
+    class ProcInfo
+      def initialize(pid, cmdline)
+        @pid = pid
+        @cmdline = cmdline
+      end
+      attr_reader :pid, :cmdline
+    end
+  
+    def self.ps
+      retval = []
+      ps_output = `ps ax`
+      ps_output.each_line do |pline|
+        pdata = pline.split(nil, 5)
+        pinfo = ProcInfo.new(pdata[0].strip, pdata[4].strip)
+        retval << pinfo
+      end
+      return retval
+    end
+  end
+end
+
+module RailsPwnage::Base  
+  # returns information about a process
+  def process_info(pid = nil)
+    info = Hash.new
+    Sys::ProcTable.ps.each do |process|
+      item = { :cmdline => process.cmdline, :pid => process.pid.to_s }
+
+      if pid.nil?
+        info[process.pid.to_s] = item
+      else
+        return item if item.pid.to_s == pid.to_s
+      end
+    end
+    if pid.nil?
+      return info
+    else
+      return nil
+    end
+  end
+end

data/zergling.gemspec

@@ -0,0 +1,40 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{zergling}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Victor Costan"]
+  s.date = %q{2008-11-24}
+  s.default_executable = %q{bin/zergling}
+  s.description = %q{Umbrella for the software driving a computer in the Zerg system.}
+  s.email = %q{victor@zergling.net}
+  s.executables = ["zerglingd", "zergling"]
+  s.extensions = ["ext/zergling_geminstall_hook/extconf.rb"]
+  s.extra_rdoc_files = ["lib/zergling.rb", "lib/zergling/process.rb", "ext/zergling_geminstall_hook/extconf.rb", "CHANGELOG", "LICENSE", "bin/zerglingd", "bin/zergling", "README"]
+  s.files = ["lib/zergling.rb", "lib/zergling/process.rb", "ext/zergling_geminstall_hook/extconf.rb", "CHANGELOG", "LICENSE", "bin/zerglingd", "bin/zergling", "README", "Rakefile", "Manifest", "zergling.gemspec"]
+  s.has_rdoc = true
+  s.homepage = %q{http://www.zergling.net}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Zergling", "--main", "README"]
+  s.require_paths = ["lib", "ext"]
+  s.rubyforge_project = %q{rails-pwnage}
+  s.rubygems_version = %q{1.3.1}
+  s.summary = %q{Umbrella for the software driving a computer in the Zerg system.}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<zerg_support>, [">= 0.0.1"])
+      s.add_development_dependency(%q<echoe>, [">= 0"])
+    else
+      s.add_dependency(%q<zerg_support>, [">= 0.0.1"])
+      s.add_dependency(%q<echoe>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<zerg_support>, [">= 0.0.1"])
+    s.add_dependency(%q<echoe>, [">= 0"])
+  end
+end

metadata

@@ -0,0 +1,96 @@
+--- !ruby/object:Gem::Specification 
+name: zergling
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Victor Costan
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-11-24 00:00:00 -05:00
+default_executable: bin/zergling
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: zerg_support
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.0.1
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: echoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: Umbrella for the software driving a computer in the Zerg system.
+email: victor@zergling.net
+executables: 
+- zerglingd
+- zergling
+extensions: 
+- ext/zergling_geminstall_hook/extconf.rb
+extra_rdoc_files: 
+- lib/zergling.rb
+- lib/zergling/process.rb
+- ext/zergling_geminstall_hook/extconf.rb
+- CHANGELOG
+- LICENSE
+- bin/zerglingd
+- bin/zergling
+- README
+files: 
+- lib/zergling.rb
+- lib/zergling/process.rb
+- ext/zergling_geminstall_hook/extconf.rb
+- CHANGELOG
+- LICENSE
+- bin/zerglingd
+- bin/zergling
+- README
+- Rakefile
+- Manifest
+- zergling.gemspec
+has_rdoc: true
+homepage: http://www.zergling.net
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Zergling
+- --main
+- README
+require_paths: 
+- lib
+- ext
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: rails-pwnage
+rubygems_version: 1.3.1
+signing_key: 
+specification_version: 2
+summary: Umbrella for the software driving a computer in the Zerg system.
+test_files: []
+