dakrone-pcap-ffi 0.0.0

data/spec/handler_examples.rb

@@ -0,0 +1,71 @@
+require 'pcap/handler'
+
+require 'spec_helper'
+
+shared_examples_for "Handler" do
+  it "must have a datalink" do
+    datalink = @pcap.datalink
+
+    datalink.value.should_not be_nil
+    datalink.name.should_not be_empty
+  end
+
+  it "should pass packets to a callback" do
+    @pcap.callback do |user,header,bytes|
+      header.captured.should_not == 0
+      header.length.should_not == 0
+
+      bytes.should_not be_null
+    end
+
+    @pcap.loop
+  end
+
+  it "should be able to get the next packet" do
+    header, data = @pcap.next
+
+    header.should_not be_nil
+    header.captured.should_not == 0
+    header.length.should_not == 0
+
+    data.should_not be_nil
+    data.should_not be_null
+  end
+
+  it "should be able to open a dump file" do
+    lambda {
+      dumper = @pcap.open_dump(Tempfile.new.path)
+      dumper.close
+    }.should_not raise_error(RuntimeError)
+  end
+
+  it "should raise an exception when opening a bad dump file" do
+    lambda {
+      @pcap.open_dump(File.join('','obviously','not','there'))
+    }.should raise_error(RuntimeError)
+  end
+
+  it "should return an empty String when an error has not occurred" do
+    @pcap.error.should be_empty
+  end
+
+  it "should be able to break out of the Handler#loop" do
+    stopped = false
+
+    @pcap.loop do |user,pkthdr,bytes|
+      stopped = true
+      @pcap.stop
+    end
+
+    stopped.should == true
+  end
+
+  it "should prevent double closes" do
+    @pcap.close
+    @pcap.should be_closed
+
+    lambda {
+      @pcap.close
+    }.should_not raise_error(StandardError)
+  end
+end

data/spec/handler_spec.rb

@@ -0,0 +1,80 @@
+require 'pcap/handler'
+
+require 'spec_helper'
+require 'helpers/dumps'
+require 'handler_examples'
+
+describe PCap::Handler do
+  describe "offline" do
+    before(:each) do
+      @pcap = PCap.open_offline(dump_path('simple_tcp'))
+    end
+
+    after(:each) do
+      @pcap.close
+    end
+
+    it_should_behave_like "Handler"
+
+    it "should not support non-blocking mode" do
+      @pcap.non_blocking = true
+      @pcap.should_not be_non_blocking
+    end
+
+    it "should return a nil if there are no packets left in the dump file" do
+      @pcap.loop
+
+      header, data = @pcap.next
+
+      header.should be_nil
+      data.should be_nil
+    end
+
+    it "should raise a ReadError when reading past the end of a dump file" do
+      @pcap.loop
+
+      lambda {
+        @pcap.next_extra
+      }.should raise_error(ReadError)
+    end
+  end
+
+  describe "live" do
+    before(:each) do
+      @pcap = PCap.open_live(:count => 2)
+    end
+
+    after(:each) do
+      @pcap.close
+    end
+
+    it_should_behave_like "Handler"
+
+    it "should support non-blocking mode" do
+      @pcap.non_blocking = true
+      @pcap.should be_non_blocking
+    end
+
+    it "should provide statistics about packets received/dropped" do
+      @pcap.loop
+
+      stats = @pcap.stats
+      stats.received.should > 0
+    end
+  end
+
+  describe "dead" do
+    before(:each) do
+      @pcap = PCap.open_dead
+    end
+
+    after(:each) do
+      @pcap.close
+    end
+
+    it "should support non-blocking mode" do
+      @pcap.non_blocking = true
+      @pcap.should be_non_blocking
+    end
+  end
+end

data/spec/helpers/dumps.rb

@@ -0,0 +1,3 @@
+def dump_path(name)
+  File.expand_path(File.join(File.dirname(__FILE__),'..','dumps',"#{name}.pcap"))
+end

data/spec/pcap_spec.rb

