dargslan-socket-stats 1.0.0__tar.gz

dargslan_socket_stats-1.0.0/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: dargslan-socket-stats
+Version: 1.0.0
+Summary: Linux socket statistics analyzer — TCP/UDP/Unix socket states, connection tracking, and network diagnostics.
+Author-email: Dargslan <info@dargslan.com>
+License: MIT
+Project-URL: Homepage, https://dargslan.com
+Project-URL: Documentation, https://dargslan.com/blog
+Project-URL: Repository, https://github.com/Dargslan
+Project-URL: Free Cheat Sheets, https://dargslan.com/cheat-sheets
+Project-URL: Linux & DevOps Books, https://dargslan.com/books
+Keywords: linux,socket,network,tcp,udp,monitoring,sysadmin,diagnostics
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: System :: Networking
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+
+# dargslan-socket-stats
+
+Linux socket statistics analyzer — TCP/UDP/Unix socket states, connection tracking, listening ports, and network diagnostics.
+
+## Installation
+
+```bash
+pip install dargslan-socket-stats
+```
+
+## Usage
+
+```bash
+dargslan-socket report        # Full socket statistics report
+dargslan-socket tcp           # TCP connections
+dargslan-socket udp           # UDP sockets
+dargslan-socket listen        # Listening sockets
+dargslan-socket states        # TCP state breakdown
+dargslan-socket audit         # Issues only
+dargslan-socket json          # JSON output
+```
+
+## Features
+
+- TCP connection state analysis (ESTABLISHED, TIME-WAIT, CLOSE-WAIT)
+- UDP socket listing with process info
+- Listening socket inventory
+- Detect high TIME-WAIT and CLOSE-WAIT counts
+- Receive queue overflow detection
+- Zero dependencies — pure Python
+
+## Part of dargslan-toolkit
+
+Install all 48 Linux sysadmin tools: `pip install dargslan-toolkit`
+
+## Links
+
+- [Free Linux Cheat Sheets](https://dargslan.com/cheat-sheets)
+- [Linux & DevOps Books](https://dargslan.com/books)
+- [Blog & Tutorials](https://dargslan.com/blog)
+
+## License
+
+MIT

dargslan_socket_stats-1.0.0/README.md

@@ -0,0 +1,44 @@
+# dargslan-socket-stats
+
+Linux socket statistics analyzer — TCP/UDP/Unix socket states, connection tracking, listening ports, and network diagnostics.
+
+## Installation
+
+```bash
+pip install dargslan-socket-stats
+```
+
+## Usage
+
+```bash
+dargslan-socket report        # Full socket statistics report
+dargslan-socket tcp           # TCP connections
+dargslan-socket udp           # UDP sockets
+dargslan-socket listen        # Listening sockets
+dargslan-socket states        # TCP state breakdown
+dargslan-socket audit         # Issues only
+dargslan-socket json          # JSON output
+```
+
+## Features
+
+- TCP connection state analysis (ESTABLISHED, TIME-WAIT, CLOSE-WAIT)
+- UDP socket listing with process info
+- Listening socket inventory
+- Detect high TIME-WAIT and CLOSE-WAIT counts
+- Receive queue overflow detection
+- Zero dependencies — pure Python
+
+## Part of dargslan-toolkit
+
+Install all 48 Linux sysadmin tools: `pip install dargslan-toolkit`
+
+## Links
+
+- [Free Linux Cheat Sheets](https://dargslan.com/cheat-sheets)
+- [Linux & DevOps Books](https://dargslan.com/books)
+- [Blog & Tutorials](https://dargslan.com/blog)
+
+## License
+
+MIT

dargslan_socket_stats-1.0.0/dargslan_socket_stats/__init__.py

@@ -0,0 +1,187 @@
+"""dargslan-socket-stats — Linux socket statistics analyzer."""
+
+__version__ = "1.0.0"
+
+import subprocess
+import re
+import json
+import os
+from datetime import datetime
+from collections import defaultdict
+
+
+def _run(cmd):
+    try:
+        r = subprocess.run(cmd, shell=True, capture_output=True, text=True, timeout=30)
+        return r.stdout.strip()
+    except Exception:
+        return ""
+
+
+def get_tcp_sockets():
+    sockets = []
+    out = _run("ss -tnp 2>/dev/null")
+    for line in out.splitlines()[1:]:
+        parts = line.split()
+        if len(parts) >= 5:
+            sock = {
+                "state": parts[0],
+                "recv_q": int(parts[1]) if parts[1].isdigit() else 0,
+                "send_q": int(parts[2]) if parts[2].isdigit() else 0,
+                "local": parts[3],
+                "remote": parts[4],
+            }
+            if len(parts) > 5:
+                pm = re.search(r'users:\(\("([^"]+)",pid=(\d+)', parts[5])
+                if pm:
+                    sock["process"] = pm.group(1)
+                    sock["pid"] = int(pm.group(2))
+            sockets.append(sock)
+    return sockets
+
+
+def get_udp_sockets():
+    sockets = []
+    out = _run("ss -unp 2>/dev/null")
+    for line in out.splitlines()[1:]:
+        parts = line.split()
+        if len(parts) >= 5:
+            sock = {
+                "state": parts[0],
+                "recv_q": int(parts[1]) if parts[1].isdigit() else 0,
+                "send_q": int(parts[2]) if parts[2].isdigit() else 0,
+                "local": parts[3],
+                "remote": parts[4],
+            }
+            if len(parts) > 5:
+                pm = re.search(r'users:\(\("([^"]+)",pid=(\d+)', parts[5])
+                if pm:
+                    sock["process"] = pm.group(1)
+                    sock["pid"] = int(pm.group(2))
+            sockets.append(sock)
+    return sockets
+
+
+def get_unix_sockets():
+    sockets = []
+    out = _run("ss -xlp 2>/dev/null")
+    for line in out.splitlines()[1:]:
+        parts = line.split()
+        if len(parts) >= 5:
+            sock = {
+                "state": parts[0] if not parts[0].startswith("u_") else parts[1],
+                "type": parts[0] if parts[0].startswith("u_") else "unix",
+                "local": parts[4] if len(parts) > 4 else "",
+            }
+            sockets.append(sock)
+    return sockets
+
+
+def get_listening_sockets():
+    sockets = []
+    out = _run("ss -tlnp 2>/dev/null")
+    for line in out.splitlines()[1:]:
+        parts = line.split()
+        if len(parts) >= 4:
+            sock = {
+                "state": "LISTEN",
+                "local": parts[3],
+                "protocol": "tcp",
+            }
+            if len(parts) > 5:
+                pm = re.search(r'users:\(\("([^"]+)",pid=(\d+)', ' '.join(parts[5:]))
+                if pm:
+                    sock["process"] = pm.group(1)
+                    sock["pid"] = int(pm.group(2))
+            sockets.append(sock)
+    out = _run("ss -ulnp 2>/dev/null")
+    for line in out.splitlines()[1:]:
+        parts = line.split()
+        if len(parts) >= 4:
+            sock = {
+                "state": "UNCONN",
+                "local": parts[3],
+                "protocol": "udp",
+            }
+            if len(parts) > 5:
+                pm = re.search(r'users:\(\("([^"]+)",pid=(\d+)', ' '.join(parts[5:]))
+                if pm:
+                    sock["process"] = pm.group(1)
+                    sock["pid"] = int(pm.group(2))
+            sockets.append(sock)
+    return sockets
+
+
+def get_state_summary():
+    out = _run("ss -s 2>/dev/null")
+    summary = {}
+    for line in out.splitlines():
+        if "TCP:" in line:
+            m = re.search(r'TCP:\s+(\d+)', line)
+            if m:
+                summary["tcp_total"] = int(m.group(1))
+            states = re.findall(r'(\w+)\s+(\d+)', line)
+            for s, c in states:
+                summary[f"tcp_{s.lower()}"] = int(c)
+        elif "UDP:" in line:
+            m = re.search(r'UDP:\s+(\d+)', line)
+            if m:
+                summary["udp_total"] = int(m.group(1))
+    return summary
+
+
+def get_connection_states():
+    states = defaultdict(int)
+    out = _run("ss -tn 2>/dev/null")
+    for line in out.splitlines()[1:]:
+        parts = line.split()
+        if parts:
+            states[parts[0]] += 1
+    return dict(states)
+
+
+def generate_report():
+    tcp = get_tcp_sockets()
+    udp = get_udp_sockets()
+    listening = get_listening_sockets()
+    conn_states = get_connection_states()
+    summary = get_state_summary()
+    issues = []
+
+    time_wait = conn_states.get("TIME-WAIT", 0)
+    close_wait = conn_states.get("CLOSE-WAIT", 0)
+    if time_wait > 1000:
+        issues.append({
+            "severity": "warning",
+            "message": f"High TIME-WAIT count: {time_wait}"
+        })
+    if close_wait > 100:
+        issues.append({
+            "severity": "warning",
+            "message": f"High CLOSE-WAIT count: {close_wait} (possible connection leak)"
+        })
+
+    high_recv_q = [s for s in tcp if s["recv_q"] > 100]
+    if high_recv_q:
+        issues.append({
+            "severity": "warning",
+            "message": f"{len(high_recv_q)} sockets with high receive queue"
+        })
+
+    wildcard_listen = [s for s in listening if "0.0.0.0:" in s.get("local", "") or ":::"]
+    return {
+        "timestamp": datetime.now().isoformat(),
+        "tcp_connections": len(tcp),
+        "udp_sockets": len(udp),
+        "listening": len(listening),
+        "connection_states": conn_states,
+        "state_summary": summary,
+        "listening_sockets": listening,
+        "issues": issues,
+        "issues_count": len(issues),
+    }
+
+
+def audit():
+    report = generate_report()
+    return report["issues"]

dargslan_socket_stats-1.0.0/dargslan_socket_stats/cli.py

@@ -0,0 +1,105 @@
+"""CLI for dargslan-socket-stats."""
+
+import sys
+import json
+from . import generate_report, get_tcp_sockets, get_udp_sockets, get_listening_sockets, get_connection_states, audit, __version__
+
+
+def print_report(data):
+    print(f"Socket Statistics Report")
+    print(f"{'=' * 60}")
+    print(f"Timestamp: {data['timestamp']}")
+    print(f"TCP Connections: {data['tcp_connections']}")
+    print(f"UDP Sockets: {data['udp_sockets']}")
+    print(f"Listening: {data['listening']}")
+    print()
+
+    if data["connection_states"]:
+        print("TCP Connection States:")
+        print(f"{'-' * 40}")
+        for state, count in sorted(data["connection_states"].items(), key=lambda x: x[1], reverse=True):
+            bar = "#" * min(count, 40)
+            print(f"  {state:<15} {count:>6}  {bar}")
+        print()
+
+    if data["listening_sockets"]:
+        print("Listening Sockets:")
+        print(f"{'-' * 40}")
+        for s in data["listening_sockets"][:20]:
+            proc = s.get("process", "unknown")
+            print(f"  {s['protocol']:<5} {s['local']:<25} {proc}")
+        print()
+
+    if data["issues"]:
+        print(f"Issues Found: {data['issues_count']}")
+        for issue in data["issues"]:
+            print(f"  [{issue['severity'].upper()}] {issue['message']}")
+    else:
+        print("No issues found.")
+
+    print(f"\nMore Linux tools: https://dargslan.com/cheat-sheets")
+
+
+def main():
+    args = sys.argv[1:]
+    if not args or args[0] in ("-h", "--help"):
+        print(f"dargslan-socket-stats v{__version__}")
+        print(f"Linux socket statistics analyzer")
+        print(f"\nUsage: dargslan-socket <command>")
+        print(f"\nCommands:")
+        print(f"  report     Full socket statistics report")
+        print(f"  tcp        TCP connections only")
+        print(f"  udp        UDP sockets only")
+        print(f"  listen     Listening sockets")
+        print(f"  states     TCP connection state breakdown")
+        print(f"  audit      Security audit (issues only)")
+        print(f"  json       Full report as JSON")
+        print(f"  version    Show version")
+        print(f"\nhttps://dargslan.com — Linux & DevOps Books")
+        return
+
+    cmd = args[0]
+    if cmd == "version":
+        print(f"dargslan-socket-stats v{__version__}")
+    elif cmd == "report":
+        print_report(generate_report())
+    elif cmd == "tcp":
+        socks = get_tcp_sockets()
+        print(f"TCP Connections: {len(socks)}")
+        for s in socks[:30]:
+            proc = s.get("process", "?")
+            print(f"  {s['state']:<13} {s['local']:<25} → {s['remote']:<25} {proc}")
+    elif cmd == "udp":
+        socks = get_udp_sockets()
+        print(f"UDP Sockets: {len(socks)}")
+        for s in socks[:30]:
+            proc = s.get("process", "?")
+            print(f"  {s['local']:<25} → {s['remote']:<25} {proc}")
+    elif cmd == "listen":
+        socks = get_listening_sockets()
+        print(f"Listening Sockets: {len(socks)}")
+        for s in socks:
+            proc = s.get("process", "?")
+            print(f"  {s['protocol']:<5} {s['local']:<30} {proc}")
+    elif cmd == "states":
+        states = get_connection_states()
+        total = sum(states.values())
+        print(f"TCP Connection States (total: {total}):")
+        for state, count in sorted(states.items(), key=lambda x: x[1], reverse=True):
+            pct = (count / total * 100) if total > 0 else 0
+            print(f"  {state:<15} {count:>6} ({pct:.1f}%)")
+    elif cmd == "audit":
+        issues = audit()
+        if not issues:
+            print("No issues found.")
+        for i in issues:
+            print(f"[{i['severity'].upper()}] {i['message']}")
+    elif cmd == "json":
+        print(json.dumps(generate_report(), indent=2))
+    else:
+        print(f"Unknown command: {cmd}. Use --help for usage.")
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

dargslan_socket_stats-1.0.0/dargslan_socket_stats.egg-info/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: dargslan-socket-stats
+Version: 1.0.0
+Summary: Linux socket statistics analyzer — TCP/UDP/Unix socket states, connection tracking, and network diagnostics.
+Author-email: Dargslan <info@dargslan.com>
+License: MIT
+Project-URL: Homepage, https://dargslan.com
+Project-URL: Documentation, https://dargslan.com/blog
+Project-URL: Repository, https://github.com/Dargslan
+Project-URL: Free Cheat Sheets, https://dargslan.com/cheat-sheets
+Project-URL: Linux & DevOps Books, https://dargslan.com/books
+Keywords: linux,socket,network,tcp,udp,monitoring,sysadmin,diagnostics
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: System :: Networking
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+
+# dargslan-socket-stats
+
+Linux socket statistics analyzer — TCP/UDP/Unix socket states, connection tracking, listening ports, and network diagnostics.
+
+## Installation
+
+```bash
+pip install dargslan-socket-stats
+```
+
+## Usage
+
+```bash
+dargslan-socket report        # Full socket statistics report
+dargslan-socket tcp           # TCP connections
+dargslan-socket udp           # UDP sockets
+dargslan-socket listen        # Listening sockets
+dargslan-socket states        # TCP state breakdown
+dargslan-socket audit         # Issues only
+dargslan-socket json          # JSON output
+```
+
+## Features
+
+- TCP connection state analysis (ESTABLISHED, TIME-WAIT, CLOSE-WAIT)
+- UDP socket listing with process info
+- Listening socket inventory
+- Detect high TIME-WAIT and CLOSE-WAIT counts
+- Receive queue overflow detection
+- Zero dependencies — pure Python
+
+## Part of dargslan-toolkit
+
+Install all 48 Linux sysadmin tools: `pip install dargslan-toolkit`
+
+## Links
+
+- [Free Linux Cheat Sheets](https://dargslan.com/cheat-sheets)
+- [Linux & DevOps Books](https://dargslan.com/books)
+- [Blog & Tutorials](https://dargslan.com/blog)
+
+## License
+
+MIT

dargslan_socket_stats-1.0.0/dargslan_socket_stats.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+dargslan_socket_stats/__init__.py
+dargslan_socket_stats/cli.py
+dargslan_socket_stats.egg-info/PKG-INFO
+dargslan_socket_stats.egg-info/SOURCES.txt
+dargslan_socket_stats.egg-info/dependency_links.txt
+dargslan_socket_stats.egg-info/entry_points.txt
+dargslan_socket_stats.egg-info/top_level.txt

dargslan_socket_stats-1.0.0/dargslan_socket_stats.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

dargslan_socket_stats-1.0.0/dargslan_socket_stats.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+dargslan-socket = dargslan_socket_stats.cli:main

dargslan_socket_stats-1.0.0/dargslan_socket_stats.egg-info/top_level.txt

@@ -0,0 +1 @@
+dargslan_socket_stats

dargslan_socket_stats-1.0.0/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "dargslan-socket-stats"
+version = "1.0.0"
+description = "Linux socket statistics analyzer — TCP/UDP/Unix socket states, connection tracking, and network diagnostics."
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.7"
+authors = [{name = "Dargslan", email = "info@dargslan.com"}]
+keywords = ["linux", "socket", "network", "tcp", "udp", "monitoring", "sysadmin", "diagnostics"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: System Administrators",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Topic :: System :: Networking",
+    "Topic :: System :: Monitoring",
+]
+
+[project.urls]
+Homepage = "https://dargslan.com"
+Documentation = "https://dargslan.com/blog"
+Repository = "https://github.com/Dargslan"
+"Free Cheat Sheets" = "https://dargslan.com/cheat-sheets"
+"Linux & DevOps Books" = "https://dargslan.com/books"
+
+[project.scripts]
+dargslan-socket = "dargslan_socket_stats.cli:main"

dargslan_socket_stats-1.0.0/setup.cfg

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