summaryrefslogtreecommitdiff
path: root/docs/routing/arp.rst
blob: 55b8666f6b086b39ecb39dbe718c8d0ab6b73f16 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
.. _routing-arp:

ARP
---

:abbr:`ARP (Address Resolution Protocol)` is a communication protocol used for
discovering the link layer address, such as a MAC address, associated with a
given internet layer address, typically an IPv4 address. This mapping is a
critical function in the Internet protocol suite. ARP was defined in 1982 by
:rfc:`826` which is Internet Standard STD 37.

In Internet Protocol Version 6 (IPv6) networks, the functionality of ARP is
provided by the Neighbor Discovery Protocol (NDP).

To manipulate or display ARP_ table entries, the following commands are
implemented.

.. option:: set protocols static arp 10.1.1.100 hwaddr 08:00:27:de:23:aa

   adding a static arp entry

.. option:: show protocols static arp

   In operational level, display all known ARP table entries
   ..

     vyos@vyos:~$ show protocols static arp
     Address                  HWtype  HWaddress           Flags Mask     Iface
     10.1.1.1                 ether   08:00:27:de:23:2e   C              eth1
     10.1.1.100               ether   08:00:27:de:23:aa   CM             eth1

.. option:: show protocols static arp interface eth1

   In operational level, display all known ARP table entries on a specific
   interface.
  
   ..

     vyos@vyos:~$ show protocols static arp interface eth1
     Address                  HWtype  HWaddress           Flags Mask     Iface
     10.1.1.1                 ether   08:00:27:de:23:2e   C              eth1
     10.1.1.100               ether   08:00:27:de:23:aa   CM             eth1

.. _ARP: https://en.wikipedia.org/wiki/Address_Resolution_Protocol