docs: traceroute names the hop that stopped it, and ends the walk there (#1516) #1626

Merged
jaylouisw merged 1 commit from docs/1116-0715 into main 2026-11-16 07:23:59 +00:00
Owner

f5d06378 (#1610) taught traceroute to stop at a probe that was stopped by a down cable, a shut port, a denying ACL or a forbidden VLAN, and to print the recorded reason in brackets ( 2 * no reply (link down)). Neither doc said so:

  • docs/SIMULATION.md 3.3 ICMP row claimed "a silent hop prints *" and said nothing about the walk ending at a structural drop, so a pulled cable read as thirty identical stars.
  • docs/CLI.md's command table described only time-exceeded and echo-reply, and the page had no place that explained the bracketed clause.

Both corrected. The transcript added to docs/CLI.md (#A trace that stops where the cable did) was reproduced from the engine: PC1 to a server two routed hops away, PC1's own cable pulled via setLinkState, 1 * no reply (link down), walk stops after one hop. The deliberate non-final case is stated too — a no ARP reply from <ip> hop prints its reason and the walk continues, per FINAL_DROP in engine/simulator.js, verified with a next hop nobody owns (30 hops, each carrying the reason).

Docs only — no engine, test or script changes.

Guards: syntax-check 342 files OK; no control bytes; doc citations 350, 0 new suspects; docs-show-commands 7 passed / 0 failed (47 forms); help-completeness 8 passed / 0 failed.

`f5d06378` (#1610) taught traceroute to stop at a probe that was stopped by a down cable, a shut port, a denying ACL or a forbidden VLAN, and to print the recorded reason in brackets (` 2 * no reply (link down)`). Neither doc said so: - `docs/SIMULATION.md` `3.3 ICMP` row claimed *"a silent hop prints `*`"* and said nothing about the walk ending at a structural drop, so a pulled cable read as thirty identical stars. - `docs/CLI.md`'s command table described only time-exceeded and echo-reply, and the page had no place that explained the bracketed clause. Both corrected. The transcript added to `docs/CLI.md` (#A trace that stops where the cable did) was reproduced from the engine: PC1 to a server two routed hops away, PC1's own cable pulled via `setLinkState`, ` 1 * no reply (link down)`, walk stops after one hop. The deliberate non-final case is stated too — a `no ARP reply from <ip>` hop prints its reason and the walk continues, per `FINAL_DROP` in `engine/simulator.js`, verified with a next hop nobody owns (30 hops, each carrying the reason). Docs only — no engine, test or script changes. Guards: syntax-check 342 files OK; no control bytes; doc citations 350, 0 new suspects; docs-show-commands 7 passed / 0 failed (47 forms); help-completeness 8 passed / 0 failed.
docs: traceroute names the hop that stopped it and ends the walk there (#1516, #1610)
All checks were successful
CI / Classify the change (pull_request) Successful in 12s
PR rebase / Rebase onto main and arm auto-merge (pull_request) Successful in 16s
CI / Server smoke test (pull_request) Has been skipped
CI / Docker build (pull_request) Has been skipped
CI / Test (Node 20) (pull_request) Successful in 1m17s
CI / Test (Node 18) (pull_request) Successful in 1m28s
CI / Test (Node 22) (pull_request) Successful in 1m36s
b59a097ae5
Engine changed in 72d... (f5d06378): a probe stopped by a down cable, a shut port,
a denying ACL or a forbidden VLAN carries the reason in `*  no reply  (<reason>)`
and ends the walk, instead of thirty identical stars. docs/SIMULATION.md still said
a silent hop simply prints `*`, and docs/CLI.md's command table described only
time-exceeded and echo-reply. Both corrected, with a transcript reproduced from the
engine (PC1's cable pulled) and the deliberate non-final `no ARP reply` case.
jaylouisw scheduled this pull request to auto merge when all checks succeed 2026-11-16 07:23:52 +00:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
jaylouisw/packetforge!1626
No description provided.