Python Security Toolkit Files

Python Security Toolkit
MAC/NetBIOS Scanner
http://pythonsecuritytoolkit.sourceforge.net/

This program is written in Python 3.  Please run it in a Python 3 interpreter.

Python Security Toolkit is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
Python Security Toolkit is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.





Instructions
---------------------------------------------------------------------------------------------------

Usage:
This program is written in Python 3 and must be ran in a Python 3 interpreter.
Execute the program from a command line console with the Python 3 interpreter.
Example:  command_prompt>python mac_netb_scanner.py





Positional arguments:

The MAC/NetBIOS scanner has 1 positional argument

The positional argument is host_range.  This is the range of IP addresses that you wish to scan.
The range of IP addresses is inclusive.
Example:  command_prompt>python mac_netb_scanner.py 192.168.5.0 192.168.5.255





Optional arguments:

The MAC/NetBIOS Scanner has 5 optional arguments.

-h, or --help
        This argument displays a help file giving a brief explanation about the
        file's command line arguments.
        Example:  command_prompt>python mac_netb_scanner.py -h

-t, or --type
	This argument sets what type of scan you wish to run: MAC addresses, NetBIOS names, or both.
	Example: command_prompt>python mac_netb_scanner.py -t m (this scans for mac addresses only)
	Example: command_prompt>python mac_netb_scanner.py -t n (this scans for NetBIOS names only)
	Example: command_prompt>python mac_netb_scanner.py -t mn (this scans for both)

-v, or --verbose
	This argument runs the scanner in verbose mode. Printing all errors and other messages.
	Example: command_prompt>python mac_netb_scanner.py -v

-w, or --write
	This argument writes the output of the scan to a file. You designate the name of the file
	to write the output to as a parameter after the flag.
	Example: command_prompt>python mac_netb_scanner.py -w file_to_write_to.txt




Defaults:

If no argument is given for hosts to scanned, a default range of .0 to .255 inclusive for the last octet, will be scanned.
If no argument is given for which type to use for the scan, then mn will be used.
If no argument is given to write output to a file, then output of the scan will only be printed to the console.
The program runs a default of 20 hosts per thread in the scan.