ruby-pcap 0.7.8 → 0.7.9
Sign up to get free protection for your applications and to get access to all the features.
- 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>
|