rex-socket 0.1.45 → 0.1.47

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: faf5e107e5cabee49fbd28a5007c63151719d74671e2ec97588f23a8bfeebb49
-  data.tar.gz: '04811e5e61dce894070fd82b9210052e24b6bc1c766a0c5497752d5b7ff0b6c2'
+  metadata.gz: ee17c01e1a4f7063f35a53e7bd069d772eb16499c796e566e59172c862ebe2f0
+  data.tar.gz: 95cec06b282479a208a793e572b312fdec938733c31ac39c11a35d4093ab6647
 SHA512:
-  metadata.gz: 6aafffe07f0d89669c785c35b30fb6651c86ff46bf4bbad1f9612e08588b27c6842b74feb13c7816bc383553342fa9e951f52d10e20141e534dbb8e31ea7b8cb
-  data.tar.gz: b8a1683cbb979abb898c3264030b3e20d0590190da1970cb717230060c9c4c1ac99d6a29052c17a07fd229edacdc192caa7a4e2209aa8018799084491360c7fd
+  metadata.gz: 194008d3f56ce2ed0a2f3472a2de73cc5f3d297ef8ff183ce1e9a380319356752c882171112b20b9edb75e44e52b644651e0bad3faabddfb158911175cd38d32
+  data.tar.gz: 766bf3d2c08fcf411aa8cc0a8137e4a140066bf730d606ba154d2e22c7da01b149b91f0365eb5c6dbc3b557b80e52661d4bb0b3888510a1877d04c2693cba34c

checksums.yaml.gz.sig

@@ -1 +1 @@
-&�A��n՞��y	YE�sQ����Ԗ�#�㜌�E��Bb{�gBVX�ؠV���K�KU@���B�������m|�4ӇԸd�2A��DK����#�x�m6G&��05H��*�7��1E��?�4%�M�7���ø�o�o�����c>if�Nf�y���+��c�e���X���|9r�-���E�4���
+z�q�!F����i�·Ή	iL�c�n�5eP���֧diR\7�T��J]�ұw#c���bm&t5�@�et?����|n=7��8]!+S�ꁁ��$���i���%t7F���Uw>l���sGpх�R�o�;��G��

data/.github/workflows/verify.yml

@@ -33,15 +33,16 @@ jobs:
       fail-fast: true
       matrix:
         ruby:
-          - 2.7
-          - 3.0
-          - 3.1
+          - '2.7'
+          - '3.0'
+          - '3.1'
+          - '3.2'
         os:
           - ubuntu-20.04
           - ubuntu-latest
         exclude:
-          - { os: ubuntu-latest, ruby: 2.7 }
-          - { os: ubuntu-latest, ruby: 3.0 }
+          - { os: ubuntu-latest, ruby: '2.7' }
+          - { os: ubuntu-latest, ruby: '3.0' }
         test_cmd:
           - bundle exec rspec
 

data/lib/rex/socket/comm/local.rb

@@ -6,6 +6,8 @@ require 'rex/socket/tcp'
 require 'rex/socket/ssl_tcp'
 require 'rex/socket/ssl_tcp_server'
 require 'rex/socket/udp'
+require 'rex/socket/sctp'
+require 'rex/socket/sctp_server'
 require 'rex/socket/ip'
 require 'timeout'
 
@@ -34,6 +36,8 @@ class Rex::Socket::Comm::Local
         return create_by_type(param, ::Socket::SOCK_STREAM, ::Socket::IPPROTO_TCP)
       when 'udp'
         return create_by_type(param, ::Socket::SOCK_DGRAM, ::Socket::IPPROTO_UDP)
+      when 'sctp'
+        return create_by_type(param, ::Socket::SOCK_STREAM, ::Socket::IPPROTO_SCTP)
       when 'ip'
         return create_ip(param)
       else
@@ -194,15 +198,21 @@ class Rex::Socket::Comm::Local
       sock.setsockopt(::Socket::SOL_SOCKET, ::Socket::SO_BROADCAST, true)
     end
 
-    # If a server TCP instance is being created...
+    # If a server instance is being created...
     if param.server?
       sock.listen(256)
 
       if !param.bare?
-        klass = Rex::Socket::TcpServer
-        if param.ssl
-          klass = Rex::Socket::SslTcpServer
-        end
+        if param.proto == 'tcp'
+          klass = Rex::Socket::TcpServer
+          if param.ssl
+            klass = Rex::Socket::SslTcpServer
+          end
+        elsif param.proto == 'sctp'
+            klass = Rex::Socket::SctpServer
+        else
+          raise Rex::BindFailed.new(param.localhost, param.localport), caller
+        end  
         sock.extend(klass)
 
         sock.initsock(param)
