image image image image image

On This Page

This chapter describes the commands that configure and monitor the network interface.

interface


interface {eth0 | eth1 | eth2 | eth3 | ib0 | ib1 | bond0}

Enters a network interface context.

Syntax Descriptioneth0Management port 0 (out of band)
eth1Management port 1 (out of band)
eth2Management port 2 (out of band)
eth3Management port 3 (out of band)
ib0InfiniBand interface 0 (part of bond0)
ib1InfiniBand interface 1 (part of bond0)
bond0IP-over-IB bonded interface which consist of ib0 and ib1
DefaultN/A
Configuration Modeconfig
History1.5
Example
ufmapl [ mgmt-sa ] (config) # interface eth0
ufmapl [ mgmt-sa ] (config interface eth0) #
Related Commandsshow interfaces
Notes

ip address


ip address <IP address> <netmask>
no ip address

Sets the IP address and netmask of this interface.
The no form of the command clears the IP address and netmask of this interface.

Syntax DescriptionIP addressIPv4 address
netmaskSubnet mask of IP address
Default0.0.0.0/0
Configuration Modeconfig interface
History1.5
Example
ufmapl [ mgmt-sa ] (config interface eth0) # ip address 10.10.10.10 255.255.255.0
Related Commands

interface
show interfaces

NotesIf DHCP is enabled on the specified interface, then the DHCP IP assignment will hold until DHCP is disabled

alias ip address


alias <index> ip address < IP address> <netmask>
no alias <index>

Adds an additional IP address to the specified interface. The secondary address will appear in the output of “show interface” under the data of the primary interface along with the alias.
The no form of the command removes the secondary address to the specified interface.

Syntax DescriptionaliasA number to be associated with the secondary IP
IP addressIPv4 address
netmaskSubnet mask of IP address
DefaultN/A
Configuration Modeconfig interface
History1.5
Example
ufmapl [ mgmt-sa ] (config interface eth0) # alias 2 ip address 9.9.9.9 255.255.255.255
Related Commands

interface
show interfaces

Notes
  • If DHCP is enabled on the specified interface, then the DHCP IP assignment will hold until DHCP is disabled
  • More than one additional IP address can be added to the interface

mtu


mtu <size>
no mtu

Sets the maximum transmission unit (MTU) size for this interface in bytes.
The no form of the command resets the MTU to its default.

Syntax DescriptionbytesRange: 65-1500 [bytes]
DefaultN/A
Configuration Modeconfig interface
History1.5
Example
ufmapl [ mgmt-sa ] (config interface eth0) # mtu 1500
Related Commands

interface
show interfaces <if-name>

Notes

duplex


duplex <duplex>
no duplex

Sets the duplex mode of the interface.
The no form of the command resets the duplex setting to its default value.

Syntax Descriptionduplex
  • half – half duplex
  • full – full duplex
  • auto – auto-duplex sensing (half or full)
Defaultauto
Configuration Modeconfig interface
History1.5
Example
ufmapl [ mgmt-sa ] (config interface eth0) # duplex auto
Related Commands

interface
show interfaces <if-name>

Notes
  • Setting the duplex to “auto” also sets the speed to “auto”
  • Setting the duplex to “half” or “full” also sets the speed to a manual setting which is determined by querying the interface to find out its current auto-detected state

speed


speed <speed>
no speed

Sets interface speed in Mbps.
The no form of the command resets the speed setting to its default value.

Syntax Descriptionspeed
  • 10 – 10Mbps
  • 100 – 100Mbps
  • 1000 – 1000Mbps
  • auto – auto-speed sensing (10/100/1000Mbps)
Defaultauto
Configuration Modeconfig interface
History1.5
Example
ufmapl [ mgmt-sa ] (config interface eth0) # speed auto
Related Commands

interface
show interfaces <if-name>

Notes
  • Setting the speed to “auto” also sets the duplex to “auto”
  • Setting the speed to 10, 100, or 1000 also sets the duplex to a manual setting which is determined by querying the interface to find out its current auto-detected state

dhcp


dhcp [renew]
no dhcp

Enables DHCP on the specified interface.
The no form of the command disables DHCP on the specified interface.

Syntax DescriptionrenewForces a renewal of the IP address. A restart on the DHCP client for the specified interface will be issued.
DefaultEnabled
Configuration Modeconfig interface
History1.5
Example
ufmapl [ mgmt-sa ] (config interface eth0) # dhcp
Related Commands

interface
show interfaces <if-name> configured

Notes
  • When enabling DHCP, the IP address and netmask are received via DHCP hence, the static IP address configuration is ignored
  • Enabling DHCP disables zeroconf and vice versa
  • Setting a static IP address and netmask does not disable DHCP. DHCP is disabled by using the “no” form of this command, or by enabling zeroconf.

zeroconf


zeroconf
no zeroconf

Enables zeroconf on the specified interface. 
The no form of the command disables the use of zeroconf on the specified interface.

Syntax DescriptionN/A
DefaultDisabled
Configuration Modeconfig interface
History1.5
Example
ufmapl [ mgmt-sa ] (config interface eth0) # zeroconf
Related Commands

interface
show interfaces <if-name> configured

Notes
  • Enabling zeroconf randomly chooses a unique link-local IPv4 address from the 169.254.0.0/16 block
  • This command is an alternative to DHCP
  • Enabling zeroconf disables DHCP and vice versa

