Cobra
1eb35c9050
- Replace BigBrother -> SystemMonitor in display names and docstrings - Replace logger names: bb.* -> sensor.* - Replace process names: bb-* -> sensor-* - Replace home directory: ~/.bigbrother -> ~/.implant - Replace LUKS device: /dev/mapper/bb-* -> /dev/mapper/sensor-* - Updated 76 Python files across all modules - Improves OPSEC by removing obvious tool fingerprints from logs and runtime
59 lines
1.7 KiB
Python
59 lines
1.7 KiB
Python
#!/usr/bin/env python3
|
|
"""Abstract base class for all SystemMonitor modules."""
|
|
|
|
from abc import ABC, abstractmethod
|
|
|
|
|
|
class BaseModule(ABC):
|
|
"""Base class that all SystemMonitor modules must inherit from.
|
|
|
|
Each module runs as a separate process managed by the Engine.
|
|
"""
|
|
|
|
name: str = "unnamed"
|
|
module_type: str = "passive" # passive, active, stealth, intel, connectivity
|
|
priority: int = 100 # OOM priority (lower = more important)
|
|
dependencies: list = [] # Module names that must be running first
|
|
requires_root: bool = False
|
|
requires_capture_bus: bool = False
|
|
|
|
def __init__(self, bus, state, config, engine=None):
|
|
self.bus = bus
|
|
self.state = state
|
|
self.config = config
|
|
self.engine = engine
|
|
self._running = False
|
|
self._pid = None
|
|
self._start_time = None
|
|
|
|
@abstractmethod
|
|
def start(self) -> None:
|
|
"""Start the module. Called by the engine in the module's own process."""
|
|
...
|
|
|
|
@abstractmethod
|
|
def stop(self) -> None:
|
|
"""Stop the module gracefully."""
|
|
...
|
|
|
|
@abstractmethod
|
|
def status(self) -> dict:
|
|
"""Return module status dict.
|
|
|
|
Returns:
|
|
{"running": bool, "pid": int, "uptime": float, "ram_mb": float, "cpu_pct": float}
|
|
"""
|
|
...
|
|
|
|
@abstractmethod
|
|
def configure(self, config: dict) -> None:
|
|
"""Apply new configuration to a running module."""
|
|
...
|
|
|
|
def health_check(self) -> bool:
|
|
"""Check if the module is healthy. Override for custom checks."""
|
|
try:
|
|
return self.status().get("running", False)
|
|
except Exception:
|
|
return False
|