netscan-ks 0.1.0__tar.gz

netscan_ks-0.1.0/PKG-INFO

@@ -0,0 +1,6 @@
+Metadata-Version: 2.4
+Name: netscan-ks
+Version: 0.1.0
+Requires-Python: >=3.8
+Requires-Dist: scapy
+Requires-Dist: tqdm

netscan_ks-0.1.0/netscan_ks.egg-info/PKG-INFO

@@ -0,0 +1,6 @@
+Metadata-Version: 2.4
+Name: netscan-ks
+Version: 0.1.0
+Requires-Python: >=3.8
+Requires-Dist: scapy
+Requires-Dist: tqdm

netscan_ks-0.1.0/netscan_ks.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+pyproject.toml
+netscan_ks.egg-info/PKG-INFO
+netscan_ks.egg-info/SOURCES.txt
+netscan_ks.egg-info/dependency_links.txt
+netscan_ks.egg-info/entry_points.txt
+netscan_ks.egg-info/requires.txt
+netscan_ks.egg-info/top_level.txt
+scanner/__init__.py
+scanner/banner_grab.py
+scanner/cli.py
+scanner/syn_scan.py

netscan_ks-0.1.0/netscan_ks.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

netscan_ks-0.1.0/netscan_ks.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+netscan = scanner.cli:run

netscan_ks-0.1.0/netscan_ks.egg-info/requires.txt

@@ -0,0 +1,2 @@
+scapy
+tqdm

netscan_ks-0.1.0/netscan_ks.egg-info/top_level.txt

@@ -0,0 +1 @@
+scanner

netscan_ks-0.1.0/pyproject.toml

@@ -0,0 +1,12 @@
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "netscan-ks"
+version = "0.1.0"
+requires-python = ">=3.8"
+dependencies = ["scapy", "tqdm"]
+
+[project.scripts]
+netscan = "scanner.cli:run"

netscan_ks-0.1.0/scanner/__init__.py

@@ -0,0 +1 @@
+

netscan_ks-0.1.0/scanner/banner_grab.py

@@ -0,0 +1,12 @@
+import socket
+
+def grab_banner(target, port, timeout=2):
+    try:
+        sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+        sock.settimeout(timeout)
+        sock.connect((target, port))
+        banner = sock.recv(1024).decode().strip()
+        sock.close()
+        return banner
+    except(socket.timeout, socket.error, UnicodeDecodeError):
+        return None

netscan_ks-0.1.0/scanner/cli.py

