ruby_smb 3.0.3 → 3.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e7ce1d9892eb5ccf2881dd78a8e1983926554f69de301560539e7d7da37061b0
-  data.tar.gz: '01692d97a27c63f470b7c2899ad9cfb2828c9e254f0747176a29555d462bbf1d'
+  metadata.gz: 4dd0be012c18ad4e243cbfa2948fc620448766612b2f33be278583981fa2cf90
+  data.tar.gz: '07309ce54e701f2c3654a9cdbc8b3eff9d42d54451321e6e17a49d46ae4ce162'
 SHA512:
-  metadata.gz: 2fafe3f08b518b285b33832e0809c9b5f4687800457bec2c1945dd33f4c7109466926a5f55a537a3cdf9851f1c0c6b9979aa0f8d75f0004749f8bdd56ba26ab4
-  data.tar.gz: 070550512fe2ffadaecb97ea014e8fa5563b722b0184303c022f901bb60466991979673adf0dedfb411585b910e92d435308f7d900326ee6d8aa8ead5e1cdf0c
+  metadata.gz: ee506f05e67f8fa1a61b0d0f05470b41e20c5972c9c9584e8fe8069352a2cd09704b66d42856fb1330a93def276525b0d50047e93b981479c064c36f35f8298a
+  data.tar.gz: 78c37f1157393e17c51a6de7ff55fb25206e84f68740c958c406c36432ca90bc572716670640b9153a3ff66247dfcbeae8f4305f3c17cd91af64e8a4fc092894

data/.github/workflows/verify.yml

@@ -17,10 +17,10 @@ jobs:
       fail-fast: true
       matrix:
         ruby:
-          - 2.5
           - 2.6
           - 2.7
           - 3.0.3
+          - 3.1.1
         test_cmd:
           - bundle exec rspec
 

data/.simplecov

@@ -2,7 +2,7 @@
 # controlled by running with coverage, so don't explicitly start coverage (and
 # therefore generate a report) when in Rubymine.  This _will_ generate a report
 # whenever `rake spec` is run.
-unless ENV['RM_INFO']
+unless ENV['RM_INFO'] || SimpleCov.running
   SimpleCov.start
 end
 

data/CONTRIBUTING.md

@@ -1,8 +1,33 @@
 # Contributing
 
