feat: ARP_AGE_UNKNOWN, the age of a neighbour the device does not report #57

Merged
christianmanivong merged 1 commits from fix/arp-unknown-age into main 2026-10-30 09:20:21 +00:00
Owner

ARP_AGE_UNKNOWN (napalm_device_types.arp, -1.0): the age a driver reports in get_arp_table and get_ipv6_neighbors_table when the device does not say how old an entry is.

NAPALM requires an age on every entry, and many devices have none (ip neigh, /proc/net/arp, a router's host list). Drivers filled in 0.0, which means "confirmed just now", and an application ranking sightings by freshness takes it at its word. -1.0 is NAPALM's own value for this (its IOS driver reports it). An expiry countdown is not an age either. The README states the contract; CHANGELOG under Unreleased.

Test: tests/test_arp_age.py.

Refs NetOrk/netork#1327. The driver PRs (fritzbox, openwrt, zyxel, linux, tplink-jetstream, windows, proxmox, opnsense, bsd, netgear) follow this contract.

Priority: P4 (blocks NetOrk/netork#1190)

`ARP_AGE_UNKNOWN` (`napalm_device_types.arp`, `-1.0`): the `age` a driver reports in `get_arp_table` and `get_ipv6_neighbors_table` when the device does not say how old an entry is. NAPALM requires an age on every entry, and many devices have none (`ip neigh`, `/proc/net/arp`, a router's host list). Drivers filled in `0.0`, which means "confirmed just now", and an application ranking sightings by freshness takes it at its word. `-1.0` is NAPALM's own value for this (its IOS driver reports it). An expiry countdown is not an age either. The README states the contract; CHANGELOG under Unreleased. Test: `tests/test_arp_age.py`. Refs NetOrk/netork#1327. The driver PRs (fritzbox, openwrt, zyxel, linux, tplink-jetstream, windows, proxmox, opnsense, bsd, netgear) follow this contract. Priority: P4 (blocks NetOrk/netork#1190)
christianmanivong added 1 commit 2026-10-30 07:37:26 +00:00
feat: ARP_AGE_UNKNOWN, the age of a neighbour the device does not report
driver / standard (pull_request) Successful in 17s
driver / lint (pull_request) Successful in 18s
driver / types (pull_request) Successful in 1m12s
driver / test (3.12) (pull_request) Successful in 1m13s
driver / test (3.13) (pull_request) Successful in 1m8s
driver / lowest (pull_request) Successful in 31s
driver / build (pull_request) Successful in 35s
driver / security (pull_request) Successful in 1m15s
CI / driver (pull_request) Successful in 3m3s
driver / publish (pull_request) Skipped
874c6c5a92
NAPALM requires an age on every entry of get_arp_table and
get_ipv6_neighbors_table. Many devices do not report one, and drivers
filled in 0.0, which means "confirmed just now". ARP_AGE_UNKNOWN (-1.0, as
NAPALM's IOS driver reports) is the value for "not reported"; the README
states the contract.

NetOrk/netork#1327
christianmanivong merged commit 131346c228 into main 2026-10-30 09:20:21 +00:00
christianmanivong deleted branch fix/arp-unknown-age 2026-10-30 09:20:21 +00:00
Sign in to join this conversation.