Handle arbitrary Impacket errors this is needed because the library doesn't implement proper inheritance for its exceptions

Create a new SMBConnection object (if there isn't one already or if refresh is True) Attempt to log in, and switch to null session if

Downloads file to self.tmp_filename NOTE: SMBConnection() can't be passed through a multiprocessing queue This means t

Rebuild our SMBConnection() if it gets borked

Check if loot files contain expected patterns.

Empty the spiderling queue

Create an options Namespace matching MANSPIDER's expected structure.

Returns true if file is a bad extension type, e.g. encrypted or compressed

Finds all regex matches in file content

Based on whether "or" logic is enabled, return True or False if the filename + extension meets the requirements

Moves a file from temp storage into the loot directory

Stop the SMB server.

converts bytes to human-readable filesize e.g. 1024 --> 1KB

Return True if file modification time matches date filters file_time is a unix timestamp

Return True if folder, file name, or extension has been blacklisted

Extract text from plain text file, auto-detecting encoding.

Attempts to retrieve "remote_file" from share and returns True if successful

Find a free port to use for the SMB server.

go spider go spider go

Tries to format impacket exceptions nicely

Detect if file is plain text using charset-normalizer.

List shares on the SMB server

Start the SMB server in a background thread.

Decode bytes to string using charset-normalizer for encoding detection.

Return true if "path" matches any of the directory filters

Return True if file extension has been whitelisted

Extract printable ASCII strings from a binary file. Similar to the Unix 'strings' command.

Extracts text from a file. Uses charset-normalizer for plain text files (handles UTF-16, etc.) Falls back to kreuzberg for bi

Return true if "filename" matches any of the filename filters

Get the hostname from the SMB connection

Check if we already have an smb_client cached If not, then create it

converts human-readable number to integer e.g. 1K --> 1000

Get ready to search by file content

Get ready to search by filename

List files inside a specific directory Only yield files which conform to all filters (except content)

Read a plain wordlist (one word/phrase per line) and append each entry to options.content.

Return True if we've reached max failed logons

List files in share/path Raise FileListError if there's a problem @byt3bl33d3r it's really not that bad

Returns True if the file isn't of a blacklisted file type

Send a message to the parent spider

Parse a host:port string. Returns (host, port) tuple. Port defaults to 445 if not specified. Handles IPv6 addresses in brackets: [::1]:44

Process messages from spiderlings Log messages, errors, files, etc.

Return true if "share" matches any of the share filters

"message_type" is a string, and can be: "e" - error "a" - authentication failure

Executes given function and places return value in result queue

Yields all files on the target to be parsed/downloaded Premptively download matching files into temp directory

Get ready to search by file extension

Accepts filename, CIDR, IP, hostname, file, or folder Supports host:port syntax (e.g., 192.168.1.1:4455) Returns list of targets as Targe

Simple wrapper around self.parent.parser.parse_file() For sole purpose of threading

Parse a file on the local filesystem

Recursively remove directory

Lists all shares on single target Includes both enumerated shares and user-specified shares (which may be hidden from enumeration)

Fixture that spins up an SMB server with test files. Uses module scope so the server is started once and shared across all tests. Yield

Fixture that spins up an SMB server with ALL test files. Uses module scope so the server is started once and shared across all tests.

Verify we can connect to the SMB server and list shares.

Verify we can list files in the share.

Extract text from test files and verify Password123 is found.

Extract text from various encodings using charset-normalizer.

MANSPIDER finds Password123 in ALL binary files with embedded text.

MANSPIDER finds Password123 in ALL document formats (docx, pdf, xlsx, doc, xls).

MANSPIDER finds Password123 in ALL text encoding variants.

Verify the SMB server starts and has files.