### set arp

Use the set arp command to

- Manually configure an entry in the Address Resolution Protocol (ARP) Table

- Display the contents of the ARP table

- Remove an entry from the ARP table

The ARP table contains the Ethernet-to-IP address mappings of other devices on the local subnetwork. Digi device/terminal servers require these mappings to communicate with these devices. The ARP protocol updates this table automatically, so manual modification is usually not required.

Anyone can view the ARP table. Root privileges are required to configure or remove entries.

#### Command Syntax

##### Configuration Syntax

Enter the set arp command as shown below to configure entries in the arp table.

`set arp ether=ether_addr ip=ip_addr [tim2liv=time]`

##### Display Syntax

Enter the set arp command as shown below to display the contents of the arp table.

`set arp [range=index_start-index_end]`

##### Remove Entry Syntax

Enter the set arp command as shown below to remove entries from the arp table.

`set arp range=index_start-index_end rmarp=on`

#### Command Fields

Command Field | Description
ether | Specifies the Ethernet address of a device.
ip | Specifies the IP address of a host or device.
range | Specifies a range of table entries, which are identified by the index field in the ARP table.
rmarp | on - means remove ARP entries specified on the range field.
tim2liv | Specifies the time, in seconds, to keep an entry in the ARP Table. The range is 0 to 1200 seconds. The default is 0, which means the entry will never time out (when displaying the ARP table, a tim2liv value of 0 will be displayed as PERM, indicating a permanent entry).

#### Command Examples

##### Displaying a Range of Entries

In this example, the set arp command displays a range of ARP table entries:

`set arp range=1-4`

##### Displaying All Entries

In this example, the set arp command displays the entire ARP table:

`set arp`

##### Configuring an Entry

In this example, the set arp command configures an ARP entry:

`set arp ip=198.150.150.10 ether=08:00:20:05:0b:da tim2liv=900`

##### Changing the tim2liv

In this example, the set arp command configures the period for which an ARP table entry should be maintained:

`set arp range=1 tim2liv=120`

##### Removing a Range of Entries

In this example, the set arp command removes a range of entries from the ARP table:

`set arp range=1-7 rmarp=on`