dialects

Documentation

Index

• Constants
• type Dialects
  • func NewDialects() *Dialects
  • func (d *Dialects) AddDialect(dialect string)
  • func (d *Dialects) Marshal() ([]byte, error)
  • func (d *Dialects) Unmarshal(data []byte) (int, error)

Constants

const (
	// PC NETWORK PROGRAM 1.0 - The original MSNET SMB protocol (otherwise known as the "core protocol")
	DIALECT_PC_NETWORK_PROGRAM_1_0 = "PC NETWORK PROGRAM 1.0"
	// PCLAN1.0 - Some versions of the original MSNET defined this as an alternate to the core protocol name
	DIALECT_PCLAN1_0 = "PCLAN1.0"
	// MICROSOFT NETWORKS 1.03 - This is used for the MS-NET 1.03 product. It defines Lock&Read,Write&Unlock, and a special version of raw read and raw write.
	DIALECT_MICROSOFT_NETWORKS_1_03 = "MICROSOFT NETWORKS 1.03"
	// MICROSOFT NETWORKS 3.0 - This is the DOS LANMAN 1.0 specific protocol. It is equivalent to the LANMAN 1.0 protocol, except the server is required to map errors from the OS/2 error to an appropriate DOS error.
	DIALECT_MICROSOFT_NETWORKS_3_0 = "MICROSOFT NETWORKS 3.0"

	// LANMAN1.0 - This is the first version of the full LANMAN 1.0 protocol
	DIALECT_LANMAN_1_0 = "LANMAN1.0"
	// LANMAN1.2 - This is the second version of the full LANMAN 1.0 protocol
	DIALECT_LANMAN_1_2 = "LANMAN1.2"
	// LANMAN2.0 - LANMAN2.0
	DIALECT_LANMAN_2_0 = "LANMAN2.0"
	// LANMAN2.1 - OS/2 LANMAN2.1
	DIALECT_LANMAN_2_1 = "LANMAN2.1"
	// LM1.2X002 - This is the first version of the full LANMAN 2.0 protocol
	DIALECT_LM1_2X002 = "LM1.2X002"
	// DOS LM1.2X002 - This is the DOS equivalent of the LM1.2X002 protocol. It is identical to the LM1.2X002 protocol, but the server will perform error mapping to appropriate DOS errors.
	DIALECT_DOS_LM1_2X002 = "DOS LM1.2X002"
	// DOS LANMAN2.1 - DOS LANMAN2.1
	DIALECT_DOS_LANMAN_2_1 = "DOS LANMAN2.1"

	// Windows for Workgroups 3.1a - Windows for Workgroups Version 1.0
	DIALECT_WINDOWS_FOR_WORKGROUPS = "Windows for Workgroups 3.1a"
	// NT LM 0.12 - The SMB protocol designed for NT networking. This has special SMBs which duplicate the NT semantics.
	DIALECT_NT_LM_0_12 = "NT LM 0.12"
)

SMB Dialects Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-cifs/69a29f73-de0c-45a6-a1aa-8ceeea42217f

Types

type Dialects

type Dialects struct {
	Dialects []string
}

SMB_Dialect represents a dialect in the SMB protocol Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-cifs/69a29f73-de0c-45a6-a1aa-8ceeea42217f

func NewDialects

func NewDialects() *Dialects

NewDialects creates a new Dialects with the specified dialects

This function creates a new Dialects structure with an empty Dialects field.

func (*Dialects) AddDialect

func (d *Dialects) AddDialect(dialect string)

AddDialect adds a dialect to the Dialects structure

This function appends the given dialect to the existing dialects in the Dialects structure.

func (*Dialects) Marshal

func (d *Dialects) Marshal() ([]byte, error)

Marshal serializes the Dialects structure into a byte slice

Per MS-CIFS section 2.2.4.52.1, the Dialects field is a list of SMB_Dialect entries, each consisting of a BufferFormat byte (0x02) followed by a null-terminated OEM string. One BufferFormat byte MUST precede each dialect string, not just the first one.

func (*Dialects) Unmarshal

func (d *Dialects) Unmarshal(data []byte) (int, error)

Unmarshal deserializes a byte slice into the Dialects structure

Per MS-CIFS section 2.2.4.52.1, the Dialects field is a list of SMB_Dialect entries, each consisting of a BufferFormat byte (0x02) followed by a null-terminated OEM string. This function iterates over the list, validating the BufferFormat byte of each entry and reading the null-terminated dialect string that follows, until the buffer is exhausted. It returns the number of bytes read and an error if any.