shutdown


shutdown
no shutdown

Disables the specified interface.
The no form of the command enables the specified interface.

Syntax DescriptionN/A
DefaultEnabled
Configuration Modeconfig interface
History1.5
Example
ufmapl [ mgmt-sa ] (config interface eth0) # shutdown
Related Commands

interface
show interfaces <if-name> configured

Notes

comment


comment <string>
no comment

Adds a comment for an interface.
The no form of the command removes a comment for an interface.

Syntax DescriptionstringA free-form string that has no semantics other than being displayed when interface records are listed
Default""
Configuration Modeconfig interface
History1.5
Example
ufmapl [ mgmt-sa ] (config interface eth0) # comment my_interface
Related Commands

interface
show interfaces <if-name>

Notes

show interfaces


show interfaces <ifname> [configured | brief]

Displays information about the specified interface, configuration status, and counters.

Syntax DescriptionifnameThe interface whose data to display (e.g., “eth0”, “eth1”, etc.)
configuredDisplays interface configuration
briefDisplays interface configuration and status in brief format
DefaultN/A
Configuration ModeAny configuration mode
History1.5
4.1.0Updated output
Example
ufmapl [ mgmt-sa ] (config) # show interfaces eth0 
Interface eth0 status: 
 Comment: 
 Admin up: yes 
 Link up: yes 
 DHCP running: yes 
 IP address: 172.30.30.8 
 Netmask: 255.255.0.0 
 IPv6 enabled: yes
 Autoconf enabled: no
 Autoconf route: yes
 Autoconf privacy: no
 DHCPv6 running: no
 IPv6 addresses: 1
 IPv6 address: fe80::a6bf:1ff:fe00:9c20/64
 Speed: 1000Mb/s (auto)
 Duplex: full (auto)
 Interface type: ethernet 
 Interface source: physical 
 MTU: 1500
 HW address: A4:BF:01:00:9C:20

 RX bytes: 1629833421 TX bytes: 2808005 
 RX packets: 12981118 TX packets: 51988 
 RX mcast packets: 26852703 TX discards: 0 
 RX discards: 0 TX errors: 0 
 RX errors: 0 TX overruns: 0 
 RX overruns: 0 TX carrier: 0 
 RX frame: 0 TX collisions: 0 
 TX queue len: 1000
Related Commands

interface <ifname> ip address <IP address> <netmask>

Notes

ipv6 enable


ipv6 enable
no ipv6 enable

Enables all IPv6 addressing for this interface.
The no form of the command disables all IPv6 addressing for this interface.

Syntax DescriptionN/A
DefaultDisabled
Configuration Modeconfig interface management
History4.1.0
Example
ufmapl (config interface eth0)# ipv6 enable
Related Commands

ipv6 address
show interface

Notes
  • The interface identifier is a 64-bit long modified EUI-64, which is based on the MAC address of the interface.
  • If IPv6 is enabled on an interface, the system will automatically add a link-local address to the interface. Link-local addresses can only be used to communicate with other hosts on the same link, and packets with link-local addresses are never forwarded by a router.
  • A link-local address, which may not be removed, is required for proper IPv6 operation. The link-local addresses start with “fe80::”, and are combined with the interface identifier to form the complete address.

ipv6 address


ipv6 address {<IPv6 address>/<netmask> | autoconfig [default | privacy]}
no ipv6 {<IPv6 address/netmask> | autoconfig [default | privacy]}

Configures IPv6 address and netmask to this interface, static or autoconfig options are possible.
The no form of the command removes the given IPv6 address and netmask or disables the autoconfig options.

Syntax DescriptionIPv6 address/netmaskConfigures a static IPv6 address and netmask. Format example: 2001:db8:1234::5678/64.
autoconfigEnables IPv6 stateless address auto configuration (SLAAC) for this interface. An address will be automatically added to the interface based on an IPv6 prefix learned from router advertisements, combined with an interface identifier.
autoconfig defaultEnables default learning routes. The default route will be discovered automatically, if the autoconfig is enabled.
autoconfig privacyUses privacy extensions for SLAAC to construct the autoconfig address, if the autoconfig is enabled
DefaultNo IP address available, auto config is enabled
Configuration Modeconfig interface management
History4.1.0
Example
ufmapl (config interface eth0)# ipv6 fe80::202:c9ff:fe5e:a5d8/64
Related Commands

ipv6 address
show interface

Notes
  • On a given interface, up to 16 addresses can be configured
  • For Ethernet, the default interface identifier is a 64-bit long modified EUI-64, which is based on the MAC address of the interface

ipv6 dhcp client enable


ipv6 dhcp client enable
no ipv6 dhcp client enable

Enables DHCPv6 on this interface.
The no form of the command disables DHCPv6 on this interface.

Syntax DescriptionN/A
DefaultEnabled
Configuration Modeconfig interface management
History4.1.0
Example
ufmapl (config interface eth0)# ipv6 dhcp client enable
Related Commands

ipv6 dhcp client renew
show ipv6 dhcp

Notes

ipv6 dhcp client renew


ipv6 dhcp client renew

Renews DHCPv6 lease for this interface.

Syntax DescriptionN/A
DefaultN/A
Configuration Modeconfig interface management
History4.1.0
Example
ufmapl (config interface eth0)# ipv6 dhcp client renew
Related Commands

ipv6 dhcp client enable
show ipv6 dhcp

Notes