# Copyright: (c) 2020, Jordan Borean (@jborean93) # MIT License (see LICENSE or https://opensource.org/licenses/MIT) from collections import OrderedDict from smbprotocol.structure import BytesField, EnumField, FlagField, IntField, Structure class Commands: """ [MS-SMB2] v53.0 2017-09-15 2.2.1.2 SMB2 Packet Header - SYNC Command The command code of an SMB2 packet, it is used in the packet header. """ SMB2_NEGOTIATE = 0x0000 SMB2_SESSION_SETUP = 0x0001 SMB2_LOGOFF = 0x0002 SMB2_TREE_CONNECT = 0x0003 SMB2_TREE_DISCONNECT = 0x0004 SMB2_CREATE = 0x0005 SMB2_CLOSE = 0x0006 SMB2_FLUSH = 0x0007 SMB2_READ = 0x0008 SMB2_WRITE = 0x0009 SMB2_LOCK = 0x000A SMB2_IOCTL = 0x000B SMB2_CANCEL = 0x000C SMB2_ECHO = 0x000D SMB2_QUERY_DIRECTORY = 0x000E SMB2_CHANGE_NOTIFY = 0x000F SMB2_QUERY_INFO = 0x0010 SMB2_SET_INFO = 0x0011 SMB2_OPLOCK_BREAK = 0x0012 class NtStatus: """ [MS-ERREF] https://msdn.microsoft.com/en-au/library/cc704588.aspx 2.3.1 NTSTATUS Values These values are set in the status field of an SMB2Header response. This is not an exhaustive list but common values that are returned. """ STATUS_SUCCESS = 0x00000000 STATUS_UNSUCCESSFUL = 0xC0000001 STATUS_NETWORK_NAME_DELETED = 0xC00000C9 STATUS_PENDING = 0x00000103 STATUS_NOTIFY_CLEANUP = 0x0000010B STATUS_NOTIFY_ENUM_DIR = 0x0000010C STATUS_BUFFER_OVERFLOW = 0x80000005 STATUS_NO_MORE_FILES = 0x80000006 STATUS_END_OF_FILE = 0xC0000011 STATUS_INVALID_EA_NAME = 0x80000013 STATUS_EA_LIST_INCONSISTENT = 0x80000014 STATUS_STOPPED_ON_SYMLINK = 0x8000002D STATUS_INVALID_INFO_CLASS = 0xC0000003 STATUS_INFO_LENGTH_MISMATCH = 0xC0000004 STATUS_INVALID_HANDLE = 0xC0000008 STATUS_INVALID_PARAMETER = 0xC000000D STATUS_NO_SUCH_FILE = 0xC000000F STATUS_INVALID_DEVICE_REQUEST = 0xC0000010 STATUS_MORE_PROCESSING_REQUIRED = 0xC0000016 STATUS_ACCESS_DENIED = 0xC0000022 STATUS_BUFFER_TOO_SMALL = 0xC0000023 STATUS_OBJECT_NAME_INVALID = 0xC0000033 STATUS_OBJECT_NAME_NOT_FOUND = 0xC0000034 STATUS_OBJECT_NAME_COLLISION = 0xC0000035 STATUS_OBJECT_PATH_INVALID = 0xC0000039 STATUS_OBJECT_PATH_NOT_FOUND = 0xC000003A STATUS_OBJECT_PATH_SYNTAX_BAD = 0xC000003B STATUS_SHARING_VIOLATION = 0xC0000043 STATUS_EAS_NOT_SUPPORTED = 0xC000004F STATUS_EA_TOO_LARGE = 0xC0000050 STATUS_NONEXISTENT_EA_ENTRY = 0xC0000051 STATUS_NO_EAS_ON_FILE = 0xC0000052 STATUS_EA_CORRUPT_ERROR = 0xC0000053 STATUS_DELETE_PENDING = 0xC0000056 STATUS_PRIVILEGE_NOT_HELD = 0xC0000061 STATUS_WRONG_PASSWORD = 0xC000006A STATUS_LOGON_FAILURE = 0xC000006D STATUS_PASSWORD_EXPIRED = 0xC0000071 STATUS_NONE_MAPPED = 0xC0000073 STATUS_INSUFFICIENT_RESOURCES = 0xC000009A STATUS_PIPE_NOT_AVAILABLE = 0xC00000AC STATUS_PIPE_BUSY = 0xC00000AE STATUS_PIPE_DISCONNECTED = 0xC00000B0 STATUS_PIPE_CLOSING = 0xC00000B1 STATUS_IO_TIMEOUT = 0xC00000B5 STATUS_FILE_IS_A_DIRECTORY = 0xC00000BA STATUS_NOT_SUPPORTED = 0xC00000BB STATUS_BAD_NETWORK_NAME = 0xC00000CC STATUS_REQUEST_NOT_ACCEPTED = 0xC00000D0 STATUS_PIPE_EMPTY = 0xC00000D9 STATUS_INTERNAL_ERROR = 0xC00000E5 STATUS_DIRECTORY_NOT_EMPTY = 0xC0000101 STATUS_NOT_A_DIRECTORY = 0xC0000103 STATUS_CANCELLED = 0xC0000120 STATUS_CANNOT_DELETE = 0xC0000121 STATUS_FILE_CLOSED = 0xC0000128 STATUS_PIPE_BROKEN = 0xC000014B STATUS_FS_DRIVER_REQUIRED = 0xC000019C STATUS_USER_SESSION_DELETED = 0xC0000203 STATUS_INSUFF_SERVER_RESOURCES = 0xC0000205 STATUS_NOT_FOUND = 0xC0000225 STATUS_PATH_NOT_COVERED = 0xC0000257 STATUS_DFS_UNAVAILABLE = 0xC000026D STATUS_NOT_A_REPARSE_POINT = 0xC0000275 STATUS_SERVER_UNAVAILABLE = 0xC0000466 STATUS_DISK_FULL = 0xC000007F class Smb2Flags: """ [MS-SMB2] v53.0 2017-09-15 2.2.1.2 SMB2 Packet Header - SYNC Flags Indicates various processing rules that need to be done on the SMB2 packet. """ SMB2_FLAGS_SERVER_TO_REDIR = 0x00000001 SMB2_FLAGS_ASYNC_COMMAND = 0x00000002 SMB2_FLAGS_RELATED_OPERATIONS = 0x00000004 SMB2_FLAGS_SIGNED = 0x00000008 SMB2_FLAGS_PRIORITY_MASK = 0x00000070 SMB2_FLAGS_DFS_OPERATIONS = 0x10000000 SMB2_FLAGS_REPLAY_OPERATIONS = 0x20000000 class SMB2HeaderAsync(Structure): """ [MS-SMB2] 2.2.1.1 SMB2 Packer Header - ASYNC https://docs.microsoft.com/en-us/openspecs/windows_protocols/ms-smb2/ea4560b7-90da-4803-82b5-344754b92a79 The SMB2 Packet header for async commands. """ def __init__(self): self.fields = OrderedDict( [ ( "protocol_id", BytesField( size=4, default=b"\xfeSMB", ), ), ( "structure_size", IntField( size=2, default=64, ), ), ("credit_charge", IntField(size=2)), ("channel_sequence", IntField(size=2)), ("reserved", IntField(size=2)), ( "command", EnumField( size=2, enum_type=Commands, ), ), ("credit_request", IntField(size=2)), ( "flags", FlagField( size=4, flag_type=Smb2Flags, ), ), ("next_command", IntField(size=4)), ("message_id", IntField(size=8)), ("async_id", IntField(size=8)), ("session_id", IntField(size=8)), ( "signature", BytesField( size=16, default=b"\x00" * 16, ), ), ("data", BytesField()), ] ) super().__init__() class SMB2HeaderRequest(Structure): """ [MS-SMB2] v53.0 2017-09-15 2.2.1.2 SMB2 Packet Header - SYNC This is the header definition that contains the ChannelSequence/Reserved instead of the Status field used for a Packet request. """ def __init__(self): self.fields = OrderedDict( [ ( "protocol_id", BytesField( size=4, default=b"\xfeSMB", ), ), ( "structure_size", IntField( size=2, default=64, ), ), ("credit_charge", IntField(size=2)), ("channel_sequence", IntField(size=2)), ("reserved", IntField(size=2)), ("command", EnumField(size=2, enum_type=Commands)), ("credit_request", IntField(size=2)), ( "flags", FlagField( size=4, flag_type=Smb2Flags, ), ), ("next_command", IntField(size=4)), ("message_id", IntField(size=8)), ("process_id", IntField(size=4)), ("tree_id", IntField(size=4)), ("session_id", IntField(size=8)), ( "signature", BytesField( size=16, default=b"\x00" * 16, ), ), ("data", BytesField()), ] ) super().__init__() class SMB2HeaderResponse(Structure): """ [MS-SMB2] v53.0 2017-09-15 2.2.1.2 SMB2 Packet Header - SYNC The header definition for an SMB Response that contains the Status field instead of the ChannelSequence/Reserved used for a Packet response. """ def __init__(self): self.fields = OrderedDict( [ ( "protocol_id", BytesField( size=4, default=b"\xfeSMB", ), ), ( "structure_size", IntField( size=2, default=64, ), ), ("credit_charge", IntField(size=2)), ("status", EnumField(size=4, enum_type=NtStatus, enum_strict=False)), ( "command", EnumField( size=2, enum_type=Commands, enum_strict=False, ), ), ("credit_response", IntField(size=2)), ( "flags", FlagField( size=4, flag_type=Smb2Flags, ), ), ("next_command", IntField(size=4)), ("message_id", IntField(size=8)), ("reserved", IntField(size=4)), ("tree_id", IntField(size=4)), ("session_id", IntField(size=8)), ( "signature", BytesField( size=16, default=b"\x00" * 16, ), ), ("data", BytesField()), ] ) super().__init__()