@@ -309,6 +319,9 @@ class Rex::Socket::Comm::Local
           when 'udp'
             sock.extend(Rex::Socket::Udp)
             sock.initsock(param)
+          when 'sctp'
+            sock.extend(Rex::Socket::Sctp)
+            sock.initsock(param)
         end
       end
 

data/lib/rex/socket/sctp.rb

@@ -0,0 +1,66 @@
+# -*- coding: binary -*-
+require 'rex/socket'
+require 'rex/io/stream'
+
+class ::Socket
+  IPPROTO_SCTP = 132
+  SOL_SCTP     = 132
+end
+
+###
+#
+# This class provides methods for interacting with a SCTP client connection.
+#
+###
+module Rex::Socket::Sctp
+
+  include Rex::Socket
+  include Rex::IO::Stream
+
+  ##
+  #
+  # Factory
+  #
+  ##
+
+  #
+  # Creates the client using the supplied hash.
+  #
+  # @see create_param
+  # @see Rex::Socket::Parameters.from_hash
+  def self.create(hash = {})
+    hash['Proto'] = 'sctp'
+    self.create_param(Rex::Socket::Parameters.from_hash(hash))
+  end
+
+  #
+  # Wrapper around the base socket class' creation method that automatically
+  # sets the parameter's protocol to SCTP.
+  #
+  def self.create_param(param)
+    param.proto = 'sctp'
+    Rex::Socket.create_param(param)
+  end
+
+  ##
+  #
+  # Stream mixin implementations
+  #
+  ##
+
+  #
+  # Calls shutdown on the SCTP connection.
+  #
+  def shutdown(how = ::Socket::SHUT_RDWR)
+    begin
+      return (super(how) == 0)
+    rescue ::Exception
+    end
+  end
+
+  # returns socket type
+  def type?
+    return 'sctp'
+  end
+
+end

data/lib/rex/socket/sctp_server.rb

@@ -0,0 +1,75 @@
+# -*- coding: binary -*-
+require 'rex/socket'
+require 'rex/socket/sctp'
+require 'rex/io/stream_server'
+
+###
+#
+# This class provides methods for interacting with a SCTP server.  It
+# implements the Rex::IO::StreamServer interface.
+#
+###
+module  Rex::Socket::SctpServer
+
+  include Rex::Socket
+  include Rex::IO::StreamServer
+
+  ##
+  #
+  # Factory
+  #
+  ##
+
+  #
+  # Creates the server using the supplied hash.
+  #
+  def self.create(hash = {})
+    hash['Proto'] = 'sctp'
+    hash['Server'] = true
+    self.create_param(Rex::Socket::Parameters.from_hash(hash))
+  end
+
+  #
+  # Wrapper around the base class' creation method that automatically sets
+  # the parameter's protocol to SCTP and sets the server flag to true.
+  #
+  def self.create_param(param)
+    param.proto  = 'sctp'
+    param.server = true
+    Rex::Socket.create_param(param)
+  end
+
+  #
+  # Accepts a child connection.
+  #
+  def accept(opts = {})
+    t = super()
+
+    # jRuby compatibility
+    if t.respond_to?('[]')
+      t = t[0]
+    end
+
+    if (t)
+      t.extend(Rex::Socket::Sctp)
+      t.context = self.context
+
+      pn = t.getpeername_as_array
+
+      # We hit a "getpeername(2)" from Ruby
+      return nil unless pn
+
+      t.peerhost = pn[1]
+      t.peerport = pn[2]
+
+      ln = t.getlocalname
+
+      t.localhost = ln[1]
+      t.localport = ln[2]
+    end
+
+    t
+  end
+
+end
+

data/lib/rex/socket/version.rb

@@ -1,5 +1,5 @@
 module Rex
   module Socket
-    VERSION = "0.1.45"
+    VERSION = "0.1.47"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rex-socket
 version: !ruby/object:Gem::Version
-  version: 0.1.45
+  version: 0.1.47
 platform: ruby
 authors:
 - Metasploit Hackers
@@ -93,7 +93,7 @@ cert_chain:
   EknWpNgVhohbot1lfVAMmIhdtOVaRVcQQixWPwprDj/ydB8ryDMDosIMcw+fkoXU
   9GJsSaSRRYQ9UUkVL27b64okU8D48m8=
   -----END CERTIFICATE-----
-date: 2023-01-13 00:00:00.000000000 Z
+date: 2023-02-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -163,6 +163,8 @@ files:
 - lib/rex/socket/ip.rb
 - lib/rex/socket/parameters.rb
 - lib/rex/socket/range_walker.rb
+- lib/rex/socket/sctp.rb
+- lib/rex/socket/sctp_server.rb
 - lib/rex/socket/ssh_factory.rb
 - lib/rex/socket/ssl.rb
 - lib/rex/socket/ssl_tcp.rb