ruby-pcap 0.7.8 → 0.7.9

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 913aacfd45979834125fde75053c925015ee8b45
+  data.tar.gz: 97499258d1aa138e73950474e439f9ec538a8aa2
+SHA512:
+  metadata.gz: ee7bca3fd1b84ccf63ba4e008a770f80e561b7eab224de77f3c6406963e302a4a737f06aebbda7d048b4269117d79babd30991a31fb31ae406bbd7296f6b4e2f
+  data.tar.gz: f4c6a018d754462db3f34ab5006ad5cb0a910a7bda315248f0352f0acf727eb34de29f49e32035085ba44b557e7489d473312208deb49fc5971e3b0b4f59e2d2

data/.travis.yml

@@ -0,0 +1,13 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - 2.1.6
+  - 2.2.2
+  - ruby-head
+os:
+  - linux
+  - osx
+before_install:
+  - sudo apt-get update -qq
+  - sudo apt-get install -y libpcap-dev

data/ChangeLog

@@ -1,3 +1,109 @@
+2015-05-24  Shintaro Kojima <goodies@codeout.net>
+
+	* version 0.7.8 released.
+
+	* Ruby 2.2 support
+
+2012-12-06  Marcus Barczak <mbarczak@etsy.com>
+
+	* version 0.7.7 released.
+
+	* Migrate packaging from jeweller to bundler
+
+2012-01-20  Pedro Navajas <pnavajas@nosolosoftware.biz>
+
+	* Modified pcap.c: new method returning the file descriptor
+
+2011-06-11  Tim Jarratt <tjarratt@gmail.com>
+
+	* Improve performance during capture and makes the gem work on any OS with ruby 1.9.*
+
+2011-06-10  Ilya Maykov <ilyam@ooyala.com>
+
+	* Don't do TRAP_BEG / TRAP_END on any version of Ruby 1.9.
+
+2011-06-09  Ilya Maykov <ilyam@ooyala.com>
+
+	* version 0.7.6 released.
+
+	* Make the trap / don't trap decision at gem installation time, as it's always based on RUBY_PLATFORM + RUBY_VERSION
+	which are known at that time.
+	Removed the shouldnt_trap argument from Pcap::Capture#dispatch and Pcap::Capture#loop, no longer needed.
+	Cache the duplicated variable in Pcap::Pcaplet#each_packet so we don't compute it each time.
+	And some minor code cleanup here and there.
+
+2011-06-07  Tim Jarratt <tjarratt@nearbuysystems.com>
+
+	* Only log "packets received / packets dropped" when a specific flag is passed in.
+
+2011-05-31  Tim Jarratt <tjarratt@nearbuysystems.com>
+
+	* version 0.7.5 released.
+
+	* Added source, destination mac address methods to TCP Packet.
+
+2011-05-30  Tim Jarratt <tjarratt@nearbuysystems.com>
+
+	* Fixes to make this gem run with ruby 1.9.2@p180 on Mac OS X 10.6.7.
+
+2011-02-17  Andrew Hobson <ahobson@damballa.com>
+
+	* version 0.7.4 released.
+
+	* Add support for recalculating the ip checksum.
+	Automatically do so if changing the source or dest IP
+
+2011-02-03  Eric Tamme <etamme@gmail.com>
+
+	* Fixed STR2CSTR issue for ruby 1.9.2
+
+2010-12-02  Andrew Hobson <ahobson@damballa.com>
+
+	* version 0.7.3 released.
+
+	* Update for newest version of libpcap
+
+2010-09-27  Andrew Hobson <ahobson@damballa.com>
+
+	* version 0.7.2 released.
+
+	* Use the proper RSTRING macros.  This appears to get ruby 1.9 working
+
+2010-06-07  Andrew Hobson <ahobson@damballa.com>
+
+	* version 0.7.1 released.
+
+	* Fix assignment of packet timestamp and bump version
+
+2009-06-06  Roman Shterenzon <roman.shterenzon@gmail.com>
+
+	* version 0.7.0 released.
+
+	* Convert to rubygem
+
+2009-05-26  Andrew Hobson <ahobson@macguffin.infloop.com>
+
+	* Allow modifying the src and dst IPs
+
+2009-05-12  Andrew Hobson <ahobson@macguffin.infloop.com>
+
+	* Allow changing the time on a packet
+
+2008-12-22  Andrew Hobson <ahobson@macguffin.local>
+
+	* Fix warning in 1.8.6.
+	Submitted-By: xHire
+
+2008-11-24  Andrew Hobson <ahobson@macguffin.infloop.com>
+
+	* Add support for opening dead pcaps
+	The plan is to support dumping created packets to files and
+	using pcap_inject
+
+	* Apply patches from debian
+
+	* Add support for dumping a raw packet
+
 2000-08-13  Masaki Fukushima  <fukusima@goto.info.waseda.ac.jp>
 
 	* version 0.6 released.

