metasm 1.0.4 → 1.0.6

data/tests/shellcode.rb

@@ -0,0 +1,111 @@
+#    This file is part of Metasm, the Ruby assembly manipulation suite
+#    Copyright (C) 2006-2009 Yoann GUILLOT
+#
+#    Licence is LGPL, see LICENCE in the top-level directory
+
+
+require 'test/unit'
+require 'metasm'
+
+class TestShellcode < Test::Unit::TestCase
+	@@cpu = Metasm::Ia32.new
+
+	def assert_equal(a, b) super(b, a) end
+
+	def bin(s)
+		if s.respond_to?(:force_encoding)
+			s.force_encoding('BINARY')
+		else
+			s
+		end
+	end
+
+	def assemble(src)
+		Metasm::Shellcode.assemble(@@cpu, src).encode_string
+	end
+
+	# ---- define_data ----
+
+	def test_define_data_basic
+		assert_equal(Metasm::Shellcode.define_data("ABCD".b), 'db 0x41, 0x42, 0x43, 0x44')
+	end
+
+	def test_define_data_empty
+		assert_equal(Metasm::Shellcode.define_data("".b), '')
+	end
+
+	def test_define_data_nil
+		assert_equal(Metasm::Shellcode.define_data(nil), '')
+	end
+
+	def test_define_data_full_range
+		assert_equal(Metasm::Shellcode.define_data("\x00\x01\x9f\xa0\xff".b),
+			'db 0x00, 0x01, 0x9f, 0xa0, 0xff')
+	end
+
+	def test_define_data_roundtrip_printable
+		src = Metasm::Shellcode.define_data("ABCD".b)
+		assert_equal(assemble(src), bin("ABCD"))
+	end
+
+	def test_define_data_roundtrip_full_range
+		bytes = (0..255).map(&:chr).join.b
+		src = Metasm::Shellcode.define_data(bytes)
+		assert_equal(assemble(src), bin(bytes))
+	end
+
+	# ---- define_cstring ----
+
+	def test_define_cstring_basic
+		assert_equal(Metasm::Shellcode.define_cstring("ABCD".b), 'db "ABCD", 0')
+	end
+
+	def test_define_cstring_empty
+		assert_equal(Metasm::Shellcode.define_cstring("".b), 'db 0')
+	end
+
+	def test_define_cstring_nil
+		assert_equal(Metasm::Shellcode.define_cstring(nil), 'db 0')
+	end
+
+	def test_define_cstring_escape_quote
+		assert_equal(Metasm::Shellcode.define_cstring("a\"b".b), 'db "a\"b", 0')
+	end
+
+	def test_define_cstring_escape_backslash
+		# input: one backslash; expected output: backslash-backslash inside string literal
+		assert_equal(Metasm::Shellcode.define_cstring("a\\b".b), 'db "a\\\\b", 0')
+	end
+
+	def test_define_cstring_mixed_printable_and_binary
+		assert_equal(Metasm::Shellcode.define_cstring("AB\x05CD".b),
+			'db "AB", 0x05, "CD", 0')
+	end
+
+	def test_define_cstring_single_high_byte
+		assert_equal(Metasm::Shellcode.define_cstring("\xff".b), 'db 0xff, 0')
+	end
+
+	def test_define_cstring_roundtrip_printable
+		src = Metasm::Shellcode.define_cstring("ABCD".b)
+		assert_equal(assemble(src), bin("ABCD\x00"))
+	end
+
+	def test_define_cstring_roundtrip_with_binary
+		input = "AB\x05CD".b
+		src = Metasm::Shellcode.define_cstring(input)
+		assert_equal(assemble(src), bin(input + "\x00"))
+	end
+
+	def test_define_cstring_roundtrip_escapes
+		input = "a\"b\\c".b
+		src = Metasm::Shellcode.define_cstring(input)
+		assert_equal(assemble(src), bin(input + "\x00"))
+	end
+
+	def test_define_cstring_roundtrip_high_byte
+		input = "\xff".b
+		src = Metasm::Shellcode.define_cstring(input)
+		assert_equal(assemble(src), bin(input + "\x00"))
+	end
+end

metadata

@@ -1,109 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: metasm
 version: !ruby/object:Gem::Version
-  version: 1.0.4
+  version: 1.0.6
 platform: ruby
 authors:
 - Yoann Guillot
-autorequire: 
+autorequire:
 bindir: bin
