ruby-pcap 0.7.8 → 0.7.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +7 -0
- data/.travis.yml +13 -0
- data/ChangeLog +106 -0
- data/README.ja.md +44 -0
- data/{README → README.md} +16 -20
- data/Rakefile +6 -0
- data/doc-ja/Capture.html +37 -37
- data/doc-ja/Dumper.html +13 -13
- data/doc-ja/Filter.html +29 -29
- data/doc-ja/ICMPPacket.html +39 -39
- data/doc-ja/IPAddress.html +9 -9
- data/doc-ja/IPPacket.html +19 -19
- data/doc-ja/Packet.html +20 -20
- data/doc-ja/Pcap.html +17 -17
- data/doc-ja/PcapError.html +2 -2
- data/doc-ja/Pcaplet.html +25 -25
- data/doc-ja/TCPPacket.html +19 -19
- data/doc-ja/TruncatedPacket.html +3 -3
- data/doc-ja/UDPPacket.html +10 -10
- data/doc-ja/index.html +9 -9
- data/ext/{Pcap.c → pcap/Pcap.c} +3 -3
- data/ext/{extconf.rb → pcap/extconf.rb} +0 -0
- data/ext/{icmp_packet.c → pcap/icmp_packet.c} +0 -0
- data/ext/{ip_packet.c → pcap/ip_packet.c} +0 -0
- data/ext/{packet.c → pcap/packet.c} +0 -0
- data/ext/{ruby_pcap.h → pcap/ruby_pcap.h} +0 -0
- data/ext/{tcp_packet.c → pcap/tcp_packet.c} +0 -0
- data/ext/{udp_packet.c → pcap/udp_packet.c} +0 -0
- data/lib/pcap/packet.rb +69 -0
- data/lib/{pcaplet.rb → pcap/pcaplet.rb} +14 -11
- data/lib/pcap/tcpdump_time_format.rb +10 -0
- data/lib/pcap_misc.rb +2 -78
- data/ruby-pcap.gemspec +6 -3
- metadata +41 -28
- data/MANIFEST +0 -47
- data/README.ja +0 -50
- data/VERSION +0 -1
data/doc-ja/Packet.html
CHANGED
@@ -8,37 +8,37 @@
|
|
8
8
|
<DT><H1>Packet</H1></DT>
|
9
9
|
<DD>
|
10
10
|
|
11
|
-
<A HREF="Capture.html"><CODE>Capture</CODE></A
|
12
|
-
<CODE>Packet</CODE
|
13
|
-
|
11
|
+
<A HREF="Capture.html"><CODE>Capture</CODE></A>によってキャプチャされたパケットのデータ。
|
12
|
+
<CODE>Packet</CODE>、およびそのサブクラスは<A HREF="http://www.ruby-lang.org/ja/man-1.4/Marshal.html"><CODE>Marshal</CODE></A>に対応
|
13
|
+
しています。
|
14
14
|
</DD>
|
15
|
-
<DT><H2
|
15
|
+
<DT><H2>スーパークラス:</H2></DT>
|
16
16
|
<DD><DL><DT><A HREF="http://www.ruby-lang.org/ja/man-1.4/Object.html"><CODE>Object</CODE></A></DT></DL></DD>
|
17
|
-
<DT><H2
|
17
|
+
<DT><H2>メソッド:</H2></DT>
|
18
18
|
<DL COMPACT>
|
19
19
|
<DT>
|
20
20
|
<A NAME="caplen"><CODE>caplen</CODE></A>
|
21
21
|
<DD>
|
22
22
|
<p>
|
23
23
|
|
24
|
-
|
24
|
+
パケットのキャプチャされている部分の長さを返します。
|
25
25
|
</p>
|
26
26
|
<DT>
|
27
27
|
<A NAME="datalink"><CODE>datalink</CODE></A>
|
28
28
|
<DD>
|
29
29
|
<p>
|
30
30
|
|
31
|
-
|
32
|
-
(<A HREF="Pcap.html#::DLT_EN10MB"><CODE>DLT_EN10MB</CODE></A>
|
31
|
+
データリンクのタイプを表す整数を返します。
|
32
|
+
(<A HREF="Pcap.html#::DLT_EN10MB"><CODE>DLT_EN10MB</CODE></A> 等)
|
33
33
|
</p>
|
34
34
|
<DT>
|
35
35
|
<A NAME="ip?"><CODE>ip?</CODE></A>
|
36
36
|
<DD>
|
37
37
|
<p>
|
38
38
|
|
39
|
-
|
40
|
-
|
41
|
-
<CODE>true</CODE>
|
39
|
+
このパケットが<A HREF="IPPacket.html"><CODE>IPPacket</CODE></A>
|
40
|
+
かそのサブクラスのインスタンスであれば
|
41
|
+
<CODE>true</CODE> を返します。
|
42
42
|
</p>
|
43
43
|
<DT>
|
44
44
|
<A NAME="len"><CODE>len</CODE></A>
|
@@ -51,45 +51,45 @@
|
|
51
51
|
<DD>
|
52
52
|
<p>
|
53
53
|
|
54
|
-
|
54
|
+
パケット全体の長さを返します。
|
55
55
|
</p>
|
56
56
|
<DT>
|
57
57
|
<A NAME="raw_data"><CODE>raw_data</CODE></A>
|
58
58
|
<DD>
|
59
59
|
<p>
|
60
60
|
|
61
|
-
|
61
|
+
このパケットの先頭からの生データを<A HREF="http://www.ruby-lang.org/ja/man-1.4/String.html"><CODE>String</CODE></A>として返します。
|
62
62
|
</p>
|
63
63
|
<DT>
|
64
64
|
<A NAME="tcp?"><CODE>tcp?</CODE></A>
|
65
65
|
<DD>
|
66
66
|
<p>
|
67
67
|
|
68
|
-
|
69
|
-
|
68
|
+
このパケットが<A HREF="TCPPacket.html"><CODE>TCPPacket</CODE></A>かそのサブクラスのインス
|
69
|
+
タンスであれば true を返します。
|
70
70
|
</p>
|
71
71
|
<DT>
|
72
72
|
<A NAME="time"><CODE>time</CODE></A>
|
73
73
|
<DD>
|
74
74
|
<p>
|
75
75
|
|
76
|
-
|
77
|
-
|
76
|
+
このパケットのタイムスタンプを <A HREF="http://www.ruby-lang.org/ja/man-1.4/Time.html"><CODE>Time</CODE></A> オブジェク
|
77
|
+
トとして返します。
|
78
78
|
</p>
|
79
79
|
<DT>
|
80
80
|
<A NAME="time_i"><CODE>time_i</CODE></A>
|
81
81
|
<DD>
|
82
82
|
<p>
|
83
83
|
|
84
|
-
|
84
|
+
このパケットのタイムスタンプを整数として返します。
|
85
85
|
</p>
|
86
86
|
<DT>
|
87
87
|
<A NAME="udp?"><CODE>udp?</CODE></A>
|
88
88
|
<DD>
|
89
89
|
<p>
|
90
90
|
|
91
|
-
|
92
|
-
|
91
|
+
このパケットが<A HREF="UDPPacket.html"><CODE>UDPPacket</CODE></A>かそのサブクラスのインス
|
92
|
+
タンスであれば true を返します。
|
93
93
|
</p>
|
94
94
|
</DL>
|
95
95
|
</DL>
|
data/doc-ja/Pcap.html
CHANGED
@@ -8,9 +8,9 @@
|
|
8
8
|
<DT><H1>Pcap</H1></DT>
|
9
9
|
<DD>
|
10
10
|
|
11
|
-
pcap
|
11
|
+
pcap 全般に関するメソッドや定数を定義しています。
|
12
12
|
</DD>
|
13
|
-
<DT><H2
|
13
|
+
<DT><H2>定数:</H2></DT>
|
14
14
|
<DL COMPACT>
|
15
15
|
<DT>
|
16
16
|
<A NAME="::DLT_NULL"><CODE>DLT_NULL</CODE></A>
|
@@ -59,47 +59,47 @@
|
|
59
59
|
<DD>
|
60
60
|
<p>
|
61
61
|
|
62
|
-
|
62
|
+
データリンク層の種類を表す定数。
|
63
63
|
</p>
|
64
64
|
</DL>
|
65
|
-
<DT><H2
|
65
|
+
<DT><H2>モジュールメソッド:</H2></DT>
|
66
66
|
<DL COMPACT>
|
67
67
|
<DT>
|
68
68
|
<A NAME=".convert="><CODE>convert = <var>bool</var></CODE></A>
|
69
69
|
<DD>
|
70
70
|
<p>
|
71
71
|
|
72
|
-
<CODE>Pcap</CODE>
|
73
|
-
|
74
|
-
|
72
|
+
<CODE>Pcap</CODE> モジュール中のクラスが IP アドレスなどの数値を
|
73
|
+
文字列に変換しようとした時の動作を設定します。<CODE>true</CODE>
|
74
|
+
ならばそのような数値は名前に変換されます。
|
75
75
|
</p>
|
76
76
|
<DT>
|
77
77
|
<A NAME=".convert?"><CODE>convert?</CODE></A>
|
78
78
|
<DD>
|
79
79
|
<p>
|
80
80
|
|
81
|
-
<CODE>Pcap</CODE>
|
82
|
-
|
83
|
-
|
81
|
+
<CODE>Pcap</CODE> モジュール中のクラスが IP アドレスなどの数値を
|
82
|
+
文字列に変換しようとした時の動作を返します。<CODE>true</CODE>
|
83
|
+
ならばそのような数値は名前に変換されます。
|
84
84
|
</p>
|
85
85
|
<DT>
|
86
86
|
<A NAME=".lookupdev"><CODE>lookupdev</CODE></A>
|
87
87
|
<DD>
|
88
88
|
<p>
|
89
89
|
|
90
|
-
|
90
|
+
ネットワークデバイス名を返します。
|
91
91
|
</p>
|
92
92
|
<DT>
|
93
93
|
<A NAME=".lookupnet"><CODE>lookupnet(<var>device</var>)</CODE></A>
|
94
94
|
<DD>
|
95
95
|
<p>
|
96
96
|
|
97
|
-
<CODE>[net, mask]</CODE>
|
98
|
-
<CODE>net</CODE
|
99
|
-
<A HREF="IPAddress.html"><CODE>IPAddress</CODE></A
|
100
|
-
<CODE>mask</CODE
|
101
|
-
|
102
|
-
|
97
|
+
<CODE>[net, mask]</CODE> なる2要素配列を返します。
|
98
|
+
<CODE>net</CODE>はネットワーク番号を表す
|
99
|
+
<A HREF="IPAddress.html"><CODE>IPAddress</CODE></A>です。
|
100
|
+
<CODE>mask</CODE>はネットマスクを表す<A HREF="http://www.ruby-lang.org/ja/man-1.4/Integer.html"><CODE>Integer</CODE></A>です。
|
101
|
+
引数<VAR>device</VAR>によりネットワークデバイス名を指定
|
102
|
+
します。
|
103
103
|
</p>
|
104
104
|
</DL>
|
105
105
|
</DL>
|
data/doc-ja/PcapError.html
CHANGED
data/doc-ja/Pcaplet.html
CHANGED
@@ -10,21 +10,21 @@
|
|
10
10
|
|
11
11
|
<P>
|
12
12
|
|
13
|
-
<A HREF="Capture.html"><CODE>Capture</CODE></A
|
14
|
-
|
15
|
-
|
16
|
-
|
13
|
+
<A HREF="Capture.html"><CODE>Capture</CODE></A>を使うパケット処理ツールの雛形を提供するクラスで
|
14
|
+
す。
|
15
|
+
使うときは<CODE>'pcaplet'</CODE> を <CODE>require</CODE>して下
|
16
|
+
さい。
|
17
17
|
</P>
|
18
18
|
|
19
19
|
<P>
|
20
20
|
|
21
|
-
|
21
|
+
典型的な使い方:
|
22
22
|
<blockquote>
|
23
23
|
<pre>require 'pcaplet'
|
24
24
|
|
25
25
|
my_tool = Pcaplet.new
|
26
26
|
my_tool.each_packet {|pkt|
|
27
|
-
# pkt
|
27
|
+
# pkt について処理を行なうコード
|
28
28
|
}
|
29
29
|
my_tool.close
|
30
30
|
</pre>
|
@@ -34,43 +34,43 @@ my_tool.close
|
|
34
34
|
|
35
35
|
<P>
|
36
36
|
|
37
|
-
|
38
|
-
|
37
|
+
コマンドラインで指定されたフィルタ、および
|
38
|
+
以下のコマンドラインオプションを tcpdump と同様に解釈します。
|
39
39
|
<blockquote>
|
40
40
|
<pre>-i -r -c -s -n
|
41
41
|
</pre>
|
42
42
|
</blockquote>
|
43
43
|
|
44
|
-
'<CODE>-r</CODE>'
|
45
|
-
|
44
|
+
'<CODE>-r</CODE>' オプションでは、gzipで圧縮されたファイルを読
|
45
|
+
み込むこともできます。
|
46
46
|
</P>
|
47
47
|
|
48
48
|
</DD>
|
49
|
-
<DT><H2
|
49
|
+
<DT><H2>スーパークラス:</H2></DT>
|
50
50
|
<DD><DL><DT><A HREF="http://www.ruby-lang.org/ja/man-1.4/Object.html"><CODE>Object</CODE></A></DT></DL></DD>
|
51
|
-
<DT><H2
|
51
|
+
<DT><H2>クラスメソッド:</H2></DT>
|
52
52
|
<DL COMPACT>
|
53
53
|
<DT>
|
54
54
|
<A NAME=".new"><CODE>new([<var>option</var>])</CODE></A>
|
55
55
|
<DD>
|
56
56
|
<p>
|
57
57
|
|
58
|
-
<CODE>Pcaplet</CODE
|
59
|
-
|
60
|
-
<VAR>option</VAR
|
61
|
-
|
58
|
+
<CODE>Pcaplet</CODE>オブジェクトを生成します。コマンドライン
|
59
|
+
の解析とデバイスのオープンが行なわれます。
|
60
|
+
<VAR>option</VAR>を指定すると、コマンドラインオプションに
|
61
|
+
追加されます。
|
62
62
|
</p>
|
63
63
|
</DL>
|
64
|
-
<DT><H2
|
64
|
+
<DT><H2>メソッド:</H2></DT>
|
65
65
|
<DL COMPACT>
|
66
66
|
<DT>
|
67
67
|
<A NAME="add_filter"><CODE>add_filter(<var>filter</var>)</CODE></A>
|
68
68
|
<DD>
|
69
69
|
<p>
|
70
70
|
|
71
|
-
|
72
|
-
<VAR>filter</VAR
|
73
|
-
|
71
|
+
コマンドラインで指定されたフィルタ加えて、さらに
|
72
|
+
<VAR>filter</VAR>を追加します。実際にはフィルタを以下のよ
|
73
|
+
うに設定します。
|
74
74
|
<blockquote>
|
75
75
|
<pre>"( current_filter ) and ( filter )"
|
76
76
|
</pre>
|
@@ -85,23 +85,23 @@ my_tool.close
|
|
85
85
|
<DD>
|
86
86
|
<p>
|
87
87
|
|
88
|
-
|
89
|
-
<A HREF="Packet.html"><CODE>Packet</CODE></A
|
90
|
-
|
88
|
+
各パケットに対して繰り返します。ブロックには
|
89
|
+
<A HREF="Packet.html"><CODE>Packet</CODE></A>クラスかそのサブクラスのインスタンスが渡されま
|
90
|
+
す。
|
91
91
|
</p>
|
92
92
|
<DT>
|
93
93
|
<A NAME="capture"><CODE>capture</CODE></A>
|
94
94
|
<DD>
|
95
95
|
<p>
|
96
96
|
|
97
|
-
|
97
|
+
内部で使用している <A HREF="Capture.html"><CODE>Capture</CODE></A> オブジェクトを返します。
|
98
98
|
</p>
|
99
99
|
<DT>
|
100
100
|
<A NAME="close"><CODE>close</CODE></A>
|
101
101
|
<DD>
|
102
102
|
<p>
|
103
103
|
|
104
|
-
|
104
|
+
デバイスをクローズします。
|
105
105
|
</p>
|
106
106
|
</DL>
|
107
107
|
</DL>
|
data/doc-ja/TCPPacket.html
CHANGED
@@ -8,32 +8,32 @@
|
|
8
8
|
<DT><H1>TCPPacket</H1></DT>
|
9
9
|
<DD>
|
10
10
|
|
11
|
-
TCP
|
11
|
+
TCPヘッダを含むパケット。
|
12
12
|
</DD>
|
13
|
-
<DT><H2
|
13
|
+
<DT><H2>スーパークラス:</H2></DT>
|
14
14
|
<DD><DL><DT><A HREF="IPPacket.html"><CODE>IPPacket</CODE></A></DT></DL></DD>
|
15
|
-
<DT><H2
|
15
|
+
<DT><H2>メソッド:</H2></DT>
|
16
16
|
<DL COMPACT>
|
17
17
|
<DT>
|
18
18
|
<A NAME="tcp_ack"><CODE>tcp_ack</CODE></A>
|
19
19
|
<DD>
|
20
20
|
<p>
|
21
21
|
|
22
|
-
Acknowledgement Number
|
22
|
+
Acknowledgement Number を返します。
|
23
23
|
</p>
|
24
24
|
<DT>
|
25
25
|
<A NAME="tcp_data"><CODE>tcp_data</CODE></A>
|
26
26
|
<DD>
|
27
27
|
<p>
|
28
28
|
|
29
|
-
|
29
|
+
データ部分を <A HREF="http://www.ruby-lang.org/ja/man-1.4/String.html"><CODE>String</CODE></A> として返します。
|
30
30
|
</p>
|
31
31
|
<DT>
|
32
32
|
<A NAME="tcp_data_len"><CODE>tcp_data_len</CODE></A>
|
33
33
|
<DD>
|
34
34
|
<p>
|
35
35
|
|
36
|
-
|
36
|
+
データ部分の長さを返します。
|
37
37
|
</p>
|
38
38
|
<DT>
|
39
39
|
<A NAME="tcp_dport"><CODE>tcp_dport</CODE></A>
|
@@ -43,22 +43,22 @@
|
|
43
43
|
<DD>
|
44
44
|
<p>
|
45
45
|
|
46
|
-
|
46
|
+
デスティネーションポート番号を返します.
|
47
47
|
</p>
|
48
48
|
<DT>
|
49
49
|
<A NAME="tcp_flags"><CODE>tcp_flags</CODE></A>
|
50
50
|
<DD>
|
51
51
|
<p>
|
52
52
|
|
53
|
-
TCP
|
53
|
+
TCP フラグフィールドの値 (6 bit) を返します。
|
54
54
|
</p>
|
55
55
|
<DT>
|
56
56
|
<A NAME="tcp_flags_s"><CODE>tcp_flags_s</CODE></A>
|
57
57
|
<DD>
|
58
58
|
<p>
|
59
59
|
|
60
|
-
TCP
|
61
|
-
<CODE>".A...F"</CODE>
|
60
|
+
TCP フラグフィールドの値 (6 bit) を
|
61
|
+
<CODE>".A...F"</CODE> といった形式の文字列として返します。
|
62
62
|
</p>
|
63
63
|
<DT>
|
64
64
|
<A NAME="tcp_fin?"><CODE>tcp_fin?</CODE></A>
|
@@ -80,8 +80,8 @@
|
|
80
80
|
<DD>
|
81
81
|
<p>
|
82
82
|
|
83
|
-
|
84
|
-
<CODE>false</CODE
|
83
|
+
フラグが立っていれば<CODE>true</CODE>を,そうでなければ
|
84
|
+
<CODE>false</CODE>を返します.
|
85
85
|
</p>
|
86
86
|
<DT>
|
87
87
|
<A NAME="tcp_off"><CODE>tcp_off</CODE></A>
|
@@ -91,21 +91,21 @@
|
|
91
91
|
<DD>
|
92
92
|
<p>
|
93
93
|
|
94
|
-
TCP
|
94
|
+
TCP データオフセット(TCPヘッダ長)を返します。
|
95
95
|
</p>
|
96
96
|
<DT>
|
97
97
|
<A NAME="tcp_seq"><CODE>tcp_seq</CODE></A>
|
98
98
|
<DD>
|
99
99
|
<p>
|
100
100
|
|
101
|
-
Sequence Number
|
101
|
+
Sequence Number を返します。
|
102
102
|
</p>
|
103
103
|
<DT>
|
104
104
|
<A NAME="tcp_sum"><CODE>tcp_sum</CODE></A>
|
105
105
|
<DD>
|
106
106
|
<p>
|
107
107
|
|
108
|
-
Checksum
|
108
|
+
Checksum フィールドの値を返します。
|
109
109
|
</p>
|
110
110
|
<DT>
|
111
111
|
<A NAME="tcp_sport"><CODE>tcp_sport</CODE></A>
|
@@ -115,28 +115,28 @@
|
|
115
115
|
<DD>
|
116
116
|
<p>
|
117
117
|
|
118
|
-
|
118
|
+
ソースポート番号を返します.
|
119
119
|
</p>
|
120
120
|
<DT>
|
121
121
|
<A NAME="tcp_urp"><CODE>tcp_urp</CODE></A>
|
122
122
|
<DD>
|
123
123
|
<p>
|
124
124
|
|
125
|
-
Urgent Pointer
|
125
|
+
Urgent Pointer フィールドの値を返します。
|
126
126
|
</p>
|
127
127
|
<DT>
|
128
128
|
<A NAME="tcp_win"><CODE>tcp_win</CODE></A>
|
129
129
|
<DD>
|
130
130
|
<p>
|
131
131
|
|
132
|
-
Window Size
|
132
|
+
Window Size を返します。
|
133
133
|
</p>
|
134
134
|
<DT>
|
135
135
|
<A NAME="to_s"><CODE>to_s</CODE></A>
|
136
136
|
<DD>
|
137
137
|
<p>
|
138
138
|
|
139
|
-
|
139
|
+
文字列に変換します。
|
140
140
|
</p>
|
141
141
|
</DL>
|
142
142
|
</DL>
|
data/doc-ja/TruncatedPacket.html
CHANGED
@@ -8,10 +8,10 @@
|
|
8
8
|
<DT><H1>TruncatedPacket</H1></DT>
|
9
9
|
<DD>
|
10
10
|
|
11
|
-
|
12
|
-
|
11
|
+
要求されたパケットに関する情報が、キャプチャされたデータ内に
|
12
|
+
存在しません。
|
13
13
|
</DD>
|
14
|
-
<DT><H2
|
14
|
+
<DT><H2>スーパークラス:</H2></DT>
|
15
15
|
<DD><DL><DT><A HREF="PcapError.html"><CODE>PcapError</CODE></A></DT></DL></DD>
|
16
16
|
</DL>
|
17
17
|
<HR>
|