data/README.ja.md

@@ -0,0 +1,44 @@
+## ruby-pcap
+
+[![Build Status](https://travis-ci.org/codeout/ruby-pcap.svg?branch=ruby-pcap-gem)](https://travis-ci.org/codeout/ruby-pcap)
+
+ruby-pcap は Ruby から LBL の libpcap (Packet Capture library) へアク
+セスするための拡張ライブラリです。TCP/IPのヘッダの情報にアクセスするた
+めのクラスも含んでいます。
+
+## インストール
+
+```
+gem install ruby-pcap
+```
+
+### 必要なもの
+
+* ruby-1.9.3以上
+  * 古いバージョンでも動くかもしれませんが、テストされていません
+* libpcap (http://www.tcpdump.org/)
+
+## 使い方
+
+doc および doc-ja ディレクトリ以下にあるファイルを見て下さい。
+examples ディレクトリに簡単なサンプルスクリプトがあります。
+
+## 作者
+
+福嶋正機 <fukusima@goto.info.waseda.ac.jp>
+
+## メンテナー
+
+Marcus Barczak <mbarczak@etsy.com>
+
+## 著作権表示
+
+ruby-pcapは福嶋正機が著作権を保持する free software です。
+
+ruby-pcapはGPL(GNU GENERAL PUBLIC LICENSE)に従って再配布または
+変更することができます。GPLについてはCOPYINGファイルを参照して
+ください。
+
+ruby-pcapは無保証です。作者はruby-pcapのバグなどから発生する
+いかなる損害に対しても責任を持ちません。詳細については GPL を
+参照してください。

data/{README → README.md}

@@ -1,40 +1,36 @@
-* Introduction
+## ruby-pcap
+
+[![Build Status](https://travis-ci.org/ickymettle/ruby-pcap.svg)](https://travis-ci.org/ickymettle/ruby-pcap)
 
 ruby-pcap is a ruby extension to LBL libpcap (Packet Capture library).
 This library also includes classes to access TCP/IP header.
 
-* Installation
-
-Requirements:
-
-  - ruby-1.8.x or ruby-1.9.2
-  - libpcap (http://www.tcpdump.org/)
+## Installation
 
-Compile:
+```
+gem install ruby-pcap
+```
 
-If ruby supports dynamic link of extension module on your OS,
-following commands will install ruby-pcap.
+### Requirements
 
-  rake build
-  sudo gem install pkg/pcap*.gem
+* ruby-1.9.3 or higher
+  * May work with older ruby version but not being tested
+* libpcap (http://www.tcpdump.org/)
 
-* Usage
+## Usage
 
 See the documentation under the directory 'doc'.
 Directory 'examples' contains some simple scripts.
 
-* Author
+## Author
 
 Masaki Fukushima <fukusima@goto.info.waseda.ac.jp>
 
-* Modifications by
-Andrew Hobson <ahobson@gmail.com>
+## Maintained by
 
-* OS X and Ruby 1.9.2 support by
-Tim Jarratt <tjarratt@gmail.com>
+Marcus Barczak <mbarczak@etsy.com>
 
-* Performance Improvements and other great contributes by
-Ilya Maykov
+## Copyright
 
 ruby-pcap is copyrighted free software by Masaki Fukushima.
 

data/Rakefile

@@ -1 +1,7 @@
 require "bundler/gem_tasks"
+require "rake/extensiontask"
+
+Rake::ExtensionTask.new("pcap") do |ext|
+end
+
+task default: :compile

data/doc-ja/Capture.html

@@ -8,52 +8,52 @@
 <DT><H1>Capture</H1></DT>
 <DD>
 
-      �ѥ��åȥ���ץ����ɽ�����֥�������
+      パケットキャプチャを表すオブジェクト
     </DD>
-<DT><H2>�����ѡ����饹:</H2></DT>
+<DT><H2>スーパークラス:</H2></DT>
 <DD><DL><DT><A HREF="http://www.ruby-lang.org/ja/man-1.4/Object.html"><CODE>Object</CODE></A></DT></DL></DD>
-<DT><H2>���󥯥롼�ɤ��Ƥ���⥸�塼��:</H2></DT>
+<DT><H2>インクルードしているモジュール:</H2></DT>
 <DL>
 <DT><A HREF="http://www.ruby-lang.org/ja/man-1.4/Enum.html"><CODE>Enumerable</CODE></A></DT>
 </DL>
-<DT><H2>���饹�᥽�å�:</H2></DT>
+<DT><H2>クラスメソッド:</H2></DT>
 <DL COMPACT>
 <DT>
 <A NAME=".open_live"><CODE>open_live(<var>device</var>[, <var>snaplen</var>[, <var>promisc</var>[, <var>to_ms</var>]]])</CODE></A>
 <DD>
 <p>
 
-          �ǥХ����򥪡��ץ󤷤� <CODE>Capture</CODE> ���֥������Ȥ���
-          ���ޤ���
+          デバイスをオープンして <CODE>Capture</CODE> オブジェクトを返
+          します。
           <VAR>snaplen</VAR>, <VAR>promisc</VAR>,
-          <VAR>to_ms</VAR> �Υǥե�����ͤϤ��줾�� 68 �����ƥå�,
-          <CODE>true</CODE>, 1000 �ߥ��äǤ���
+          <VAR>to_ms</VAR> のデフォルト値はそれぞれ 68 オクテット,
+          <CODE>true</CODE>, 1000 ミリ秒です。
         </p>
 <DT>
 <A NAME=".open_offline"><CODE>open_offline(<var>filename</var>)</CODE></A>
 <DD>
 <p>
 
-          <VAR>filename</VAR> �ǻ��ꤵ�줿�ե�����򥪡��ץ󤷤�
-          <CODE>Capture</CODE>���֥������Ȥ��֤��ޤ���
+          <VAR>filename</VAR> で指定されたファイルをオープンして
+          <CODE>Capture</CODE>オブジェクトを返します。
         </p>
 </DL>
-<DT><H2>�᥽�å�:</H2></DT>
+<DT><H2>メソッド:</H2></DT>
 <DL COMPACT>
 <DT>
 <A NAME="close"><CODE>close</CODE></A>
 <DD>
 <p>
 
-          <CODE>Capture</CODE>���֥������Ȥ򥯥��������ޤ���
+          <CODE>Capture</CODE>オブジェクトをクローズします。
         </p>
 <DT>
 <A NAME="datalink"><CODE>datalink</CODE></A>
 <DD>
 <p>
 
-          �ǡ�����󥯤Υ����פ�ɽ���������֤��ޤ���
-          (<A HREF="Pcap.html#::DLT_EN10MB"><CODE>DLT_EN10MB</CODE></A> ��)
+          データリンクのタイプを表す整数を返します。
+          (<A HREF="Pcap.html#::DLT_EN10MB"><CODE>DLT_EN10MB</CODE></A> 等)
         </p>
 <DT>
 <A NAME="dispatch"><CODE>dispatch([<var>count</var>]) {|<var>packet</var>|...}</CODE></A>
@@ -62,18 +62,18 @@
 
           <P>
 
-            �ƥѥ��åȤ��Ф��Ʒ����֤��ޤ����֥��å��ˤ�
-            <A HREF="Packet.html"><CODE>Packet</CODE></A>�����Υ��֥��饹�Υ��󥹥��󥹤��Ϥ���ޤ���
+            各パケットに対して繰り返します。ブロックには
+            <A HREF="Packet.html"><CODE>Packet</CODE></A>かそのサブクラスのインスタンスが渡されます。
           </P>
 
           <P>
 
-            <VAR>count</VAR> �ˤϽ�������ѥ��åȤκ��������ꤷ�ޤ���
-            <VAR>count</VAR> �� -1 ����ꤹ��ȥХåե������äƤ����
-            ���å����Ƥ�������ޤ���<VAR>count</VAR> �� 0 ����ꤹ���
-            ���顼���ե�����ν���꤫�����ॢ���Ȥ�ã����ޤǥѥ��å�
-            ��������ޤ���
-            <VAR>count</VAR> �Υǥե�����ͤ� -1 �Ǥ���
+            <VAR>count</VAR> には処理するパケットの最大数を指定します。
+            <VAR>count</VAR> に -1 を指定するとバッファに入っているパ
+            ケット全てを処理します。<VAR>count</VAR> に 0 を指定すると
+            エラーかファイルの終わりかタイムアウトに達するまでパケット
+            を処理します。
+            <VAR>count</VAR> のデフォルト値は -1 です。
           </P>
 
         </p>
@@ -90,16 +90,16 @@
 
           <P>
 
-            �ƥѥ��åȤ��Ф��Ʒ����֤��ޤ����֥��å��ˤ�
-            <A HREF="Packet.html"><CODE>Packet</CODE></A>�����Υ��֥��饹�Υ��󥹥��󥹤��Ϥ���ޤ���
+            各パケットに対して繰り返します。ブロックには
+            <A HREF="Packet.html"><CODE>Packet</CODE></A>かそのサブクラスのインスタンスが渡されます。
           </P>
 
           <P>
 
-            <VAR>count</VAR> �ˤϽ�������ѥ��åȤκ��������ꤷ�ޤ���
-            <VAR>count</VAR> ����ο�����ꤹ��ȥ��顼���ե�����ν���
-            ���ã����ޤǥѥ��åȤ�������ޤ���<VAR>count</VAR> �Υǥե�
-            ����ͤ� -1 �Ǥ���
+            <VAR>count</VAR> には処理するパケットの最大数を指定します。
+            <VAR>count</VAR> に負の数を指定するとエラーかファイルの終わ
+            りに達するまでパケットを処理します。<VAR>count</VAR> のデフォ
+            ルト値は -1 です。
           </P>
 
         </p>
@@ -111,29 +111,29 @@
 <DD>
 <p>
 
-          snapshot ��Ĺ�����֤��ޤ���
+          snapshot の長さを返します。
         </p>
 <DT>
 <A NAME="setfilter"><CODE>setfilter(<var>filter</var>[, <var>optimize</var>])</CODE></A>
 <DD>
 <p>
 
-          <VAR>filter</VAR> �ǻ��ꤵ�줿ʸ���󡢤ޤ���<A HREF="Filter.html"><CODE>Filter</CODE></A>��
-          �ե��륿�Ȥ������ꤷ�ޤ���
-          <VAR>optimize</VAR> �� <CODE>true</CODE> �ξ��Ϻ�Ŭ�����
-          ���ޤ���<VAR>optimize</VAR> �Υǥե�����ͤ� 
-          <CODE>true</CODE> �Ǥ���
+          <VAR>filter</VAR> で指定された文字列、または<A HREF="Filter.html"><CODE>Filter</CODE></A>を
+          フィルタとして設定します。
+          <VAR>optimize</VAR> が <CODE>true</CODE> の場合は最適化を行
+          います。<VAR>optimize</VAR> のデフォルト値は 
+          <CODE>true</CODE> です。
         </p>
 <DT>
 <A NAME="stats"><CODE>stats</CODE></A>
 <DD>
 <p>
 
-          �ѥ��åȥ���ץ���ˤĤ��Ƥ����פ�ޤ� <A HREF="http://www.ruby-lang.org/ja/man-1.4/Struct.html"><CODE>Struct</CODE></A>
-          ���֤��ޤ�����¤�Τϰʲ��Υ��Ф�����ޤ���
+          パケットキャプチャについての統計を含む <A HREF="http://www.ruby-lang.org/ja/man-1.4/Struct.html"><CODE>Struct</CODE></A>
+          を返します。構造体は以下のメンバを持ちます。
           <BLOCKQUOTE>
 <DL COMPACT>
-<DT><CODE>recv</CODE></DT><DD>���������ѥ��åȤο�</DD><DT><CODE>drop</CODE></DT><DD>��ꤳ�ܤ��������ѥ��åȤο�</DD></DL>
+<DT><CODE>recv</CODE></DT><DD>受信したパケットの数</DD><DT><CODE>drop</CODE></DT><DD>取りこぼしたしたパケットの数</DD></DL>
 </BLOCKQUOTE>
 
         </p>

data/doc-ja/Dumper.html

@@ -8,41 +8,41 @@
 <DT><H1>Dumper</H1></DT>
 <DD>
 
-      �ѥ��åȤ� tcpdump �����Υե�����˽񤭽Ф����饹�����������ե������
-      tcpdump ��<A HREF="Capture.html#.open_offline"><CODE>Capture.open_offline</CODE></A>��Ȥä��ɤळ�Ȥ��Ǥ��ޤ���
+      パケットを tcpdump 形式のファイルに書き出すクラス。生成したファイルは
+      tcpdump や<A HREF="Capture.html#.open_offline"><CODE>Capture.open_offline</CODE></A>を使って読むことができます。
     </DD>
-<DT><H2>�����ѡ����饹:</H2></DT>
+<DT><H2>スーパークラス:</H2></DT>
 <DD><DL><DT><A HREF="http://www.ruby-lang.org/ja/man-1.4/Object.html"><CODE>Object</CODE></A></DT></DL></DD>
-<DT><H2>���饹�᥽�å�:</H2></DT>
+<DT><H2>クラスメソッド:</H2></DT>
 <DL COMPACT>
 <DT>
 <A NAME=".open"><CODE>open(<var>capture</var>, <var>filename</var>)</CODE></A>
 <DD>
 <p>
 
-          <VAR>capture</VAR>�����������ѥ��åȤ�
-          <VAR>filename</VAR>�˽񤭽Ф������<CODE>Dumper</CODE>���֤�
-          �ޤ���
+          <VAR>capture</VAR>から取り込んだパケットを
+          <VAR>filename</VAR>に書き出すための<CODE>Dumper</CODE>を返し
+          ます。
         </p>
 </DL>
-<DT><H2>�᥽�å�:</H2></DT>
+<DT><H2>メソッド:</H2></DT>
 <DL COMPACT>
 <DT>
 <A NAME="close"><CODE>close</CODE></A>
 <DD>
 <p>
 
-          <CODE>Dumper</CODE>���֥������Ȥ򥯥��������ޤ���
+          <CODE>Dumper</CODE>オブジェクトをクローズします。
         </p>
 <DT>
 <A NAME="dump"><CODE>dump(<var>packet</var>)</CODE></A>
 <DD>
 <p>
 
-          <VAR>packet</VAR>�򤳤�<CODE>Dumper</CODE>�˽񤭽Ф��ޤ���
-          <VAR>packet</VAR>�Ϥ���<CODE>Dumper</CODE>�򥪡��ץ󤹤����
-          ���ꤷ��<A HREF="Capture.html"><CODE>Capture</CODE></A>��������ޤ줿��ΤǤʤ���Фʤ��
-          ����
+          <VAR>packet</VAR>をこの<CODE>Dumper</CODE>に書き出します。
+          <VAR>packet</VAR>はこの<CODE>Dumper</CODE>をオープンする時に
+          指定した<A HREF="Capture.html"><CODE>Capture</CODE></A>から取り込まれたものでなければなりま
+          せん。
         </p>
 </DL>
 </DL>