-cert_chain:
-- |
-  -----BEGIN CERTIFICATE-----
-  MIIDXzCCAkegAwIBAgILBAAAAAABIVhTCKIwDQYJKoZIhvcNAQELBQAwTDEgMB4G
-  A1UECxMXR2xvYmFsU2lnbiBSb290IENBIC0gUjMxEzARBgNVBAoTCkdsb2JhbFNp
-  Z24xEzARBgNVBAMTCkdsb2JhbFNpZ24wHhcNMDkwMzE4MTAwMDAwWhcNMjkwMzE4
-  MTAwMDAwWjBMMSAwHgYDVQQLExdHbG9iYWxTaWduIFJvb3QgQ0EgLSBSMzETMBEG
-  A1UEChMKR2xvYmFsU2lnbjETMBEGA1UEAxMKR2xvYmFsU2lnbjCCASIwDQYJKoZI
-  hvcNAQEBBQADggEPADCCAQoCggEBAMwldpB5BngiFvXAg7aEyiie/QV2EcWtiHL8
-  RgJDx7KKnQRfJMsuS+FggkbhUqsMgUdwbN1k0ev1LKMPgj0MK66X17YUhhB5uzsT
-  gHeMCOFJ0mpiLx9e+pZo34knlTifBtc+ycsmWQ1z3rDI6SYOgxXG71uL0gRgykmm
-  KPZpO/bLyCiR5Z2KYVc3rHQU3HTgOu5yLy6c+9C7v/U9AOEGM+iCK65TpjoWc4zd
-  QQ4gOsC0p6Hpsk+QLjJg6VfLuQSSaGjlOCZgdbKfd/+RFO+uIEn8rUAVSNECMWEZ
-  XriX7613t2Saer9fwRPvm2L7DWzgVGkWqQPabumDk3F2xmmFghcCAwEAAaNCMEAw
-  DgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFI/wS3+o
-  LkUkrk1Q+mOai97i3Ru8MA0GCSqGSIb3DQEBCwUAA4IBAQBLQNvAUKr+yAzv95ZU
-  RUm7lgAJQayzE4aGKAczymvmdLm6AC2upArT9fHxD4q/c2dKg8dEe3jgr25sbwMp
-  jjM5RcOO5LlXbKr8EpbsU8Yt5CRsuZRj+9xTaGdWPoO4zzUhw8lo/s7awlOqzJCK
-  6fBdRoyV3XpYKBovHd7NADdBj+1EbddTKJd+82cEHhXXipa0095MJ6RMG3NzdvQX
-  mcIfeg7jLQitChws/zyrVQ4PkX4268NXSb7hLi18YIvDQVETI53O9zJrlAGomecs
-  Mx86OyXShkDOOyyGeMlhLxS67ttVb9+E7gUJTb0o2HLO02JQZR7rkpeDMdmztcpH
-  WD9f
-  -----END CERTIFICATE-----
-- |
-  -----BEGIN CERTIFICATE-----
-  MIIElDCCA3ygAwIBAgIOSBtqBybS6D8mAtSCWs0wDQYJKoZIhvcNAQELBQAwTDEg
-  MB4GA1UECxMXR2xvYmFsU2lnbiBSb290IENBIC0gUjMxEzARBgNVBAoTCkdsb2Jh
-  bFNpZ24xEzARBgNVBAMTCkdsb2JhbFNpZ24wHhcNMTYwNjE1MDAwMDAwWhcNMjQw
-  NjE1MDAwMDAwWjBaMQswCQYDVQQGEwJCRTEZMBcGA1UEChMQR2xvYmFsU2lnbiBu
-  di1zYTEwMC4GA1UEAxMnR2xvYmFsU2lnbiBDb2RlU2lnbmluZyBDQSAtIFNIQTI1
-  NiAtIEczMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAjYVVI6kfU6/J
-  7TbCKbVu2PlC9SGLh/BDoS/AP5fjGEfUlk6Iq8Zj6bZJFYXx2Zt7G/3YSsxtToZA
-  F817ukcotdYUQAyG7h5LM/MsVe4hjNq2wf6wTjquUZ+lFOMQ5pPK+vldsZCH7/g1
-  LfyiXCbuexWLH9nDoZc1QbMw/XITrZGXOs5ynQYKdTwfmOPLGC+MnwhKkQrZ2TXZ
-  g5J2Yl7fg67k1gFOzPM8cGFYNx8U42qgr2v02dJsLBkwXaBvUt/RnMngDdl1EWWW
-  2UO0p5A5rkccVMuxlW4l3o7xEhzw127nFE2zGmXWhEpX7gSvYjjFEJtDjlK4Prau
-  niyX/4507wIDAQABo4IBZDCCAWAwDgYDVR0PAQH/BAQDAgEGMB0GA1UdJQQWMBQG
-  CCsGAQUFBwMDBggrBgEFBQcDCTASBgNVHRMBAf8ECDAGAQH/AgEAMB0GA1UdDgQW
-  BBQPOueslJF0LZYCc4OtnC5JPxmqVDAfBgNVHSMEGDAWgBSP8Et/qC5FJK5NUPpj
-  move4t0bvDA+BggrBgEFBQcBAQQyMDAwLgYIKwYBBQUHMAGGImh0dHA6Ly9vY3Nw
-  Mi5nbG9iYWxzaWduLmNvbS9yb290cjMwNgYDVR0fBC8wLTAroCmgJ4YlaHR0cDov
-  L2NybC5nbG9iYWxzaWduLmNvbS9yb290LXIzLmNybDBjBgNVHSAEXDBaMAsGCSsG
-  AQQBoDIBMjAIBgZngQwBBAEwQQYJKwYBBAGgMgFfMDQwMgYIKwYBBQUHAgEWJmh0
-  dHBzOi8vd3d3Lmdsb2JhbHNpZ24uY29tL3JlcG9zaXRvcnkvMA0GCSqGSIb3DQEB
-  CwUAA4IBAQAVhCgM7aHDGYLbYydB18xjfda8zzabz9JdTAKLWBoWCHqxmJl/2DOK
-  XJ5iCprqkMLFYwQL6IdYBgAHglnDqJQy2eAUTaDVI+DH3brwaeJKRWUtTUmQeGYy
-  DrBowLCIsI7tXAb4XBBIPyNzujtThFKAzfCzFcgRCosFeEZZCNS+t/9L9ZxqTJx2
-  ohGFRYzUN+5Q3eEzNKmhHzoL8VZEim+zM9CxjtEMYAfuMsLwJG+/r/uBAXZnxKPo
-  4KvcM1Uo42dHPOtqpN+U6fSmwIHRUphRptYCtzzqSu/QumXSN4NTS35nfIxA9gcc
-  sK8EBtz4bEaIcpzrTp3DsLlUo7lOl8oU
-  -----END CERTIFICATE-----
-- |
-  -----BEGIN CERTIFICATE-----
-  MIIE5jCCA86gAwIBAgIMKDuO03uv6RWXR1uAMA0GCSqGSIb3DQEBCwUAMFoxCzAJ
-  BgNVBAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52LXNhMTAwLgYDVQQDEydH
-  bG9iYWxTaWduIENvZGVTaWduaW5nIENBIC0gU0hBMjU2IC0gRzMwHhcNMTYwOTEz
-  MTgxMDIyWhcNMTkxMTExMTUxNTM4WjBgMQswCQYDVQQGEwJVUzEWMBQGA1UECBMN
-  TWFzc2FjaHVzZXR0czEPMA0GA1UEBxMGQm9zdG9uMRMwEQYDVQQKEwpSYXBpZDcg
-  TExDMRMwEQYDVQQDEwpSYXBpZDcgTExDMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A
-  MIIBCgKCAQEAl0HeC0FzN1BJ4nQkxsBng3peS9Bdi9rpSGx+g0Ximd+M/7twmund
-  bzn2JPbNK/Gp/rq/SytrNSLcUzcbH/0z5Ltyw1/jQsGtRBrns0NZSRXqupQDW5R6
-  HFpaIAl3OdsesmIQc/fm0uhh8dkfHVo7UsZO/TeCPoy0uHXTI6aFBPzMMsdz+gf3
-  cCCLsnNKQh/T2Q/jwBs3NTPoyza/pPZcvGogKcWCeNihTO5Rn1Fc71sMHSjQsDtn
-  1fWGKYGi0qjvZ4lpGM9IFZMTbySKHbPLhhHnBOoV7avGemdky3AEsUeiT+6DY0P1
-  IydBy24uVNhGATglME1ttlT4Eme/to0M6wIDAQABo4IBpDCCAaAwDgYDVR0PAQH/
-  BAQDAgeAMIGUBggrBgEFBQcBAQSBhzCBhDBIBggrBgEFBQcwAoY8aHR0cDovL3Nl
-  Y3VyZS5nbG9iYWxzaWduLmNvbS9jYWNlcnQvZ3Njb2Rlc2lnbnNoYTJnM29jc3Au
-  Y3J0MDgGCCsGAQUFBzABhixodHRwOi8vb2NzcDIuZ2xvYmFsc2lnbi5jb20vZ3Nj
-  b2Rlc2lnbnNoYTJnMzBWBgNVHSAETzBNMEEGCSsGAQQBoDIBMjA0MDIGCCsGAQUF
-  BwIBFiZodHRwczovL3d3dy5nbG9iYWxzaWduLmNvbS9yZXBvc2l0b3J5LzAIBgZn
-  gQwBBAEwCQYDVR0TBAIwADA/BgNVHR8EODA2MDSgMqAwhi5odHRwOi8vY3JsLmds
-  b2JhbHNpZ24uY29tL2dzY29kZXNpZ25zaGEyZzMuY3JsMBMGA1UdJQQMMAoGCCsG
-  AQUFBwMDMB0GA1UdDgQWBBSm8RBpBC/cK9VmxzO2+RWnacN8CTAfBgNVHSMEGDAW
-  gBQPOueslJF0LZYCc4OtnC5JPxmqVDANBgkqhkiG9w0BAQsFAAOCAQEANVO3uYQl
-  h8iicbaXE3odrL+kXXmeeNgt4BD3x7GKAVIVixtwBS6pvrshjc1LN0tm3ruiv8oy
-  cq4FiEmVUXZejSRvVVtABeWdZWo+lJ8NxCBUEYYmnMrjgFIbGiEbBsg7PGtyeQsA
-  5Wbg7Lx889mS1tKfQBcPif8EjpTiXNfMiywmpaMYmvm+yQgzrRLDbjz6JV0Rc5Ga
-  WChka+LTPnMtsWJuFM8ka8icMeS28/nAGERdewxWvz+DeAPMORdTJ7aqb6+Y9xuz
-  G+Hmcg1v810agasPdoydE0RTVZgEOOMoQ07qu7JFXVWZ9ZQpHT7qJATWL/b2csFG
-  8mVuTXnyJOKRJA==
-  -----END CERTIFICATE-----
-date: 2019-04-08 00:00:00.000000000 Z
+cert_chain: []
+date: 2026-05-20 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.7'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.7'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -149,6 +55,7 @@ files:
 - README
 - Rakefile
 - TODO
