docs(SIMULATION): MAC ageing is modelled, and the Absent row says so no longer #2070

Merged
jaylouisw merged 1 commit from docs/1119-0217 into main 2026-11-19 02:40:04 +00:00
Owner

docs/SIMULATION.md §2.1 listed MAC ageing among the Absent behaviours. The engine has aged dynamic entries since #1395:

  • MAC_AGE_MS = 300000 (engine/device.js:6)
  • macLookup(vid, mac, nowMs) answers null past it, so the data path floods rather than sending to a port the table only remembers (engine/device.js:882)
  • ageMacs(nowMs) sweeps the table (engine/device.js:894, called from macRows())

§2.2 of the same page already said entries age out after 300 s, and test/mac-ageing.test.js (19 checks) pins it — so the page contradicted itself in two adjacent sections.

The Absent row keeps the items that really are absent (MAC move detection, per-port MAC limits, port security, storm control, error counters, CRC/FCS errors, collisions) and a new Modelled row states the ageing rule and its citations.

Docs-only. Guards: syntax-check 434 files OK; docs-show-commands 7/7 (59 forms, 118 commands); docs-cli-transcript 4/4; help-completeness 8/8 (102 advertised commands, 19 mechanisms, 16 shows); no-form-help-key 81/81; help-key-works-in-every-prompt 10/10.

`docs/SIMULATION.md` §2.1 listed **MAC ageing** among the Absent behaviours. The engine has aged dynamic entries since #1395: - `MAC_AGE_MS = 300000` (`engine/device.js:6`) - `macLookup(vid, mac, nowMs)` answers `null` past it, so the data path floods rather than sending to a port the table only remembers (`engine/device.js:882`) - `ageMacs(nowMs)` sweeps the table (`engine/device.js:894`, called from `macRows()`) §2.2 of the same page already said entries age out after 300 s, and `test/mac-ageing.test.js` (19 checks) pins it — so the page contradicted itself in two adjacent sections. The Absent row keeps the items that really are absent (MAC move detection, per-port MAC limits, port security, storm control, error counters, CRC/FCS errors, collisions) and a new Modelled row states the ageing rule and its citations. Docs-only. Guards: syntax-check 434 files OK; docs-show-commands 7/7 (59 forms, 118 commands); docs-cli-transcript 4/4; help-completeness 8/8 (102 advertised commands, 19 mechanisms, 16 shows); no-form-help-key 81/81; help-key-works-in-every-prompt 10/10.
docs(SIMULATION): MAC ageing is modelled, and the Absent row says so no longer
All checks were successful
PR rebase / Rebase onto main and arm auto-merge (pull_request) Successful in 4s
CI / Classify the change (pull_request) Successful in 6s
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 55s
CI / Test (Node 22) (pull_request) Successful in 55s
CI / Test (Node 18) (pull_request) Successful in 1m2s
CI / Arm auto-merge (pull_request) Successful in 3s
e9b49b4252
§2.1 listed 'MAC ageing' as Absent. The engine has aged dynamic entries since
#1395: MAC_AGE_MS is 300 s (engine/device.js:6), macLookup() answers nothing
past it so the data path floods rather than sending to a remembered port, and
ageMacs() sweeps the table. §2.2 of the same page already said so, and
test/mac-ageing.test.js (19 checks) pins the behaviour, so the page contradicted
itself. The row now carries the modelled behaviour and keeps the genuinely
absent items (MAC move detection, port security, storm control, error counters,
CRC/FCS errors, collisions) in the Absent row.
forgejo-actions scheduled this pull request to auto merge when all checks succeed 2026-11-19 02:30:32 +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!2070
No description provided.