What can I help you with?

NVIDIA NVOS User Manual for NVLink Switches v25.02.2141

NVIDIA Docs Hub NVIDIA Networking Networking Software Switch Software NVIDIA NVOS User Manual for NVLink Switches v25.02.2141 Management Interface Commands

On This Page

nv show interface
nv show interface link
nv show interface ip
nv set/unset interface link state
nv set/unset interface description
nv set/unset interface ip
nv unset interface
nv set/unset interface link mtu
nv set/unset interface link speed
nv set/unset interface link duplex
nv set interface link auto-negotiate
nv set interface ip autoconf
nv set interface ip gateway
nv set interface ip arp-timeout

Management Interface Commands

VRF
- nv show vrf
- nv set interface ip vrf
IP DHCP Client

nv show interface

	nv show interface [interface-id] Displays details of an IPoIB/eth0 interface. If not interface is selected, summary of attributes of all interfaces will be displayed.
Syntax Description	interface-id	Name of the interface to display (e.g., eth0)
Default	N/A
History	25.02.1884
Example	Copy Copied! admin@nvos:~$ nv show interface eth0 operational applied ----------------------- ------------------------------------- ------- ip vrf default default arp-timeout 1800 1800 autoconf enabled enabled dhcp-client state enabled enabled set-hostname enabled enabled is-running yes has-lease yes dhcp-client6 state enabled enabled set-hostname enabled enabled is-running yes has-lease no [address] 10.7.89.7/20 [address] fdfd:fdfd:7:80:eaeb:d3ff:fe4b:70b8/64 [gateway] link auto-negotiate on on duplex full full speed 1G 1G mac e8:eb:d3:4b:70:b8 counters in-bytes 2.53 MB in-pkts 15719 in-drops 0 in-errors 0 out-bytes 144.50 KB out-pkts 917 out-drops 0 out-errors 0 carrier-transitions 4 mtu 1500 1500 state up up ifindex 2 type eth eth Copy Copied! admin@nvos:~$ nv show interface Interface State Speed MTU Type Description Logical state Physical state Summary --------- ----- ----- ----- -------- ----------- ------------- -------------- -------------------------------------------------- acp1 down nvl Down Polling acp2 down nvl Down Polling acp3 down nvl Down Polling acp4 down nvl Down Polling eth0 up 1G 1500 eth ip.address: 10.7.145.68/21 ip.address: fdfd:fdfd:7:145:9e63:c0ff:fe72:b212/64 ip.address: fdfd:fdfd:7:145::1000:4240/128 fnm1 down fnm Down Polling fnm2 down fnm Down Polling lo up 65536 loopback ip.address: 127.0.0.1/16 ip.address: ::1/128 sw1p1s1 down nvl Down Disabled sw1p1s2 down nvl Down Disabled
REST API	GET https://<ip>/nvue_v1/interface
Related Commands	nv set interface nv show interface
Notes

nv show interface link

	nv show interface <interface-id> link {state \| counters} Displays link information of an IPoIB/eth0 interface.
Syntax Description	interface-id	Name of the interface to display (e.g., eth0)
	state	Show only the data relating to state
	stats	Show only the data relating to statistics
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv show interface eth0 link operational applied --------------------- ----------------- ------- auto-negotiate on on duplex full full mtu 1500 1500 speed 1G 1G state up up counters carrier-transitions 6 in-bytes 32.84 MB in-drops 0 in-errors 0 in-pkts 209466 out-bytes 16.99 MB out-drops 0 out-errors 0 out-pkts 121334 mac 08:c0:eb:58:7f:90` Copy Copied! `admin@nvos:~$ nv show interface eth0 link state operational applied -- ----------- ------- up` Copy Copied! `admin@nvos:~$ nv show interface eth0 link counters operational ------------------- ----------- in-bytes 4.20 MB in-pkts 5561 in-drops 0 in-errors 0 out-bytes 1.42 MB out-pkts 2942 out-drops 0 out-errors 0 carrier-transitions 5`
REST API	GET https://<ip>/nvue_v1/interface/<interface-id>/link
Related Commands	nv show interface nv set interface link nv unset interface link
Notes

nv show interface ip

	nv show interface <interface-id> ip {address \| dhcp-client \| dhcp-client6 \| gateway} Displays IP configuration and state of an IPoIB/eth0 interface.
Syntax Description	interface-id	Name of the interface to display (e.g., ib0, eth0)
	address	Display the IP address configuration of an IPoIB/eth0 interface
	dhcp-client	Display the DHCPv4 configuration and state of an IPoIB/eth0 interface
	dhcp-client6	Display the DHCPv6 configuration and state of an IPoIB/eth0 interface
	gateway	Display the IP gateway configuration of an IPoIB/eth0 interface
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv show interface eth0 ip operational applied -------------- ------------------------------------- ------- vrf default default arp-timeout 1800 1800 autoconf enabled enabled dhcp-client state enabled enabled set-hostname enabled enabled is-running yes has-lease yes dhcp-client6 state enabled enabled set-hostname enabled enabled is-running yes has-lease no [address] 10.7.89.7/20 [address] fdfd:fdfd:7:80:eaeb:d3ff:fe4b:70b8/64 [gateway]` Copy Copied! `admin@nvos:~$ nv show interface eth0 ip address ------------------------------------- 10.7.144.154/21 fdfd:fdfd:7:145::1000:454c/128 fdfd:fdfd:7:145:ac0:ebff:fe58:7f90/64` Copy Copied! `admin@nvos:~$ nv show interface eth0 ip dhcp-client operational applied ------------ ----------- ------- set-hostname enabled enabled state enabled enabled has-lease yes is-running yes`
REST API	GET https://<ip>/nvue_v1/interface/<interface-id>/ip
Related Commands	nv show interface nv set interface ip nv unset interface ip
Notes

