cli(traceroute): max <n> caps the walk the index has promised since #1484 #2437
No reviewers
Labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
jaylouisw/packetforge!2437
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "rev/1121-1442"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Question
A Cisco-style box's
traceroutehop cap: what it is called on the line, what range it accepts, and what the box prints after the last hop when the cap - not the destination - ended the walk.helphas advertisedtraceroute|tracert <address|name> [max <n>]since #1484, anddocs/CLI.mdrecorded the row as "indexed and not implemented":_traceroute()readtokens[0]only, somax 5was swallowed in silence and every trace ran thirty hops - whileSimulator.traceroute()has takenopts.maxHopsall along (its tests exercise 1, 2, 3 and 5).Evidence
Maximum Time to Live [30]- "The traceroute command terminates when the destination is reached or when this value is reached." No closing line is described; the worked capture ends at the last hop.traceroute ip {...} [ttl max-ttl]withttl max-ttl ... (Range: 1-255), default 30; "terminates when the destination responds, when the maximum TTL is exceeded, or when the user interrupts".ttl min_ttl max_ttl;max-ttl"The largest TTL value that can be used. The default is 30. The command terminates ... when the value is reached."[max max], "the maximum time-to-live (TTL) ... default value is 30" (its output shape is Linux's, not IOS's).maxttl"an integer from 1 through 255 ... Default: 30".Verdict: the cap exists on every IOS-family form, defaults to 30, accepts 1-255, and nothing is printed after the last hop. The keyword is split across platforms (
ttl <max>,ttl <min> <max>,max,maxttl); classic IOS has only the interactive prompt.What changed
engine/cli.js_traceroute(): parsesmax <n>after the target, validates 1-255, refuses (by name, no probe sent) a missing value, a non-numeric or out-of-range value, a secondmax, and any other word after the target; passes{ maxHops: n }to the walk.engine/simulator.js:maxHopsclamp 64 -> 255, so an accepted value is the value used.after 1 hop).helpnow reads[max <1-255>];docs/CLI.mdgains "The hop limit" and stops calling the row half-implemented.research/traceroute-hop-cap.md: evidence table, verdict, unadopted spellings, open questions.test/traceroute-max-hops.test.js: 34 assertions.Gates
node scripts/syntax-check.js: 538 files OK.npm test: 458 suites, 15535 assertions, 0 failed.Unresolved
Which keyword an IOS-faithful console should adopt (
ttlforms not added - a second grammar, not the completion of this one); theminlower bound and how hop numbers are numbered when it is used; a capture of a cap hit on a silent tail;probe/timeoutkeywords are out of scope.max <n>caps the walk the index has promised since #1484 (#2437)