tem_multi_proxy 0.1

data/CHANGELOG

@@ -0,0 +1 @@
+v0.1. Initial release. Standalone manager works.

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2009 Massachusetts Institute of Technology
+
+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,8 @@
+bin/tem_multi_proxy
+CHANGELOG
+lib/tem_multi_proxy/manager.rb
+lib/tem_multi_proxy.rb
+LICENSE
+Rakefile
+README
+Manifest

data/README

@@ -0,0 +1,9 @@
+tem_multi_proxy is a tool that automatically creates a TEM proxy for each PC/SC
+reader on the system. The tool reacts appropriately to PC/SC events like
+readers being added or cards being inserted. It also re-spawns proxy processes
+if they die.
+
+The utility's intended use is for TEM clusters (systems with multiple TEMs
+attached), where the TEM's auto-configuration mechanism wouldn't allow access to
+all the TEMs.
+ 

data/Rakefile

@@ -0,0 +1,26 @@
+require 'rubygems'
+gem 'echoe'
+require 'echoe'
+
+Echoe.new('tem_multi_proxy') do |p|
+  p.project = 'tem' # rubyforge project
+  p.docs_host = "costan@rubyforge.org:/var/www/gforge-projects/tem/rdoc/"
+  
+  p.author = 'Victor Costan'
+  p.email = 'victor@costan.us'
+  p.summary = 'Maintains TEM proxies for all the physically attached TEMs.'
+  p.url = 'http://tem.rubyforge.org'
+  p.dependencies = ['rbtree >=0.2.1',
+                    'smartcard >=0.3.1',
+                    'tem_ruby >=0.11',
+                    'zerg_support >=0.0.9']
+  
+  p.need_tar_gz = !Platform.windows?
+  p.need_zip = !Platform.windows?
+  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/bin/tem_multi_proxy

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'tem_multi_proxy'
+
+manager = Tem::MultiProxy::Manager.new
+manager.management_loop

data/lib/tem_multi_proxy.rb

@@ -0,0 +1,12 @@
+# Gem requirements.
+require 'rubygems'
+require 'smartcard'
+require 'tem_ruby'
+require 'zerg_support'
+
+# :nodoc: namespace
+module Tem::MultiProxy  
+end
+
+# The files making up the gem.
+require 'tem_multi_proxy/manager.rb'

data/lib/tem_multi_proxy/manager.rb

@@ -0,0 +1,132 @@
+require 'logger'
+require 'rbtree'
+require 'set'
+
+
+# :nodoc: namespace
+module Tem::MultiProxy  
+
+class Manager
+  def initialize
+    @pcsc_context = Smartcard::PCSC::Context.new(Smartcard::PCSC::SCOPE_SYSTEM)
+    @proxy_pids = {}
+    @proxy_ports = {}
+    @free_ports = RBTree.new
+    (9001...9050).each { |port| @free_ports[port] = true }
+    @logger = Logger.new STDERR
+  end
+
+  # Polls each smartcard reader to see if there's a card present.
+  def poll_readers
+    readers = @pcsc_context.list_readers(nil).map { |name| { :name => name }}
+    reader_states = Smartcard::PCSC::ReaderStates.new readers.length
+    readers.each_with_index do |reader, i|
+      reader_states.set_reader_name_of!(i, reader[:name])
+      reader_states.set_current_state_of!(i, Smartcard::PCSC::STATE_UNAWARE)      
+    end    
+    @pcsc_context.get_status_change reader_states, 100
+    
+    readers.each_with_index do |reader, i|
+      reader[:atr] = reader_states.atr_of i
+      # current_state_of is buggy on pcsclite, using the ATR for card detection.
+      if reader[:atr].length == 0
+        reader[:card] = false
+        reader[:atr] = nil
+      else
+        reader[:card] = true
+      end
+    end
+    
+    readers
+  end
+    
+  # Allocates a port for a TEM proxy.
+  def alloc_proxy_port(reader_name)
+    port = @free_ports.min.first
+    @free_ports.delete port
+    @proxy_ports[reader_name] = port
+    port
+  end
+  
+  # Marks a TEM proxy port as free.
+  def free_proxy_port(reader_name)
+    port = @proxy_ports[reader_name]
+    return unless port
+    @proxy_ports.delete reader_name
+    @free_ports[port] = true
+  end
+
+  # Launches a tem_proxy process connecting to a reader.
+  def spawn_proxy_for_reader(reader)
+    proxy_port = alloc_proxy_port reader[:name]
+    proxy_pid = Zerg::Support::Process.spawn 'tem_proxy', [proxy_port.to_s],
+        :env => {'TEM_PORT' => reader[:name], 'DEBUG' => 'no'},
+        :pgroup => true
+    @proxy_pids[reader[:name]] = proxy_pid
+  end
+  
+  # Updates the internal status to reflect that a tem_proxy process died. 
+  def proxy_died(reader_name)
+    free_proxy_port reader_name
+    @proxy_pids.delete reader_name
+  end
+  
+  # Kills the tem_proxy process for a reader.
+  def kill_proxy(reader_name)
+    if proxy_pid = @proxy_pids[reader_name]
+      Zerg::Support::Process.kill_tree proxy_pid
+    end
+    proxy_died reader_name
+  end
+  
+  # Kills all the proxy processes.
+  def kill_all_proxies
+    processes = Zerg::Support::Process.processes
+    processes.each do |proc_info|
+      next unless /tem_proxy/ =~ proc_info[:command_line]
+      @logger.info "Mass-killing TEM proxy (pid #{proc_info[:pid]})"
+      Zerg::Support::Process::kill_tree proc_info[:pid]
+    end
+  end  
+  
+  # Synchronizes the running tem_proxy processes with the list of readers.  
+  def sync_reader_proxies
+    processes = Zerg::Support::Process.processes_by_id
+    # Check for crashed tem_proxy processes.
+    @proxy_pids.each do |reader_name, pid|
+      proc_info = processes[pid]
+      unless proc_info and /tem_proxy/ =~ proc_info[:command_line]
+        @logger.warn "TEM proxy for #{reader_name} (pid #{pid}) died."
+        proxy_died reader_name
+      end
+    end
+
+    live_readers = poll_readers.select { |reader| reader[:card] }
+    # Kill proxies whose readers aren't available.
+    live_reader_names = Set.new live_readers.map { |reader| reader[:name] }
+    @proxy_pids.keys.each do |reader_name|
+      next if live_reader_names.include? reader_name
+      @logger.info "Killing TEM proxy for #{reader_name}. " +
+                   "(pid #{@proxy_pids[reader_name]})"
+      kill_proxy reader_name
+    end
+    
+    # Spawn proxies for readers without them.
+    live_readers.each do |reader|
+      next if @proxy_pids[reader[:name]]
+      @logger.info "Spawning new TEM proxy for #{reader[:name]}."
+      spawn_proxy_for_reader reader
+    end
+  end
+  
+  # Never-ending loop mananging TEM proxies for all the readers.
+  def management_loop
+    kill_all_proxies
+    loop do
+      sync_reader_proxies
+      Kernel.sleep 1
+    end
+  end
+end
+
+end  # namespace Tem::MultiProxy

