ruby_smb 0.0.18 → 0.0.19

data/lib/ruby_smb/nbss/negative_session_response.rb

@@ -0,0 +1,30 @@
+module RubySMB
+  module Nbss
+
+
+    # Representation of the NetBIOS Negative Session Service Response packet as defined in
+    # [4.3.4 SESSION REQUEST PACKET](https://tools.ietf.org/html/rfc1002)
+    class NegativeSessionResponse < BinData::Record
+      endian :big
+
+      session_header :session_header
+      uint8          :error_code, label: 'Error Code'
+
+      def error_msg
+        case error_code
+        when 0x80
+          'Not listening on called name'
+        when 0x81
+          'Not listening for calling name'
+        when 0x82
+          'Called name not present'
+        when 0x83
+          'Called name present, but insufficient resources'
+        when 0x8F
+          'Unspecified error'
+        end
+      end
+    end
+
+  end
+end

data/lib/ruby_smb/nbss/session_header.rb

@@ -0,0 +1,13 @@
+module RubySMB
+  module Nbss
+    # Representation of the NetBIOS Session Service Header as defined in
+    # [4.3.1 GENERAL FORMAT OF SESSION PACKETS](https://tools.ietf.org/html/rfc1002)
+    class SessionHeader < BinData::Record
+      endian :big
+
+      uint8  :session_packet_type, label: 'Session Packet Type'
+      uint8  :flags,               label: 'Flags',              initial_value: 0
+      uint16 :packet_length,       label: 'Packet Length'
+    end
+  end
+end

data/lib/ruby_smb/nbss/session_request.rb

@@ -0,0 +1,13 @@
+module RubySMB
+  module Nbss
+    # Representation of the NetBIOS Session Service Request packet as defined in
+    # [4.3.2 SESSION REQUEST PACKET](https://tools.ietf.org/html/rfc1002)
+    class SessionRequest < BinData::Record
+      endian :big
+
+      session_header :session_header
+      string         :called_name,  label: 'Called Name'
+      string         :calling_name, label: 'Calling Name'
+    end
+  end
+end

data/lib/ruby_smb/smb1.rb

@@ -1,19 +1,22 @@
-# This module adds the namespace for version 1 of the SMB Protocol
-# as defined in [MS-SMB](https://msdn.microsoft.com/en-us/library/cc246231.aspx)
-module RubySMB::SMB1
-  # Protocol ID value. Translates to \xFFSMB
-  SMB_PROTOCOL_ID = 0xFF534D42
+module RubySMB
+  # This module adds the namespace for version 1 of the SMB Protocol
+  # as defined in [MS-SMB](https://msdn.microsoft.com/en-us/library/cc246231.aspx)
+  module SMB1
+    # Protocol ID value. Translates to \xFFSMB
+    SMB_PROTOCOL_ID = 0xFF534D42
 
-  require 'ruby_smb/smb1/dispositions'
-  require 'ruby_smb/smb1/create_actions'
-  require 'ruby_smb/smb1/oplock_levels'
-  require 'ruby_smb/smb1/commands'
-  require 'ruby_smb/smb1/andx_block'
-  require 'ruby_smb/smb1/bit_field'
-  require 'ruby_smb/smb1/smb_header'
-  require 'ruby_smb/smb1/parameter_block'
-  require 'ruby_smb/smb1/data_block'
-  require 'ruby_smb/smb1/dialect'
-  require 'ruby_smb/smb1/packet'
-  require 'ruby_smb/smb1/tree'
+    require 'ruby_smb/smb1/create_actions'
+    require 'ruby_smb/smb1/oplock_levels'
+    require 'ruby_smb/smb1/resource_type'
+    require 'ruby_smb/smb1/commands'
+    require 'ruby_smb/smb1/andx_block'
+    require 'ruby_smb/smb1/bit_field'
+    require 'ruby_smb/smb1/smb_header'
+    require 'ruby_smb/smb1/parameter_block'
+    require 'ruby_smb/smb1/data_block'
+    require 'ruby_smb/smb1/dialect'
+    require 'ruby_smb/smb1/packet'
+    require 'ruby_smb/smb1/tree'
+    require 'ruby_smb/smb1/file'
+  end
 end

