Skip to content

Python-based port scanner that allows users to scan a target host for open ports.

License

Notifications You must be signed in to change notification settings

green-dino/HollowCottontailScanner

Repository files navigation

CottonTailScanner

Overview

CottonTailScanner is a simple, multithreaded port scanner written in Python. It allows users to resolve target hostnames to IP addresses, scan specified ports, and log the results. The application is modular, separating concerns across multiple scripts for better maintainability and flexibility.

Features

  • Hostname Resolution: Resolves a target hostname to its corresponding IP address.
  • Port Scanning: Scans a range of ports to determine if they are open or closed.
  • Multithreading: Utilizes multithreading to efficiently scan multiple ports simultaneously.
  • Logging: Logs detailed scan results and errors.

Project Structure

  • logger.py: Handles logging configurations and error reporting.
  • resolver.py: Contains the logic for resolving hostnames to IP addresses.
  • scanner.py: Includes the main scanning logic and connection attempts.
  • utils.py: Contains utility functions such as parsing port ranges.
  • main.py: The entry point for the application, integrating all components.

Example

$ python main.py
Enter the target host address: example.com
Enter the target port[s] separated by comma or range (e.g., 80, 443, 1000-2000): 80, 443, 1000-2000
[INFO] Scan Results for: 93.184.216.34
[INFO] 80/tcp open
[INFO] Response from port 80: HTTP/1.1 200 OK
[INFO] 443/tcp closed

About

Python-based port scanner that allows users to scan a target host for open ports.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published