FD.io VPP
v21.06-3-gbb25fbf28
Vector Packet Processing
|
ip6 nd <interface> ...
This command is used to configure the neighbor discovery parameters on a given interface. Use the '<em>show ip6 interface</em>' command to display some of the current neighbor discovery parameters on a given interface. This command has three formats:
<b>Format 1 - Router Advertisement Options:</b> (Only one can be entered in a single command)
'<em><b>ip6 nd <interface> [no] [ra-managed-config-flag] | [ra-other-config-flag] | [ra-suppress] | [ra-suppress-link-layer] | [ra-send-unicast] | [ra-lifetime <lifetime>] | [ra-initial <cnt> <interval>] | [ra-interval <max-interval> [<min-interval>]] | [ra-cease]</b></em>'
Where:
<em>[no] ra-managed-config-flag</em> - Advertises in ICMPv6 router-advertisement messages to use stateful address auto-configuration to obtain address information (sets the M-bit). Default is the M-bit is not set and the '<em>no</em>' option returns it to this default state.
<em>[no] ra-other-config-flag</em> - Indicates in ICMPv6 router-advertisement messages that hosts use stateful auto configuration to obtain nonaddress related information (sets the O-bit). Default is the O-bit is not set and the '<em>no</em>' option returns it to this default state.
<em>[no] ra-suppress</em> - Disables sending ICMPv6 router-advertisement messages. The '<em>no</em>' option implies to enable sending ICMPv6 router-advertisement messages.
<em>[no] ra-suppress-link-layer</em> - Indicates not to include the optional source link-layer address in the ICMPv6 router-advertisement messages. Default is to include the optional source link-layer address and the '<em>no</em>' option returns it to this default state.
<em>[no] ra-send-unicast</em> - Use the source address of the router-solicitation message if availiable. The default is to use multicast address of all nodes, and the '<em>no</em>' option returns it to this default state.
<em>[no] ra-lifetime <lifetime></em> - Advertises the lifetime of a default router in ICMPv6 router-advertisement messages. The range is from 0 to 9000 seconds. '<em><lifetime></em>' must be greater than '<em><max-interval></em>'. The default value is 600 seconds and the '<em>no</em>' option returns it to this default value.
<em>[no] ra-initial <cnt> <interval></em> - Number of initial ICMPv6 router-advertisement messages sent and the interval between each message. Range for count is 1 - 3 and default is 3. Range for interval is 1 to 16 seconds, and default is 16 seconds. The '<em>no</em>' option returns both to their default value.
<em>[no] ra-interval <max-interval> [<min-interval>]</em> - Configures the interval between sending ICMPv6 router-advertisement messages. The range for max-interval is from 4 to 200 seconds. min-interval can not be more than 75% of max-interval. If not set, min-interval will be set to 75% of max-interval. The range for min-interval is from 3 to 150 seconds. The '<em>no</em>' option returns both to their default value.
<em>[no] ra-cease</em> - Cease sending ICMPv6 router-advertisement messages. The '<em>no</em>' options implies to start (or restart) sending ICMPv6 router-advertisement messages.
<b>Format 2 - Prefix Options:</b>
'<em><b>ip6 nd <interface> [no] prefix <ip6-address>/<width> [<valid-lifetime> <pref-lifetime> | infinite] [no-advertise] [off-link] [no-autoconfig] [no-onlink]</b></em>'
Where:
<em>no</em> - All additional flags are ignored and the prefix is deleted.
<em><valid-lifetime> <pref-lifetime></em> - '<em><valid-lifetime></em>' is the length of time in seconds during what the prefix is valid for the purpose of on-link determination. Range is 7203 to 2592000 seconds and default is 2592000 seconds (30 days). '<em><pref-lifetime></em>' is the prefered-lifetime and is the length of time in seconds during what addresses generated from the prefix remain preferred. Range is 0 to 604800 seconds and default is 604800 seconds (7 days).
<em>infinite</em> - Both '<em><valid-lifetime></em>' and '<em><<pref-lifetime></em>' are inifinte, no timeout.
<em>no-advertise</em> - Do not send full router address in prefix advertisement. Default is to advertise (i.e. - This flag is off by default).
<em>off-link</em> - Prefix is off-link, clear L-bit in packet. Default is on-link (i.e. - This flag is off and L-bit in packet is set by default and this prefix can be used for on-link determination). '<em>no-onlink</em>' also controls the L-bit.
<em>no-autoconfig</em> - Do not use prefix for autoconfiguration, clear A-bit in packet. Default is autoconfig (i.e. - This flag is off and A-bit in packet is set by default.
<em>no-onlink</em> - Do not use prefix for onlink determination, clear L-bit in packet. Default is on-link (i.e. - This flag is off and L-bit in packet is set by default and this prefix can be used for on-link determination). '<em>off-link</em>' also controls the L-bit.
<b>Format 3: - Default of Prefix:</b>
'<em><b>ip6 nd <interface> [no] prefix <ip6-address>/<width> default</b></em>'
When a new prefix is added (or existing one is being overwritten) <em>default</em> uses default values for the prefix. If <em>no</em> is used, the <em>default</em> is ignored and the prefix is deleted.
vpp# ip6 nd GigabitEthernet2/0/0 ra-interval 100 20
Example of how to add a prefix: vpp# ip6 nd GigabitEthernet2/0/0 prefix fe80::fe:28ff:fe9c:75b3/64 infinite no-advertise
Example of how to delete a prefix: vpp# ip6 nd GigabitEthernet2/0/0 no prefix fe80::fe:28ff:fe9c:75b3/64
Declaration: ip6_nd_command (src/vnet/ip6-nd/ip6_ra.c line 2290)
Implementation: ip6_ra_cmd.
ip6 nd address autoconfig <interface> [default-route|disable].
This command is used to enable ND address autoconfiguration on particular interface including setting up default routes.
vpp# ip6 nd address autoconfig GigabitEthernet2/0/0
Example of how to enable ND address autoconfiguration with setting up default routes: vpp# ip6 nd address autoconfig GigabitEthernet2/0/0 default-route
Example of how to disable ND address autoconfiguration: vpp# ip6 nd address autoconfig GigabitEthernet2/0/0 disable
Declaration: ip6_nd_address_autoconfig_command (src/vnet/ip6-nd/rd_cp.c line 592)
Implementation: ip6_nd_address_autoconfig.
set ip6 nd proxy <interface> [del] <host-ip>.
Declaration: set_ip6_nd_proxy_command (src/vnet/ip6-nd/ip6_nd_proxy.c line 117)
Implementation: set_ip6_nd_proxy_cmd.