data/lib/ruby_smb/smb1/bit_field.rb

@@ -1,5 +1,6 @@
 module RubySMB
   module SMB1
+    # Namespace for SMB1 Bit Mask style field definitions
     module BitField
       require 'ruby_smb/smb1/bit_field/header_flags'
       require 'ruby_smb/smb1/bit_field/header_flags2'
@@ -18,6 +19,8 @@ module RubySMB
       require 'ruby_smb/smb1/bit_field/smb_nmpipe_status'
       require 'ruby_smb/smb1/bit_field/share_access'
       require 'ruby_smb/smb1/bit_field/create_options'
+      require 'ruby_smb/smb1/bit_field/security_flags'
+      require 'ruby_smb/smb1/bit_field/file_status_flags'
     end
   end
 end

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

@@ -1,10 +1,10 @@
 module RubySMB
   module SMB1
     module BitField
-
       # Represents a CreateOptions BitField as used by both the NT_CREATE_ANDX
       # and the NT_TRANSACT_CREATE Requests. The definition for this field can be found at
-      # [2.2.4.64.1 Request](https://msdn.microsoft.com/en-us/library/ee442175.aspx)
+      # [2.2.4.64.1 Request](https://msdn.microsoft.com/en-us/library/ee442175.aspx) and
+      # [2.2.4.9.1 Client Request Extensions](https://msdn.microsoft.com/en-us/library/cc246332.aspx)
       class CreateOptions < BinData::Record
         endian  :little
         bit1    :create_tree_connection,      label: 'Create Tree Connection'
@@ -27,12 +27,12 @@ module RubySMB
         # Byte Boundary
         bit1    :open_for_free_space_query,   label: 'Open for Free Space Query'
         bit1    :open_no_recall,              label: 'Open No Recall'
-        bit1    :reserved2,                   label: 'Reserved Space'
+        bit1    :open_reparse_point,          label: 'Open Reparse Point'
         bit1    :reserve_opfilter,            label: 'Reserve OPFilter'
         bit4    :reserved,                    label: 'Reserved Space'
         # Byte Boundary
-        bit8
+        bit8    :reserved2,                   label: 'Reserved Space'
       end
     end
   end
-end
+end

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

@@ -0,0 +1,18 @@
+module RubySMB
+  module SMB1
+    module BitField
+      # Represents a FileStatusFlags BitField as used by both the SMB_COM_NT_CREATE_ANDX
+      # and the NT_TRANSACT_CREATE Responses. The definition for this field can be found at
+      # [2.2.4.9.2 Server Response Extensions](https://msdn.microsoft.com/en-us/library/cc246334.aspx)
+      class FileStatusFlags < BinData::Record
+        endian  :little
+        bit5    :reserved,      label: 'Reserved'
+        bit1    :reparse_tag,   label: 'No Reparse Tag'
+        bit1    :no_substreams, label: 'No Data Sream'
+        bit1    :no_eas,        label: 'No Extended Attributes (EAs)'
+        # byte boundary
+        bit8    :reserved2,     label: 'Reserved'
+      end
+    end
+  end
+end

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

@@ -3,7 +3,7 @@ module RubySMB
     module BitField
       # The AccessMode bit-field for an SMB1 Open2 Request as defined in
       # [2.2.6.1.1 Request](https://msdn.microsoft.com/en-us/library/ee441733.aspx)
-      class Open2AccessMode< BinData::Record
+      class Open2AccessMode < BinData::Record
         endian  :little
         bit1    :reserved2,           label: 'Reserved Space'
         bit3    :sharing_mode,        label: 'Sharing Mode'
@@ -22,18 +22,18 @@ module RubySMB
         # ReadWrite, and Execute respectively.
         #
         # @param mode [Symbol] the access mode to set
-        def set_access_mode(mode=:r)
+        def set_access_mode(mode = :r)
           modes = [:r, :w, :rw, :x]
-          raise ArgumentError, "Mode must be one of #{modes.to_s}" unless modes.include? mode
+          raise ArgumentError, "Mode must be one of #{modes}" unless modes.include? mode
           case mode
