What can I help you with?

NVIDIA NVOS User Manual for InfiniBand Switches v25.02.2002

NVIDIA Docs Hub NVIDIA Networking Networking Software Switch Software NVIDIA NVOS User Manual for InfiniBand Switches v25.02.2002 IPoIB Commands

On This Page

nv show interface ib0
nv show interface link
nv show interface ip
nv set interface link state
nv set/unset interface description
nv set/unset interface ip
nv unset interface
nv unset interface link

IPoIB Commands

nv show interface ib0

	nv show interface {interface-id} Displays details of an IPoIB interface.
Syntax description	interface-id	Name of the IPoIB interface to display (e.g., ib0)
Default	N/A
History	25.02.2xxx
Example	Copy Copied! admin@nvos:~$ nv show interface ib0 operational applied ----------------------- ----------------------------------------------------------- -------- ip arp-timeout 1800 1800 autoconf disabled disabled dhcp-client state disabled disabled set-hostname enabled enabled is-running no has-lease no dhcp-client6 state disabled disabled set-hostname enabled enabled is-running no has-lease no [gateway] link auto-negotiate on duplex full speed auto mac 80:00:00:02:fe:80:00:00:00:00:00:00:90:0a:84:03:00:76:a8:00 counters in-bytes 72 Bytes in-pkts 1 in-drops 0 in-errors 0 out-bytes 480 Bytes out-pkts 4 out-drops 0 out-errors 0 carrier-transitions 2 mtu 2044 2044 state up up ifindex 8 type ipoib ipoib
REST API	GET https://<id>/nvue_v1/interface/{interface-id}
Related commands	nv show interface nv set interface nv unset interface
Notes

nv show interface link

	nv show interface {interface-id} link {state \| counters} Displays link information of an IPoIB interface.
Syntax description	interface-id	Name of the interface to display (e.g., ib0).
	state	Show only the data relating to state.
	stats	Show only the data relating to statistics.
Default	N/A
History	25.02.2xxx
Example	Copy Copied! `admin@nvos:~$ nv show interface ib0 link state operational applied pending description -- ----------- ------- ------- ----------- up up The state of the interface` Copy Copied! admin@nvos:~$ nv show interface ib0 link counters operational applied pending description ------------------- ----------- ------- ------- ---------------------------------------------------------------------- carrier-transitions 4 Number of times the interface state has transitioned between up and... in-bytes 0 Bytes Total number of bytes received on the interface in-drops 0 Number of received packets dropped in-errors 0 Number of received packets with errors in-pkts 0 Total number of packets received on the interface out-bytes 720 Bytes Total number of bytes transmitted out of the interface out-drops 0 The number of outbound packets that were chosen to be discarded eve... out-errors 0 The number of outbound packets that could not be transmitted because... out-pkts 6 Total number of packets transmitted out of the interface
REST API	GET https://<id>/nvue_v1/interface/{interface-id}/link GET https://<id>/nvue_v1/interface/{interface-id}/link/state GET https://<id>/nvue_v1/interface/{interface-id}/link/counters
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} Displays IP address of an IPoIB interface.
Syntax description	interface-id	Name of the interface to display (e.g., ib0).
Default	N/A
History	25.02.2xxx
Example	Copy Copied! admin@nvos:~$ nv show interface ib0 ip operational applied pending description --------- ----------- ------- ----------- --------------------- autoconf enable IPv6 Stateless Address Autoconfiguration (SLAAC) [address] 10.10.1.1/8 10.10.1.1/8 IPv4 and IPv6 address admin@nvos:~$ nv show interface ib0 ip address operational applied pending description -- ----------- ------- ----------- --------------------- 10.10.1.1/8 ipv4 and ipv6 address
REST API	GET https://<id>/nvue_v1/interface/{interface-id}/ip GET https://<id>/nvue_v1/interface/{interface-id}/ip/address
Related commands	nv show interface nv set interface ip nv unset interface ip
Notes

nv set interface link state

	nv set interface {interface-id} link state {value} Sets the administrative link state of a given IPoIB interface.
Syntax description	interface-id	Name of the interface whose link state to set (e.g., ib0).
Syntax description	value	New value for the link state: {up, down}
Default	N/A
History	25.02.2xxx
Example	Copy Copied! `admin@nvos:~$ nv set interface ib0 link state up`
REST API	PATCH https://<id>/nvue_v1/interface/{interface-id}/link/state
Related commands	nv show interface nv unset interface {interface-id} 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 interface. The unset formof the command sets the description of a given IPoIB interface to empty.
Syntax description	interface-id	Name of the interface whose link state to set (e.g., ib0).
Syntax description	value	New value for the description.
Default	N/A
History	25.02.2xxx
Example	Copy Copied! `admin@nvos:~$ nv set interface ib0 description "IPoIB interface"` Copy Copied! `admin@nvos:~$ nv unset interface ib0 description`
REST API	PATCH https://<id>/nvue_v1/interface/{interface-id}
Related commands	nv show interface nvunset interface description
Notes

nv set/unset interface ip

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

nv unset interface

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

nv unset interface link

	nv unset interface {interface-id} link {state} Sets the administrative link state of a given IPoIB interface to the default value of "up".
Syntax description	interface-id	Name of the interface whose link state to set to default (e.g., ib0).
Default	N/A
History	25.02.2xxx
Example	Copy Copied! `admin@nvos:~$ nv unset interface ib0 link admin@nvos:~$ nv unset interface ib0 link state`
REST API	PATCH https://<id>/nvue_v1/interface/{interface-id}/link
Related commands	nv show interface nv set interface link
Notes	Since state is the only settable attribute of link, the two forms of the command are equivalent.

© Copyright 2024, NVIDIA. Last updated on Jan 8, 2025.