nv set/unset interface link state

	nv set interface <interface-id> link state {value} nv unset interface <interface-id> link state {value} Set/unset the administrative link state of a given IPoIB/eth0 interface.
Syntax Description	interface-id	Name of the interface whose link state to set (e.g., eth0)
	value	New value for the link state: up, down
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv unset interface eth0 link state admin@nvos:~$ nv set interface eth0 link state up`
REST API	PATCH https://<ip>/nvue_v1/interface/<interface-id>/link/state
Related Commands	nv show interface nv set interface link nv unset interface link state
Notes

nv set/unset interface description

	nv set interface <interface-id> description nv unset interface <interface-id> description Sets the description of a given IPoIB/eth0 interface. The unset form of the command sets the description of a given IPoIB/eth0 interface to empty.
Syntax Description	interface-id	Name of the interface whose link state to set, (e.g. ib0, eth0)
	value	New value for the description.
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv set interface eth0 description "mgmt interface" admin@nvos:~$ nv unset interface eth0 description`
REST API	PATCH https://<ip>/nvue_v1/interface/<interface-id>
Related Commands	nv show interface nv unset interface description
Notes

nv set/unset interface ip

	nv set interface <interface-id> ip address <ip-prefix-id> nv unset interface <interface-id> ip address <ip-prefix-id> Sets the IP address of a given IPoIB/eth0 interface. The unset form of the command deletes one or more IP addresses assigned to a given IPoIB/eth0 interface.
Syntax Description	interface-id	Name of the interface whose IP address to set (e.g., ib0, eth0)
	ip-prefix-id	IP address and netmask to assign to the interface
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv set interface eth0 ip address 10.10.1.1/8`
REST API	PATCH https://<ip>/nvue_v1/interface/<interface-id>/ip/address
Related Commands	nv show interface nv unset interface ip
Notes

nv unset interface

	nv unset interface <interface-id> Sets all attributes of an IPoIB/eth0 interface to default values.
Syntax Description	interface-id	Name of the interface to set to default values (e.g., eth0)
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv unset interface eth0`
REST API	PATCH https://<ip>/nvue_v1/interface/<interface-id>
Related Commands	nv show interface nv set interface
Notes

nv set/unset interface link mtu

	nv set interface <interface-id> link mtu <bytes> nv unset interface <interface-id> link mtu Sets the Maximum Transmission Unit (MTU) of this interface. The unset form of the command resets the MTU to its default.
Syntax Description	interface-id	Name of the interface to display (e.g., eth0)
	bytes	Range: 1280–9000
Default	1500
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv set interface eth0 link mtu 1500`
REST API	PATCH https://<ip>/nvue_v1/interface/<interface-id>/link
Related Commands	nv show interface link
Notes

nv set/unset interface link speed

	nv set interface <interface-id> link speed <speed> nv unset interface <interface-id> link speed Sets the interface speed. The unset form of the command resets the speed setting for this interface to its default value.
Syntax Description	interface-id	Name of the interface to display (e.g., eth0)
	speed	10M, 100M, 1000M
Default	1000M
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv set interface eth0 link speed 100M`
REST API	PATCH https://<ip>/nvue_v1/interface/<interface-id>/link
Related Commands	nv show interface link
Notes

