# Neighbor Discovery

The `nv unset` commands remove the configuration you set with the equivalent `nv set` commands. This guide only describes an `nv unset` command if it differs from the `nv set` command.

## nv set interface <interface-id> neighbor ipv6 <ip-address> lladdr <lladdr-id>

Configures a static ARP table entry for an interface with an IPv6 address associated with a MAC address for easy management or as a security measure to prevent spoofing and other nefarious activities.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.
`<ip-address>` | The static IPv6 address.
`<lladdr-id>` | The MAC address you want to associate with IPv6 address.

### Version History

Introduced in Cumulus Linux 5.7.0

### Example

    cumulus@switch:~$ nv set interface swp51 neighbor ipv6 fe80::4ab0:2dff:fea2:4c79 lladdr 00:00:5E:00:53:51

## nv set interface <interface-id> neighbor ipv6 <ip-address> lladdr <lladdr-id> flag

Configures a flag to indicate that the neighbor in the IP neighbor table is a router (`is-router`) or learned externally (`ext_learn`).

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.
`<ip-address>` | The static IPv6 address.
`<lladdr-id>` | The MAC address you want to associate with IPv6 address.

### Version History

Introduced in Cumulus Linux 5.7.0

### Example

    cumulus@switch:~$ nv set interface swp51 neighbor ipv6 fe80::4ab0:2dff:fea2:4c79 lladdr 00:00:5E:00:53:51 flag is-router

## nv set interface <interface-id> neighbor ipv6 <ip-address> lladdr <lladdr-id> state

Configures the state of the neighbor in the IP neighbor table (`delay`, `failed`, `incomplete`, `noarp`, `permanent`, `probe`, `reachable`, or `stale`).

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.
`<ip-address>` | The static IPv6 address.
`<lladdr-id>` | The MAC address you want to associate with IPv6 address.

### Version History

Introduced in Cumulus Linux 5.7.0

### Example

    cumulus@switch:~$ nv set interface swp51 neighbor ipv6 fe80::4ab0:2dff:fea2:4c79 lladdr 00:00:5E:00:53:51 state permanent

## nv set interface <interface-id> ip neighbor-discovery dnssl <domain-name-id>

Configures the ND search lists (DNSSL).

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.
`<domain-name-id>` | The domain portion of a hostname (RFC 1123) or an internationalized hostname (RFC 5890).

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set interface swp1 ip neighbor-discovery dnssl accounting.nvidia.com

## nv set interface <interface-id> ip neighbor-discovery dnssl <domain-name-id> lifetime

Configures the maximum amount of time you want to use the domain suffix for domain name resolution. You can set a value between 0 and 4294967295 seconds or use the keyword `infinte` to set the time to never expire. If you set the value to 0, the host does not use the DNSSL.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.
`<domain-name-id>` | The domain portion of a hostname (RFC 1123) or an internationalized hostname (RFC 5890).

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set interface swp1 ip neighbor-discovery dnssl accounting.nvidia.com lifetime infinite

## nv set interface <interface-id> ip neighbor-discovery state

Enables and disables ND. The default setting is `enabled`.

ND allows different devices on the same link to advertise their existence to their neighbors and to learn about the existence of their neighbors. ND is the IPv6 equivalent of IPv4 ARP for layer 2 address resolution.

In Cumulus Linux 5.14 and earlier, you specify `enable on` or `enable off` instead of `state enabled` or `state disabled`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set interface swp1 ip neighbor-discovery state disabled

## nv set interface <interface-id> ip neighbor-discovery home-agent state

Enables and disables the Home Agent. The default setting is `disabled`.

In Cumulus Linux 5.14 and earlier, you specify `enable on` or `enable off` instead of `state enabled` or `state disabled`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set interface swp1 ip neighbor-discovery home-agent state enabled

## nv set interface <interface-id> ip neighbor-discovery home-agent lifetime

Configures the maximum amount of time you want the router to act as a Home Agent. You can set a value between 0 and 65520 seconds. If you set the value to 0, the router is not a Home Agent. The default setting is 0.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set interface swp1 ip neighbor-discovery home-agent lifetime 200

## nv set interface <interface-id> ip neighbor-discovery home-agent preference

Configures the Home Agent router preference used to order the addresses returned in the Home Agent address discovery reply. You can set a value between 0 and 65535. 0 is the lowest preference. The default setting is 0.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set interface swp1 ip neighbor-discovery home-agent preference 0

## nv set interface <interface-id> ip neighbor-discovery mtu

Configures the MTU for ND messages on an interface. You can set a value between 1 and 65535.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set interface swp1 ip neighbor-discovery mtu 1500

## nv set interface <interface-id> ip neighbor-discovery prefix <ipv6-prefix-id> autoconfig

