metasm 1.0.5 → 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,114 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: metasm
 version: !ruby/object:Gem::Version
-  version: 1.0.5
+  version: 1.0.6
 platform: ruby
 authors:
 - Yoann Guillot
-autorequire: 
+autorequire:
 bindir: bin
-cert_chain:
-- |
-  -----BEGIN CERTIFICATE-----
-  MIIDtzCCAp+gAwIBAgIQDOfg5RfYRv6P5WD8G/AwOTANBgkqhkiG9w0BAQUFADBl
-  MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
-  d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJv
-  b3QgQ0EwHhcNMDYxMTEwMDAwMDAwWhcNMzExMTEwMDAwMDAwWjBlMQswCQYDVQQG
-  EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNl
-  cnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgQ0EwggEi
-  MA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCtDhXO5EOAXLGH87dg+XESpa7c
-  JpSIqvTO9SA5KFhgDPiA2qkVlTJhPLWxKISKityfCgyDF3qPkKyK53lTXDGEKvYP
-  mDI2dsze3Tyoou9q+yHyUmHfnyDXH+Kx2f4YZNISW1/5WBg1vEfNoTb5a3/UsDg+
-  wRvDjDPZ2C8Y/igPs6eD1sNuRMBhNZYW/lmci3Zt1/GiSw0r/wty2p5g0I6QNcZ4
-  VYcgoc/lbQrISXwxmDNsIumH0DJaoroTghHtORedmTpyoeb6pNnVFzF1roV9Iq4/
-  AUaG9ih5yLHa5FcXxH4cDrC0kqZWs72yl+2qp/C3xag/lRbQ/6GW6whfGHdPAgMB
-  AAGjYzBhMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQW
-  BBRF66Kv9JLLgjEtUYunpyGd823IDzAfBgNVHSMEGDAWgBRF66Kv9JLLgjEtUYun
-  pyGd823IDzANBgkqhkiG9w0BAQUFAAOCAQEAog683+Lt8ONyc3pklL/3cmbYMuRC
-  dWKuh+vy1dneVrOfzM4UKLkNl2BcEkxY5NM9g0lFWJc1aRqoR+pWxnmrEthngYTf
-  fwk8lOa4JiwgvT2zKIn3X/8i4peEH+ll74fg38FnSbNd67IJKusm7Xi+fT8r87cm
-  NW1fiQG2SVufAQWbqz0lwcy2f8Lxb4bG+mRo64EtlOtCt/qMHt1i8b5QZ7dsvfPx
-  H2sMNgcWfzd8qVttevESRmCD1ycEvkvOl77DZypoEd+A5wwzZr8TDRRu838fYxAe
-  +o0bJW1sj6W3YQGx0qMmoRBxna3iw/nDmVG3KwcIzi7mULKn+gpFL6Lw8g==
-  -----END CERTIFICATE-----
-- |
-  -----BEGIN CERTIFICATE-----
-  MIIFMDCCBBigAwIBAgIQBAkYG1/Vu2Z1U0O1b5VQCDANBgkqhkiG9w0BAQsFADBl
-  MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
-  d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJv
-  b3QgQ0EwHhcNMTMxMDIyMTIwMDAwWhcNMjgxMDIyMTIwMDAwWjByMQswCQYDVQQG
-  EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNl
-  cnQuY29tMTEwLwYDVQQDEyhEaWdpQ2VydCBTSEEyIEFzc3VyZWQgSUQgQ29kZSBT
-  aWduaW5nIENBMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA+NOzHH8O
-  Ea9ndwfTCzFJGc/Q+0WZsTrbRPV/5aid2zLXcep2nQUut4/6kkPApfmJ1DcZ17aq
-  8JyGpdglrA55KDp+6dFn08b7KSfH03sjlOSRI5aQd4L5oYQjZhJUM1B0sSgmuyRp
-  wsJS8hRniolF1C2ho+mILCCVrhxKhwjfDPXiTWAYvqrEsq5wMWYzcT6scKKrzn/p
-  fMuSoeU7MRzP6vIK5Fe7SrXpdOYr/mzLfnQ5Ng2Q7+S1TqSp6moKq4TzrGdOtcT3
-  jNEgJSPrCGQ+UpbB8g8S9MWOD8Gi6CxR93O8vYWxYoNzQYIH5DiLanMg0A9kczye
-  n6Yzqf0Z3yWT0QIDAQABo4IBzTCCAckwEgYDVR0TAQH/BAgwBgEB/wIBADAOBgNV
-  HQ8BAf8EBAMCAYYwEwYDVR0lBAwwCgYIKwYBBQUHAwMweQYIKwYBBQUHAQEEbTBr
-  MCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5kaWdpY2VydC5jb20wQwYIKwYBBQUH
-  MAKGN2h0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEFzc3VyZWRJ
-  RFJvb3RDQS5jcnQwgYEGA1UdHwR6MHgwOqA4oDaGNGh0dHA6Ly9jcmw0LmRpZ2lj
-  ZXJ0LmNvbS9EaWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5jcmwwOqA4oDaGNGh0dHA6
-  Ly9jcmwzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5jcmww
-  TwYDVR0gBEgwRjA4BgpghkgBhv1sAAIEMCowKAYIKwYBBQUHAgEWHGh0dHBzOi8v
-  d3d3LmRpZ2ljZXJ0LmNvbS9DUFMwCgYIYIZIAYb9bAMwHQYDVR0OBBYEFFrEuXsq
-  CqOl6nEDwGD5LfZldQ5YMB8GA1UdIwQYMBaAFEXroq/0ksuCMS1Ri6enIZ3zbcgP
-  MA0GCSqGSIb3DQEBCwUAA4IBAQA+7A1aJLPzItEVyCx8JSl2qB1dHC06GsTvMGHX
-  fgtg/cM9D8Svi/3vKt8gVTew4fbRknUPUbRupY5a4l4kgU4QpO4/cY5jDhNLrddf
-  RHnzNhQGivecRk5c/5CxGwcOkRX7uq+1UcKNJK4kxscnKqEpKBo6cSgCPC6Ro8Al
-  EeKcFEehemhor5unXCBc2XGxDI+7qPjFEmifz0DLQESlE/DmZAwlCEIysjaKJAL+
-  L3J+HNdJRZboWR3p+nRka7LrZkPas7CM1ekN3fYBIM6ZMWM9CBoYs4GbT8aTEAb8
-  B4H6i9r5gkn3Ym6hU/oSlBiFLpKR6mhsRDKyZqHnGKSaZFHv
-  -----END CERTIFICATE-----
-- |
-  -----BEGIN CERTIFICATE-----
-  MIIFIzCCBAugAwIBAgIQCMePMbkSxvnPeJhYXIfaxzANBgkqhkiG9w0BAQsFADBy
-  MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
-  d3cuZGlnaWNlcnQuY29tMTEwLwYDVQQDEyhEaWdpQ2VydCBTSEEyIEFzc3VyZWQg
-  SUQgQ29kZSBTaWduaW5nIENBMB4XDTIwMTAwNzAwMDAwMFoXDTIzMTEwNjEyMDAw
-  MFowYDELMAkGA1UEBhMCVVMxFjAUBgNVBAgTDU1hc3NhY2h1c2V0dHMxDzANBgNV
-  BAcTBkJvc3RvbjETMBEGA1UEChMKUmFwaWQ3IExMQzETMBEGA1UEAxMKUmFwaWQ3
-  IExMQzCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALNTz4zvAy7h/vQp
-  4dr1txXHlABAagkwYYwTMCtHs5PXsJITx/5SAjx5swuaLfze5kPBNF2YImvFlOXY
-  WaB+0PsOnXnaARsDZU683xFlj8izU6IN6VrAHzDLKFBzruJENrOJD/ikbEtbjO/q
-  gFbmS9J9v5ohG/pcRSS0t4ZPAwymf8eCp6QsvOKK/Aymp1RhlRaP8N6N5CIpkhz1
-  9p968iCE+DjOXVYxcWE+jE/7uB1dbgrXykNBujMSS3GULOvVEY28n6NCmrPlo23g
-  yRjYVJ2Vy14nBqnxDZ/yRIfWRVjWoT9TsAEbe9gY29oDpSCSs4wSmLQd5zGCpZ9h
-  r0HDFB8CAwEAAaOCAcUwggHBMB8GA1UdIwQYMBaAFFrEuXsqCqOl6nEDwGD5LfZl
-  dQ5YMB0GA1UdDgQWBBTLBL7DTwumVEKtdCdpHVYMXOFeDzAOBgNVHQ8BAf8EBAMC
-  B4AwEwYDVR0lBAwwCgYIKwYBBQUHAwMwdwYDVR0fBHAwbjA1oDOgMYYvaHR0cDov
-  L2NybDMuZGlnaWNlcnQuY29tL3NoYTItYXNzdXJlZC1jcy1nMS5jcmwwNaAzoDGG
-  L2h0dHA6Ly9jcmw0LmRpZ2ljZXJ0LmNvbS9zaGEyLWFzc3VyZWQtY3MtZzEuY3Js
-  MEwGA1UdIARFMEMwNwYJYIZIAYb9bAMBMCowKAYIKwYBBQUHAgEWHGh0dHBzOi8v
-  d3d3LmRpZ2ljZXJ0LmNvbS9DUFMwCAYGZ4EMAQQBMIGEBggrBgEFBQcBAQR4MHYw
-  JAYIKwYBBQUHMAGGGGh0dHA6Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBOBggrBgEFBQcw
-  AoZCaHR0cDovL2NhY2VydHMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0U0hBMkFzc3Vy
-  ZWRJRENvZGVTaWduaW5nQ0EuY3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQEL
-  BQADggEBAN+GL5/myPWg7oH4mVrG7/OhXF1MoYQF0ddaNiqaweEHMuKJBQCVZRbL
-  37HojoKXXv2yyRJBCeTB+ojrxX+5PdLVZa0ss7toWzJ2A1poPXZ1eZvm5xeFD32z
-  YQaTmmNWNI3PCDTyJ2PXUc+bDiNNwcZ7yc5o78UNRvp9Jxghya17Q76c9Ov9wvnv
-  dxxQKWGOQy0m4fBrkyjAyH9Djjn81RbQrqYgPuhd5nD0HjN3VUQLhQbIJrk9TVs0
-  EknWpNgVhohbot1lfVAMmIhdtOVaRVcQQixWPwprDj/ydB8ryDMDosIMcw+fkoXU
-  9GJsSaSRRYQ9UUkVL27b64okU8D48m8=
-  -----END CERTIFICATE-----
-date: 2021-07-02 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
@@ -154,6 +55,7 @@ files:
 - README
 - Rakefile
 - TODO
