smb

package

v1.0.0 Latest Latest Go to latest Published: Dec 1, 2025 License: Apache-2.0, ISC Imports: 6 Imported by: 3

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/zmap/zgrab2

Links

Open Source Insights

Documentation ¶

Overview ¶

Package smb provides a zgrab2 module that scans for smb. This was ported directly from zgrab.

Index ¶

func RegisterModule()
type Flags
- func (flags *Flags) Help() string
- func (flags *Flags) Validate(_ []string) error
type Module
type Scanner

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func RegisterModule ¶

func RegisterModule()

RegisterModule registers the zgrab2 module.

Types ¶

type Flags ¶

type Flags struct {
	zgrab2.BaseFlags `group:"Basic Options"`
	// SetupSession tells the client to continue the handshake up to the point where credentials would be needed.
	SetupSession bool `long:"setup-session" description:"After getting the response from the negotiation request, send a setup session packet."`
}

Flags holds the command-line configuration for the smb scan module. Populated by the framework.

func (*Flags) Help ¶

func (flags *Flags) Help() string

Help returns the module's help string.

func (*Flags) Validate ¶

func (flags *Flags) Validate(_ []string) error

Validate checks that the flags are valid. On success, returns nil. On failure, returns an error instance describing the error.

type Module ¶

type Module struct {
}

Module implements the zgrab2.Module interface.

func (*Module) Description ¶ added in v0.1.3

func (module *Module) Description() string

Description returns an overview of this module.

func (*Module) NewFlags ¶

func (module *Module) NewFlags() any

NewFlags returns a default Flags object.

func (*Module) NewScanner ¶

func (module *Module) NewScanner() zgrab2.Scanner

NewScanner returns a new Scanner instance.

type Scanner ¶

type Scanner struct {
	// contains filtered or unexported fields
}

Scanner implements the zgrab2.Scanner interface.

func (*Scanner) GetDialerGroupConfig ¶ added in v0.2.0

func (scanner *Scanner) GetDialerGroupConfig() *zgrab2.DialerGroupConfig

func (*Scanner) GetName ¶

func (scanner *Scanner) GetName() string

GetName returns the Scanner name defined in the Flags.

func (*Scanner) GetScanMetadata ¶ added in v1.0.0

func (scanner *Scanner) GetScanMetadata() any

GetScanMetadata returns any metadata on the scan itself from this module.

func (*Scanner) GetTrigger ¶

func (scanner *Scanner) GetTrigger() string

GetTrigger returns the Trigger defined in the Flags.

func (*Scanner) Init ¶

func (scanner *Scanner) Init(flags zgrab2.ScanFlags) error

Init initializes the Scanner.

func (*Scanner) InitPerSender ¶

func (scanner *Scanner) InitPerSender(senderID int) error

InitPerSender initializes the scanner for a given sender.

func (*Scanner) Protocol ¶

func (scanner *Scanner) Protocol() string

Protocol returns the protocol identifier of the scan.

func (*Scanner) Scan ¶

func (scanner *Scanner) Scan(ctx context.Context, dialGroup *zgrab2.DialerGroup, target *zgrab2.ScanTarget) (zgrab2.ScanStatus, any, error)

Scan performs the following:

Connect to the TCP port (default 445).
Send a negotiation packet with the default values: Dialects = { DialectSmb_2_1 }, SecurityMode = SecurityModeSigningEnabled
Read response from server; on failure, exit with log = nil. If the server returns a protocol ID indicating support for version 1, set smbv1_support = true Pull out the relevant information from the response packet
If --setup-session is not set, exit with success.
Send a setup session packet to the server with appropriate values
Read the response from the server; on failure, exit with the log so far.
Return the log.

Source Files ¶

View all Source files

scanner.go

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL