Estructura inicial funcional con documentación en el README.md de la FastAPI
This commit is contained in:
307
env/lib/python3.12/site-packages/smbprotocol/header.py
vendored
Normal file
307
env/lib/python3.12/site-packages/smbprotocol/header.py
vendored
Normal file
@@ -0,0 +1,307 @@
|
||||
# Copyright: (c) 2020, Jordan Borean (@jborean93) <jborean93@gmail.com>
|
||||
# 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__()
|
||||
Reference in New Issue
Block a user