-            when :r
-              self.access_mode = 0
-            when :w
-              self.access_mode = 1
-            when :rw
-              self.access_mode = 2
-            when :x
-              self.access_mode = 3
+          when :r
+            self.access_mode = 0
+          when :w
+            self.access_mode = 1
+          when :rw
+            self.access_mode = 2
+          when :x
+            self.access_mode = 3
           end
         end
       end

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

@@ -3,7 +3,7 @@ module RubySMB
     module BitField
       # The OpenMode bit-field for an SMB1 Open2 Request as defined in
       # [2.2.6.1.1 Request](https://msdn.microsoft.com/en-us/library/ee441733.aspx)
-      class Open2OpenMode< BinData::Record
+      class Open2OpenMode < BinData::Record
         endian  :little
         bit3    :reserved2,           label: 'Reserved Space'
         bit1    :create_file,         label: 'Create File Options'

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

@@ -12,7 +12,6 @@ module RubySMB
         bit1    :dfs,                   label: 'DFS Share',                  initial_value: 0
         bit1    :search,                label: 'Exclusive Search Bits',      initial_value: 1
         bit8    :reserved2,             label: 'Reserved Space',             initial_value: 0
-
       end
     end
   end

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

@@ -0,0 +1,15 @@
+module RubySMB
+  module SMB1
+    module BitField
+      # Represents a SecurityFlags BitField as used by both the SMB_COM_NT_CREATE_ANDX
+      # and the NT_TRANSACT_CREATE Requests. The definition for this field can be found at
+      # [2.2.4.64.1 Request](https://msdn.microsoft.com/en-us/library/ee442175.aspx)
+      class SecurityFlags < BinData::Record
+        endian  :little
+        bit6    :reserved,         label: 'Reserved Space'
+        bit1    :effective_only,   label: 'Effective Only'
+        bit1    :context_tracking, label: 'Context Tracking'
+      end
+    end
+  end
+end

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

@@ -1,11 +1,10 @@
 module RubySMB
   module SMB1
     module BitField
-
       # Represents a ShareAccess Bit-Field as defined in
       # [2.2.4.64.1 Request](https://msdn.microsoft.com/en-us/library/ee442175.aspx)
       class ShareAccess < BinData::Record
-        endian  :little
+        endian :little
         bit5  :reserved,        label: 'Reserved Space'
         bit1  :share_delete,    label: 'Share Delete Access'
         bit1  :share_write,     label: 'Share Write Access'
@@ -17,4 +16,4 @@ module RubySMB
       end
     end
   end
-end
+end

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

@@ -2,33 +2,30 @@ module RubySMB
   module SMB1
     module BitField
       # The bit-field for SMB1 Extended File Attributes as defined in
-      # [2.2.1.2.3 SMB_EXT_FILE_ATTR](https://msdn.microsoft.com/en-us/library/ee878573.aspx)
+      # [2.2.1.2.3 SMB_EXT_FILE_ATTR](https://msdn.microsoft.com/en-us/library/ee878573.aspx) and
+      # [2.2.1.2.1 Extended File Attribute (SMB_EXT_FILE_ATTR) Extensions](https://msdn.microsoft.com/en-us/library/cc246322.aspx)
       class SmbExtFileAttributes < BinData::Record
-        endian  :little
-        bit1  :normal,            label: 'Normal File'
-        bit1  :reserved,          label: 'Reserved Space'
-        bit1  :archive,           label: 'Archive'
-        bit1  :directory,         label: 'Directory'
-        bit1  :reserved2,         label: 'Reserved Space'
-        bit1  :system,            label: 'System File'
-        bit1  :hidden,            label: 'Hidden File'
-        bit1  :read_only,         label: 'Read Only'
+        endian :little
+        bit1  :normal,              label: 'Normal File'
+        bit1  :reserved,            label: 'Reserved Space'
+        bit1  :archive,             label: 'Archive'
+        bit1  :directory,           label: 'Directory'
+        bit1  :reserved2,           label: 'Reserved Space'
+        bit1  :system,              label: 'System File'
+        bit1  :hidden,              label: 'Hidden File'
+        bit1  :read_only,           label: 'Read Only'
         # Byte boundary