@@ -0,0 +1,51 @@
+require 'pcap/pcap'
+require 'pcap/version'
+
+require 'spec_helper'
+require 'helpers/dumps'
+
+describe PCap do
+  it "should define a VERSION constant" do
+    PCap.const_defined?('VERSION').should == true
+  end
+
+  it "should have a library version" do
+    PCap.lib_version.should_not be_empty
+  end
+
+  it "should return the name of a device suitable for open_live" do
+    dev = PCap.device
+
+    dev.should_not be_nil
+    dev.should_not be_empty
+  end
+
+  it "should enumerate over all usable devices" do
+    PCap.each_device do |dev|
+      dev.should_not be_nil
+      dev.should_not be_null
+      dev.class.should == PCap::IF
+    end
+  end
+
+  it "should be able to open a live pcap handler" do
+    lambda {
+      pcap = PCap.open_live
+      pcap.close
+    }.should_not raise_error(StandardError)
+  end
+
+  it "should be able to open a dead pcap handler" do
+    lambda {
+      pcap = PCap.open_dead('null')
+      pcap.close
+    }.should_not raise_error(StandardError)
+  end
+
+  it "should be able to open a pcap dump file" do
+    lambda {
+      pcap = PCap.open_offline(dump_path('simple_tcp'))
+      pcap.close
+    }.should_not raise_error(StandardError)
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,8 @@
+require 'rubygems'
+gem 'rspec', '>=1.1.12'
+require 'spec'
+
+require 'pcap/version'
+
+include FFI
+include FFI::PCap

data/tasks/spec.rb

@@ -0,0 +1,9 @@
+require 'spec/rake/spectask'
+
+desc "Run all specifications"
+Spec::Rake::SpecTask.new(:spec) do |t|
+  t.libs += ['lib', 'spec']
+  t.spec_opts = ['--colour', '--format', 'specdoc']
+end
+
+task :default => :spec

metadata

@@ -0,0 +1,101 @@
+--- !ruby/object:Gem::Specification 
+name: dakrone-pcap-ffi
+version: !ruby/object:Gem::Version 
+  version: 0.0.0
+platform: ruby
+authors: 
+- Postmodern, Dakrone
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-05-27 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: Bindings to sniff packets using the FFI interface in Ruby.
+email: postmodern.mod3@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.txt
+files: 
+- .gitignore
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- VERSION
+- examples/print_bytes.rb
+- lib/pcap.rb
+- lib/pcap/addr.rb
+- lib/pcap/data_link.rb
+- lib/pcap/dumper.rb
+- lib/pcap/error_buffer.rb
+- lib/pcap/exceptions.rb
+- lib/pcap/exceptions/read_error.rb
+- lib/pcap/ffi.rb
+- lib/pcap/file_header.rb
+- lib/pcap/handler.rb
+- lib/pcap/if.rb
+- lib/pcap/in_addr.rb
+- lib/pcap/packet_header.rb
+- lib/pcap/packets.rb
+- lib/pcap/packets/ethernet.rb
+- lib/pcap/packets/ip.rb
+- lib/pcap/packets/tcp.rb
+- lib/pcap/packets/typedefs.rb
+- lib/pcap/pcap.rb
+- lib/pcap/sock_addr.rb
+- lib/pcap/sock_addr_in.rb
+- lib/pcap/stat.rb
+- lib/pcap/time_val.rb
+- lib/pcap/typedefs.rb
+- lib/pcap/version.rb
+- pcap-ffi.gemspec
+- spec/data_link_spec.rb
+- spec/dumps/simple_tcp.pcap
+- spec/error_buffer.rb
+- spec/handler_examples.rb
+- spec/handler_spec.rb
+- spec/helpers/dumps.rb
+- spec/pcap_spec.rb
+- spec/spec_helper.rb
+- tasks/spec.rb
+has_rdoc: true
+homepage: http://github.com/postmodern/pcap-ffi
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+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: "0"
+  version: 
+requirements: []
+
+rubyforge_project: pcap-ffi
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: FFI bindings for libpcap
+test_files: 
+- spec/pcap_spec.rb
+- spec/data_link_spec.rb
+- spec/error_buffer.rb
+- spec/spec_helper.rb
+- spec/handler_spec.rb
+- spec/handler_examples.rb
+- spec/helpers/dumps.rb
+- examples/print_bytes.rb