arp: restructure chapter

- Use initial passage from WikiPedia (thanks)
- use new style .. option:: for operational commands
This commit is contained in:
Christian Poessinger 2019-11-19 07:16:57 +01:00
parent 40a202c3b9
commit d31736cd25

View File

@ -1,34 +1,44 @@
.. _routing-arp:
Address Resolution Protocol (ARP)
---------------------------------
ARP
---
To manipulate or display ARP_ table entries, the following commands are implemented.
: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.
adding a static arp entry
^^^^^^^^^^^^^^^^^^^^^^^^^
In Internet Protocol Version 6 (IPv6) networks, the functionality of ARP is
provided by the Neighbor Discovery Protocol (NDP).
.. code-block:: sh
To manipulate or display ARP_ table entries, the following commands are
implemented.
set protocols static arp 10.1.1.100 hwaddr 08:00:27:de:23:aa
commit
.. option:: set protocols static arp 10.1.1.100 hwaddr 08:00:27:de:23:aa
display arp table entries
^^^^^^^^^^^^^^^^^^^^^^^^^
adding a static arp entry
.. code-block:: sh
.. option:: show protocols static arp
show protocols static arp
In operational level, display all known ARP table entries
..
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
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
.. code-block:: sh
.. option:: show protocols static arp interface eth1
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
In operational level, display all known ARP table entries on a specific
interface.
..
.. _ARP: https://en.wikipedia.org/wiki/Address_Resolution_Protocol
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