-        bit4  :reserved3,         label: 'Reserved Space'
-        bit1  :compressed,        label: 'Compressed File'
-        bit2  :reserved4,         label: 'Reserved Space'
-        bit1  :temporary,         label: 'Temporary File'
+        bit1  :reserved3,           label: 'Reserved Space'
+        bit1  :encrypted,           label: 'Encrypted'
+        bit1  :not_content_indexed, label: 'Not Content Indexed'
+        bit1  :offline,             label: 'Offline'
+        bit1  :compressed,          label: 'Compressed File'
+        bit1  :reparse_point,       label: 'Reparse Point'
+        bit1  :sparse,              label: 'Sparse File'
+        bit1  :temporary,           label: 'Temporary File'
         # Byte Boundary
-        bit8  :reserved5,         label: 'Reserved Space'
-        # Byte Boundary
-        bit1  :write_through,     label: 'Write through'
-        bit1  :reserved6,         label: 'Reserved Space'
-        bit1  :no_buffering,      label: 'Do not Buffer'
-        bit1  :random_access,     label: 'Random Access'
-        bit1  :sequential_scan,   label: 'Sequential Access'
-        bit1  :delete_on_close,   label: 'Delete on close'
-        bit1  :backup_semantics,  label: 'Backup Semantics'
-        bit1  :posix_semantics,   label: 'POSIX Semantics'
+        bit8  :reserved4,           label: 'Reserved Space'
+        bit8  :reserved5,           label: 'Reserved Space'
       end
     end
   end

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

@@ -4,7 +4,7 @@ module RubySMB
       # The Flags bit-field for SMB1 File Attributes as defined in
       # [2.2.1.2.4 SMB_FILE_ATTRIBUTES](https://msdn.microsoft.com/en-us/library/ee441551.aspx)
       class SmbFileAttributes < BinData::Record
-        endian  :little
+        endian :little
         bit2  :reserved,     label: 'Reserved Space'
         bit1  :archive,      label: 'Archive'
         bit1  :directory,    label: 'Directory'

data/lib/ruby_smb/smb1/commands.rb

@@ -1,7 +1,10 @@
 module RubySMB
   module SMB1
     module Commands
+      SMB_COM_CLOSE                   = 0x04
       SMB_COM_ECHO                    = 0x2B
+      SMB_COM_READ_ANDX               = 0x2E
+      SMB_COM_WRITE_ANDX              = 0x2F
       SMB_COM_TRANSACTION2            = 0x32
       SMB_COM_TRANSACTION2_SECONDARY  = 0x33
       SMB_COM_TREE_DISCONNECT         = 0x71
@@ -10,6 +13,8 @@ module RubySMB
       SMB_COM_LOGOFF                  = 0x74
       SMB_COM_TREE_CONNECT            = 0x75
       SMB_COM_NT_TRANSACT             = 0xA0
+      SMB_COM_NT_TRANSACT_SECONDARY   = 0xA1
+      SMB_COM_NT_CREATE_ANDX          = 0xA2
       SMB_COM_NO_ANDX_COMMAND         = 0xFF
     end
   end

data/lib/ruby_smb/smb1/create_actions.rb

@@ -4,19 +4,17 @@ module RubySMB
     # SMB_COM_NT_CREATE_ANDX responses. The definitions for these values can be found at
     # [2.2.7.1.2 Response](https://msdn.microsoft.com/en-us/library/ee441961.aspx)
     module CreateActions
-
       # An existing file was deleted and a new file was created in its place.
-      FILE_SUPERSEDED    = 0x00000000
+      FILE_SUPERSEDED = 0x00000000
 
       # An existing file was opened.
-      FILE_OPENED         = 0x00000001
+      FILE_OPENED = 0x00000001
 
       # A new file was created.
       FILE_CREATED       = 0x00000002
 
       # An existing file was overwritten.
       FILE_OVERWRITEN    = 0x00000003
-
     end
   end
-end
+end

data/lib/ruby_smb/smb1/file.rb