+- cortex.yaml
 - doc/code_organisation.txt
 - doc/const_missing.txt
 - doc/core/DynLdr.txt
@@ -186,6 +93,7 @@ files:
 - metasm/cpu/arm64.rb
 - metasm/cpu/arm64/debug.rb
 - metasm/cpu/arm64/decode.rb
+- metasm/cpu/arm64/decompile.rb
 - metasm/cpu/arm64/encode.rb
 - metasm/cpu/arm64/main.rb
 - metasm/cpu/arm64/opcodes.rb
@@ -205,6 +113,13 @@ files:
 - metasm/cpu/dalvik/decode.rb
 - metasm/cpu/dalvik/main.rb
 - metasm/cpu/dalvik/opcodes.rb
+- metasm/cpu/dwarf.rb
+- metasm/cpu/dwarf/debug.rb
+- metasm/cpu/dwarf/decode.rb
+- metasm/cpu/dwarf/decompile.rb
+- metasm/cpu/dwarf/encode.rb
+- metasm/cpu/dwarf/main.rb
+- metasm/cpu/dwarf/opcodes.rb
 - metasm/cpu/ebpf.rb
 - metasm/cpu/ebpf/debug.rb
 - metasm/cpu/ebpf/decode.rb
@@ -278,6 +193,7 @@ files:
 - metasm/cpu/x86_64/compile_c.rb
 - metasm/cpu/x86_64/debug.rb
 - metasm/cpu/x86_64/decode.rb