data/tem_multi_proxy.gemspec

@@ -0,0 +1,44 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{tem_multi_proxy}
+  s.version = "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{2009-06-01}
+  s.default_executable = %q{tem_multi_proxy}
+  s.description = %q{Maintains TEM proxies for all the physically attached TEMs.}
+  s.email = %q{victor@costan.us}
+  s.executables = ["tem_multi_proxy"]
+  s.extra_rdoc_files = ["bin/tem_multi_proxy", "CHANGELOG", "lib/tem_multi_proxy/manager.rb", "lib/tem_multi_proxy.rb", "LICENSE", "README"]
+  s.files = ["bin/tem_multi_proxy", "CHANGELOG", "lib/tem_multi_proxy/manager.rb", "lib/tem_multi_proxy.rb", "LICENSE", "Rakefile", "README", "Manifest", "tem_multi_proxy.gemspec"]
+  s.homepage = %q{http://tem.rubyforge.org}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Tem_multi_proxy", "--main", "README"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{tem}
+  s.rubygems_version = %q{1.3.4}
+  s.summary = %q{Maintains TEM proxies for all the physically attached TEMs.}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<rbtree>, [">= 0.2.1"])
+      s.add_runtime_dependency(%q<smartcard>, [">= 0.3.1"])
+      s.add_runtime_dependency(%q<tem_ruby>, [">= 0.11"])
+      s.add_runtime_dependency(%q<zerg_support>, [">= 0.0.9"])
+    else
+      s.add_dependency(%q<rbtree>, [">= 0.2.1"])
+      s.add_dependency(%q<smartcard>, [">= 0.3.1"])
+      s.add_dependency(%q<tem_ruby>, [">= 0.11"])
+      s.add_dependency(%q<zerg_support>, [">= 0.0.9"])
+    end
+  else
+    s.add_dependency(%q<rbtree>, [">= 0.2.1"])
+    s.add_dependency(%q<smartcard>, [">= 0.3.1"])
+    s.add_dependency(%q<tem_ruby>, [">= 0.11"])
+    s.add_dependency(%q<zerg_support>, [">= 0.0.9"])
+  end
+end

metadata

@@ -0,0 +1,112 @@
+--- !ruby/object:Gem::Specification 
+name: tem_multi_proxy
+version: !ruby/object:Gem::Version 
+  version: "0.1"
+platform: ruby
+authors: 
+- Victor Costan
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-06-01 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rbtree
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.2.1
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: smartcard
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.3.1
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: tem_ruby
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0.11"
+    version: 
+- !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.9
+    version: 
+description: Maintains TEM proxies for all the physically attached TEMs.
+email: victor@costan.us
+executables: 
+- tem_multi_proxy
+extensions: []
+
+extra_rdoc_files: 
+- bin/tem_multi_proxy
+- CHANGELOG
+- lib/tem_multi_proxy/manager.rb
+- lib/tem_multi_proxy.rb
+- LICENSE
+- README
+files: 
+- bin/tem_multi_proxy
+- CHANGELOG
+- lib/tem_multi_proxy/manager.rb
+- lib/tem_multi_proxy.rb
+- LICENSE
+- Rakefile
+- README
+- Manifest
+- tem_multi_proxy.gemspec
+has_rdoc: true
+homepage: http://tem.rubyforge.org
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Tem_multi_proxy
+- --main
+- README
+require_paths: 
+- lib
+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: tem
+rubygems_version: 1.3.4
+signing_key: 
+specification_version: 3
+summary: Maintains TEM proxies for all the physically attached TEMs.
+test_files: []
+