@@ -0,0 +1,289 @@
+module RubySMB
+  module SMB1
+    # Represents a file on the Remote server that we can perform
+    # various I/O operations on.
+    class File
+      # The {RubySMB::SMB1::Tree} that this file belong to
+      # @!attribute [rw] tree
+      #   @return [RubySMB::SMB1::Tree]
+      attr_accessor :tree
+
+      # The name of the file
+      # @!attribute [rw] name
+      #   @return [String]
+      attr_accessor :name
+
+      # The {SmbExtFileAttributes} for the file
+      # @!attribute [rw] attributes
+      #   @return [RubySMB::SMB1::BitField::SmbExtFileAttributes]
+      attr_accessor :attributes
+
+      # The file ID
+      # @!attribute [rw] fid
+      #   @return [Integer]
+      attr_accessor :fid
+
+      # The last access date/time for the file
+      # @!attribute [rw] last_access
+      #   @return [DateTime]
+      attr_accessor :last_access
+
+      # The last change date/time for the file
+      # @!attribute [rw] last_change
+      #   @return [DateTime]
+      attr_accessor :last_change
+
+      # The last write date/time for the file
+      # @!attribute [rw] last_write
+      #   @return [DateTime]
+      attr_accessor :last_write
+
+      # The actual size, in bytes, of the file
+      # @!attribute [rw] size
+      #   @return [Integer]
+      attr_accessor :size
+
+      # The size in bytes that the file occupies on disk
+      # @!attribute [rw] size_on_disk
+      #   @return [Integer]
+      attr_accessor :size_on_disk
+
+      def initialize(tree:, response:, name:)
+        raise ArgumentError, 'No tree provided' if tree.nil?
+        raise ArgumentError, 'No response provided' if response.nil?
+        raise ArgumentError, 'No file name provided' if name.nil?
+
+        @tree = tree
+        @name = name
+
+        @attributes   = response.parameter_block.ext_file_attributes
+        @fid          = response.parameter_block.fid
+        @last_access  = response.parameter_block.last_access_time.to_datetime
+        @last_change  = response.parameter_block.last_change_time.to_datetime
+        @last_write   = response.parameter_block.last_write_time.to_datetime
+        @size         = response.parameter_block.end_of_file
+        @size_on_disk = response.parameter_block.allocation_size
+      end
+
+      # Appends the supplied data to the end of the file.
+      #
+      # @param data [String] the data to write to the file
+      # @return [WindowsError::ErrorCode] the NTStatus code returned from the operation
+      def append(data:)
+        write(data: data, offset: @size)
+      end
+
+      # Closes the handle to the remote file.
+      #
+      # @return [WindowsError::ErrorCode] the NTStatus code returned by the operation
+      # @raise [RubySMB::Error::InvalidPacket] if the response command is not SMB_COM_CLOSE
+      # @raise [RubySMB::Error::UnexpectedStatusCode] if the response NTStatus is not STATUS_SUCCESS
+      def close
+        close_request = set_header_fields(RubySMB::SMB1::Packet::CloseRequest.new)
+        raw_response  = @tree.client.send_recv(close_request)
+        response = RubySMB::SMB1::Packet::CloseResponse.read(raw_response)
+        unless response.smb_header.command == RubySMB::SMB1::Commands::SMB_COM_CLOSE
+          raise RubySMB::Error::InvalidPacket, 'Not a CloseResponse packet'
+        end
+        unless response.status_code == WindowsError::NTStatus::STATUS_SUCCESS
+          raise RubySMB::Error::UnexpectedStatusCode, response.status_code.name
+        end
+        response.status_code
+      end
+
+      # Read from the file, a specific number of bytes
+      # from a specific offset. If no parameters are given
+      # it will read the entire file.
+      #
+      # @param bytes [Integer] the number of bytes to read
+      # @param offset [Integer] the byte offset in the file to start reading from
+      # @return [String] the data read from the file
+      # @raise [RubySMB::Error::InvalidPacket] if the response command is not SMB_COM_READ_ANDX
+      # @raise [RubySMB::Error::UnexpectedStatusCode] if the response NTStatus is not STATUS_SUCCESS
+      def read(bytes: @size, offset: 0)
+        atomic_read_size = if bytes > @tree.client.max_buffer_size
+                             @tree.client.max_buffer_size
+                           else
+                             bytes
+                           end
+        remaining_bytes = bytes
+        data = ''
+
+        loop do
+          read_request = read_packet(read_length: atomic_read_size, offset: offset)
+          raw_response = @tree.client.send_recv(read_request)
+          response = RubySMB::SMB1::Packet::ReadAndxResponse.read(raw_response)
+          unless response.smb_header.command == RubySMB::SMB1::Commands::SMB_COM_READ_ANDX
+            raise RubySMB::Error::InvalidPacket, 'Not a ReadAndxResponse packet'
+          end
+          unless response.status_code == WindowsError::NTStatus::STATUS_SUCCESS
+            raise RubySMB::Error::UnexpectedStatusCode, response.status_code.name
+          end
+
+          if response.is_a?(RubySMB::SMB1::Packet::ReadAndxResponse)
+            data << response.data_block.data.to_binary_s
+          else
+            # Returns the current data immediately if we got an empty packet with an
+            # SMB_COM_READ_ANDX command and a STATUS_SUCCESS (just in case)
+            return data
+          end
+
+          remaining_bytes -= atomic_read_size
+          break unless remaining_bytes > 0
+
+          offset += atomic_read_size
+          atomic_read_size = remaining_bytes if remaining_bytes < @tree.client.max_buffer_size
+        end
+
+        data
+      end
+
+      # Crafts the ReadRequest packet to be sent for read operations.
+      #
+      # @param bytes [Integer] the number of bytes to read
+      # @param offset [Integer] the byte offset in the file to start reading from
+      # @return [RubySMB::SMB1::Packet::ReadAndxRequest] the crafted ReadRequest packet
+      def read_packet(read_length: 0, offset: 0)
+        read_request = set_header_fields(RubySMB::SMB1::Packet::ReadAndxRequest.new)
+        read_request.parameter_block.max_count_of_bytes_to_return = read_length
+        read_request.parameter_block.offset = offset
+        read_request
+      end
+      
+      def send_recv_read(read_length: 0, offset: 0)
+        read_request = read_packet(read_length: read_length, offset: offset)
+        raw_response = tree.client.send_recv(read_request)
+        response = RubySMB::SMB1::Packet::ReadAndxResponse.read(raw_response)
+        response.data_block.data.to_binary_s
+      end
+
+      # Delete a file on close
+      #
+      # @return [WindowsError::ErrorCode] the NTStatus Response code
+      def delete
+        raw_response = @tree.client.send_recv(delete_packet)
+        response = RubySMB::SMB1::Packet::Trans2::SetFileInformationResponse.read(raw_response)
+        response.status_code
+      end
+
+      # Crafts the SetFileInformationRequest packet to be sent for delete operations.
+      #
+      # @return [RubySMB::SMB1::Packet::Trans2::SetFileInformationRequest] the set info packet
+      def delete_packet
+        delete_request = RubySMB::SMB1::Packet::Trans2::SetFileInformationRequest.new
+        delete_request = @tree.set_header_fields(delete_request)
+        delete_request.data_block.trans2_parameters.fid = @fid
+        passthrough_info_level = RubySMB::Fscc::FileInformation::FILE_DISPOSITION_INFORMATION +
+          RubySMB::Fscc::FileInformation::SMB_INFO_PASSTHROUGH
+        delete_request.data_block.trans2_parameters.information_level = passthrough_info_level
+        delete_request.data_block.trans2_data.info_level_struct.delete_pending = 1
+        set_trans2_params(delete_request)
+      end
+
+      # Write the supplied data to the file at the given offset.
+      #
+      # @param data [String] the data to write to the file
+      # @param offset [Integer] the offset in the file to start writing from
+      # @return [Integer] the count of bytes written
+      # @raise [RubySMB::Error::InvalidPacket] if the response command is not SMB_COM_WRITE_ANDX
+      # @raise [RubySMB::Error::UnexpectedStatusCode] if the response NTStatus is not STATUS_SUCCESS
+      def write(data:, offset: 0)
+        buffer = data.dup
+        bytes  = data.length
+        total_bytes_written = 0
+
+        loop do
+          atomic_write_size = if bytes > @tree.client.max_buffer_size
+                               @tree.client.max_buffer_size
+                              else
+                                bytes
+                              end
+          write_request = write_packet(data: buffer.slice!(0, atomic_write_size), offset: offset)
+          raw_response = @tree.client.send_recv(write_request)
+          response = RubySMB::SMB1::Packet::WriteAndxResponse.read(raw_response)
+          unless response.smb_header.command == RubySMB::SMB1::Commands::SMB_COM_WRITE_ANDX
+            raise RubySMB::Error::InvalidPacket, 'Not a WriteAndxResponse packet'
+          end
+          unless response.status_code == WindowsError::NTStatus::STATUS_SUCCESS
+            raise RubySMB::Error::UnexpectedStatusCode, response.status_code.name
+          end
+          bytes_written = response.parameter_block.count_low + (response.parameter_block.count_high << 16)
+          total_bytes_written += bytes_written
+          offset += bytes_written
+          bytes -= bytes_written
+          break unless buffer.length > 0
+        end
+
+        total_bytes_written
+      end
+
+      # Creates the Request packet for the #write command
+      #
+      # @param data [String] the data to write to the file
+      # @param offset [Integer] the offset in the file to start writing from
+      # @return [RubySMB::SMB1::Packet::WriteAndxRequest] the request packet
+      def write_packet(data:'', offset: 0)
+        write_request = set_header_fields(RubySMB::SMB1::Packet::WriteAndxRequest.new)
+        write_request.parameter_block.offset = offset
+        write_request.parameter_block.write_mode.writethrough_mode = 1
+        write_request.data_block.data = data
+        write_request.parameter_block.remaining = write_request.parameter_block.data_length
+        write_request
+      end
+      
+      def send_recv_write(data:'', offset: 0)
+        pkt = write_packet(data: data, offset: offset)
+        raw_response = @tree.client.send_recv(pkt)
+        response = RubySMB::SMB1::Packet::WriteAndxResponse.read(raw_response)
+        response.parameter_block.count_low
+      end
+
+      # Rename a file
+      #
+      # @param new_file_name [String] the new name
+      # @return [WindowsError::ErrorCode] the NTStatus Response code
+      def rename(new_file_name)
+        raw_response = tree.client.send_recv(rename_packet(new_file_name))
+        response = RubySMB::SMB1::Packet::Trans2::SetFileInformationResponse.read(raw_response)
+        response.status_code
+      end
+
+      # Crafts the SetFileInformationRequest packet to be sent for rename operations.
+      #
+      # @param new_file_name [String] the new name
+      # @return [RubySMB::SMB1::Packet::Trans2::SetFileInformationRequest] the set info packet
+      def rename_packet(new_file_name)
+        rename_request = RubySMB::SMB1::Packet::Trans2::SetFileInformationRequest.new
+        rename_request = @tree.set_header_fields(rename_request)
+        rename_request.data_block.trans2_parameters.fid = @fid
+        passthrough_info_level = RubySMB::Fscc::FileInformation::FILE_RENAME_INFORMATION +
+          RubySMB::Fscc::FileInformation::SMB_INFO_PASSTHROUGH
+        rename_request.data_block.trans2_parameters.information_level = passthrough_info_level
+        rename_request.data_block.trans2_data.info_level_struct.file_name = new_file_name.encode('utf-16le')
+        set_trans2_params(rename_request)
+      end
+
+      # Sets the header fields that we have to set on every packet
+      # we send for File operations.
+      #
+      # @param request [RubySMB::GenericPacket] the request packet to set fields on
+      # @return [RubySMB::GenericPacket] the modified request packet
+      def set_header_fields(request)
+        request = @tree.set_header_fields(request)
+        request.parameter_block.fid = @fid
+        request
+      end
+
+      # Sets ParameterBlock options for Trans2 requests
+      def set_trans2_params(request)
+        request.parameter_block.total_parameter_count = request.parameter_block.parameter_count
+        request.parameter_block.total_data_count      = request.parameter_block.data_count
+        request.parameter_block.max_parameter_count   = request.parameter_block.parameter_count
+        request.parameter_block.max_data_count        = 16_384
+        request
+      end
+      private :set_trans2_params
+
+    end
+  end
+end