@@ -0,0 +1,103 @@
+import argparse
+from math import e
+import threading
+import time
+import ipaddress
+from tqdm import tqdm
+from scanner.syn_scan import syn_scan
+from concurrent.futures import ThreadPoolExecutor
+from scanner.banner_grab import grab_banner
+
+
+def run():
+    threading.excepthook = scapy_thread_error_filter
+    start_time = time.time()
+
+    parser = argparse.ArgumentParser()
+    parser.add_argument("-t", "--target", help="Target IP address to scan", required=True)
+    parser.add_argument("-p", "--ports", help="Specific ports to scan", nargs="+")
+    parser.add_argument("-s", "--start", help="Start of port range to scan" ,type=int)
+    parser.add_argument("-e", "--end", help="End of port range to scan", type=int)
+    args = parser.parse_args()
+
+    target = args.target
+    targeted_port = args.ports
+    start_port = args.start
+    end_port = args.end
+    open_ports = []
+    filtered_ports = []
+
+    print(f"Starting scan on {target}...")
+
+    #Error checks
+    if bool(start_port) != bool(end_port):
+        print("Error: --start and --end must be used together.")
+        return
+    
+    try:
+        ipaddress.ip_address(target)
+    except ValueError:
+        print(f"Error: '{target}' is not a valid IP address.")
+        return
+    
+    if start_port and end_port:
+        if not (1 <= start_port <= 65535) or not (1 <= end_port <= 65535):
+            print("Error: Ports must be between 1 and 65535.")
+            return
+        if start_port > end_port:
+            print("Error: Start port must be less than or equal to end port.")
+            return
+
+    #Scanning starts here
+    if targeted_port:
+        ports = [int(p.strip(",")) for p in targeted_port]
+        if any(not (1 <= p <= 65535) for p in ports):
+            print("Error: Ports must be between 1 and 65535.")
+            return
+        with ThreadPoolExecutor(max_workers=50) as executor:
+            results = list(tqdm(executor.map(lambda port: scan_and_store(target, port), ports),
+                    total=len(ports), desc="Scanning"))
+        for port, result in results:
+            if result == "OPEN":
+                open_ports.append(port)
+            elif "FILTERED" in result:
+                filtered_ports.append(port)
+
+    if start_port and end_port:
+        with ThreadPoolExecutor(max_workers=50) as executor:
+            results = list(tqdm(executor.map(lambda port: scan_and_store(target, port), range(start_port, end_port + 1)),
+                               total=end_port - start_port + 1, desc="Scanning"))
+        for port, result in results:
+            if result == "OPEN":
+                open_ports.append(port)
+            elif "FILTERED" in result:
+                filtered_ports.append(port)
+
+    #Outputs
+    print(f"Open ports:{len(open_ports)}")
+    for port in open_ports:
+        banner = grab_banner(target, port)
+        if banner:
+            print(f"Port {port} is OPEN - Banner: {banner}")
+        else:
+            print(f"Port {port} is OPEN")
+        
+    print(f"Filtered ports:{len(filtered_ports)}")
+    for port in filtered_ports:
+        print(f"Port {port} is FILTERED")
+
+    elapsed = time.time() - start_time
+    print(f"Scan completed in {elapsed:.2f} seconds.")
+
+def scan_and_store(target, port):
+    result = syn_scan(target, port)
+    return (port, result)
+
+# Scapy's sr1() spawns internal threads for packet sending/receiving.
+# When running my own scans with ThreadPoolExecutor, these internal threads occasionally fail with OSError errno 9 (Bad file descriptor)
+# and errno 22 (Invalid argument) during cleanup. These are known Scapy pipe errors on Windows and do not affect scan results.
+# threading.excepthook is used to suppress these specific errors only. To clarify, the errors do occur on every scan, they are just not visible to the user.
+def scapy_thread_error_filter(args):
+    if isinstance(args.exc_value, OSError) and args.exc_value.errno in (9, 22):
+        return
+    threading.__excepthook__(args)

netscan_ks-0.1.0/scanner/syn_scan.py

@@ -0,0 +1,34 @@
+from scapy.layers.inet import IP, TCP, ICMP
+from scapy.sendrecv import sr1
+import random
+
+def syn_scan(target, port, retries=2, timeout=2):
+    for attempt in range(retries + 1):
+        sport = random.randint(1024, 65535)
+        packet = IP(dst=target) / TCP(sport=sport, 
+                                      dport=port, 
+                                      flags="S")
+
+        response = sr1(packet, timeout=timeout, verbose=0)
+
+        if response is None:
+            if attempt == retries:
+                return "FILTERED"
+            continue
+
+        if response.haslayer(TCP):
+            flags = response.getlayer(TCP).flags
+            if flags & 0x12 == 0x12:  # SYN-ACK
+                rst = IP(dst=target) / TCP(sport=sport,
+                                          dport=port, 
+                                          flags="R",
+                                          seq=response.ack)
+                sr1(rst, timeout=timeout, verbose=0)
+                return "OPEN"
+            elif flags & 0x14 == 0x14:  # RST-ACK
+                return "CLOSED"
+        elif response.haslayer(ICMP):
+            icmp = response.getlayer(ICMP)
+            if icmp.type == 3:
+                return f"FILTERED (ICMP type 3 code {icmp.code})"
+    return "UNKNOWN"

netscan_ks-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+