How jm33-m0/emp3r0r works
emp3r0r is a cross-platform, memory-only command-and-control framework. An operator uses the console to issue work; the C2 server admits authenticated agents, routes commands and streams, and returns agent responses for operator handling. Agents execute through command handlers and extensible script/native-module runtimes, while transport and mesh subsystems provide resilient links and peer relaying. The README also documents file transfer, listeners/stagers, PFS, and Linux eBPF capabilities. Edges are limited to relationships visible in excerpts or documented in the README; unsampled subsystem links are omitted where not explicit.
Main entry points: server_main.go C2 server · handler_messagetun.go Message tunnel · handler.go Command handling · mod.go Agent modules
Components 24
Operator control
- C2 console
core/cmd/cc/main.go - Operator commands
core/internal/cc/operator/cmd.go - Job tracking
core/internal/cc/jobs/manager.go - Operator API client
core/internal/cc/api/client/client.go
C2 services
- C2 server
core/internal/cc/server/server_main.go - Agent check-in
core/internal/cc/server/handler_checkin.go - Message tunnel
core/internal/cc/server/handler_messagetun.go - Agent trust and state
core/internal/cc/base/agents/agentdb.go - File transfer service
core/internal/cc/base/ftp/handler_ftp.go
Agent runtime
- Agent process
core/cmd/agent/agent.go - Command handling
core/internal/agent/handler/handler.go - Agent C2 transport
core/internal/agent/base/c2transport/connector.go
Transport and mesh
- Peer mesh
core/internal/agent/mesh/service.go - C2 transport
core/internal/transport/c2transport.go - Listeners
core/lib/listener/manager.go - Preflight gate
core/lib/preflight/server.go
Execution extensions
- Starlark runtime
core/lib/script/engine.go - Agent modules
core/internal/agent/modules/mod.go - COFF and ELF loaders
core/lib/coffloader/loader_linux.go - In-memory libraries
core/lib/memmod/memmod_elf_linux.go - Linux eBPF APIs
core/lib/libbpf/libbpf_linux.go - Bundled modules
core/modules
Other components
- Operator
- Agent network
Connections 27
- Operator → C2 console: operates
- C2 console → C2 server: starts or connects
core/cmd/cc/main.go - C2 console → Operator commands: dispatches commands
- Operator commands → Operator API client: issues requests
- Operator commands → Job tracking: tracks jobs
- C2 server → Agent check-in: routes check-ins
- Agent check-in → Agent trust and state: checks identity
core/internal/cc/server/handler_checkin.go - C2 server → Message tunnel: handles tunnels
- Message tunnel → Agent trust and state: authenticates sessions
core/internal/cc/server/handler_messagetun.go - Message tunnel → Job tracking: receives output
- C2 server → File transfer service: serves transfers
- Agent process → Command handling: dispatches commands
- Command handling → Agent C2 transport: uses transport
core/internal/agent/handler/handler.go - Agent C2 transport → C2 transport: communicates over
- C2 transport → Agent network: sends traffic
- Agent network → Agent check-in: reaches C2
- Message tunnel → Operator API client: returns responses
- Agent process → Peer mesh: runs peer mesh
- Peer mesh → Agent network: gossips with peers
core/internal/agent/mesh/service.go - Command handling → Starlark runtime: runs scripts
- Command handling → Agent modules: dispatches modules
- Agent modules → COFF and ELF loaders: loads native objects
- Agent modules → In-memory libraries: maps libraries
- Starlark runtime → Linux eBPF APIs: exposes eBPF
README.md - Agent modules → Bundled modules: loads bundled modules
README.md - Listeners → Agent network: accepts connections
- Agent process → Preflight gate: checks admission