Configures automatic configuration to indicate to hosts on the local link that they can use the specified prefix for IPv6 auto configuration. The default setting is `disabled`.

In Cumulus Linux 5.14 and earlier, you specify `on` or `off`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.
`<ipv6-address-id>` | The IPv6 address.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set interface swp1 ip neighbor-discovery prefix 2001:db8:1::100/32 autoconfig disabled

## nv set interface <interface-id> ip neighbor-discovery prefix <ipv6-prefix-id> off-link

Configures advertisement to make no statement about prefix on-link or off-link properties. The default setting is `disabled`.

In Cumulus Linux 5.14 and earlier, you specify `on` or `off`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.
`<ipv6-address-id>` | The IPv6 address.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set interface swp1 ip neighbor-discovery prefix 2001:db8:1::100/32 off-link disabled

## nv set interface <interface-id> ip neighbor-discovery prefix <ipv6-prefix-id> preferred-lifetime

Configures the amount of time that addresses generated from a prefix remain preferred. You can specify a value between 0 and 4294967295. The default setting is 604800.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.
`<ipv6-address-id>` | The IPv6 address.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set interface swp1 ip neighbor-discovery prefix 2001:db8:1::100/32 preferred-lifetime 1000000

## nv set interface <interface-id> ip neighbor-discovery prefix <ipv6-prefix-id> router-address

Configures advertisement to indicate to hosts on the local link that the specified prefix contains a complete IP address by setting R flag. The default setting is `disabled`.

In Cumulus Linux 5.14 and earlier, you specify `on` or `off`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.
`<ipv6-address-id>` | The IPv6 address.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set interface swp1 ip neighbor-discovery prefix 2001:db8:1::100/32 router-address enabled

## nv set interface <interface-id> ip neighbor-discovery prefix <ipv6-prefix-id> valid-lifetime

Configures the amount of time that the prefix is valid for on-link determination. You can specify a value between 0 and 4294967295. The default setting is 2592000.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.
`<ipv6-address-id>` | The IPv6 address.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set interface swp1 ip neighbor-discovery prefix 2001:db8:1::100/32 valid-lifetime 2000000000

## nv set interface <interface-id> ipv6 neighbor-discovery rdnss <address-id>

Configures recursive DNS servers (RDNSS). You must specify the IPv6 address of each RDNSS you want to advertise.

In Cumulus Linux 5.14 and earlier, the command is `nv set interface <interface-id> ip neighbor-discovery rdnss <address-id`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.
`<ipv6-address-id>` | The IPv6 address.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set interface swp1 ipv6 neighbor-discovery rdnss 2001:db8:1::100

## nv set interface <interface-id> ipv6 neighbor-discovery rdnss <address-id> lifetime

Configures the maximum amount of time you want to use the RDNSS for domain name resolution. You can specify a value between 0 and 4294967295, or specify `infinite` to use the RDNSS for domain name resolution indefinitely. If you set the value to 0, the RDNSS address no longer advertises.

In Cumulus Linux 5.14 and earlier, the command is `nv set interface <interface-id> ip neighbor-discovery rdnss <address-id lifetime`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.
`<ipv6-address-id>` | The IPv6 address.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set interface swp1 ipv6 neighbor-discovery rdnss 2001:db8:1::100 lifetime infinite

## nv set interface <interface-id> ipv6 neighbor-discovery router-advertisement state

Enables and disables router advertisement for the interface. The default setting is `disabled`.

- In Cumulus Linux 5.4 and earlier, the NVUE command to enable router advertisment for an interface is `nv set interface <interface-id> ip neighbor-discovery router-advertisement enable off` and the NVUE command to disable router advertisment for an interface is `nv set interface <interface-id> ip neighbor-discovery router-advertisement enable on`.
- In Cumulus Linux 5.14 and earlier, you specify `enable on` or `enable off` instead of `state enabled` or `state disabled`.

In Cumulus Linux 5.14 and earlier, the command is `nv set interface <interface-id> ip neighbor-discovery router-advertisement state`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set interface swp1 ipv6 neighbor-discovery router-advertisement state enabled

## nv set interface <interface-id> ipv6 neighbor-discovery router-advertisement fast-retransmit

Configures the specified interface to allow consecutive router advertisement packets to transmit more frequently than every three seconds (fast retransmit). The default setting is `enabled`.

In Cumulus Linux 5.14 and earlier:

- The command is `nv set interface <interface-id> ip neighbor-discovery router-advertisement fast-retransmit`.
- You specify `on` or `off` instead of `enabled` or `disabled`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set interface swp1 ipv6 neighbor-discovery router-advertisement fast-retransmit disabled

## nv set interface <interface-id> ipv6 neighbor-discovery router-advertisement hop-limit

Configures the hop limit value in the IP header of the outgoing router advertisement packet. You can set a value between 0 and 255. The default setting is 64.

