Skip to main content
Version: current

neighbor


ip/neighbor

Type: Directory

The neighbor list shows all discovered neighbors in the Layer 2 broadcast domain. It shows to which interface the neighbor is connected, its IP/MAC addresses, and other related parameters.

The number of neighbor entries is limited to (total RAM in megabytes) * 16 per interface to avoid memory exhaustion.

[admin@MikroTik] /ip/neighbor/print
# INTERFACE ADDRESS MAC-ADDRESS IDENTITY VERSION BOARD
0 ether13 192.168.33.2 00:0C:42:00:38:9F MikroTik 5.99 RB1100AHx2
1 ether11 1.1.1.4 00:0C:42:40:94:25 test-host 5.8 RB1000
2 Local 10.0.11.203 00:02:B9:3E:AD:E0 c2611-r1 Cisco I...
3 Local 10.0.11.47 00:0C:42:84:25:BA 11.47-750 5.7 RB750
4 Local 10.0.11.254 00:0C:42:70:04:83 tsys-sw1 5.8 RB750G
5 Local 10.0.11.202 00:17:5A:90:66:08 c7200 Cisco I...
Read-only ArgumentTypeDescription
interfacemulti { interface: iface_enum }Interface name to which the discovered device is connected. Shows both the master interface and the actual slave interface.
addressalt { address4: ipAddr , address6: ip6Addr }The highest IP address configured on a discovered device.
address4ipAddrIPv4 address configured on a discovered device.
address6ip6AddrIPv6 address configured on a discovered device.
mac-addressmacAddrMAC address of the remote device. Can be used to connect with mac-telnet.
identitystringConfigured system identity of the discovered device.
platformstringName of the platform, e.g. "MikroTik", "cisco".
versionstringVersion number of installed software on the remote device.
unpackenum (none | simple | uncompress-headers | uncompress-all) { none:0x00, simple:0x01, uncompress-headers:0x03, uncompress-all:0x07 }Discovery packet compression type.
agetimeTime interval since the last discovery packet was received.
uptimetimeUptime of the remote device. Shown only for devices with RouterOS installed.
software-idstringRouterOS software ID on the remote device. Applies only to devices with RouterOS installed.
boardstringRouterBoard model. Displayed only for devices with RouterOS installed.
ipv6boolWhether the device has IPv6 enabled.
interface-namestringInterface name on the neighbor device connected to the L2 broadcast domain. Applies to CDP.
system-descriptionstringSystem description reported by the Link Layer Discovery Protocol (LLDP).
system-capsubit (other, repeater, bridge, wlan-ap, router, telephone, docsis-cable-device, station-only)System capabilities reported by LLDP.
system-caps-enabledubit (other, repeater, bridge, wlan-ap, router, telephone, docsis-cable-device, station-only)Enabled system capabilities reported by LLDP.
discovered-byubit (cdp, lldp, mndp)Discovery protocols through which the neighbor was discovered.
running ( unset )multi { array-id, cap: string }List of features running on the neighbor device. Currently lists only the CAPsMAN feature.