ronin-support 0.1.0.pre1

data/spec/formatting/binary/helpers/hexdumps/od_hex_quads.txt

@@ -0,0 +1,17 @@
+0000000 0706050403020100 0f0e0d0c0b0a0908
+0000020 1716151413121110 1f1e1d1c1b1a1918
+0000040 2726252423222120 2f2e2d2c2b2a2928
+0000060 3736353433323130 3f3e3d3c3b3a3938
+0000100 4746454443424140 4f4e4d4c4b4a4948
+0000120 5756555453525150 5f5e5d5c5b5a5958
+0000140 6766656463626160 6f6e6d6c6b6a6968
+0000160 7776757473727170 7f7e7d7c7b7a7978
+0000200 8786858483828180 8f8e8d8c8b8a8988
+0000220 9796959493929190 9f9e9d9c9b9a9998
+0000240 a7a6a5a4a3a2a1a0 afaeadacabaaa9a8
+0000260 b7b6b5b4b3b2b1b0 bfbebdbcbbbab9b8
+0000300 c7c6c5c4c3c2c1c0 cfcecdcccbcac9c8
+0000320 d7d6d5d4d3d2d1d0 dfdedddcdbdad9d8
+0000340 e7e6e5e4e3e2e1e0 efeeedecebeae9e8
+0000360 f7f6f5f4f3f2f1f0 fffefdfcfbfaf9f8
+0000400

data/spec/formatting/binary/helpers/hexdumps/od_hex_shorts.txt

@@ -0,0 +1,17 @@
+0000000 0100 0302 0504 0706 0908 0b0a 0d0c 0f0e
+0000020 1110 1312 1514 1716 1918 1b1a 1d1c 1f1e
+0000040 2120 2322 2524 2726 2928 2b2a 2d2c 2f2e
+0000060 3130 3332 3534 3736 3938 3b3a 3d3c 3f3e
+0000100 4140 4342 4544 4746 4948 4b4a 4d4c 4f4e
+0000120 5150 5352 5554 5756 5958 5b5a 5d5c 5f5e
+0000140 6160 6362 6564 6766 6968 6b6a 6d6c 6f6e
+0000160 7170 7372 7574 7776 7978 7b7a 7d7c 7f7e
+0000200 8180 8382 8584 8786 8988 8b8a 8d8c 8f8e
+0000220 9190 9392 9594 9796 9998 9b9a 9d9c 9f9e
+0000240 a1a0 a3a2 a5a4 a7a6 a9a8 abaa adac afae
+0000260 b1b0 b3b2 b5b4 b7b6 b9b8 bbba bdbc bfbe
+0000300 c1c0 c3c2 c5c4 c7c6 c9c8 cbca cdcc cfce
+0000320 d1d0 d3d2 d5d4 d7d6 d9d8 dbda dddc dfde
+0000340 e1e0 e3e2 e5e4 e7e6 e9e8 ebea edec efee
+0000360 f1f0 f3f2 f5f4 f7f6 f9f8 fbfa fdfc fffe
+0000400

data/spec/formatting/binary/helpers/hexdumps/od_octal_bytes.txt

@@ -0,0 +1,17 @@
+0000000 000 001 002 003 004 005 006 007 010 011 012 013 014 015 016 017
+0000020 020 021 022 023 024 025 026 027 030 031 032 033 034 035 036 037
+0000040 040 041 042 043 044 045 046 047 050 051 052 053 054 055 056 057
+0000060 060 061 062 063 064 065 066 067 070 071 072 073 074 075 076 077
+0000100 100 101 102 103 104 105 106 107 110 111 112 113 114 115 116 117
+0000120 120 121 122 123 124 125 126 127 130 131 132 133 134 135 136 137
+0000140 140 141 142 143 144 145 146 147 150 151 152 153 154 155 156 157
+0000160 160 161 162 163 164 165 166 167 170 171 172 173 174 175 176 177
+0000200 200 201 202 203 204 205 206 207 210 211 212 213 214 215 216 217
+0000220 220 221 222 223 224 225 226 227 230 231 232 233 234 235 236 237
+0000240 240 241 242 243 244 245 246 247 250 251 252 253 254 255 256 257
+0000260 260 261 262 263 264 265 266 267 270 271 272 273 274 275 276 277
+0000300 300 301 302 303 304 305 306 307 310 311 312 313 314 315 316 317
+0000320 320 321 322 323 324 325 326 327 330 331 332 333 334 335 336 337
+0000340 340 341 342 343 344 345 346 347 350 351 352 353 354 355 356 357
+0000360 360 361 362 363 364 365 366 367 370 371 372 373 374 375 376 377
+0000400