In Cumulus Linux 5.14 and earlier, the command is `nv set interface <interface-id> ip neighbor-discovery router-advertisement hop-limit`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set interface swp1 ipv6 neighbor-discovery router-advertisement hop-limit 100

## nv set interface <interface-id> ipv6 neighbor-discovery router-advertisement interval

Configures the maximum time in milliseconds allowed between sending unsolicited multicast RA from the interface. You can set a value between 70 and 1800000 milliseconds. The default setting is 600000.

In Cumulus Linux 5.14 and earlier, the command is `nv set interface <interface-id> ip neighbor-discovery router-advertisement interval`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set interface swp1 ipv6 neighbor-discovery router-advertisement interval 60000

## nv set interface <interface-id> ip neighbor-discovery router-advertisement interval-option

Configures the specified interface to indicate to hosts that the router uses an advertisement interval to send router advertisements. The default setting is `disabled`.

In Cumulus Linux 5.14 and earlier:

- The command is `nv set interface <interface-id> ip neighbor-discovery router-advertisement interval-option`.
- You specify `on` or `off` instead of `enabled` or `disabled`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set interface swp1 ipv6 neighbor-discovery router-advertisement interval-option enabled

## nv set interface <interface-id> ipv6 neighbor-discovery router-advertisement lifetime

Configures the maximum amount of time that router advertisement messages can exist on the route. You can specify a value between 0 and 9000. The default setting is 1800.

In Cumulus Linux 5.14 and earlier, the command is `nv set interface <interface-id> ip neighbor-discovery router-advertisement lifetime`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set interface swp1 ipv6 neighbor-discovery router-advertisement lifetime 4000

## nv set interface <interface-id> ipv6 neighbor-discovery router-advertisement managed-config

Configures the specified interface to allow a dynamic host to use a managed protocol, such as DHCPv6, to configure IP addresses automatically (managed configuration). The default setting is `disabled`.

In Cumulus Linux 5.14 and earlier:

- The command is `nv set interface <interface-id> ip neighbor-discovery router-advertisement managed-config`.
- You specify `on` or `off` instead of `enabled` or `disabled`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set interface swp1 ipv6 neighbor-discovery router-advertisement managed-config enabled

## nv set interface <interface-id> ipv6 neighbor-discovery router-advertisement other-config

Configures the specified interface to allow a dynamic host to use a managed protocol to configure additional information through DHCPv6. The default setting is `disabled`.

In Cumulus Linux 5.14 and earlier:

- The command is `nv set interface <interface-id> ip neighbor-discovery router-advertisement other-config`.
- You specify `on` or `off` instead of `enabled` or `disabled`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set interface swp1 ipv6 neighbor-discovery router-advertisement other-config enabled

## nv set interface <interface-id> ipv6 neighbor-discovery router-advertisement reachable-time

Configures the amount of time that an IPv6 node is reachable. You can set a value between 0 and 3600000 milliseconds. The default setting is 0.

In Cumulus Linux 5.14 and earlier, the command is `nv set interface <interface-id> ip neighbor-discovery router-advertisement reachable-time`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set interface swp1 ipv6 neighbor-discovery router-advertisement reachable-time 3600000

## nv set interface <interface-id> ipv6 neighbor-discovery router-advertisement retransmit-time

Configures the interval at which neighbor solicitation messages retransmit. You can set a value between 0 and 4294967295 milliseconds. The default setting is 0.

In Cumulus Linux 5.14 and earlier, the command is `nv set interface <interface-id> ip neighbor-discovery router-advertisement retransmit-time`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set interface swp1 ipv6 neighbor-discovery router-advertisement retransmit-time 4294967295

## nv set interface <interface-id> ipv6 neighbor-discovery router-advertisement router-preference

Configures the specified interface to allow hosts to use router preference to select the default router. You can set a value of high, medium, or low. The default setting is `medium`.

In Cumulus Linux 5.14 and earlier, the command is `nv set interface <interface-id> ip neighbor-discovery router-advertisement router-preference`.

### Command Syntax

Syntax | Description
--- | ---
`<interface-id>` | The interface you want to configure.

### Version History

Introduced in Cumulus Linux 5.1.0

### Example

    cumulus@switch:~$ nv set interface swp1 ipv6 neighbor-discovery router-advertisement router-preference high

## nv set system global nd base-reachable-time

Configures how long a neighbor cache entry is valid. The entry is valid for at least the value between the base reachable time divided by two and three times the base reachable time divided by two. You can specify a value between 30 and 2147483 seconds. The default value is auto; NVUE derives the value for auto from the `/etc/sysctl.d/neigh.conf` file.

### Version History

Introduced in Cumulus Linux 5.6.0

### Example

    cumulus@switch:~$ nv set system global nd base-reachable-time 50