+## Versioning
+
+RubySMB attempts to follow [the Semantic Versioning 2.0.0](https://semver.org/) standard, however due to certain key architectural qualities, some reservations are made regarding what will trigger major and minor version bumps. A large component of RubySMB are the data definitions written using [BinData](https://github.com/dmendel/bindata). These definitions are implemented in an incremental fashion, causing some to be missing while others are only partially implemented (particularly in cases where fields are dependent on other types that may or may not be defined). Because of this, the RubySMB project reserves the right to update these definitions without incrementing the major version. In most cases, the definitions and their fields do not need to be used to perform standard operations such as connecting to, authenticating to and reading a file from a remote SMB server. The API provided by non-BinData objects will remain stable across minor versions, with backwards incompatible changes triggering a major version bump. Backwards incompatible changes to data structure definitions in BinData will cause the RubySMB maintianers to perform a minor version bump. These changes include but are not limited to:
+
+* Changes to the class name due to how BinData's internal registration works
+* Their field names which may be updated to avoid conflicts
+* Their field types which may be extended with more functionality or switched from integers to full-flag based definitions
+
+### Usage Examples
+The following two examples show dangerous operations that may not be stable across minor version bumps, and safe operations.
+
+```
+# dangerous operation, the BinData object name (TransformHeader) may change in the future
+header = RubySMB::SMB2::Packet::TransformHeader.read(raw_request)
+# also dangerous operation, the field name may change in the future
+header.flags = 0
+```
+
+```
+# safe operation, the API exposed on the Client won't change without a major version bump
+client = RubySMB::Client.new(dispatcher, smb1: options[:smbv1], smb2: options[:smbv2], smb3: options[:smbv3], username: options[:username], password: options[:password], domain: options[:domain])
+# safe operation, methods on non-BinData objects won't change without a major version bump
+protocol = client.negotiate
+```
+
 ## Forking
 
-[Fork this repository](https://github.com/rapid7/smb2/fork)
+[Fork this repository](https://github.com/rapid7/ruby_smb/fork)
 
 ## Branching
 
@@ -14,7 +39,7 @@ Branch names follow the format `TYPE/ISSUE/SUMMARY`.  You can create it with `gi
 
 ### `ISSUE`
 
-`ISSUE` is either a [Github issue](https://github.com/rapid7/smb2/issues) or an issue from some other
+`ISSUE` is either a [Github issue](https://github.com/rapid7/ruby_smb/issues) or an issue from some other
 issue tracking software.
 
 ### `SUMMARY`
@@ -49,7 +74,7 @@ Push your branch to your fork on gitub: `git push TYPE/ISSUE/SUMMARY`
 
 ### Pull Request
 
-* [Create new Pull Request](https://github.com/rapid7/smb2/compare/)
+* [Create new Pull Request](https://github.com/rapid7/ruby_smb/compare/)
 * Add a Verification Steps to the description comment
 
 ```

data/README.md

@@ -12,6 +12,12 @@ The RubySMB library provides client-level and packet-level support for the proto
 
 See the Wiki for more information on this project's long-term goals, style guide, and developer tips.
 
+
+## Versioning
+RubySMB attempts to follow [the Semantic Versioning 2.0.0](https://semver.org/) standard, however due to certain key architectural qualities, some reservations are made regarding what will trigger major and minor version bumps. Upstream consumers utilizing higher-level SMB operations can lock to minor (`~= 3.0`) versions however consumers utilizing raw SMB packet manipulation are recommended to set restrictions for compatibility to allow update resolution for patch versions (`~= 3.0.0`).
+
+
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -34,6 +40,8 @@ Or install it yourself as:
 
 All packets are implemented in a declarative style with BinData. Nested data structures are used where appropriate to give users an easy method of manipulating individual fields inside of a packet.
 
+Note that these packets are defined using [BinData](https://github.com/dmendel/bindata) and that their struction is subject to change across minor version bumps. See [CONTRIBUTING.md](https://github.com/rapid7/ruby_smb/blob/master/CONTRIBUTING.md#versioning) for more information.
+
 #### SMB1
 
 SMB1 Packets are made up of three basic components:

data/examples/pwsh_service.rb

@@ -0,0 +1,112 @@
+#!/usr/bin/ruby
+
+# This example script is used for launching a powershell command as a service on a host.
+# It will attempt to connect to a host and create a new service to launch the command using powershell.exe.
+# Example usage: ruby pwsh_service.rb --username msfadmin --password msfadmin 192.168.172.138 "echo test > C:\\Users\\User\\Desktop\\test.txt"
+# This will try to connect to \\192.168.172.138 with the msfadmin:msfadmin credentials and create a new service to run the powershell command.
+
+def random_string(length)
+  return (1..length).map { (('a'..'z').to_a + ('A'..'Z').to_a)[rand(26*2)] }.join
+end
+
+require 'bundler/setup'
+require 'optparse'
+require 'ruby_smb'
+
+args = ARGV.dup
+options = {
+  domain: '.',
+  username: '',
+  password: '',
+  command: nil,
+  smbv1: true,
+  smbv2: true,
+  smbv3: true,
+  target: nil
+}
+options[:command] = args.pop
+options[:target] = args.pop
+optparser = OptionParser.new do |opts|
+  opts.banner = "Usage: #{File.basename(__FILE__)} [options] target command"
+  opts.on("--[no-]smbv1", "Enable or disable SMBv1 (default: #{options[:smbv1] ? 'Enabled' : 'Disabled'})") do |smbv1|
+    options[:smbv1] = smbv1
+  end
+  opts.on("--[no-]smbv2", "Enable or disable SMBv2 (default: #{options[:smbv2] ? 'Enabled' : 'Disabled'})") do |smbv2|
+    options[:smbv2] = smbv2
+  end
+  opts.on("--[no-]smbv3", "Enable or disable SMBv3 (default: #{options[:smbv3] ? 'Enabled' : 'Disabled'})") do |smbv3|
+    options[:smbv3] = smbv3
+  end
+  opts.on("--username USERNAME", "The account's username (default: #{options[:username]})") do |username|
+    if username.include?('\\')
+      options[:domain], options[:username] = username.split('\\', 2)
+    else
+      options[:username] = username
+    end
+  end
+  opts.on("--password PASSWORD", "The account's password (default: #{options[:password]})") do |password|
+    options[:password] = password
+  end
+end
+optparser.parse!(args)
+
+if options[:target].nil? || options[:command].nil?
+  abort(optparser.help)
+end
+
+sock = TCPSocket.new options[:target], 445
+dispatcher = RubySMB::Dispatcher::Socket.new(sock, read_timeout: 60)
+
+client = RubySMB::Client.new(dispatcher, smb1: options[:smbv1], smb2: options[:smbv2], smb3: options[:smbv3], username: options[:username], password: options[:password], domain: options[:domain])
+protocol = client.negotiate
+status = client.authenticate
+
+puts "#{protocol} : #{status}"
+
+tree = client.tree_connect("\\\\#{options[:target]}\\IPC$")
+svcctl = tree.open_file(filename: 'svcctl', write: true, read: true)
+
+puts('Binding to \\svcctl...')
+svcctl.bind(endpoint: RubySMB::Dcerpc::Svcctl)
+puts('Bound to \\svcctl')
+
+puts('Opening Service Control Manager')
+scm_handle = svcctl.open_sc_manager_w(options[:target])
+
+service_name = random_string(8)
+display_name = random_string(8)
+binary_path_name = "%COMSPEC% /c start /b /min powershell.exe -nop -win hid -noni -en #{[options[:command].encode("UTF-16LE")].pack("m0")}"
+puts "Full Command: #{binary_path_name}"
+svc_handle = svcctl.create_service_w(scm_handle, service_name, display_name, binary_path_name)
+
+puts('Created new service')
+
+svcctl.close_service_handle(svc_handle)
+
+puts('Opening the service')
+
+svc_handle = svcctl.open_service_w(scm_handle, service_name)
+
+puts('Starting the service')
+
+begin
+  svcctl.start_service_w(svc_handle)
+rescue RubySMB::Dcerpc::Error::SvcctlError => e
+  if e.message.include?('ERROR_SERVICE_REQUEST_TIMEOUT')
+    puts "Service start timed out, OK if running a command or non-service executable..."
+  else
+    puts "Service start error: #{e}"
+  end
+end
+
+puts('Deleting the service')
+
+svcctl.delete_service(svc_handle)
+
+puts('Closing Service Control Manager')
+
+svcctl.close_service_handle(scm_handle)
+
+puts('Done')
+
+client.disconnect!

data/lib/ruby_smb/client/negotiation.rb

@@ -251,7 +251,7 @@ module RubySMB
           raise ArgumentError, 'Must be an array of strings' unless dialect.is_a? String
           packet.add_dialect(dialect.to_i(16))
         end
-        packet.capabilities.encryption = 1
+        packet.capabilities.encryption = @session_encrypt_data ? 1 : 0
 
         if packet.dialects.include?(0x0311)
           nc = RubySMB::SMB2::NegotiateContext.new(

data/lib/ruby_smb/client.rb

@@ -29,10 +29,26 @@ module RubySMB
     # It indicates that the server implements SMB 2.1 or future dialect revisions
     # Note that this must be used for SMB3
     SMB1_DIALECT_SMB2_WILDCARD = 'SMB 2.???'.freeze
+
+    SMB2_DIALECT_0202 = '0x0202'.freeze
+    SMB2_DIALECT_0210 = '0x0210'.freeze
+    SMB2_DIALECT_0300  = '0x0300'.freeze
+    SMB2_DIALECT_0302  = '0x0302'.freeze
+    SMB2_DIALECT_0311  = '0x0311'.freeze
+
     # Dialect values for SMB2
-    SMB2_DIALECT_DEFAULT = ['0x0202', '0x0210']
+    SMB2_DIALECT_DEFAULT = [
+      SMB2_DIALECT_0202,
+      SMB2_DIALECT_0210,
+    ].freeze
+
     # Dialect values for SMB3
-    SMB3_DIALECT_DEFAULT = ['0x0300', '0x0302', '0x0311']
+    SMB3_DIALECT_DEFAULT = [
+      SMB2_DIALECT_0300,
+      SMB2_DIALECT_0302,
+      SMB2_DIALECT_0311
+    ].freeze
+
     # The default maximum size of a SMB message that the Client accepts (in bytes)
     MAX_BUFFER_SIZE = 64512
     # The default maximum size of a SMB message that the Server accepts (in bytes)
@@ -129,6 +145,11 @@ module RubySMB
     #   @return [Integer]
     attr_accessor :session_id
 
+    # Whether or not the current session has the guest flag set
+    # @!attribute [rw] session_is_guest
+    #   @return [Boolean]
+    attr_accessor :session_is_guest
+
     # Whether or not the Server requires signing
     # @!attribute [rw] signing_enabled
     #   @return [Boolean]

data/lib/ruby_smb/dcerpc/request.rb

@@ -48,6 +48,7 @@ module RubySMB
         end
         choice 'Svcctl', selection: -> { opnum } do
           open_sc_manager_w_request       Svcctl::OPEN_SC_MANAGER_W
+          create_service_w_request        Svcctl::CREATE_SERVICE_W
           open_service_w_request          Svcctl::OPEN_SERVICE_W
           query_service_status_request    Svcctl::QUERY_SERVICE_STATUS
           query_service_config_w_request  Svcctl::QUERY_SERVICE_CONFIG_W
@@ -55,6 +56,7 @@ module RubySMB
           start_service_w_request         Svcctl::START_SERVICE_W
           control_service_request         Svcctl::CONTROL_SERVICE
           close_service_handle_request    Svcctl::CLOSE_SERVICE_HANDLE
+          delete_service_request          Svcctl::DELETE_SERVICE
           string                          :default
         end
         choice 'Samr', selection: -> { opnum } do

data/lib/ruby_smb/dcerpc/svcctl/create_service_w_request.rb

@@ -0,0 +1,35 @@
+module RubySMB
+  module Dcerpc
+    module Svcctl
+
+      # [3.1.4.12 RCreateServiceW (Opnum 12)](https://docs.microsoft.com/en-us/openspecs/windows_protocols/ms-scmr/6a8ca926-9477-4dd4-b766-692fab07227e)
+      class CreateServiceWRequest < BinData::Record
+        attr_reader :opnum
+
+        endian :little
+
+        sc_rpc_handle             :h_sc_object
+        ndr_conf_var_wide_stringz :lp_service_name
+        ndr_wide_stringz_ptr      :lp_display_name
+        ndr_uint32                :dw_desired_access
+        ndr_uint32                :dw_service_type
+        ndr_uint32                :dw_start_type
+        ndr_uint32                :dw_error_control
+        ndr_conf_var_wide_stringz :lp_binary_path_name
+        ndr_wide_stringz_ptr      :lp_load_order_group
+        ndr_uint32_ptr            :lp_dw_tag_id
+        svcctl_byte_array_ptr     :lp_dependencies, type: :ndr_uint8
+        ndr_uint32                :dw_depend_size, initial_value: -> { lp_dependencies.size }
+        ndr_wide_stringz_ptr      :lp_service_start_name
+        svcctl_byte_array_ptr     :lp_password, type: :ndr_uint8
+        ndr_uint32                :dw_pw_size, initial_value: -> { lp_password.size }
+
+        def initialize_instance
+          super
+          @opnum = CREATE_SERVICE_W
+        end
+      end
+
+    end
+  end
+end

data/lib/ruby_smb/dcerpc/svcctl/create_service_w_response.rb

@@ -0,0 +1,24 @@
+module RubySMB
+  module Dcerpc
+    module Svcctl
+
+      # [3.1.4.12 RCreateServiceW (Opnum 12)](https://docs.microsoft.com/en-us/openspecs/windows_protocols/ms-scmr/6a8ca926-9477-4dd4-b766-692fab07227e)
+      class CreateServiceWResponse < BinData::Record
+        attr_reader :opnum
+
+        endian :little
+
+        ndr_uint32_ptr :lp_dw_tag_id
+        sc_rpc_handle  :lp_sc_handle
+        ndr_uint32     :error_status
+
+        def initialize_instance
+          super
+          @opnum = CREATE_SERVICE_W
+        end
+
+      end
+
+    end
+  end
+end

data/lib/ruby_smb/dcerpc/svcctl/delete_service_request.rb

@@ -0,0 +1,21 @@
+module RubySMB
+  module Dcerpc
+    module Svcctl
+
+      # [3.1.4.2 RDeleteService (Opnum 2)](https://docs.microsoft.com/en-us/openspecs/windows_protocols/ms-scmr/6744cdb8-f162-4be0-bb31-98996b6495be)
+      class DeleteServiceRequest < BinData::Record
+        attr_reader :opnum
+
+        endian :little
+
+        sc_rpc_handle             :lp_sc_handle
+
+        def initialize_instance
+          super
+          @opnum = DELETE_SERVICE
+        end
+      end
+
+    end
+  end
+end

data/lib/ruby_smb/dcerpc/svcctl/delete_service_response.rb

@@ -0,0 +1,21 @@
+module RubySMB
+  module Dcerpc
+    module Svcctl
+
+      # [3.1.4.2 RDeleteService (Opnum 2)](https://docs.microsoft.com/en-us/openspecs/windows_protocols/ms-scmr/6744cdb8-f162-4be0-bb31-98996b6495be)
+      class DeleteServiceResponse < BinData::Record
+        attr_reader :opnum
+
+        endian :little
+
+        ndr_uint32                :error_status
+
+        def initialize_instance
+          super
+          @opnum = DELETE_SERVICE
+        end
+      end
+
+    end
+  end
+end

data/lib/ruby_smb/dcerpc/svcctl.rb

@@ -9,8 +9,10 @@ module RubySMB
       # Operation numbers
       CLOSE_SERVICE_HANDLE    = 0x0000
       CONTROL_SERVICE         = 0x0001
+      DELETE_SERVICE          = 0x0002
       QUERY_SERVICE_STATUS    = 0x0006
       CHANGE_SERVICE_CONFIG_W = 0x000B
+      CREATE_SERVICE_W        = 0x000C
       OPEN_SC_MANAGER_W       = 0x000F
       OPEN_SERVICE_W          = 0x0010
       QUERY_SERVICE_CONFIG_W  = 0x0011
@@ -19,6 +21,10 @@ module RubySMB
 
       class ScRpcHandle < Ndr::NdrContextHandle; end
 
+      class SvcctlByteArrayPtr < Ndr::NdrConfArray
+        default_parameters type: :ndr_uint8
+        extend Ndr::PointerClassPlugin
+      end
 
       #################################
       #           Constants           #
@@ -254,10 +260,14 @@ module RubySMB
       require 'ruby_smb/dcerpc/svcctl/open_service_w_response'
       require 'ruby_smb/dcerpc/svcctl/query_service_status_request'
       require 'ruby_smb/dcerpc/svcctl/query_service_status_response'
+      require 'ruby_smb/dcerpc/svcctl/delete_service_request'
+      require 'ruby_smb/dcerpc/svcctl/delete_service_response'
       require 'ruby_smb/dcerpc/svcctl/query_service_config_w_request'
       require 'ruby_smb/dcerpc/svcctl/query_service_config_w_response'
       require 'ruby_smb/dcerpc/svcctl/change_service_config_w_request'
       require 'ruby_smb/dcerpc/svcctl/change_service_config_w_response'
+      require 'ruby_smb/dcerpc/svcctl/create_service_w_request'
+      require 'ruby_smb/dcerpc/svcctl/create_service_w_response'
       require 'ruby_smb/dcerpc/svcctl/start_service_w_request'
       require 'ruby_smb/dcerpc/svcctl/start_service_w_response'
       require 'ruby_smb/dcerpc/svcctl/control_service_request'
@@ -289,10 +299,41 @@ module RubySMB
         open_sc_manager_w_response.lp_sc_handle
       end
 
+      # Creates an RPC context handle to a new service record.
+      #
+      # @param scm_handle [RubySMB::Dcerpc::Svcctl::ScRpcHandle] handle to the SCM database
+      # @param service_name [String] the ServiceName of the service record
+      # @param display_name [String] the DisplayName of the service record
+      # @param binary_path_name [String] the BinaryPathName of the service record
+      # @return [RubySMB::Dcerpc::Svcctl::ScRpcHandle] handle to the created service record
+      # @raise [RubySMB::Dcerpc::Error::InvalidPacket] if the response is not a CreateServiceWResponse packet
+      # @raise [RubySMB::Dcerpc::Error::SvcctlError] if the response error status is not ERROR_SUCCESS
+      def create_service_w(scm_handle, service_name, display_name, binary_path_name)
+        create_service_w_request = CreateServiceWRequest.new(dw_desired_access: SERVICE_ALL_ACCESS)
+        create_service_w_request.dw_service_type = SERVICE_INTERACTIVE_PROCESS | SERVICE_WIN32_OWN_PROCESS
+        create_service_w_request.dw_start_type = SERVICE_DEMAND_START
+        create_service_w_request.h_sc_object = scm_handle
+        create_service_w_request.lp_service_name = service_name
+        create_service_w_request.lp_display_name = display_name
+        create_service_w_request.lp_binary_path_name = binary_path_name
+        response = dcerpc_request(create_service_w_request)
+        begin
+          create_service_w_response = CreateServiceWResponse.read(response)
+        rescue IOError
+          raise RubySMB::Dcerpc::Error::InvalidPacket, 'Error reading CreateServiceWResponse'
+        end
+        unless create_service_w_response.error_status == WindowsError::Win32::ERROR_SUCCESS
+          raise RubySMB::Dcerpc::Error::SvcctlError,
+            "Error returned when creating #{service_name} service: "\
+            "#{WindowsError::Win32.find_by_retval(create_service_w_response.error_status.value).join(',')}"
+        end
+        create_service_w_response.lp_sc_handle
+      end
+
       # Creates an RPC context handle to an existing service record.
       #
       # @param scm_handle [RubySMB::Dcerpc::Svcctl::ScRpcHandle] handle to the SCM database
-      # @param service_name [Srting] the ServiceName of the service record
+      # @param service_name [String] the ServiceName of the service record
       # @param access [Integer] access right
       # @return [RubySMB::Dcerpc::Svcctl::ScRpcHandle] handle to the found service record
       # @raise [RubySMB::Dcerpc::Error::InvalidPacket] if the response is not a OpenServiceWResponse packet
@@ -303,16 +344,16 @@ module RubySMB
         open_service_w_request.lp_service_name = service_name
         response = dcerpc_request(open_service_w_request)
         begin
-          open_sercice_w_response = OpenServiceWResponse.read(response)
+          open_service_w_response = OpenServiceWResponse.read(response)
         rescue IOError
           raise RubySMB::Dcerpc::Error::InvalidPacket, 'Error reading OpenServiceWResponse'
         end
-        unless open_sercice_w_response.error_status == WindowsError::Win32::ERROR_SUCCESS
+        unless open_service_w_response.error_status == WindowsError::Win32::ERROR_SUCCESS
           raise RubySMB::Dcerpc::Error::SvcctlError,
             "Error returned when opening #{service_name} service: "\
-            "#{WindowsError::Win32.find_by_retval(open_sercice_w_response.error_status.value).join(',')}"
+            "#{WindowsError::Win32.find_by_retval(open_service_w_response.error_status.value).join(',')}"
         end
-        open_sercice_w_response.lp_sc_handle
+        open_service_w_response.lp_sc_handle
       end
 
       # Returns the current status of the specified service
@@ -472,6 +513,26 @@ module RubySMB
             "#{WindowsError::Win32.find_by_retval(csh_response.error_status.value).join(',')}"
         end
       end
+
+      # Deletes the specified service
+      #
+      # @param scm_handle [RubySMB::Dcerpc::Svcctl::ScRpcHandle] handle to the service record
+      # @raise [RubySMB::Dcerpc::Error::InvalidPacket] if the response is not a DeleteServiceResponse packet
+      # @raise [RubySMB::Dcerpc::Error::SvcctlError] if the response error status is not ERROR_SUCCESS
+      def delete_service(svc_handle)
+        ds_request = DeleteServiceRequest.new(lp_sc_handle: svc_handle)
+        response = dcerpc_request(ds_request)
+        begin
+          ds_response = DeleteServiceResponse.read(response)
+        rescue IOError
+          raise RubySMB::Dcerpc::Error::InvalidPacket, 'Error reading DeleteServiceResponse'
+        end
+        unless ds_response.error_status == WindowsError::Win32::ERROR_SUCCESS
+         raise RubySMB::Dcerpc::Error::SvcctlError,
+           "Error returned when deleting the service: "\
+           "#{WindowsError::Win32.find_by_retval(ds_response.error_status.value).join(',')}"
+        end
+      end
     end
   end
 end

data/lib/ruby_smb/dcerpc/winreg/open_root_key_request.rb

@@ -33,7 +33,7 @@ module RubySMB
           super
           @opnum = get_parameter(:opnum) if has_parameter?(:opnum)
           self.server_name = :null
-          self.sam_desired.maximum = 1 unless [OPEN_HKPD, OPEN_HKPT, OPEN_HKPN].include?(@opnum)
+          self.sam_desired.maximum_allowed = 1 unless [OPEN_HKPD, OPEN_HKPT, OPEN_HKPN].include?(@opnum)
         end
       end
 

data/lib/ruby_smb/dcerpc/winreg/regsam.rb

@@ -33,7 +33,7 @@ module RubySMB
         bit1    :generic_execute,        label: 'Generic Execute'
         bit1    :generic_all,            label: 'Generic All'
         bit2    :reserved4,              label: 'Reserved Space'
-        bit1    :maximum,                label: 'Maximum Allowed'
+        bit1    :maximum_allowed,        label: 'Maximum Allowed'
         bit1    :system_security,        label: 'System Security'
       end
 

data/lib/ruby_smb/dcerpc/winreg.rb

@@ -274,7 +274,7 @@ module RubySMB
           lp_sub_key:             sub_key,
           lp_class:               opts[:lp_class] || :null,
           dw_options:             opts[:dw_options] || RubySMB::Dcerpc::Winreg::CreateKeyRequest::REG_KEY_TYPE_VOLATILE,
-          sam_desired:            opts[:sam_desired] || RubySMB::Dcerpc::Winreg::Regsam.new(maximum: 1),
+          sam_desired:            opts[:sam_desired] || RubySMB::Dcerpc::Winreg::Regsam.new(maximum_allowed: 1),
           lp_security_attributes: opts[:lp_security_attributes] || RubySMB::Dcerpc::RpcSecurityAttributes.new,
           lpdw_disposition:       opts[:lpdw_disposition] || RubySMB::Dcerpc::Winreg::CreateKeyRequest::REG_CREATED_NEW_KEY,
         }

data/lib/ruby_smb/server/session.rb

@@ -13,6 +13,7 @@ module RubySMB
         @user_id = user_id
         @state = state
         @signing_required = false
+        @metadata = {}
         # tree id => provider processor instance
         @tree_connect_table = {}
         @creation_time = Time.now
@@ -62,6 +63,11 @@ module RubySMB
       #   @return [Hash]
       attr_accessor :tree_connect_table
 
+      # Untyped hash for storing additional arbitrary metadata about the current session
+      # @!attribute [rw] metadaa
+      #   @return [Hash]
+      attr_accessor :metadata
+
       # The time at which this session was created.
       # @!attribute [r] creation_time
       #   @return [Time]

data/lib/ruby_smb/smb1/bit_field/directory_access_mask.rb

@@ -30,7 +30,7 @@ module RubySMB
         bit1    :generic_execute, label: 'Generic Execute'
         bit1    :generic_all,     label: 'Generic All'
         bit2    :reserved3
-        bit1    :maximum,         label: 'Maximum Allowed'
+        bit1    :maximum_allowed, label: 'Maximum Allowed'
         bit1    :system_security, label: 'System Security'
       end
     end

data/lib/ruby_smb/smb1/bit_field/file_access_mask.rb

@@ -30,7 +30,7 @@ module RubySMB
         bit1    :generic_execute, label: 'Generic Execute'
         bit1    :generic_all,     label: 'Generic All'
         bit2    :reserved3
-        bit1    :maximum,         label: 'Maximum Allowed'
+        bit1    :maximum_allowed, label: 'Maximum Allowed'
         bit1    :system_security, label: 'System Security'
       end
     end

data/lib/ruby_smb/smb2/bit_field/directory_access_mask.rb

@@ -30,7 +30,7 @@ module RubySMB
         bit1    :generic_execute, label: 'Generic Execute'
         bit1    :generic_all,     label: 'Generic All'
         bit2    :reserved3
-        bit1    :maximum,         label: 'Maximum Allowed'
+        bit1    :maximum_allowed, label: 'Maximum Allowed'
         bit1    :system_security, label: 'System Security'
       end
     end

data/lib/ruby_smb/smb2/bit_field/file_access_mask.rb

@@ -30,7 +30,7 @@ module RubySMB
         bit1    :generic_execute, label: 'Generic Execute'
         bit1    :generic_all,     label: 'Generic All'
         bit2    :reserved3
-        bit1    :maximum,         label: 'Maximum Allowed'
+        bit1    :maximum_allowed, label: 'Maximum Allowed'
         bit1    :system_security, label: 'System Security'
       end
     end

data/lib/ruby_smb/smb2/packet/session_setup_request.rb

@@ -18,6 +18,17 @@ module RubySMB
         uint64                     :previous_session_id,     label: 'Previous Session ID'
         string                     :buffer,                  label: 'Security Buffer', length: -> { security_buffer_length }
 
+        # Takes the specified security buffer string and inserts it into the {RubySMB::SMB2::Packet::SessionSetupRequest#buffer}
+        # as well as updating the {RubySMB::SMB2::Packet::SessionSetupRequest#security_buffer_length}
+        # This method DOES NOT wrap the security buffer in any way.
+        #
+        # @param buffer [String] the security buffer
+        # @return [void]
+        def set_security_buffer(buffer)
+          self.security_buffer_length = buffer.length
+          self.buffer = buffer
+        end
+
         # Takes a serialized NTLM Type 1 message and wraps it in the GSS ASN1 encoding
         # and inserts it into the {RubySMB::SMB2::Packet::SessionSetupRequest#buffer}
         # as well as updating the {RubySMB::SMB2::Packet::SessionSetupRequest#security_buffer_length}

data/lib/ruby_smb/version.rb

@@ -1,3 +1,3 @@
 module RubySMB
-  VERSION = '3.0.3'.freeze
+  VERSION = '3.0.6'.freeze
 end

data/ruby_smb.gemspec

@@ -34,7 +34,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'yard'
 
   spec.add_runtime_dependency 'rubyntlm'
-  spec.add_runtime_dependency 'windows_error', '>= 0.1.3'
+  spec.add_runtime_dependency 'windows_error', '>= 0.1.4'
   spec.add_runtime_dependency 'bindata'
   spec.add_runtime_dependency 'openssl-ccm'
   spec.add_runtime_dependency 'openssl-cmac'

data/spec/lib/ruby_smb/client_spec.rb

@@ -557,6 +557,16 @@ RSpec.describe RubySMB::Client do
     end
   end
 
+  describe '#wipe_state!' do
+    context 'with SMB1' do
+      it { expect { smb1_client.wipe_state! }.to_not raise_error }
+    end
+
+    context 'with SMB2' do
+      it { expect { smb2_client.wipe_state! }.to_not raise_error }
+    end
+  end
+
   describe '#logoff!' do
     context 'with SMB1' do
       let(:raw_response) { double('Raw response') }

data/spec/lib/ruby_smb/dcerpc/svcctl/create_service_w_request_spec.rb

@@ -0,0 +1,143 @@
+RSpec.describe RubySMB::Dcerpc::Svcctl::CreateServiceWRequest do
+  subject(:packet) { described_class.new }
+
+  it { is_expected.to respond_to :h_sc_object }
+  it { is_expected.to respond_to :lp_service_name }
+  it { is_expected.to respond_to :lp_display_name }
+  it { is_expected.to respond_to :dw_desired_access }
+  it { is_expected.to respond_to :dw_service_type }
+  it { is_expected.to respond_to :dw_start_type }
+  it { is_expected.to respond_to :dw_error_control }
+  it { is_expected.to respond_to :lp_binary_path_name }
+  it { is_expected.to respond_to :lp_load_order_group }
+  it { is_expected.to respond_to :lp_dw_tag_id }
+  it { is_expected.to respond_to :lp_dependencies }
+  it { is_expected.to respond_to :dw_depend_size }
+  it { is_expected.to respond_to :lp_service_start_name }
+  it { is_expected.to respond_to :lp_password }
+  it { is_expected.to respond_to :dw_pw_size }
+
+  it 'is little endian' do
+    expect(described_class.fields.instance_variable_get(:@hints)[:endian]).to eq :little
+  end
+
+
+  describe '#h_sc_object' do
+    it 'is a ScRpcHandle structure' do
+      expect(packet.h_sc_object).to be_a RubySMB::Dcerpc::Svcctl::ScRpcHandle
+    end
+  end
+
+  describe '#lp_service_name' do
+    it 'is a NdrConfVarWideStringz structure' do
+      expect(packet.lp_service_name).to be_a RubySMB::Dcerpc::Ndr::NdrConfVarWideStringz
+    end
+  end
+
+  describe '#lp_display_name' do
+    it 'is a NdrWideStringzPtr structure' do
+      expect(packet.lp_display_name).to be_a RubySMB::Dcerpc::Ndr::NdrWideStringzPtr
+    end
+  end
+
+  describe '#dw_desired_access' do
+    it 'is a NdrUint32' do
+      expect(packet.dw_desired_access).to be_a RubySMB::Dcerpc::Ndr::NdrUint32
+    end
+  end
+
+  describe '#dw_service_type' do
+    it 'is a NdrUint32' do
+      expect(packet.dw_service_type).to be_a RubySMB::Dcerpc::Ndr::NdrUint32
+    end
+  end
+
+  describe '#dw_start_type' do
+    it 'is a NdrUint32' do
+      expect(packet.dw_start_type).to be_a RubySMB::Dcerpc::Ndr::NdrUint32
+    end
+  end
+
+  describe '#dw_error_control' do
+    it 'is a NdrUint32' do
+      expect(packet.dw_error_control).to be_a RubySMB::Dcerpc::Ndr::NdrUint32
+    end
+  end
+
+  describe '#lp_binary_path_name' do
+    it 'is a NdrConfVarWideStringz structure' do
+      expect(packet.lp_binary_path_name).to be_a RubySMB::Dcerpc::Ndr::NdrConfVarWideStringz
+    end
+  end
+
+  describe '#lp_load_order_group' do
+    it 'is a NdrWideStringzPtr structure' do
+      expect(packet.lp_load_order_group).to be_a RubySMB::Dcerpc::Ndr::NdrWideStringzPtr
+    end
+  end
+
+  describe '#lp_dw_tag_id' do
+    it 'is a NdrUint32Ptr' do
+      expect(packet.lp_dw_tag_id).to be_a RubySMB::Dcerpc::Ndr::NdrUint32Ptr
+    end
+  end
+
+  describe '#lp_dependencies' do
+    it 'is a SvcctlByteArrayPtr structure' do
+      expect(packet.lp_dependencies).to be_a RubySMB::Dcerpc::Svcctl::SvcctlByteArrayPtr
+    end
+  end
+
+  describe '#dw_depend_size' do
+    it 'is a NdrUint32' do
+      expect(packet.dw_depend_size).to be_a RubySMB::Dcerpc::Ndr::NdrUint32
+    end
+  end
+
+  describe '#lp_service_start_name' do
+    it 'is a NdrWideStringzPtr structure' do
+      expect(packet.lp_service_start_name).to be_a RubySMB::Dcerpc::Ndr::NdrWideStringzPtr
+    end
+  end
+
+  describe '#lp_password' do
+    it 'is a SvcctlByteArrayPtr structure' do
+      expect(packet.lp_password).to be_a RubySMB::Dcerpc::Svcctl::SvcctlByteArrayPtr
+    end
+  end
+
+  describe '#dw_pw_size' do
+    it 'is a NdrUint32' do
+      expect(packet.dw_pw_size).to be_a RubySMB::Dcerpc::Ndr::NdrUint32
+    end
+  end
+
+  it 'should keep #dw_desired_access 4-byte aligned' do
+    5.times do |i1|
+      5.times do |i2|
+        packet.lp_service_name = "A" * i1
+        packet.lp_display_name = "B" * i2
+        expect(packet.dw_desired_access.abs_offset % 4).to eq 0
+      end
+    end
+  end
+
+  describe '#initialize_instance' do
+    it 'sets #opnum to CREATE_SERVICE_W constant' do
+      expect(packet.opnum).to eq(RubySMB::Dcerpc::Svcctl::CREATE_SERVICE_W)
+    end
+  end
+
+  it 'reads its own binary representation and outputs the same packet' do
+    packet = described_class.new(
+      h_sc_object: {context_handle_attributes: 0, context_handle_uuid: '367abb81-9844-35f1-ad32-98f038001003'},
+      lp_service_name: 'test',
+      lp_display_name: 'Test',
+      dw_desired_access: 3,
+      lp_binary_path_name: 'test',
+      lp_password: 'test'.bytes
+    )
+    binary = packet.to_binary_s
+    expect(described_class.read(binary)).to eq(packet)
+  end
+end

data/spec/lib/ruby_smb/dcerpc/svcctl/create_service_w_response_spec.rb

@@ -0,0 +1,45 @@
+RSpec.describe RubySMB::Dcerpc::Svcctl::CreateServiceWResponse do
+  subject(:packet) { described_class.new }
+
+  it { is_expected.to respond_to :lp_dw_tag_id }
+  it { is_expected.to respond_to :lp_sc_handle }
+  it { is_expected.to respond_to :error_status }
+
+  it 'is little endian' do
+    expect(described_class.fields.instance_variable_get(:@hints)[:endian]).to eq :little
+  end
+
+  describe '#lp_dw_tag_id' do
+    it 'is a NdrUint32Ptr' do
+      expect(packet.lp_dw_tag_id).to be_a RubySMB::Dcerpc::Ndr::NdrUint32Ptr
+    end
+  end
+
+  describe '#lp_sc_handle' do
+    it 'is a ScRpcHandle structure' do
+      expect(packet.lp_sc_handle).to be_a RubySMB::Dcerpc::Svcctl::ScRpcHandle
+    end
+  end
+
+  describe '#error_status' do
+    it 'is a NdrUint32' do
+      expect(packet.error_status).to be_a RubySMB::Dcerpc::Ndr::NdrUint32
+    end
+  end
+
+  describe '#initialize_instance' do
+    it 'sets #opnum to CREATE_SERVICE_W constant' do
+      expect(packet.opnum).to eq(RubySMB::Dcerpc::Svcctl::CREATE_SERVICE_W)
+    end
+  end
+
+  it 'reads its own binary representation and outputs the same packet' do
+    packet = described_class.new(
+      lp_dw_tag_id: 3,
+      lp_sc_handle: {context_handle_attributes: 0, context_handle_uuid: '367abb81-9844-35f1-ad32-98f038001003'},
+      error_status: 3
+    )
+    binary = packet.to_binary_s
+    expect(described_class.read(binary)).to eq(packet)
+  end
+end

data/spec/lib/ruby_smb/dcerpc/svcctl/delete_service_request_spec.rb

@@ -0,0 +1,29 @@
+RSpec.describe RubySMB::Dcerpc::Svcctl::DeleteServiceRequest do
+  subject(:packet) { described_class.new }
+
+  it { is_expected.to respond_to :lp_sc_handle }
+
+  it 'is little endian' do
+    expect(described_class.fields.instance_variable_get(:@hints)[:endian]).to eq :little
+  end
+
+  describe '#lp_sc_handle' do
+    it 'is a ScRpcHandle structure' do
+      expect(packet.lp_sc_handle).to be_a RubySMB::Dcerpc::Svcctl::ScRpcHandle
+    end
+  end
+
+  describe '#initialize_instance' do
+    it 'sets #opnum to DELETE_SERVICE constant' do
+      expect(packet.opnum).to eq(RubySMB::Dcerpc::Svcctl::DELETE_SERVICE)
+    end
+  end
+
+  it 'reads its own binary representation and outputs the same packet' do
+    packet = described_class.new(
+      lp_sc_handle: {context_handle_attributes: 0, context_handle_uuid: '367abb81-9844-35f1-ad32-98f038001003'}
+    )
+    binary = packet.to_binary_s
+    expect(described_class.read(binary)).to eq(packet)
+  end
+end

data/spec/lib/ruby_smb/dcerpc/svcctl/delete_service_response_spec.rb

@@ -0,0 +1,29 @@
+RSpec.describe RubySMB::Dcerpc::Svcctl::DeleteServiceResponse do
+  subject(:packet) { described_class.new }
+
+  it { is_expected.to respond_to :error_status }
+
+  it 'is little endian' do
+    expect(described_class.fields.instance_variable_get(:@hints)[:endian]).to eq :little
+  end
+
+  describe '#error_status' do
+    it 'is a NdrUint32' do
+      expect(packet.error_status).to be_a RubySMB::Dcerpc::Ndr::NdrUint32
+    end
+  end
+
+  describe '#initialize_instance' do
+    it 'sets #opnum to DELETE_SERVICE constant' do
+      expect(packet.opnum).to eq(RubySMB::Dcerpc::Svcctl::DELETE_SERVICE)
+    end
+  end
+
+  it 'reads its own binary representation and outputs the same packet' do
+    packet = described_class.new(
+      error_status: 3
+    )
+    binary = packet.to_binary_s
+    expect(described_class.read(binary)).to eq(packet)
+  end
+end

data/spec/lib/ruby_smb/dcerpc/winreg/open_root_key_request_spec.rb

@@ -57,30 +57,30 @@ RSpec.describe RubySMB::Dcerpc::Winreg::OpenRootKeyRequest do
     end
 
     context 'when #opnum is not OPEN_HKPD, OPEN_HKPT or OPEN_HKPN' do
-      it 'sets the #sam_desired.maximum flag' do
+      it 'sets the #sam_desired.maximum_allowed flag' do
         packet = described_class.new(opnum: RubySMB::Dcerpc::Winreg::OPEN_HKCR)
-        expect(packet.sam_desired.maximum).to eq(1)
+        expect(packet.sam_desired.maximum_allowed).to eq(1)
       end
     end
 
     context 'when #opnum is OPEN_HKPD' do
-      it 'does not set the #sam_desired.maximum flag' do
+      it 'does not set the #sam_desired.maximum_allowed flag' do
         packet = described_class.new(opnum: RubySMB::Dcerpc::Winreg::OPEN_HKPD)
-        expect(packet.sam_desired.maximum).to eq(0)
+        expect(packet.sam_desired.maximum_allowed).to eq(0)
       end
     end
 
     context 'when #opnum is OPEN_HKPT' do
-      it 'does not set the #sam_desired.maximum flag' do
+      it 'does not set the #sam_desired.maximum_allowed flag' do
         packet = described_class.new(opnum: RubySMB::Dcerpc::Winreg::OPEN_HKPT)
-        expect(packet.sam_desired.maximum).to eq(0)
+        expect(packet.sam_desired.maximum_allowed).to eq(0)
       end
     end
 
     context 'when #opnum is OPEN_HKPN' do
-      it 'does not set the #sam_desired.maximum flag' do
+      it 'does not set the #sam_desired.maximum_allowed flag' do
         packet = described_class.new(opnum: RubySMB::Dcerpc::Winreg::OPEN_HKPN)
-        expect(packet.sam_desired.maximum).to eq(0)
+        expect(packet.sam_desired.maximum_allowed).to eq(0)
       end
     end
   end

data/spec/lib/ruby_smb/dcerpc/winreg/regsam_spec.rb

@@ -22,7 +22,7 @@ RSpec.describe RubySMB::Dcerpc::Winreg::Regsam do
   it { is_expected.to respond_to :generic_execute }
   it { is_expected.to respond_to :generic_all }
   it { is_expected.to respond_to :reserved4 }
-  it { is_expected.to respond_to :maximum }
+  it { is_expected.to respond_to :maximum_allowed }
   it { is_expected.to respond_to :system_security }
 
 

data/spec/lib/ruby_smb/dcerpc/winreg_spec.rb

@@ -755,7 +755,7 @@ RSpec.describe RubySMB::Dcerpc::Winreg do
         lp_sub_key:             sub_key,
         lp_class:               :null,
         dw_options:             RubySMB::Dcerpc::Winreg::CreateKeyRequest::REG_KEY_TYPE_VOLATILE,
-        sam_desired:            RubySMB::Dcerpc::Winreg::Regsam.new(maximum: 1),
+        sam_desired:            RubySMB::Dcerpc::Winreg::Regsam.new(maximum_allowed: 1),
         lp_security_attributes: RubySMB::Dcerpc::RpcSecurityAttributes.new,
         lpdw_disposition:       RubySMB::Dcerpc::Winreg::CreateKeyRequest::REG_CREATED_NEW_KEY
       }

data/spec/lib/ruby_smb/smb1/bit_field/directory_access_mask_spec.rb

@@ -19,7 +19,7 @@ RSpec.describe RubySMB::SMB1::BitField::DirectoryAccessMask do
   it { is_expected.to respond_to :generic_write }
   it { is_expected.to respond_to :generic_execute }
   it { is_expected.to respond_to :generic_all }
-  it { is_expected.to respond_to :maximum }
+  it { is_expected.to respond_to :maximum_allowed }
   it { is_expected.to respond_to :system_security }
 
   it 'is little endian' do
@@ -146,12 +146,12 @@ RSpec.describe RubySMB::SMB1::BitField::DirectoryAccessMask do
     it_behaves_like 'bit field with one flag set', :system_security, 'V', 0x01000000
   end
 
-  describe '#maximum' do
+  describe '#maximum_allowed' do
     it 'should be a 1-bit field per the SMB spec' do
-      expect(flags.maximum).to be_a BinData::Bit1
+      expect(flags.maximum_allowed).to be_a BinData::Bit1
     end
 
-    it_behaves_like 'bit field with one flag set', :maximum, 'V', 0x02000000
+    it_behaves_like 'bit field with one flag set', :maximum_allowed, 'V', 0x02000000
   end
 
   describe '#generic_all' do

data/spec/lib/ruby_smb/smb1/bit_field/file_access_mask_spec.rb

@@ -19,7 +19,7 @@ RSpec.describe RubySMB::SMB1::BitField::FileAccessMask do
   it { is_expected.to respond_to :generic_write }
   it { is_expected.to respond_to :generic_execute }
   it { is_expected.to respond_to :generic_all }
-  it { is_expected.to respond_to :maximum }
+  it { is_expected.to respond_to :maximum_allowed }
   it { is_expected.to respond_to :system_security }
 
   it 'is little endian' do
@@ -146,12 +146,12 @@ RSpec.describe RubySMB::SMB1::BitField::FileAccessMask do
     it_behaves_like 'bit field with one flag set', :system_security, 'V', 0x01000000
   end
 
-  describe '#maximum' do
+  describe '#maximum_allowed' do
     it 'should be a 1-bit field per the SMB spec' do
-      expect(flags.maximum).to be_a BinData::Bit1
+      expect(flags.maximum_allowed).to be_a BinData::Bit1
     end
 
-    it_behaves_like 'bit field with one flag set', :maximum, 'V', 0x02000000
+    it_behaves_like 'bit field with one flag set', :maximum_allowed, 'V', 0x02000000
   end
 
   describe '#generic_all' do

data/spec/lib/ruby_smb/smb1/tree_spec.rb

@@ -118,6 +118,11 @@ RSpec.describe RubySMB::SMB1::Tree do
         end
         tree.open_file(filename: unicode_filename.chop)
       end
+
+      it 'removes the leading \\ from the filename if needed' do
+        expect(tree).to receive(:_open).with(filename: filename)
+        tree.open_file(filename: '\\' + filename)
+      end
     end
 
     describe 'flags' do

data/spec/lib/ruby_smb/smb2/bit_field/directory_access_mask_spec.rb

@@ -19,7 +19,7 @@ RSpec.describe RubySMB::SMB2::BitField::DirectoryAccessMask do
   it { is_expected.to respond_to :generic_write }
   it { is_expected.to respond_to :generic_execute }
   it { is_expected.to respond_to :generic_all }
-  it { is_expected.to respond_to :maximum }
+  it { is_expected.to respond_to :maximum_allowed }
   it { is_expected.to respond_to :system_security }
 
   it 'is little endian' do
@@ -146,12 +146,12 @@ RSpec.describe RubySMB::SMB2::BitField::DirectoryAccessMask do
     it_behaves_like 'bit field with one flag set', :system_security, 'V', 0x01000000
   end
 
-  describe '#maximum' do
+  describe '#maximum_allowed' do
     it 'should be a 1-bit field per the SMB spec' do
-      expect(flags.maximum).to be_a BinData::Bit1
+      expect(flags.maximum_allowed).to be_a BinData::Bit1
     end
 
-    it_behaves_like 'bit field with one flag set', :maximum, 'V', 0x02000000
+    it_behaves_like 'bit field with one flag set', :maximum_allowed, 'V', 0x02000000
   end
 
   describe '#generic_all' do

data/spec/lib/ruby_smb/smb2/bit_field/file_access_mask_spec.rb

@@ -19,7 +19,7 @@ RSpec.describe RubySMB::SMB2::BitField::FileAccessMask do
   it { is_expected.to respond_to :generic_write }
   it { is_expected.to respond_to :generic_execute }
   it { is_expected.to respond_to :generic_all }
-  it { is_expected.to respond_to :maximum }
+  it { is_expected.to respond_to :maximum_allowed }
   it { is_expected.to respond_to :system_security }
 
   it 'is little endian' do
@@ -146,12 +146,12 @@ RSpec.describe RubySMB::SMB2::BitField::FileAccessMask do
     it_behaves_like 'bit field with one flag set', :system_security, 'V', 0x01000000
   end
 
-  describe '#maximum' do
+  describe '#maximum_allowed' do
     it 'should be a 1-bit field per the SMB spec' do
-      expect(flags.maximum).to be_a BinData::Bit1
+      expect(flags.maximum_allowed).to be_a BinData::Bit1
     end
 
-    it_behaves_like 'bit field with one flag set', :maximum, 'V', 0x02000000
+    it_behaves_like 'bit field with one flag set', :maximum_allowed, 'V', 0x02000000
   end
 
   describe '#generic_all' do

data/spec/lib/ruby_smb/smb2/tree_spec.rb

@@ -348,6 +348,11 @@ RSpec.describe RubySMB::SMB2::Tree do
         end
         tree.open_file(filename: filename)
       end
+
+       it 'removes the leading \\ from the filename if needed' do
+        expect(tree).to receive(:_open).with(filename: filename)
+        tree.open_file(filename: "\\".encode('UTF-16LE') + filename)
+      end
     end
 
     describe 'attributes' do
@@ -544,7 +549,7 @@ RSpec.describe RubySMB::SMB2::Tree do
       tree.open_pipe(**opts)
     end
 
-    it 'remove the leading \\ from the filename if needed' do
+    it 'removes the leading \\ from the filename if needed' do
       expect(tree).to receive(:_open).with(filename: 'test', write: true)
       tree.open_pipe(**opts)
     end

data/spec/spec_helper.rb

@@ -1,8 +1,7 @@
 require 'simplecov'
 
-SimpleCov.start do
-  add_filter '/spec/'
-end
+SimpleCov.start unless SimpleCov.running
+SimpleCov.add_filter '/spec/'
 
 require 'coveralls'
 require 'ruby_smb'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby_smb
 version: !ruby/object:Gem::Version
-  version: 3.0.3
+  version: 3.0.6
 platform: ruby
 authors:
 - Metasploit Hackers
@@ -97,7 +97,7 @@ cert_chain:
   EknWpNgVhohbot1lfVAMmIhdtOVaRVcQQixWPwprDj/ydB8ryDMDosIMcw+fkoXU
   9GJsSaSRRYQ9UUkVL27b64okU8D48m8=
   -----END CERTIFICATE-----
-date: 2022-02-11 00:00:00.000000000 Z
+date: 2022-04-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: redcarpet
@@ -189,14 +189,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.3
+        version: 0.1.4
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.3
+        version: 0.1.4
 - !ruby/object:Gem::Dependency
   name: bindata
   requirement: !ruby/object:Gem::Requirement
@@ -272,6 +272,7 @@ files:
 - examples/negotiate_with_netbios_service.rb
 - examples/net_share_enum_all.rb
 - examples/pipes.rb
+- examples/pwsh_service.rb
 - examples/query_service_status.rb
 - examples/read_file.rb
 - examples/read_file_encryption.rb
@@ -371,6 +372,10 @@ files:
 - lib/ruby_smb/dcerpc/svcctl/close_service_handle_response.rb
 - lib/ruby_smb/dcerpc/svcctl/control_service_request.rb
 - lib/ruby_smb/dcerpc/svcctl/control_service_response.rb
+- lib/ruby_smb/dcerpc/svcctl/create_service_w_request.rb
+- lib/ruby_smb/dcerpc/svcctl/create_service_w_response.rb
+- lib/ruby_smb/dcerpc/svcctl/delete_service_request.rb
+- lib/ruby_smb/dcerpc/svcctl/delete_service_response.rb
 - lib/ruby_smb/dcerpc/svcctl/open_sc_manager_w_request.rb
 - lib/ruby_smb/dcerpc/svcctl/open_sc_manager_w_response.rb
 - lib/ruby_smb/dcerpc/svcctl/open_service_w_request.rb
@@ -670,6 +675,10 @@ files:
 - spec/lib/ruby_smb/dcerpc/svcctl/close_service_handle_response_spec.rb
 - spec/lib/ruby_smb/dcerpc/svcctl/control_service_request_spec.rb
 - spec/lib/ruby_smb/dcerpc/svcctl/control_service_response_spec.rb
+- spec/lib/ruby_smb/dcerpc/svcctl/create_service_w_request_spec.rb
+- spec/lib/ruby_smb/dcerpc/svcctl/create_service_w_response_spec.rb
+- spec/lib/ruby_smb/dcerpc/svcctl/delete_service_request_spec.rb
+- spec/lib/ruby_smb/dcerpc/svcctl/delete_service_response_spec.rb
 - spec/lib/ruby_smb/dcerpc/svcctl/open_sc_manager_w_request_spec.rb
 - spec/lib/ruby_smb/dcerpc/svcctl/open_sc_manager_w_response_spec.rb
 - spec/lib/ruby_smb/dcerpc/svcctl/open_service_w_request_spec.rb
@@ -950,6 +959,10 @@ test_files:
 - spec/lib/ruby_smb/dcerpc/svcctl/close_service_handle_response_spec.rb
 - spec/lib/ruby_smb/dcerpc/svcctl/control_service_request_spec.rb
 - spec/lib/ruby_smb/dcerpc/svcctl/control_service_response_spec.rb
+- spec/lib/ruby_smb/dcerpc/svcctl/create_service_w_request_spec.rb
+- spec/lib/ruby_smb/dcerpc/svcctl/create_service_w_response_spec.rb
+- spec/lib/ruby_smb/dcerpc/svcctl/delete_service_request_spec.rb
+- spec/lib/ruby_smb/dcerpc/svcctl/delete_service_response_spec.rb
 - spec/lib/ruby_smb/dcerpc/svcctl/open_sc_manager_w_request_spec.rb
 - spec/lib/ruby_smb/dcerpc/svcctl/open_sc_manager_w_response_spec.rb
 - spec/lib/ruby_smb/dcerpc/svcctl/open_service_w_request_spec.rb

metadata.gz.sig

@@ -1 +1,2 @@
-��d����3��xߦ��(��X��q�"�2�
�=�|;3�AQn���e8���u�8��s��4���-`����=�w^��"+$R�X`J�Z8J���#K�>M^
+f����Jہ�X�3~�a��άo+ �2������	��|�0�nr�%��Op�K,�}y��yn:TRBP�šBx=aN�&�h)M�߫��Y!)ԛ}au:#{�P��`��O5b�?lJo%7�\�IM�F.�^�_���90+����x�
+�������;���'��L�Y�^w%�!���"*�������
+�J��u�l�lź�$�_��7B`pdɰ�4��ӓ�/Ë��I���.��o��#S�v�f�o�=I�w�8ڳ�Vv�]�˃��u��2��~�x����jj�`���l?'B����Ip��E�?�^�
���GW�����Yq�^'Ӷ���y{P��y����K&K&��8�<��Q�^��p�kS��F1�󯧾G�t"�瓺evoc.����