data/spec/formatting/binary/helpers/hexdumps/od_octal_ints.txt

@@ -0,0 +1,17 @@
+0000000 00300400400 00701402404 01302404410 01703406414
+0000020 02304410420 02705412424 03306414430 03707416434
+0000040 04310420440 04711422444 05312424450 05713426454
+0000060 06314430460 06715432464 07316434470 07717436474
+0000100 10320440500 10721442504 11322444510 11723446514
+0000120 12324450520 12725452524 13326454530 13727456534
+0000140 14330460540 14731462544 15332464550 15733466554
+0000160 16334470560 16735472564 17336474570 17737476574
+0000200 20340500600 20741502604 21342504610 21743506614
+0000220 22344510620 22745512624 23346514630 23747516634
+0000240 24350520640 24751522644 25352524650 25753526654
+0000260 26354530660 26755532664 27356534670 27757536674
+0000300 30360540700 30761542704 31362544710 31763546714
+0000320 32364550720 32765552724 33366554730 33767556734
+0000340 34370560740 34771562744 35372564750 35773566754
+0000360 36374570760 36775572764 37376574770 37777576774
+0000400

data/spec/formatting/binary/helpers/hexdumps/od_octal_quads.txt

@@ -0,0 +1,17 @@
+0000000 0034060120200300400400 0074160320601302404410
+0000020 0134260521202304410420 0174360721603306414430
+0000040 0234461122204310420440 0274561322605312424450
+0000060 0334661523206314430460 0374761723607316434470
+0000100 0435062124210320440500 0475162324611322444510
+0000120 0535262525212324450520 0575362725613326454530
+0000140 0635463126214330460540 0675563326615332464550
+0000160 0735663527216334470560 0775763727617336474570
+0000200 1036064130220340500600 1076164330621342504610
+0000220 1136264531222344510620 1176364731623346514630
+0000240 1236465132224350520640 1276565332625352524650
+0000260 1336665533226354530660 1376765733627356534670
+0000300 1437066134230360540700 1477166334631362544710
+0000320 1537266535232364550720 1577366735633366554730
+0000340 1637467136234370560740 1677567336635372564750
+0000360 1737667537236374570760 1777767737637376574770
+0000400

data/spec/formatting/binary/helpers/hexdumps/od_octal_shorts.txt

@@ -0,0 +1,17 @@
+0000000 000400 001402 002404 003406 004410 005412 006414 007416
+0000020 010420 011422 012424 013426 014430 015432 016434 017436
+0000040 020440 021442 022444 023446 024450 025452 026454 027456
+0000060 030460 031462 032464 033466 034470 035472 036474 037476
+0000100 040500 041502 042504 043506 044510 045512 046514 047516
+0000120 050520 051522 052524 053526 054530 055532 056534 057536
+0000140 060540 061542 062544 063546 064550 065552 066554 067556
+0000160 070560 071562 072564 073566 074570 075572 076574 077576
+0000200 100600 101602 102604 103606 104610 105612 106614 107616
+0000220 110620 111622 112624 113626 114630 115632 116634 117636
+0000240 120640 121642 122644 123646 124650 125652 126654 127656
+0000260 130660 131662 132664 133666 134670 135672 136674 137676
+0000300 140700 141702 142704 143706 144710 145712 146714 147716
+0000320 150720 151722 152724 153726 154730 155732 156734 157736
+0000340 160740 161742 162744 163746 164750 165752 166754 167756
+0000360 170760 171762 172764 173766 174770 175772 176774 177776
+0000400

