776 lines
26 KiB
Python
776 lines
26 KiB
Python
|
|
# Copyright: (c) 2019, Jordan Borean (@jborean93) <jborean93@gmail.com>
|
||
|
|
# MIT License (see LICENSE or https://opensource.org/licenses/MIT)
|
||
|
|
|
||
|
|
from collections import OrderedDict
|
||
|
|
|
||
|
|
from smbprotocol.header import NtStatus
|
||
|
|
from smbprotocol.structure import (
|
||
|
|
BoolField,
|
||
|
|
BytesField,
|
||
|
|
DateTimeField,
|
||
|
|
EnumField,
|
||
|
|
FlagField,
|
||
|
|
IntField,
|
||
|
|
Structure,
|
||
|
|
UuidField,
|
||
|
|
)
|
||
|
|
|
||
|
|
|
||
|
|
class CreateContextName:
|
||
|
|
"""
|
||
|
|
[MS-SMB2] v53.0 2017-09-15
|
||
|
|
|
||
|
|
2.2.13.2 SMB2_CREATE_CONTEXT Request Values
|
||
|
|
Valid names for the name to set on a SMB2_CREATE_CONTEXT Request entry
|
||
|
|
"""
|
||
|
|
|
||
|
|
SMB2_CREATE_EA_BUFFER = b"\x45\x78\x74\x41"
|
||
|
|
|
||
|
|
# note: the structures for this are located in security_descriptor.py
|
||
|
|
SMB2_CREATE_SD_BUFFER = b"\x53\x65\x63\x44"
|
||
|
|
SMB2_CREATE_DURABLE_HANDLE_REQUEST = b"\x44\x48\x6e\x51"
|
||
|
|
SMB2_CREATE_DURABLE_HANDLE_RECONNECT = b"\x44\x48\x6e\x43"
|
||
|
|
SMB2_CREATE_ALLOCATION_SIZE = b"\x41\x6c\x53\x69"
|
||
|
|
SMB2_CREATE_QUERY_MAXIMAL_ACCESS_REQUEST = b"\x4d\x78\x41\x63"
|
||
|
|
SMB2_CREATE_TIMEWARP_TOKEN = b"\x54\x57\x72\x70"
|
||
|
|
SMB2_CREATE_QUERY_ON_DISK_ID = b"\x51\x46\x69\x64"
|
||
|
|
SMB2_CREATE_REQUEST_LEASE = b"\x52\x71\x4c\x73"
|
||
|
|
SMB2_CREATE_REQUEST_LEASE_V2 = b"\x52\x71\x4c\x73"
|
||
|
|
SMB2_CREATE_DURABLE_HANDLE_REQUEST_V2 = b"\x44\x48\x32\x51"
|
||
|
|
SMB2_CREATE_DURABLE_HANDLE_RECONNECT_V2 = b"\x44\x48\x32\x43"
|
||
|
|
SMB2_CREATE_APP_INSTANCE_ID = b"\x45\xbc\xa6\x6a\xef\xa7\xf7\x4a" b"\x90\x08\xfa\x46\x2e\x14\x4d\x74"
|
||
|
|
SMB2_CREATE_APP_INSTANCE_VERSION = b"\xb9\x82\xd0\xb7\x3b\x56\x07\x4f" b"\xa0\x7b\x52\x4a\x81\x16\xa0\x10"
|
||
|
|
SVHDX_OPEN_DEVICE_CONTEXT = b"\x9c\xcb\xcf\x9e\x04\xc1\xe6\x43" b"\x98\x0e\x15\x8d\xa1\xf6\xec\x83"
|
||
|
|
|
||
|
|
@staticmethod
|
||
|
|
def get_response_structure(name, size=None):
|
||
|
|
"""
|
||
|
|
Returns the response structure for a know list of create context
|
||
|
|
responses.
|
||
|
|
|
||
|
|
:param name: The constant value above
|
||
|
|
:param size: Specify the size of the context buffer, used to differenciate between REQUEST_LEASE and
|
||
|
|
REQUEST_LEASE_V2.
|
||
|
|
:return: The response structure or None if unknown
|
||
|
|
"""
|
||
|
|
# Special handling for request lease here the header name has the same value, use the size to differenciate.
|
||
|
|
if name == CreateContextName.SMB2_CREATE_REQUEST_LEASE:
|
||
|
|
return {
|
||
|
|
32: SMB2CreateResponseLease(),
|
||
|
|
52: SMB2CreateResponseLeaseV2(),
|
||
|
|
}.get(size, None)
|
||
|
|
|
||
|
|
return {
|
||
|
|
CreateContextName.SMB2_CREATE_DURABLE_HANDLE_REQUEST: SMB2CreateDurableHandleResponse(),
|
||
|
|
CreateContextName.SMB2_CREATE_DURABLE_HANDLE_RECONNECT: SMB2CreateDurableHandleReconnect(),
|
||
|
|
CreateContextName.SMB2_CREATE_QUERY_MAXIMAL_ACCESS_REQUEST: SMB2CreateQueryMaximalAccessResponse(),
|
||
|
|
CreateContextName.SMB2_CREATE_QUERY_ON_DISK_ID: SMB2CreateQueryOnDiskIDResponse(),
|
||
|
|
CreateContextName.SMB2_CREATE_DURABLE_HANDLE_REQUEST_V2: SMB2CreateDurableHandleResponseV2(),
|
||
|
|
CreateContextName.SMB2_CREATE_DURABLE_HANDLE_RECONNECT_V2: SMB2CreateDurableHandleReconnectV2,
|
||
|
|
CreateContextName.SMB2_CREATE_APP_INSTANCE_ID: SMB2CreateAppInstanceId(),
|
||
|
|
CreateContextName.SMB2_CREATE_APP_INSTANCE_VERSION: SMB2CreateAppInstanceVersion(),
|
||
|
|
}.get(name, None)
|
||
|
|
|
||
|
|
|
||
|
|
class EAFlags:
|
||
|
|
"""
|
||
|
|
[MS-FSCC]
|
||
|
|
|
||
|
|
2.4.15 FileFullEaInformation Flags
|
||
|
|
Specifies the flag used when setting extended attributes.
|
||
|
|
"""
|
||
|
|
|
||
|
|
NONE = 0x0000000
|
||
|
|
FILE_NEED_EA = 0x00000080
|
||
|
|
|
||
|
|
|
||
|
|
class LeaseState:
|
||
|
|
"""
|
||
|
|
[MS-SMB2]
|
||
|
|
|
||
|
|
2.2.13.2.8 SMB2_CREATE_REQUEST_LEASE LeaseState
|
||
|
|
The requested lease state, field is constructed with a combination of the
|
||
|
|
following values.
|
||
|
|
"""
|
||
|
|
|
||
|
|
SMB2_LEASE_NONE = 0x00
|
||
|
|
SMB2_LEASE_READ_CACHING = 0x01
|
||
|
|
SMB2_LEASE_HANDLE_CACHING = 0x02
|
||
|
|
SMB2_LEASE_WRITE_CACHING = 0x04
|
||
|
|
|
||
|
|
|
||
|
|
class LeaseRequestFlags:
|
||
|
|
"""
|
||
|
|
[MS-SMB2]
|
||
|
|
|
||
|
|
2.2.13.2.10 SMB2_CREATE_REQUEST_LEASE_V2
|
||
|
|
The flags to use on an SMB2CreateRequestLeaseV2 packet.
|
||
|
|
"""
|
||
|
|
|
||
|
|
SMB2_LEASE_FLAG_PARENT_LEASE_KEY_SET = 0x00000004
|
||
|
|
|
||
|
|
|
||
|
|
class LeaseResponseFlags:
|
||
|
|
"""
|
||
|
|
[MS-SMB2]
|
||
|
|
|
||
|
|
2.2.14.2.10 SMB2_CREATE_RESPONSE_LEASE
|
||
|
|
"""
|
||
|
|
|
||
|
|
SMB2_LEASE_FLAG_BREAK_IN_PROGRESS = 0x00000002
|
||
|
|
SMB2_LEASE_FLAG_PARENT_LEASE_KEY_SET = 0x00000004 # V2 Response
|
||
|
|
|
||
|
|
|
||
|
|
class DurableHandleFlags:
|
||
|
|
"""
|
||
|
|
[MS-SMB2]
|
||
|
|
|
||
|
|
2.2.13.2.11 SMB2_CREATE_DURABLE_HANDLE_REQUEST_V2
|
||
|
|
Flags used on an SMB2CreateDurableHandleRequestV2 packet.
|
||
|
|
"""
|
||
|
|
|
||
|
|
SMB2_DHANDLE_FLAG_PERSISTENT = 0x00000002
|
||
|
|
|
||
|
|
|
||
|
|
class SVHDXOriginatorFlags:
|
||
|
|
"""
|
||
|
|
[MS-RSVD] 2.2.4.12 SVHDX_OPEN_DEVICE_CONTEXT OriginatorFlags
|
||
|
|
Used to indicate which component has originated or issued the operations.
|
||
|
|
"""
|
||
|
|
|
||
|
|
SVHDX_ORIGINATOR_PVHDPARSER = 0x00000001
|
||
|
|
SVHDX_ORIGINATOR_VHDMP = 0x00000004
|
||
|
|
|
||
|
|
|
||
|
|
class SMB2CreateContextRequest(Structure):
|
||
|
|
"""
|
||
|
|
[MS-SMB2] v53.0 2017-09-15
|
||
|
|
|
||
|
|
2.2.13.2 SMB2_CREATE_CONTEXT Request Values
|
||
|
|
Structure used in the SMB2 CREATE Request and SMB2 CREATE Response to
|
||
|
|
encode additional flags and attributes
|
||
|
|
"""
|
||
|
|
|
||
|
|
def __init__(self):
|
||
|
|
self.fields = OrderedDict(
|
||
|
|
[
|
||
|
|
("next", IntField(size=4)),
|
||
|
|
("name_offset", IntField(size=2, default=16)),
|
||
|
|
("name_length", IntField(size=2, default=lambda s: len(s["buffer_name"]))),
|
||
|
|
("reserved", IntField(size=2)),
|
||
|
|
("data_offset", IntField(size=2, default=SMB2CreateContextRequest._buffer_data_offset)),
|
||
|
|
("data_length", IntField(size=4, default=lambda s: len(s["buffer_data"]))),
|
||
|
|
("buffer_name", BytesField(size=lambda s: s["name_length"].get_value())),
|
||
|
|
(
|
||
|
|
"padding",
|
||
|
|
BytesField(
|
||
|
|
size=SMB2CreateContextRequest._padding_size,
|
||
|
|
default=SMB2CreateContextRequest._default_padding_size,
|
||
|
|
),
|
||
|
|
),
|
||
|
|
("buffer_data", BytesField(size=lambda s: s["data_length"].get_value())),
|
||
|
|
# not actually a field but each list entry must start at the 8 byte
|
||
|
|
# alignment
|
||
|
|
(
|
||
|
|
"padding2",
|
||
|
|
BytesField(
|
||
|
|
size=SMB2CreateContextRequest._padding2_size,
|
||
|
|
default=SMB2CreateContextRequest._default_padding2_size,
|
||
|
|
),
|
||
|
|
),
|
||
|
|
]
|
||
|
|
)
|
||
|
|
super().__init__()
|
||
|
|
|
||
|
|
@staticmethod
|
||
|
|
def _buffer_data_offset(structure):
|
||
|
|
if structure["data_length"].get_value() == 0:
|
||
|
|
return 0
|
||
|
|
else:
|
||
|
|
return structure["name_offset"].get_value() + len(structure["buffer_name"]) + len(structure["padding"])
|
||
|
|
|
||
|
|
@staticmethod
|
||
|
|
def _padding_size(structure):
|
||
|
|
if structure["data_length"].get_value() == 0:
|
||
|
|
return 0
|
||
|
|
|
||
|
|
buffer_name_len = structure["name_length"].get_value()
|
||
|
|
mod = buffer_name_len % 8
|
||
|
|
return mod if mod == 0 else 8 - mod
|
||
|
|
|
||
|
|
@staticmethod
|
||
|
|
def _default_padding_size(structure):
|
||
|
|
return b"\x00" * SMB2CreateContextRequest._padding_size(structure)
|
||
|
|
|
||
|
|
@staticmethod
|
||
|
|
def _padding2_size(structure):
|
||
|
|
data_length = len(structure["buffer_name"]) + len(structure["padding"]) + len(structure["buffer_data"])
|
||
|
|
mod = data_length % 8
|
||
|
|
return mod if mod == 0 else 8 - mod
|
||
|
|
|
||
|
|
@staticmethod
|
||
|
|
def _default_padding2_size(structure):
|
||
|
|
return b"\x00" * SMB2CreateContextRequest._padding2_size(structure)
|
||
|
|
|
||
|
|
def get_context_data(self):
|
||
|
|
"""
|
||
|
|
Get the buffer_data value of a context response and try to convert it
|
||
|
|
to the relevant structure based on the buffer_name used. If it is an
|
||
|
|
unknown structure then the raw bytes are returned.
|
||
|
|
|
||
|
|
:return: relevant Structure of buffer_data or bytes if unknown name
|
||
|
|
"""
|
||
|
|
buffer_name = self["buffer_name"].get_value()
|
||
|
|
structure = CreateContextName.get_response_structure(buffer_name, size=self["data_length"].get_value())
|
||
|
|
if structure:
|
||
|
|
structure.unpack(self["buffer_data"].get_value())
|
||
|
|
return structure
|
||
|
|
else:
|
||
|
|
# unknown structure, just return the raw bytes
|
||
|
|
return self["buffer_data"].get_value()
|
||
|
|
|
||
|
|
@staticmethod
|
||
|
|
def pack_multiple(messages):
|
||
|
|
"""
|
||
|
|
Converts a list of SMB2CreateContextRequest structures and packs them
|
||
|
|
as a bytes object used when setting to the SMB2CreateRequest
|
||
|
|
buffer_contexts field. This should be used as it would calculate the
|
||
|
|
correct next field value for each context entry.
|
||
|
|
|
||
|
|
:param messages: List of SMB2CreateContextRequest structures
|
||
|
|
:return: bytes object that is set on the SMB2CreateRequest
|
||
|
|
buffer_contexts field.
|
||
|
|
"""
|
||
|
|
data = b""
|
||
|
|
msg_count = len(messages)
|
||
|
|
for i, msg in enumerate(messages):
|
||
|
|
if not isinstance(msg, SMB2CreateContextRequest):
|
||
|
|
buffer = msg
|
||
|
|
buffer_name = getattr(msg, "NAME", None)
|
||
|
|
if buffer_name is None:
|
||
|
|
raise ValueError(
|
||
|
|
"Invalid context message, must be either a SMB2CreateContextRequest or a "
|
||
|
|
"predefined structure object with NAME defined."
|
||
|
|
)
|
||
|
|
msg = SMB2CreateContextRequest()
|
||
|
|
msg["buffer_name"] = buffer_name
|
||
|
|
msg["buffer_data"] = buffer
|
||
|
|
|
||
|
|
if i == msg_count - 1:
|
||
|
|
msg["next"] = 0
|
||
|
|
else:
|
||
|
|
# because the end padding2 val won't be populated if the entry
|
||
|
|
# offset is 0, we set to 1 so the len calc is correct
|
||
|
|
msg["next"] = 1
|
||
|
|
msg["next"] = len(msg)
|
||
|
|
|
||
|
|
data += msg.pack()
|
||
|
|
return data
|
||
|
|
|
||
|
|
|
||
|
|
class SMB2CreateEABuffer(Structure):
|
||
|
|
"""
|
||
|
|
[MS-SMB2] 2.2.13.2.1 SMB2_CREATE_EA_BUFFER
|
||
|
|
[MS-FSCC] 2.4.15 FileFullEaInformation
|
||
|
|
|
||
|
|
Used to apply extended attributes as part of creating a new file.
|
||
|
|
"""
|
||
|
|
|
||
|
|
NAME = CreateContextName.SMB2_CREATE_EA_BUFFER
|
||
|
|
|
||
|
|
def __init__(self):
|
||
|
|
self.fields = OrderedDict(
|
||
|
|
[
|
||
|
|
# 0 if no more entries, otherwise offset after ea_value
|
||
|
|
("next_entry_offset", IntField(size=4)),
|
||
|
|
("flags", FlagField(size=1, flag_type=EAFlags)),
|
||
|
|
("ea_name_length", IntField(size=1, default=lambda s: len(s["ea_name"]) - 1)), # minus \x00
|
||
|
|
("ea_value_length", IntField(size=2, default=lambda s: len(s["ea_value"]))),
|
||
|
|
# ea_name is ASCII byte encoded and needs a null terminator '\x00'
|
||
|
|
("ea_name", BytesField(size=lambda s: s["ea_name_length"].get_value() + 1)),
|
||
|
|
("ea_value", BytesField(size=lambda s: s["ea_value_length"].get_value())),
|
||
|
|
# not actually a field but each list entry must start at the 4 byte
|
||
|
|
# alignment
|
||
|
|
(
|
||
|
|
"padding",
|
||
|
|
BytesField(size=SMB2CreateEABuffer._padding_size, default=SMB2CreateEABuffer._default_padding_size),
|
||
|
|
),
|
||
|
|
]
|
||
|
|
)
|
||
|
|
super().__init__()
|
||
|
|
|
||
|
|
@staticmethod
|
||
|
|
def _padding_size(structure):
|
||
|
|
if structure["next_entry_offset"].get_value() == 0:
|
||
|
|
return 0
|
||
|
|
|
||
|
|
data_length = len(structure["ea_name"]) + len(structure["ea_value"])
|
||
|
|
mod = data_length % 4
|
||
|
|
return mod if mod == 0 else 4 - mod
|
||
|
|
|
||
|
|
@staticmethod
|
||
|
|
def _default_padding_size(structure):
|
||
|
|
return b"\x00" * SMB2CreateEABuffer._padding_size(structure)
|
||
|
|
|
||
|
|
@staticmethod
|
||
|
|
def pack_multiple(messages):
|
||
|
|
"""
|
||
|
|
Converts a list of SMB2CreateEABuffer structures and packs them as a
|
||
|
|
bytes object used when setting to the SMB2CreateContextRequest
|
||
|
|
buffer_data field. This should be used as it would calculate the
|
||
|
|
correct next_entry_offset field value for each buffer entry.
|
||
|
|
|
||
|
|
:param messages: List of SMB2CreateEABuffer structures
|
||
|
|
:return: bytes object that is set on the SMB2CreateContextRequest
|
||
|
|
buffer_data field.
|
||
|
|
"""
|
||
|
|
data = b""
|
||
|
|
msg_count = len(messages)
|
||
|
|
for i, msg in enumerate(messages):
|
||
|
|
if i == msg_count - 1:
|
||
|
|
msg["next_entry_offset"] = 0
|
||
|
|
else:
|
||
|
|
# because the end padding val won't be populated if the entry
|
||
|
|
# offset is 0, we set to 1 so the len calc is correct
|
||
|
|
msg["next_entry_offset"] = 1
|
||
|
|
msg["next_entry_offset"] = len(msg)
|
||
|
|
data += msg.pack()
|
||
|
|
|
||
|
|
return data
|
||
|
|
|
||
|
|
|
||
|
|
class SMB2CreateDurableHandleRequest(Structure):
|
||
|
|
"""
|
||
|
|
[MS-SMB2] 2.2.13.2.3 SMB2_CREATE_DURABLE_HANDLE_REQUEST
|
||
|
|
|
||
|
|
Used by the client to mark the open as a durable open.
|
||
|
|
"""
|
||
|
|
|
||
|
|
NAME = CreateContextName.SMB2_CREATE_DURABLE_HANDLE_REQUEST
|
||
|
|
|
||
|
|
def __init__(self):
|
||
|
|
self.fields = OrderedDict([("durable_request", BytesField(size=16, default=b"\x00" * 16))])
|
||
|
|
super().__init__()
|
||
|
|
|
||
|
|
|
||
|
|
class SMB2CreateDurableHandleResponse(Structure):
|
||
|
|
"""
|
||
|
|
[MS-SMB2] 2.2.14.2.3 SMB2_CREATE_DURABLE_HANDLE_RESPONSE
|
||
|
|
|
||
|
|
Sent by the server in response to an SMB2CreateDurableHandleRequest packet.
|
||
|
|
"""
|
||
|
|
|
||
|
|
def __init__(self):
|
||
|
|
self.fields = OrderedDict([("reserved", IntField(size=8))])
|
||
|
|
super().__init__()
|
||
|
|
|
||
|
|
|
||
|
|
class SMB2CreateDurableHandleReconnect(Structure):
|
||
|
|
"""
|
||
|
|
[MS-SMB2] 2.2.13.2.4 SMB2_CREATE_DURABLE_HANDLE_RECONNECT
|
||
|
|
|
||
|
|
Used by the client when attempting to reestablish a durable open
|
||
|
|
"""
|
||
|
|
|
||
|
|
NAME = CreateContextName.SMB2_CREATE_DURABLE_HANDLE_RECONNECT
|
||
|
|
|
||
|
|
def __init__(self):
|
||
|
|
self.fields = OrderedDict([("data", BytesField(size=16))])
|
||
|
|
super().__init__()
|
||
|
|
|
||
|
|
|
||
|
|
class SMB2CreateQueryMaximalAccessRequest(Structure):
|
||
|
|
"""
|
||
|
|
[MS-SMB2] 2.2.13.2.5 SMB2_CREATE_QUERY_MAXIMAL_ACCESS_REQUEST
|
||
|
|
|
||
|
|
Used by the client to retrieve maximal access information as part of
|
||
|
|
processing the open.
|
||
|
|
"""
|
||
|
|
|
||
|
|
NAME = CreateContextName.SMB2_CREATE_QUERY_MAXIMAL_ACCESS_REQUEST
|
||
|
|
|
||
|
|
def __init__(self):
|
||
|
|
self.fields = OrderedDict([("timestamp", DateTimeField())])
|
||
|
|
super().__init__()
|
||
|
|
|
||
|
|
|
||
|
|
class SMB2CreateQueryMaximalAccessResponse(Structure):
|
||
|
|
"""
|
||
|
|
[MS-SMB2] 2.2.14.2.5 SMB2_CREATE_QUERY_MAXIMAL_ACCESS_RESPONSE
|
||
|
|
|
||
|
|
Used by the server in response to an SMB2CreateQueryMaximalAccessRequest
|
||
|
|
packet.
|
||
|
|
"""
|
||
|
|
|
||
|
|
def __init__(self):
|
||
|
|
self.fields = OrderedDict(
|
||
|
|
[
|
||
|
|
("query_status", EnumField(size=4, enum_type=NtStatus, enum_strict=False)),
|
||
|
|
# either FilePipePrinterAccessMask or DirectoryAccessMask
|
||
|
|
("maximal_access", IntField(size=4)),
|
||
|
|
]
|
||
|
|
)
|
||
|
|
super().__init__()
|
||
|
|
|
||
|
|
|
||
|
|
class SMB2CreateAllocationSize(Structure):
|
||
|
|
"""
|
||
|
|
[MS-SMB2] 2.2.13.2.6 SMB2_CREATE_ALLOCATION_SIZE
|
||
|
|
|
||
|
|
Used by the client to set the allocation size of a file that is being
|
||
|
|
newly created or overwritten.
|
||
|
|
"""
|
||
|
|
|
||
|
|
NAME = CreateContextName.SMB2_CREATE_ALLOCATION_SIZE
|
||
|
|
|
||
|
|
def __init__(self):
|
||
|
|
self.fields = OrderedDict([("allocation_size", IntField(size=8))])
|
||
|
|
super().__init__()
|
||
|
|
|
||
|
|
|
||
|
|
class SMB2CreateTimewarpToken(Structure):
|
||
|
|
"""
|
||
|
|
[MS-SMB2] 2.2.13.2.7 SMB2_CREATE_TIMEWARP_TOKEN
|
||
|
|
|
||
|
|
Used by the client when requesting the server to open a version of the file
|
||
|
|
at a previous point in time.
|
||
|
|
"""
|
||
|
|
|
||
|
|
NAME = CreateContextName.SMB2_CREATE_TIMEWARP_TOKEN
|
||
|
|
|
||
|
|
def __init__(self):
|
||
|
|
self.fields = OrderedDict([("timestamp", DateTimeField())])
|
||
|
|
super().__init__()
|
||
|
|
|
||
|
|
|
||
|
|
class SMB2CreateRequestLease(Structure):
|
||
|
|
"""
|
||
|
|
[MS-SMB2] 2.2.13.2.8 SMB2_CREATE_REQUEST_LEASE
|
||
|
|
|
||
|
|
Used by the cliet when requesting the server to return a lease.
|
||
|
|
"""
|
||
|
|
|
||
|
|
NAME = CreateContextName.SMB2_CREATE_REQUEST_LEASE
|
||
|
|
|
||
|
|
def __init__(self):
|
||
|
|
self.fields = OrderedDict(
|
||
|
|
[
|
||
|
|
("lease_key", BytesField(size=16)),
|
||
|
|
("lease_state", FlagField(size=4, flag_type=LeaseState)),
|
||
|
|
("lease_flags", IntField(size=4)),
|
||
|
|
("lease_duration", IntField(size=8)),
|
||
|
|
]
|
||
|
|
)
|
||
|
|
super().__init__()
|
||
|
|
|
||
|
|
|
||
|
|
class SMB2CreateResponseLease(Structure):
|
||
|
|
"""
|
||
|
|
[MS-SMB2] 2.2.14.2.10 SMB2_CREATE_RESPONSE_LEASE
|
||
|
|
|
||
|
|
Sent by the server in response to an SMB2CreateRequestLease
|
||
|
|
"""
|
||
|
|
|
||
|
|
def __init__(self):
|
||
|
|
self.fields = OrderedDict(
|
||
|
|
[
|
||
|
|
("lease_key", BytesField(size=16)),
|
||
|
|
("lease_state", FlagField(size=4, flag_type=LeaseState)),
|
||
|
|
("lease_flags", FlagField(size=4, flag_type=LeaseResponseFlags)),
|
||
|
|
("lease_duration", IntField(size=8)),
|
||
|
|
]
|
||
|
|
)
|
||
|
|
super().__init__()
|
||
|
|
|
||
|
|
|
||
|
|
class SMB2CreateQueryOnDiskIDResponse(Structure):
|
||
|
|
"""
|
||
|
|
[MS-SMB2] 2.2.14.2.9 SMB2_CREATE_QUERY_ON_DISK_ID
|
||
|
|
|
||
|
|
Sent by the server in response to an SMB2CreateQueryOnDiskIDRequest packet.
|
||
|
|
"""
|
||
|
|
|
||
|
|
NAME = CreateContextName.SMB2_CREATE_QUERY_ON_DISK_ID
|
||
|
|
|
||
|
|
def __init__(self):
|
||
|
|
self.fields = OrderedDict(
|
||
|
|
[
|
||
|
|
("disk_file_id", IntField(size=8)),
|
||
|
|
("volume_id", IntField(size=8)),
|
||
|
|
("reserved", BytesField(size=16, default=b"\x00" * 16)),
|
||
|
|
]
|
||
|
|
)
|
||
|
|
super().__init__()
|
||
|
|
|
||
|
|
|
||
|
|
class SMB2CreateRequestLeaseV2(Structure):
|
||
|
|
"""
|
||
|
|
[MS-SMB2] 2.2.13.2.10 SMB2_CREATE_REQUEST_LEASE_V2
|
||
|
|
|
||
|
|
Used when the client is requesting the server to return a lease on a file
|
||
|
|
or directory.
|
||
|
|
Valid for the SMB 3.x family only
|
||
|
|
"""
|
||
|
|
|
||
|
|
NAME = CreateContextName.SMB2_CREATE_REQUEST_LEASE_V2
|
||
|
|
|
||
|
|
def __init__(self):
|
||
|
|
self.fields = OrderedDict(
|
||
|
|
[
|
||
|
|
("lease_key", BytesField(size=16)),
|
||
|
|
("lease_state", FlagField(size=4, flag_type=LeaseState)),
|
||
|
|
("lease_flags", FlagField(size=4, flag_type=LeaseRequestFlags)),
|
||
|
|
("lease_duration", IntField(size=8)),
|
||
|
|
("parent_lease_key", BytesField(size=16)),
|
||
|
|
("epoch", BytesField(size=2)),
|
||
|
|
("reserved", IntField(size=2)),
|
||
|
|
]
|
||
|
|
)
|
||
|
|
super().__init__()
|
||
|
|
|
||
|
|
|
||
|
|
class SMB2CreateResponseLeaseV2(Structure):
|
||
|
|
"""
|
||
|
|
[MS-SMB2] 2.2.14.2.11 SMB2_CREATE_RESPONSE_LEASE_V2
|
||
|
|
|
||
|
|
Sent by the server in response to an SMB2CreateRequestLeaseV2 packet.
|
||
|
|
"""
|
||
|
|
|
||
|
|
def __init__(self):
|
||
|
|
self.fields = OrderedDict(
|
||
|
|
[
|
||
|
|
("lease_key", BytesField(size=16)),
|
||
|
|
("lease_state", FlagField(size=4, flag_type=LeaseState)),
|
||
|
|
("flags", FlagField(size=4, flag_type=LeaseResponseFlags)),
|
||
|
|
("lease_duration", IntField(size=8)),
|
||
|
|
("parent_lease_key", BytesField(size=16)),
|
||
|
|
("epoch", IntField(size=2)),
|
||
|
|
("reserved", IntField(size=2)),
|
||
|
|
]
|
||
|
|
)
|
||
|
|
super().__init__()
|
||
|
|
|
||
|
|
|
||
|
|
class SMB2CreateDurableHandleRequestV2(Structure):
|
||
|
|
"""
|
||
|
|
[MS-SMB2] 2.2.13.2.11 SMB2_CREATE_DURABLE_HANDLE_REQUEST_V2
|
||
|
|
|
||
|
|
Used by the client to request the server mark the open as durable or
|
||
|
|
persistent.
|
||
|
|
Valid for the SMB 3.x family only
|
||
|
|
"""
|
||
|
|
|
||
|
|
NAME = CreateContextName.SMB2_CREATE_DURABLE_HANDLE_REQUEST_V2
|
||
|
|
|
||
|
|
def __init__(self):
|
||
|
|
self.fields = OrderedDict(
|
||
|
|
[
|
||
|
|
# timeout in milliseconds
|
||
|
|
("timeout", IntField(size=4)),
|
||
|
|
("flags", FlagField(size=4, flag_type=DurableHandleFlags)),
|
||
|
|
("reserved", IntField(size=8)),
|
||
|
|
("create_guid", UuidField(size=16)),
|
||
|
|
]
|
||
|
|
)
|
||
|
|
super().__init__()
|
||
|
|
|
||
|
|
|
||
|
|
class SMB2CreateDurableHandleReconnectV2(Structure):
|
||
|
|
"""
|
||
|
|
[MS-SMB2] 2.2.13.2.12 SMB2_CREATE_DURABLE_HANDLE_RECONNECT_V2
|
||
|
|
|
||
|
|
Used by the client when reestablishing a durable open.
|
||
|
|
Valid for the SMB 3.x family only
|
||
|
|
"""
|
||
|
|
|
||
|
|
NAME = CreateContextName.SMB2_CREATE_DURABLE_HANDLE_RECONNECT_V2
|
||
|
|
|
||
|
|
def __init__(self):
|
||
|
|
self.fields = OrderedDict(
|
||
|
|
[
|
||
|
|
("file_id", BytesField(size=16)),
|
||
|
|
("create_guid", UuidField(size=16)),
|
||
|
|
("flags", FlagField(size=4, flag_type=DurableHandleFlags)),
|
||
|
|
]
|
||
|
|
)
|
||
|
|
super().__init__()
|
||
|
|
|
||
|
|
|
||
|
|
class SMB2CreateDurableHandleResponseV2(Structure):
|
||
|
|
"""
|
||
|
|
[MS-SMB2] 2.2.14.2.12 SMB2_CREATE_DURABLE_HANDLE_RESPONSE_V2
|
||
|
|
|
||
|
|
Sent by the server in response to an SMB2CreateDurableHandleRequestV2
|
||
|
|
packet.
|
||
|
|
"""
|
||
|
|
|
||
|
|
def __init__(self):
|
||
|
|
self.fields = OrderedDict(
|
||
|
|
[("timeout", IntField(size=4)), ("flags", FlagField(size=4, flag_type=DurableHandleFlags))]
|
||
|
|
)
|
||
|
|
super().__init__()
|
||
|
|
|
||
|
|
|
||
|
|
class SMB2CreateAppInstanceId(Structure):
|
||
|
|
"""
|
||
|
|
[MS-SMB2] 2.2.13.2.13 SMB2_CREATE_APP_INSTANCE_ID
|
||
|
|
|
||
|
|
Used by the client when supplying an identifier provided by an application.
|
||
|
|
Valid for the SMB 3.x family and should also have an durable handle on the
|
||
|
|
create request.
|
||
|
|
"""
|
||
|
|
|
||
|
|
NAME = CreateContextName.SMB2_CREATE_APP_INSTANCE_ID
|
||
|
|
|
||
|
|
def __init__(self):
|
||
|
|
self.fields = OrderedDict(
|
||
|
|
[
|
||
|
|
("structure_size", IntField(size=2, default=20)),
|
||
|
|
("reserved", IntField(size=2)),
|
||
|
|
("app_instance_id", BytesField(size=16)),
|
||
|
|
]
|
||
|
|
)
|
||
|
|
super().__init__()
|
||
|
|
|
||
|
|
|
||
|
|
class SMB2SVHDXOpenDeviceContextRequest(Structure):
|
||
|
|
"""
|
||
|
|
[MS-SMB2] 2.2.13.2.14 SVHDX_OPEN_DEVICE_CONTEXT
|
||
|
|
[MS-RSVD] 2.2.4.12 SVHDX_OPEN_DEVICE_CONTEXT
|
||
|
|
|
||
|
|
Used to open the shared virtual disk file.
|
||
|
|
"""
|
||
|
|
|
||
|
|
NAME = CreateContextName.SVHDX_OPEN_DEVICE_CONTEXT
|
||
|
|
|
||
|
|
def __init__(self):
|
||
|
|
self.fields = OrderedDict(
|
||
|
|
[
|
||
|
|
("version", IntField(size=4, default=1)),
|
||
|
|
("has_initiator_id", BoolField(size=1, default=lambda s: len(s["initiator_host_name"]) > 0)),
|
||
|
|
("reserved", BytesField(size=3, default=b"\x00\x00\x00")),
|
||
|
|
("initiator_id", UuidField(size=16)),
|
||
|
|
("originator_flags", EnumField(size=4, enum_type=SVHDXOriginatorFlags)),
|
||
|
|
("open_request_id", IntField(size=8)),
|
||
|
|
("initiator_host_name_length", IntField(size=2, default=lambda s: len(s["initiator_host_name"]))),
|
||
|
|
# utf-16-le encoded string
|
||
|
|
("initiator_host_name", BytesField(size=lambda s: s["initiator_host_name_length"].get_value())),
|
||
|
|
]
|
||
|
|
)
|
||
|
|
super().__init__()
|
||
|
|
|
||
|
|
|
||
|
|
class SMB2SVHDXOpenDeviceContextResponse(Structure):
|
||
|
|
"""
|
||
|
|
[MS-SMB2] 2.2.14.2.14 SVHDX_OPEN_DEVICE_CONTEXT_RESPONSE
|
||
|
|
[MS-RSVD] 2.2.4.31 SVHDX_OPEN_DEVICE_CONTEXT_RESPONSE
|
||
|
|
|
||
|
|
The response packet sent by the server in response to an
|
||
|
|
SMB2VHDXOpenDeviceContextRequest
|
||
|
|
"""
|
||
|
|
|
||
|
|
def __init__(self):
|
||
|
|
self.fields = OrderedDict(
|
||
|
|
[
|
||
|
|
("version", IntField(size=4, default=1)),
|
||
|
|
("has_initiator_id", BoolField(size=1, default=lambda s: len(s["initiator_host_name"]) > 0)),
|
||
|
|
("reserved", BytesField(size=3, default=b"\x00\x00\x00")),
|
||
|
|
("initiator_id", UuidField(size=16)),
|
||
|
|
("flags", IntField(size=4)),
|
||
|
|
("originator_flags", EnumField(size=4, enum_type=SVHDXOriginatorFlags)),
|
||
|
|
("open_request_id", IntField(size=8)),
|
||
|
|
("initiator_host_name_length", IntField(size=2, default=lambda s: len(s["initiator_host_name"]))),
|
||
|
|
# utf-16-le encoded string
|
||
|
|
("initiator_host_name", BytesField(size=lambda s: s["initiator_host_name_length"].get_value())),
|
||
|
|
]
|
||
|
|
)
|
||
|
|
super().__init__()
|
||
|
|
|
||
|
|
|
||
|
|
class SMB2SVHDXOpenDeviceContextV2Request(Structure):
|
||
|
|
"""
|
||
|
|
[MS-SMB2] 2.2.13.2.14 SVHDX_OPEN_DEVICE_CONTEXT
|
||
|
|
[MS-RSVD] 2.2.4.32 SVHDX_OPEN_DEVICE_CONTEXT_V2
|
||
|
|
|
||
|
|
Used to open the shared virtual disk file on the RSVD Protocol version 2
|
||
|
|
"""
|
||
|
|
|
||
|
|
NAME = CreateContextName.SVHDX_OPEN_DEVICE_CONTEXT
|
||
|
|
|
||
|
|
def __init__(self):
|
||
|
|
self.fields = OrderedDict(
|
||
|
|
[
|
||
|
|
("version", IntField(size=4, default=2)),
|
||
|
|
("has_initiator_id", BoolField(size=1, default=lambda s: len(s["initiator_host_name"]) > 0)),
|
||
|
|
("reserved", BytesField(size=3, default=b"\x00\x00\x00")),
|
||
|
|
("initiator_id", UuidField(size=16)),
|
||
|
|
("originator_flags", EnumField(size=4, enum_type=SVHDXOriginatorFlags)),
|
||
|
|
("open_request_id", IntField(size=8)),
|
||
|
|
("initiator_host_name_length", IntField(size=2, default=lambda s: len(s["initiator_host_name"]))),
|
||
|
|
# utf-16-le encoded string
|
||
|
|
("initiator_host_name", BytesField(size=lambda s: s["initiator_host_name_length"].get_value())),
|
||
|
|
("virtual_disk_properties_initialized", IntField(size=4)),
|
||
|
|
("server_service_version", IntField(size=4)),
|
||
|
|
("virtual_sector_size", IntField(size=4)),
|
||
|
|
("physical_sector_size", IntField(size=4)),
|
||
|
|
("virtual_size", IntField(size=8)),
|
||
|
|
]
|
||
|
|
)
|
||
|
|
super().__init__()
|
||
|
|
|
||
|
|
|
||
|
|
class SMB2SVHDXOpenDeviceContextV2Response(Structure):
|
||
|
|
"""
|
||
|
|
[MS-SMB2] 2.2.14.2.14 SVHDX_OPEN_DEVICE_CONTEXT_RESPONSE
|
||
|
|
[MS-RSVD] 2.2.4.32 SVHDX_OPEN_DEVICE_CONTEXT_V2_RESPONSE
|
||
|
|
|
||
|
|
The response packet sent by the server in response to an
|
||
|
|
SMB2VHDXOpenDeviceContextV2Request
|
||
|
|
"""
|
||
|
|
|
||
|
|
def __init__(self):
|
||
|
|
self.fields = OrderedDict(
|
||
|
|
[
|
||
|
|
("version", IntField(size=4, default=2)),
|
||
|
|
("has_initiator_id", BoolField(size=1, default=lambda s: len(s["initiator_host_name"]) > 0)),
|
||
|
|
("reserved", BytesField(size=3, default=b"\x00\x00\x00")),
|
||
|
|
("initiator_id", UuidField(size=16)),
|
||
|
|
("flags", IntField(size=4)),
|
||
|
|
("originator_flags", EnumField(size=4, enum_type=SVHDXOriginatorFlags)),
|
||
|
|
("open_request_id", IntField(size=8)),
|
||
|
|
("initiator_host_name_length", IntField(size=2, default=lambda s: len(s["initiator_host_name"]))),
|
||
|
|
# utf-16-le encoded string
|
||
|
|
("initiator_host_name", BytesField(size=lambda s: s["initiator_host_name_length"].get_value())),
|
||
|
|
("virtual_disk_properties_initialized", IntField(size=4)),
|
||
|
|
("server_service_version", IntField(size=4)),
|
||
|
|
("virtual_sector_size", IntField(size=4)),
|
||
|
|
("physical_sector_size", IntField(size=4)),
|
||
|
|
("virtual_size", IntField(size=8)),
|
||
|
|
]
|
||
|
|
)
|
||
|
|
super().__init__()
|
||
|
|
|
||
|
|
|
||
|
|
class SMB2CreateAppInstanceVersion(Structure):
|
||
|
|
"""
|
||
|
|
[MS-SMB2] 2.2.13.2.15 SMB2_CREATE_APP_INSTANCE_VERSION
|
||
|
|
|
||
|
|
Used when the client is supplying a version for the app instance identifier
|
||
|
|
provided by an application.
|
||
|
|
Valid for the SMB 3.1.1+ family
|
||
|
|
"""
|
||
|
|
|
||
|
|
NAME = CreateContextName.SMB2_CREATE_APP_INSTANCE_VERSION
|
||
|
|
|
||
|
|
def __init__(self):
|
||
|
|
self.fields = OrderedDict(
|
||
|
|
[
|
||
|
|
("structure_size", IntField(size=2, default=24)),
|
||
|
|
("reserved", IntField(size=2)),
|
||
|
|
("padding", IntField(size=4)),
|
||
|
|
("app_instance_version_high", IntField(size=8)),
|
||
|
|
("app_instance_version_low", IntField(size=8)),
|
||
|
|
]
|
||
|
|
)
|
||
|
|
super().__init__()
|