+- cortex.yaml
 - doc/code_organisation.txt
 - doc/const_missing.txt
 - doc/core/DynLdr.txt
@@ -191,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
@@ -210,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
@@ -283,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
@@ -460,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:
 - "."
@@ -480,9 +392,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.10
-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:
@@ -498,4 +409,5 @@ test_files:
 - tests/mips.rb
 - tests/parse_c.rb
 - tests/preprocessor.rb
+- tests/shellcode.rb
 - tests/x86_64.rb

data.tar.gz.sig

@@ -1,3 +0,0 @@
-���C���k#D6�Z?���bH��;Ӏ�3|L�\=�;�}F�3��`ܦ�5���*c
-܋�b�Q����Ol�zn�iq�jEȈ=�>S(�h���e�̭��i������C��!}�F�LN�	�Q��c
-�]�N�V�9|�m��ks4��%�gi�X�ژ����X���L�ه�>տ$DB��y%rˆ�u(j�q�:X�U�F�R8
��(.�_!�M��n�@��
���^tE�u$�S0�~R֡ڻ�

metadata.gz.sig

@@ -1,2 +0,0 @@
-5������Yp��hީ��-}�ۈ}	V-N�{8CynM	N ʹ��
*��7ӽY�/�Z@S�����%R��b|�-��ݣea-���tJȯ��� L�jZ���Tz�ޡv�E۹�N�C���[T$��ܹt4�gx@��b1nIȐ�=e����o��RH���m���]�Z)�
-?�5��:*��,ʩ'��q�T�#M��향�3s�<~_��}��O��W�4�]q�M.�Q�e�vc\��Z�qHYO�w1n��xh""