You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit f9b5003
Browse filesBrowse the repository at this point in the historyBrowse files
Document -no-abort and -max-queries, generate GitHub release notes, and pin go.mod at 1.24.2. A patchless go 1.24 line makes go build refuse to run because charmbracelet/bubbles requires 1.24.2; make tidy is go mod tidy plus a CI grep that fails on drift.
Co-authored-by: Cursor <cursoragent@cursor.com>
Copy file name to clipboardExpand all lines: CHANGELOG.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -28,7 +28,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
28
28
- TUI form now validates domain syntax and DNS server `ip:port` format up front, matching the CLI. The validators were extracted into a shared `internal/validate` package used by both entry points (previously the form only checked for non-empty values).
29
29
-`validate.Domain` now enforces the 63-character per-label limit and accepts punycode TLDs (`xn--...`).
30
30
-`Version` is a `var` injected via `-ldflags "-X main.Version=$(git describe --tags --dirty)"`. `-version` writes to stdout.
31
-
-`go` directive is `1.24`. golangci-lint CI is pinned to v2.12.2. Docker final stage is distroless static nonroot, with builder and runtime images pinned by digest.
31
+
-`go` directive is `1.24.2` (required by charmbracelet/bubbles; a patchless `go 1.24` makes `go build` demand tidy). golangci-lint CI is pinned to v2.12.2. Docker final stage is distroless static nonroot, with builder and runtime images pinned by digest. Tagged releases generate GitHub release notes.
32
32
33
33
### Removed
34
34
- Removed the unused `dns.Resolve` function, superseded by `dns.ResolveTypes`.
@@ -42,7 +42,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
42
42
- Refreshed the DEVELOPER_GUIDE: removed "Future Development" items that already shipped, updated the file tree, and corrected `dns` package references.
43
43
- Fixed stale references in `DOCUMENTATION_STRUCTURE.md` (changelog path) and README (package blurbs).
44
44
- Added `docs/ROADMAP.md` capturing the prioritized review findings and follow-up plan.
45
-
- GitHub Pages landing page (`docs/index.md`) refreshed to the 0.6.0 feature set, adding cards for Output Formats (`-format`), Rate Limiting (`-rate`), Record Types (`-type`), and Recursive Enumeration (`-recursive`/`-depth`).
45
+
- GitHub Pages landing page (`docs/index.md`) covers the 0.7.0 feature set: scan accounting, `-no-abort`, `-max-queries`, the recursion ceiling, and wildcard fingerprint filtering.
46
46
- Normalized em dashes to hyphens across `docs/` for consistency with the no-em-dash convention.
47
47
- Documented outcome classification, `EventDone.Stats`, and the reliability guard in ARCHITECTURE.
48
48
- Corrected ARCHITECTURE output-format note (TUI file output shipped in P5) and DEVELOPER_GUIDE "CLI-only zero deps" claim.
Copy file name to clipboardExpand all lines: README.md
+6-2Lines changed: 6 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -71,7 +71,9 @@ Or launch the interactive terminal UI with no flags:
71
71
| :--- | :--- |
72
72
| Worker Pool | Spawn N goroutines for parallel DNS resolution with a configurable concurrency ceiling |
73
73
| DNS Engine | Resolve subdomains against any DNS server with per-query timeouts and retry backoff |
74
-
| Wildcard Detection | Double-probe check before scanning; aborts early unless `-force` is set |
74
+
| Wildcard Detection | Double-probe check before scanning; aborts early unless `-force` is set. With `-force`, answers that match the wildcard fingerprint are dropped |
75
+
| Scan Accounting | Every query is counted as resolved, nxdomain, timeout, refused, or other. After 200 queries a >20% infrastructure failure rate aborts unless `-no-abort` is set |
76
+
| Query Cap |`-max-queries` stops admitting work. Recursive scans warn about the theoretical ceiling and refuse to start above 1e7 jobs unless `-max-queries` or `-force` is set |
| Input Validation | RFC-compliant domain syntax and strict `ip:port` format enforcement |
77
79
| Wordlist Dedup | Deduplicate wordlist entries in a single pass before scanning begins |
@@ -201,6 +203,8 @@ make help # list all targets
201
203
|`-dns-server <ip:port>`|`8.8.8.8:53`| DNS server address (validated on startup) |
202
204
|`-attempts <n>`|`1`| DNS resolution attempts per subdomain (1 = no retry) |
203
205
|`-force`|`false`| Continue scanning even if wildcard DNS is detected |
206
+
|`-no-abort`|`false`| Keep scanning after the 20% resolver failure-rate abort (warning is still emitted) |
207
+
|`-max-queries <n>`|`0`| Max DNS lookups to admit (0 = unlimited) |
204
208
|`-o <file>`| n/a | Write results to file in addition to stdout |
205
209
|`-format <fmt>`|`text`| Output format: `text`, `json`, or `csv`|
206
210
|`-rate <qps>`|`0`| Max DNS queries per second across all workers (0 = unlimited) |
@@ -218,7 +222,7 @@ make help # list all targets
218
222
<br>
219
223
220
224
> [!NOTE]
221
-
> Wildcard DNS is detected automatically before scanning begins. If the target resolves wildcard records, the tool exits with a warning, since all subdomains would match, making results meaningless. Pass `-force` to override.
225
+
> Wildcard DNS is detected automatically before scanning begins. If the target resolves wildcard records, the tool exits with a warning, since all subdomains would match, making results meaningless. Pass `-force` to override. With `-force`, results whose records are a subset of the wildcard fingerprint are still dropped and counted as `wildcard-filtered`. Recursive scans probe each new parent and skip expanding wildcard branches.
222
226
223
227
> [!CAUTION]
224
228
> Simulation mode (`-simulate`) generates synthetic results and performs zero network I/O. Do not confuse simulated output with real DNS data.
The flow of data through the `subenum` application can be summarized as follows:
141
141
142
-
1.**Input**: The user provides command-line arguments: the target domain, the path to a wordlist file (`-w`), a concurrency level (`-t`), a DNS timeout (`-timeout`), a DNS server (`-dns-server`), attempts (`-attempts`), output options (`-o`, `-format`), and scan tuning (`-rate`, `-type`, `-recursive`, `-depth`), plus flags for verbose mode (`-v`), progress reporting (`-progress`), and force mode (`-force`). The TUI (`-tui`) gathers the equivalent values from its form instead.
142
+
1.**Input**: The user provides command-line arguments: the target domain, the path to a wordlist file (`-w`), a concurrency level (`-t`), a DNS timeout (`-timeout`), a DNS server (`-dns-server`), attempts (`-attempts`), output options (`-o`, `-format`), and scan tuning (`-rate`, `-type`, `-recursive`, `-depth`, `-max-queries`, `-no-abort`), plus flags for verbose mode (`-v`), progress reporting (`-progress`), and force mode (`-force`). The TUI (`-tui`) gathers the equivalent values from its form instead.
143
143
2.**Configuration**: These arguments are parsed and validated by the **Argument Parsing** component and assembled into a `scan.Config`, which is the single input to the scan engine.
144
144
3.**Preflight and wildcard detection**: Inside `scan.Run` the apex is resolved once; any outcome other than Found or NXDOMAIN emits `EventError` naming the resolver and returns. Then two random subdomains are resolved (skipped in simulation mode). The union of those answers is the wildcard fingerprint. If either resolves, an `EventWildcard` is emitted; the scan aborts unless `-force` is set. With `-force`, later results whose records are a subset of the fingerprint are dropped. In recursive mode the same probe is run against each newly resolved parent before expansion; a wildcard branch is skipped. `-recursive` also computes the job ceiling and refuses to start above 1e7 unless `-max-queries` or `-force` is set.
145
145
4.**Wordlist Loading**: `wordlist.LoadWordlist` reads the file in a single pass, sanitizes lines, and deduplicates entries into a slice, which is passed to `scan.Run` via `Config.Entries`.
Copy file name to clipboardExpand all lines: docs/index.md
+9-1Lines changed: 9 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -29,7 +29,7 @@ subenum brute-forces subdomains by resolving a wordlist against a target domain
29
29
</div>
30
30
<divclass="feature-card">
31
31
<strong>Wildcard Detection</strong>
32
-
<span>Double-probe check before scanning; exits early unless <code>-force</code> is set.</span>
32
+
<span>Double-probe check before scanning; exits early unless <code>-force</code> is set. With <code>-force</code>, answers matching the wildcard fingerprint are dropped. Recursive scans skip expanding wildcard branches.</span>
33
33
</div>
34
34
<divclass="feature-card">
35
35
<strong>Interactive TUI</strong>
@@ -71,6 +71,14 @@ subenum brute-forces subdomains by resolving a wordlist against a target domain
71
71
<strong>Input Validation</strong>
72
72
<span>RFC-compliant domain syntax and strict <code>ip:port</code> format enforcement on startup.</span>
73
73
</div>
74
+
<divclass="feature-card">
75
+
<strong>Scan Accounting</strong>
76
+
<span>Every query is counted as resolved, nxdomain, timeout, refused, or other. After 200 queries a greater than 20% infrastructure failure rate aborts unless <code>-no-abort</code> is set.</span>
77
+
</div>
78
+
<divclass="feature-card">
79
+
<strong>Query Cap</strong>
80
+
<span><code>-max-queries</code> stops admitting work. Recursive scans warn about the theoretical ceiling and refuse to start above 1e7 jobs unless <code>-max-queries</code> or <code>-force</code> is set.</span>
0 commit comments