data/spec/formatting/binary/helpers/hexdumps/od_repeated.txt

@@ -0,0 +1,6 @@
+0000000 062550 066154 020157 020040 020040 020040 020040 020040
+0000020 020040 020040 020040 020040 020040 020040 020040 020040
+*
+0000060 020040 020040 020040 020040 020040 063440 067557 061144
+0000100 062571 000012
+0000103

data/spec/formatting/binary/helpers/hexdumps/repeated.bin

@@ -0,0 +1 @@
+hello                                                      goodbye

data/spec/formatting/binary/integer_spec.rb

@@ -0,0 +1,140 @@
+require 'spec_helper'
+require 'ronin/formatting/binary'
+
+require 'ostruct'
+
+describe Integer do
+  subject { 0x41 }
+
+  it "should provide Integer#bytes" do
+    should respond_to(:bytes)
+  end
+
+  it "should provide Integer#pack" do
+    should respond_to(:pack)
+  end
+
+  it "should provide Integer#hex_escape" do
+    should respond_to(:hex_escape)
+  end
+
+  it "should alias char to the #chr method" do
+    subject.char.should == subject.chr
+  end
+
+  describe "hex_escape" do
+    subject { 42 }
+
+    it "should hex escape an Integer" do
+      subject.hex_escape.should == "\\x2a"
+    end
+  end
+
+  describe "bytes" do
+    let(:little_endian_char)  { [0x37] }
+    let(:little_endian_short) { [0x37, 0x13] }
+    let(:little_endian_long)  { [0x37, 0x13, 0x0, 0x0] }
+    let(:little_endian_quad)  { [0x37, 0x13, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0] }
+
+    let(:big_endian_char)  { [0x37] }
+    let(:big_endian_short) { [0x13, 0x37] }
+    let(:big_endian_long)  { [0, 0, 0x13, 0x37] }
+    let(:big_endian_quad)  { [0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x13, 0x37] }
+
+    subject { 0x1337 }
+
+    it "should return the bytes in little endian ordering by default" do
+      subject.bytes(4).should == little_endian_long
+    end
+
+    it "should return the bytes for a char in little endian ordering" do
+      subject.bytes(1, :little).should == little_endian_char
+    end
+
+    it "should return the bytes for a short in little endian ordering" do
+      subject.bytes(2, :little).should == little_endian_short
+    end
+
+    it "should return the bytes for a long in little endian ordering" do
+      subject.bytes(4, :little).should == little_endian_long
+    end
+
+    it "should return the bytes for a quad in little endian ordering" do
+      subject.bytes(8, :little).should == little_endian_quad
+    end
+
+    it "should return the bytes for a char in big endian ordering" do
+      subject.bytes(1, :big).should == big_endian_char
+    end
+
+    it "should return the bytes for a short in big endian ordering" do
+      subject.bytes(2, :big).should == big_endian_short
+    end
+
+    it "should return the bytes for a long in big endian ordering" do
+      subject.bytes(4, :big).should == big_endian_long
+    end
+
+    it "should return the bytes for a quad in big endian ordering" do
+      subject.bytes(8, :big).should == big_endian_quad
+    end
+  end
+
+  describe "pack" do
+    let(:i386) do
+      OpenStruct.new(:endian => :little, :address_length => 4)
+    end
+
+    let(:ppc) do
+      OpenStruct.new(:endian => :big, :address_length => 4)
+    end
+
+    subject { 0x1337 }
+
+    let(:i386_packed_int)   { "7\023\000\000" }
+    let(:i386_packed_short) { "7\023" }
+    let(:i386_packed_long)  { "7\023\000\000" }
+    let(:i386_packed_quad)  { "7\023\000\000\000\000\000\000" }
+
+    let(:ppc_packed_int)   { "\000\000\0237" }
+    let(:ppc_packed_short) { "\0237" }
+    let(:ppc_packed_long)  { "\000\000\0237" }
+    let(:ppc_packed_quad)  { "\000\000\000\000\000\000\0237" }
+
+    it "should pack itself for a little-endian architecture by default" do
+      subject.pack(i386).should == i386_packed_int
+    end
+
+    it "should pack itself as a short for a little-endian architecture" do
+      subject.pack(i386,2).should == i386_packed_short
+    end
+
+    it "should pack itself as a long for a little-endian architecture" do
+      subject.pack(i386,4).should == i386_packed_long
+    end
+
+    it "should pack itself as a quad for a little-endian architecture" do
+      subject.pack(i386,8).should == i386_packed_quad
+    end
+
+    it "should pack itself for a big-endian architecture" do
+      subject.pack(ppc).should == ppc_packed_int
+    end
+
+    it "should pack itself as a short for a big-endian architecture" do
+      subject.pack(ppc,2).should == ppc_packed_short
+    end
+
+    it "should pack itself as a long for a big-endian architecture" do
+      subject.pack(ppc,4).should == ppc_packed_long
+    end
+
+    it "should pack itself as a quad for a big-endian architecture" do
+      subject.pack(ppc,8).should == ppc_packed_quad
+    end
+
+    it "should accept Array#pack template strings" do
+      subject.pack('L').should == i386_packed_long
+    end
+  end
+end

