show arp: print the vendor's Type column between the hardware address and the interface #1625

Merged
jaylouisw merged 1 commit from rev/1116-0700 into main 2026-11-16 07:11:32 +00:00
Owner

The ARP table has six columns in Cisco's own field list - Protocol, Address, Age (min), Hardware Addr, Type, Interface - where Type is ARPA (Ethernet), SNAP (RFC 1042) or SAP (802.3). This console printed five: Type was absent, so a row could not be compared field-for-field against a box's and the encapsulation was never stated.

Type now prints in the vendor's position, filled with ARPA - the only value this model can honestly produce, because SNAP/SAP are encapsulation on Token Ring/FDDI media the catalogue does not carry, and every binding learned here is IPv4 over 802.3 framing. Header and rows are padded from the same widths so the word lands under its heading.

Evidence

Changes: engine/cli.js (one header line, one row line), test/show-arp.test.js (new section: the column is named in position, rows read ARPA, and the value aligns under the heading; column counts 5 to 6), test/arp-ageing.test.js (column indices), docs/CLI.md and docs/ARCHITECTURE.md samples, research/show-arp-type-column.md.

Gates: node scripts/syntax-check.js 342 files OK; full npm test 272 suites, 9796 assertions, 0 failed.

Unresolved (written up, not invented): incomplete (0 Incomplete ARPA) and PROBE entries are not modelled by the data path, so only learned bindings can appear.

The ARP table has six columns in Cisco's own field list - Protocol, Address, Age (min), Hardware Addr, **Type**, Interface - where Type is ARPA (Ethernet), SNAP (RFC 1042) or SAP (802.3). This console printed five: Type was absent, so a row could not be compared field-for-field against a box's and the encapsulation was never stated. Type now prints in the vendor's position, filled with `ARPA` - the only value this model can honestly produce, because SNAP/SAP are encapsulation on Token Ring/FDDI media the catalogue does not carry, and every binding learned here is IPv4 over 802.3 framing. Header and rows are padded from the same widths so the word lands under its heading. **Evidence** - https://www.cisco.com/E-Learning/bulk/public/tac/cim/cib/using_cisco_ios_software/cmdrefs/show_ip_arp.htm (sample + field table: Type = ARPA / SNAP / SAP) - https://www.cisco.com/en/US/docs/ios-xml/ios/ipaddr_arp/configuration/xe-3se/3850/arp-config-arp.pdf - https://www.cisco.com/c/en/us/td/docs/ios-xml/ios/ipaddr_arp/configuration/xe-16-7/arp-xe-16-7-book/arp-config-arp.html **Changes**: engine/cli.js (one header line, one row line), test/show-arp.test.js (new section: the column is named in position, rows read ARPA, and the value aligns under the heading; column counts 5 to 6), test/arp-ageing.test.js (column indices), docs/CLI.md and docs/ARCHITECTURE.md samples, research/show-arp-type-column.md. **Gates**: `node scripts/syntax-check.js` 342 files OK; full `npm test` 272 suites, 9796 assertions, 0 failed. **Unresolved** (written up, not invented): incomplete (`0 Incomplete ARPA`) and PROBE entries are not modelled by the data path, so only learned bindings can appear.
show arp: print the vendor's Type column, between the hardware address and the interface
All checks were successful
CI / Classify the change (pull_request) Successful in 15s
PR rebase / Rebase onto main and arm auto-merge (pull_request) Successful in 15s
CI / Server smoke test (pull_request) Successful in 42s
CI / Test (Node 20) (pull_request) Successful in 1m14s
CI / Docker build (pull_request) Successful in 20s
CI / Test (Node 18) (pull_request) Successful in 1m28s
CI / Test (Node 22) (pull_request) Successful in 1m29s
cae1aaa403
The ARP table has six columns in Cisco's own field list - Protocol, Address, Age (min), Hardware Addr,
Type, Interface - and the Type value is described there as ARPA (Ethernet), SNAP (RFC 1042) or SAP
(802.3). This console printed five: Type was simply absent, so a row could not be lined up against a
box's and the encapsulation was not stated at all.

Type now prints in the vendor's position, filled with ARPA, which is the only value this model can
honestly produce: SNAP and SAP are encap on Token Ring/FDDI media the catalogue does not carry, and every
binding learned here is IPv4 over 802.3 framing. Header and rows are padded from the same widths, so the
word lands under its heading.

Evidence: https://www.cisco.com/E-Learning/bulk/public/tac/cim/cib/using_cisco_ios_software/cmdrefs/show_ip_arp.htm
plus the XE 3SE/16.x ARP configuration guides' show arp samples. Notes and what stays unresolved
(incomplete and PROBE entries, which the data path does not model) in research/show-arp-type-column.md.
jaylouisw changed title from test probe to show arp: print the Type column 2026-11-16 07:09:55 +00:00
jaylouisw changed title from show arp: print the Type column to show arp: print the vendor's Type column between the hardware address and the interface 2026-11-16 07:10:08 +00:00
jaylouisw scheduled this pull request to auto merge when all checks succeed 2026-11-16 07:10:26 +00:00
jaylouisw force-pushed rev/1116-0700 from cae1aaa403
All checks were successful
CI / Classify the change (pull_request) Successful in 15s
PR rebase / Rebase onto main and arm auto-merge (pull_request) Successful in 15s
CI / Server smoke test (pull_request) Successful in 42s
CI / Test (Node 20) (pull_request) Successful in 1m14s
CI / Docker build (pull_request) Successful in 20s
CI / Test (Node 18) (pull_request) Successful in 1m28s
CI / Test (Node 22) (pull_request) Successful in 1m29s
to 36dbe9c9b1
All checks were successful
CI / Classify the change (pull_request) Successful in 16s
PR rebase / Rebase onto main and arm auto-merge (pull_request) Successful in 21s
CI / Server smoke test (pull_request) Successful in 47s
CI / Test (Node 20) (pull_request) Successful in 1m20s
CI / Docker build (pull_request) Successful in 20s
CI / Test (Node 18) (pull_request) Successful in 1m33s
CI / Test (Node 22) (pull_request) Successful in 1m39s
2026-11-16 07:10:29 +00:00
Compare
jaylouisw scheduled this pull request to auto merge when all checks succeed 2026-11-16 07:11:20 +00:00
jaylouisw force-pushed rev/1116-0700 from 36dbe9c9b1
All checks were successful
CI / Classify the change (pull_request) Successful in 16s
PR rebase / Rebase onto main and arm auto-merge (pull_request) Successful in 21s
CI / Server smoke test (pull_request) Successful in 47s
CI / Test (Node 20) (pull_request) Successful in 1m20s
CI / Docker build (pull_request) Successful in 20s
CI / Test (Node 18) (pull_request) Successful in 1m33s
CI / Test (Node 22) (pull_request) Successful in 1m39s
to e5a68f6a1f
All checks were successful
CI / Classify the change (pull_request) Successful in 14s
PR rebase / Rebase onto main and arm auto-merge (pull_request) Successful in 14s
CI / Test (Node 18) (pull_request) Has been skipped
CI / Test (Node 20) (pull_request) Has been skipped
CI / Test (Node 22) (pull_request) Has been skipped
CI / Server smoke test (pull_request) Has been skipped
CI / Docker build (pull_request) Has been skipped
2026-11-16 07:11:23 +00:00
Compare
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!1625
No description provided.