nv set/unset interface link duplex

	nv set interface <interface-id> link duplex <duplex> nv unset interface <interface-id> link duplex Sets the interface duplex. The unset form of the command resets the duplex setting for this interface to its default value.
Syntax Description	interface-id	The interface (e.g., eth0)
	duplex	full, half
Default	full
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv set interface eth0 link duplex full`
REST API	PATCH https://<ip>/nvue_v1/interface/<interface-id>/link
Related Commands	nv show interface link
Notes

nv set interface link auto-negotiate

	nv set interface <interface-id> link auto-negotiate <auto> Sets link speed and characteristic auto negotiation.
Syntax Description	interface-id	The interface (e.g., eth0)
	auto	on, off
Default	on
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv set interface eth0 link auto-negotiate on`
REST API	PATCH https://<ip>/nvue_v1/interface/<interface-id>/link
Related Commands	nv show interface link
Notes

nv set interface ip autoconf

	nv set interface <interface-id> ip autoconf <autoconf> IPv6 Stateless Address Autoconfiguration (SLAAC)
Syntax Description	interface-id	The interface
	autoconf	enable, disable
Default	Enable
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv set interface eth0 ip autoconf enable`
REST API	PATCH https://<ip>/nvue_v1/interface/<interface-id>/ip
Related Commands	nv unset interface ip gateway
Notes

nv set interface ip gateway

	nv set interface <interface-id> ip gateway {gateway-ip} Sets default gateway IP address for an interface.
Syntax Description	interface-id	The interface
	gateway-ip	The gateway IP address
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv set interface eth0 ip gateway 1.1.1.1`
REST API	PATCH https://<ip>/nvue_v1/interface/<interface-id>/ip/gateway
Related Commands	nv show interface ip
Notes

nv set interface ip arp-timeout

	nv set interface <interface-id> ip arp-timeout <time> Sets IPv4 arp timeout (in seconds) for an interface.
Syntax Description	interface-id	The interface
	time	Seconds. Range: 60–28800
Default	1800
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv set interface eth0 ip arp-timeout 2100`
REST API	PATCH https://<ip>/nvue_v1/interface/<interface-id>/ip
Related Commands
Notes

VRF

nv show vrf

	show vrf {vrf-id}{loopback \| loopback ip \| loopback ip address {ip-prefix-id}} Shows VRFs.
Syntax Description	vrf-id	VRF
	loopback	Return loopback interface details of a VRF.
	loopback ip	Return IP details of a VRF loopback interface.
	loopback ip address	Return details of the IP addresses.
	ip-prefix-id	IPv4 or IPv6 address and route prefix in CIDR notation
	<none>	Shows all VRFs
Default	N/A
Configuration Mode	config
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv show vrf Name Table Summary --------- ----- ----------------------- + default 254 IP Address: 127.0.0.1/8 default IP Address: ::1/128 + mgmt 1001 IP Address: 127.0.0.1/8 mgmt IP Address: ::1/128` Copy Copied! admin@nvos:~$ nv show vrf mgmt operational applied description ------------- ----------- ----------- ---------------------------------------------------------------------- table 1001 auto The routing table number, between 1001-1255, used by the named VRF.... evpn enable off Turn the feature 'on' or 'off'. The default is 'off'. loopback ip [address] 127.0.0.1/8 127.0.0.1/8 static IPv4 or IPv6 address [address] ::1/128 ::1/128 ptp enable on Turn the feature 'on' or 'off'. The default is 'on'. router bgp enable off Turn the feature 'on' or 'off'. The default is 'off'. ospf enable off Turn the feature 'on' or 'off'. The default is 'off'. [rib] RIB Routes [static] Routes Copy Copied! `admin@nvos:~$ nv show vrf mgmt loopback operational applied description ----------- ----------- ----------- --------------------------- ip [address] 127.0.0.1/8 127.0.0.1/8 static IPv4 or IPv6 address [address] ::1/128 ::1/128` Copy Copied! `admin@nvos:~$ nv show vrf mgmt loopback ip operational applied description --------- ----------- ----------- --------------------------- [address] 127.0.0.1/8 127.0.0.1/8 static IPv4 or IPv6 address [address] ::1/128 ::1/128` Copy Copied! `admin@nvos:~$ nv show vrf mgmt loopback ip address ----------- 127.0.0.1/8 ::1/128` Copy Copied! `admin@nvos:~$ nv show vrf mgmt loopback ip address 127.0.0.1/8 operational applied description -- ----------- ------- -----------`
REST API	GET https://<ip>/nvue_v1/vrf/{vrf-id}
Related Commands
Notes	FRR must be running to be able to use this command.