data/spec/formatting/binary/string_spec.rb

@@ -0,0 +1,306 @@
+require 'spec_helper'
+require 'ronin/formatting/binary'
+
+require 'formatting/binary/helpers/hexdumps'
+require 'ostruct'
+
+describe String do
+  subject { "hello" }
+
+  it "should provide String#depack" do
+    should respond_to(:depack)
+  end
+
+  it "should provide String#zlib_inflate" do
+    should respond_to(:zlib_inflate)
+  end
+
+  it "should provide String#zlib_deflate" do
+    should respond_to(:zlib_deflate)
+  end
+
+  it "should provide String#hex_unescape" do
+    should respond_to(:hex_unescape)
+  end
+
+  it "should provide String#xor" do
+    should respond_to(:xor)
+  end
+
+  it "should provide String#unhexdump" do
+    should respond_to(:unhexdump)
+  end
+
+  describe "depack" do
+    subject { 0x1337 }
+
+    let(:i386) do
+      OpenStruct.new(:endian => :little, :address_length => 4)
+    end
+
+    let(:ppc) do
+      OpenStruct.new(:endian => :big, :address_length => 4)
+    end
+
+    let(:i386_packed_int)   { "7\023\000\000" }
+    let(:i386_packed_short) { "7\023" }
+    let(:i386_packed_long)  { "7\023\000\000" }
+    let(:i386_packed_quad)  { "7\023\000\000\000\000\000\000" }
+
+    let(:ppc_packed_int)   { "\000\000\0237" }
+    let(:ppc_packed_short) { "\0237" }
+    let(:ppc_packed_long)  { "\000\000\0237" }
+    let(:ppc_packed_quad)  { "\000\000\000\000\000\000\0237" }
+
+    it "should depack itself for a little-endian architecture" do
+      i386_packed_int.depack(i386).should == subject
+    end
+
+    it "should depack itself as a short for a little-endian architecture" do
+      i386_packed_short.depack(i386,2).should == subject
+    end
+
+    it "should depack itself as a long for a little-endian architecture" do
+      i386_packed_long.depack(i386,4).should == subject
+    end
+
+    it "should depack itself as a quad for a little-endian architecture" do
+      i386_packed_quad.depack(i386,8).should == subject
+    end
+
+    it "should depack itself for a big-endian architecture" do
+      ppc_packed_int.depack(ppc).should == subject
+    end
+
+    it "should depack itself as a short for a big-endian architecture" do
+      ppc_packed_short.depack(ppc,2).should == subject
+    end
+
+    it "should depack itself as a long for a big-endian architecture" do
+      ppc_packed_long.depack(ppc,4).should == subject
+    end
+
+    it "should depack itself as a quad for a big-endian architecture" do
+      ppc_packed_quad.depack(ppc,8).should == subject
+    end
+
+    it "should accept String#unpack template strings" do
+      i386_packed_long.depack('L').should == [subject]
+    end
+  end
+
+  describe "base64_encode" do
+    subject { "hello\0" }
+
+    it "should base64 encode a String" do
+      subject.base64_encode.should == "aGVsbG8A\n"
+    end
+  end
+
+  describe "base64_decode" do
+    subject { "aGVsbG8A\n" }
+
+    it "should base64 decode a String" do
+      subject.base64_decode.should == "hello\0"
+    end
+  end
+
+  describe "zlib_inflate" do
+    subject do
+      "x\xda3H\xb3H3MM6\xd354II\xd651K5\xd7M43N\xd4M\xb3\xb0L2O14423Mb\0\0\xc02\t\xae"
+    end
+
+    it "should inflate a zlib deflated String" do
+      subject.zlib_inflate.should == "0f8f5ec6-14dc-46e7-a63a-f89b7d11265b\0"
+    end
+  end
+
+  describe "zlib_deflate" do
+    subject { "hello" }
+
+    it "should zlib deflate a String" do
+      subject.zlib_deflate.should == "x\x9c\xcbH\xcd\xc9\xc9\a\0\x06,\x02\x15"
+    end
+  end
+
+  describe "hex_escape" do
+    subject { "hello\x4e" }
+
+    it "should hex escape a String" do
+      subject.hex_escape.should == "\\x68\\x65\\x6c\\x6c\\x6f\\x4e"
+    end
+  end
+
+  describe "hex_unescape" do
+    it "should unescape a normal String" do
+      "hello".hex_unescape.should == "hello"
+    end
+
+    it "should unescape a hex String" do
+      "\\x68\\x65\\x6c\\x6c\\x6f\\x4e".hex_unescape.should == "hello\x4e"
+    end
+
+    it "should unescape an octal String" do
+      "hello\012".hex_unescape.should == "hello\n"
+    end
+
+    it "should unescape control characters" do
+      "hello\\n".hex_unescape.should == "hello\n"
+    end
+  end
+
+  describe "xor" do
+    subject { 'hello' }
+
+    let(:key) { 0x50 }
+    let(:keys) { [0x50, 0x55] }
+
+    it "should not contain the key used in the xor" do
+      should_not include(key.chr)
+    end
+
+    it "should not equal the original string" do
+      subject.xor(key).should_not == subject
+    end
+
+    it "should be able to be decoded with another xor" do
+      subject.xor(key).xor(key).should == subject
+    end
+
+    it "should allow xoring against a single key" do
+      subject.xor(key).should == "85<<?"
+    end
+
+    it "should allow xoring against multiple keys" do
+      subject.xor(keys).should == "80<9?"
+    end
+  end
+
+  describe "unhexdump" do
+    include Helpers
+
+    describe "GNU hexdump" do
+      let(:ascii) { load_binary_data('ascii') }
+      let(:repeated) { load_binary_data('repeated') }
+
+      it "should unhexdump octal-byte hexdump output" do
+        hexdump = load_hexdump('hexdump_octal_bytes')
+
+        hexdump.unhexdump(:format => :hexdump, :encoding => :octal_bytes).should == ascii
+      end
+
+      it "should unhexdump hex-byte hexdump output" do
+        hexdump = load_hexdump('hexdump_hex_bytes')
+
+        hexdump.unhexdump(:format => :hexdump, :encoding => :hex_bytes).should == ascii
+      end
+
+      it "should unhexdump decimal-short hexdump output" do
+        hexdump = load_hexdump('hexdump_decimal_shorts')
+
+        hexdump.unhexdump(:format => :hexdump, :encoding => :decimal_shorts).should == ascii
+      end
+
+      it "should unhexdump octal-short hexdump output" do
+        hexdump = load_hexdump('hexdump_octal_shorts')
+
+        hexdump.unhexdump(:format => :hexdump, :encoding => :octal_shorts).should == ascii
+      end
+
+      it "should unhexdump hex-short hexdump output" do
+        hexdump = load_hexdump('hexdump_hex_shorts')
+
+        hexdump.unhexdump(:format => :hexdump, :encoding => :hex_shorts).should == ascii
+      end
+
+      it "should unhexdump repeated hexdump output" do
+        hexdump = load_hexdump('hexdump_repeated')
+
+        hexdump.unhexdump(:format => :hexdump, :encoding => :hex_bytes).should == repeated
+      end
+    end
+
+    describe "od" do
+      let(:ascii) { load_binary_data('ascii') }
+      let(:repeated) { load_binary_data('repeated') }
+
+      it "should unhexdump octal-byte hexdump output" do
+        hexdump = load_hexdump('od_octal_bytes')
+
+        hexdump.unhexdump(:format => :od, :encoding => :octal_bytes).should == ascii
+      end
+
+      it "should unhexdump octal-shorts hexdump output" do
+        hexdump = load_hexdump('od_octal_shorts')
+
+        hexdump.unhexdump(:format => :od, :encoding => :octal_shorts).should == ascii
+      end
+
+      it "should unhexdump octal-ints hexdump output" do
+        hexdump = load_hexdump('od_octal_ints')
+
+        hexdump.unhexdump(:format => :od, :encoding => :octal_ints).should == ascii
+      end
+
+      it "should unhexdump octal-quads hexdump output" do
+        hexdump = load_hexdump('od_octal_quads')
+
+        hexdump.unhexdump(:format => :od, :encoding => :octal_quads).should == ascii
+      end
+
+      it "should unhexdump decimal-byte hexdump output" do
+        hexdump = load_hexdump('od_decimal_bytes')
+
+        hexdump.unhexdump(:format => :od, :encoding => :decimal_bytes).should == ascii
+      end
+
+      it "should unhexdump decimal-shorts hexdump output" do
+        hexdump = load_hexdump('od_decimal_shorts')
+
+        hexdump.unhexdump(:format => :od, :encoding => :decimal_shorts).should == ascii
+      end
+
+      it "should unhexdump decimal-ints hexdump output" do
+        hexdump = load_hexdump('od_decimal_ints')
+
+        hexdump.unhexdump(:format => :od, :encoding => :decimal_ints).should == ascii
+      end
+
+      it "should unhexdump decimal-quads hexdump output" do
+        hexdump = load_hexdump('od_decimal_quads')
+
+        hexdump.unhexdump(:format => :od, :encoding => :decimal_quads).should == ascii
+      end
+
+      it "should unhexdump hex-byte hexdump output" do
+        hexdump = load_hexdump('od_hex_bytes')
+
+        hexdump.unhexdump(:format => :od, :encoding => :hex_bytes).should == ascii
+      end
+
+      it "should unhexdump hex-shorts hexdump output" do
+        hexdump = load_hexdump('od_hex_shorts')
+
+        hexdump.unhexdump(:format => :od, :encoding => :hex_shorts).should == ascii
+      end
+
+      it "should unhexdump hex-ints hexdump output" do
+        hexdump = load_hexdump('od_hex_ints')
+
+        hexdump.unhexdump(:format => :od, :encoding => :hex_ints).should == ascii
+      end
+
+      it "should unhexdump hex-quads hexdump output" do
+        hexdump = load_hexdump('od_hex_quads')
+
+        hexdump.unhexdump(:format => :od, :encoding => :hex_quads).should == ascii
+      end
+
+      it "should unhexdump repeated hexdump output" do
+        hexdump = load_hexdump('od_repeated')
+
+        hexdump.unhexdump(:format => :od, :encoding => :octal_shorts).should == repeated
+      end
+    end
+  end
+end