+- metasm/cpu/x86_64/decompile.rb
 - metasm/cpu/x86_64/encode.rb
 - metasm/cpu/x86_64/main.rb
 - metasm/cpu/x86_64/opcodes.rb
@@ -455,12 +371,13 @@ files:
 - tests/mips.rb
 - tests/parse_c.rb
 - tests/preprocessor.rb
+- tests/shellcode.rb
 - tests/x86_64.rb
 homepage: http://metasm.cr0.org
 licenses:
 - LGPL-2.1
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - "."
@@ -475,9 +392,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.8
-signing_key: 
+rubygems_version: 3.4.19
+signing_key:
 specification_version: 4
 summary: Metasm is a cross-architecture assembler, disassembler, linker, and debugger.
 test_files:
@@ -493,4 +409,5 @@ test_files:
 - tests/mips.rb
 - tests/parse_c.rb
 - tests/preprocessor.rb
+- tests/shellcode.rb
 - tests/x86_64.rb

checksums.yaml.gz.sig

@@ -1,3 +0,0 @@
-��=���^
��	8�W�
-��*�O?2�!�O�)��}�e���-��ǹ��@s$�9�F`lo���ՙ�3�.O�o9S�����1b���~6����G���p(�
-V���F�4��G9a-H()s�ٌ�<�>SyHLSY�7�@�w�}38QP�Z��Bl�5��8�t�����0��Q�P�=�pfj\p���>芉�?�ḡ��POţ�ι7Ա���RQD(mi�1.K5»K��P��
y��i.h\:�a�>