nv set interface ip vrf

	nv set interface <interface-id> ip vrf {vrf-name} Assigns an interface to a VRF.
Syntax Description	interface-id	The interface
	vrf-name	The VRF: default/ mgmt
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv set interface eth0 ip vrf mgmt`
REST API	PATCH https://<ip>/nvue_v1/interface/<interface-id>/ip
Related Commands	nv unset interface ip vrf
Notes

IP DHCP Client

nv set interface ip dhcp-client state

	nv set interface <interface-id> ip dhcp-client state {enabled \| disabled} nv unset interface <interface-id> ip dhcp-client Enables/disables DHCP client for an interface. The unset form of the command returns the DHCP client to its default state.
Syntax Description	interface-id	The interface
Default	Enabled
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv set interface eth0 ip dhcp-client state enabled`
REST API	PATCH https://<ip>/nvue_v1/interface/<interface-id>/ip/dhcp-client
Related Commands	nv set interface ip dhcp-client6 state
Notes	Configuring the DHCP client for either IPv4 or IPv6 will set the same configuration for both.

nv set interface ip dhcp-client set-hostname

	nv set interface <interface-id> ip dhcp-client set-hostname {enabled \| disabled} nv unset interface <interface-id> ip dhcp-client set-hostname Allows/disallows DHCP client to set system hostname from DHCP. The unset form of the command returns the system hostname to its default state.
Syntax Description	interface-id	The interface
Default	Enabled
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv set interface eth0 ip dhcp-client set-hostname enabled`
REST API	PATCH https://<ip>/nvue_v1/interface/<interface-id>/ip/dhcp-client
Related Commands	nv set interface ip dhcp-client6 set-hostname nv set interface ip dhcp-client state
Notes	Configuring the DHCP client for either IPv4 or IPv6 will set the same configuration for both.

nv set interface ip dhcp-client6 state

	nv set interface <interface-id> ip dhcp-client6 state {enabled \| disabled} nv set interface <interface-id> ip dhcp-client6 Enables/disables DHCPv6 client for an interface. The unset form of the command returns the DHCPv6 client to its original state.
Syntax Description	interface-id	The interface
Default	Enabled
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv set interface eth0 ip dhcp-client6 state enabled`
REST API	PATCH https://<ip>/nvue_v1/interface/<interface-id>/ip/dhcp-client6
Related Commands	nv set interface ip dhcp-client state
Notes	Configuring the DHCP client for either IPv4 or IPv6 will set the same configuration for both.

nv set interface ip dhcp-client6 set-hostname

	nv set interface <interface-id> ip dhcp-client6 set-hostname {enabled \| disabled} nv unset interface <interface-id> ip dhcp-client6 set-hostname Allows/disallows DHCP client to set system hostname from DHCPv6. The unset form of the command returns the DHCP client to its default state.
Syntax Description	interface-id	The interface
Default	Enabled
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv set interface eth0 ip dhcp-client6 set-hostname enabled`
REST API	PATCH https://<ip>/nvue_v1/interface/<interface-id>/ip/dhcp-client6
Related Commands	nv set interface ip dhcp-client set-hostname nv set interface ip dhcp-client6 state
Notes	Configuring the DHCP client for either IPv4 or IPv6 will set the same configuration for both.

nv action renew interface ip dhcp-client

	nv action renew interface <interface-id> ip dhcp-client Renews DHCPv4 lease for this interface.
Syntax Description	interface-id	The interface
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv action renew interface eth0 ip dhcp-client`
REST API	POST https://<ip>/nvue_v1/interface/<interface-id>/ip
Related Commands
Notes

nv action renew interface ip dhcp-client6

	nv action renew interface <interface-id> ip dhcp-client6 Renews DHCPv6 lease for this interface.
Syntax Description	interface-id	The interface
Default	N/A
History	25.02.1884
Example	Copy Copied! `admin@nvos:~$ nv action renew interface eth0 ip dhcp-client6`
REST API	POST https://<ip>/nvue_v1/interface/<interface-id>/ip/dhcp-client6
Related Commands
Notes

© Copyright 2025, NVIDIA. Last updated on Apr 23, 2025.