How knownsec/ksubdomain works
ksubdomain is a high-speed, stateless DNS brute-force and validation tool. Users provide target domains and wordlists through flags, files, or stdin; the runtime builds DNS probes, sends them through a selected network device, captures replies, and retries unanswered probes. Successful answers can be expanded to deeper labels and written to output. Documented branches include script-based API discovery, wildcard handling, ASN/IP-range summaries, and CSV output. The main execution and packet paths are excerpted; some optional capability links are documented only in the README.
Main entry points: start.go Scan runner · recv.go Packet receiver · send.go DNS probe sender · script.go Lua script engine
Components 19
Inputs and orchestration
- CLI options
core/options.go - Scan runner
core/start.go - Input streams
core/start.go
Discovery and probes
- Device selection
core/device.go - API sources
core/sources.go - Lua script engine
core/script.go - DNS probe sender
core/send.go
Replies and results
- Packet receiver
core/recv.go - Probe state
core/localStruct.go - Retry tracking
core/start.go - DNS results
core/recv.go
Result enrichment
- Wildcard filtering
core/filterwild.go - ASN summary
core/summary.go - IP range utilities
core/network.go - Spreadsheet export
core/excel.go
Other components
- User
- Network device
- API scripts
resources/scripts - DNS resolvers
Connections 22
- User → CLI options: sets flags
core/options.go - CLI options → Scan runner: starts scan
- Scan runner → Input streams: reads input
core/start.go - Scan runner → Device selection: selects device
core/start.go - Device selection → Network device: uses device
- Scan runner → Packet receiver: starts capture
core/start.go - Scan runner → DNS probe sender: initializes sender
core/start.go - Scan runner → API sources: runs API mode
core/start.go - API sources → Lua script engine: uses scripts
- Lua script engine → API scripts: loads scripts
readme.md - Lua script engine → DNS resolvers: queries web APIs
readme.md - Scan runner → Retry tracking: dispatches retries
core/start.go - Retry tracking → DNS probe sender: resends probes
core/start.go - DNS probe sender → Probe state: records probes
core/send.go - DNS probe sender → DNS resolvers: sends DNS probes
- Packet receiver → Probe state: matches replies
core/recv.go - Packet receiver → Retry tracking: queues deeper probes
core/recv.go - Packet receiver → DNS results: writes answers
core/recv.go - Packet receiver → Wildcard filtering: feeds output
readme.md - Scan runner → ASN summary: runs summary
core/start.go - ASN summary → IP range utilities: uses IP ranges
- Scan runner → Spreadsheet export: exports spreadsheet
readme.md