net interface
net interface(1) BIG-IP TMSH Manual net interface(1)
NAME
interface - Configures the parameters of interfaces.
MODULE
net
SYNTAX
Configure the interface component within the net module using the syntax in the following sections.
MODIFY
modify interface [name]
options:
description [string]
[disabled | enabled]
flow-control (none |rx | tx | tx-rx)
force-gigabit-fiber [enabled | disabled]
forward-error-correction [enabled | disabled]
media [auto | 10baseT half | 10baseT full | 100baseTX half |
100baseTX full | 1000baseT half | 1000baseT full |
1000baseSX full | 1000baseLX full | 1000baseCX full |
10GbaseT full | 10GbaseSR full | 10GbaseLR full |
10GbaseER full | 10SFP+Cu full | 40GbaseSR4 full |
40GbaseLR4 full | no-phy]
media-fixed [auto | 10baseT half | 10baseT full |
100baseTX half | 100baseTX full | 1000baseT half |
1000baseT full | no-phy]
media-sfp [auto | 10baseT half | 10baseT full | 100baseTX half |
100baseTX full | 1000baseT half | 1000baseT full |
1000baseSX full | 1000baseLX full | 1000baseCX full |
10GbaseT full | 10GbaseSR full | 10GbaseLR full |
10GbaseER full | 10SFP+Cu full | 40GbaseSR4 full |
40GbaseLR4 full | 100GbaseSR4 full | 100GbaseLR4 full |
none | no-phy]
no-mgmt
port-fwd-mode [l3 | passive | virtual-wire]
prefer-port [fixed | sfp]
sflow {
options:
poll-interval [integer]
poll-interval-global [no | yes]
}
stp [disabled | enabled]
stp-auto-edge-port [enabled | disabled]
stp-edge-port [false | true]
stp-link-type [auto | p2p | shared]
stp-reset
span-mode [false | true]
qinq-ethertype [string]
bundle [disabled | enabled | not-supported]
bundle-speed [100G | 40G | not-supported]
edit interface [ [ [name] | [glob] | [regex] ] ... ]
options:
all-properties
non-default-properties
reset-stats interface
reset-stats interface [ [ [name] | [glob] | [regex] ] ... ]
DISPLAY
list interface
list interface [ [ [name] | [glob] | [regex] ] ... ]
show running-config interface
show running-config interface
[ [ [name] | [glob] | [regex] ] ... ]
options:
all-properties
mac-address
media-active
media-capabilities
media-max
mtu
non-default-properties
(pending | not-pending)
one-line
show interface
show interface [ [ [name] | [glob] | [regex] ] ... ]
options:
all-properties
(default | exa | gig | kil | meg | peta | raw | tera | yotta | zetta)
field-fmt
DESCRIPTION
You can use the interface component to enable or disable an interface, and to display and set media options,
duplex mode, and status for an interface. In addition, you can specify whether the interface participates in
the spanning tree protocol (STP) configuration, and set per-interface STP parameters such as link type, edge
port status, and automatic edge port detection.
EXAMPLES
modify interface 1.1 enabled
Enables the interface named 1.1.
modify interface 1.2 disabled
Disables the interface named 1.2.
modify interface 1.1 1.2 1.3 stp disable
Disables STP on the interfaces named 1.1, 1.2, and 1.3.
modify interface 1.1 1.2 1.3 stp-auto-edge-port enabled
Sets auto edge detection for STP on the interfaces named 1.1, 1.2, and 1.3.
modify interface 1.1 1.2 1.3 stp-edge-port true
Sets the edge port attribute for STP on the interfaces named 1.1, 1.2, and 1.3.
OPTIONS
description
User defined description.
[disabled | enabled]
Enables or disables the specified interface. The default value is enabled.
flow-control
Specifies how the system controls the sending of PAUSE frames for flow control. The default value is tx-
rx.
none Disables flow control.
rx Specifies that the interface honors pause frames from its partner, but does not generate pause
frames.
tx Specifies that the interface ignores pause frames from its partner, and generates pause frames when
necessary.
tx-rx
Specifies that the interface honors pause frames from its partner, and also generates pause frames
when necessary.
force-gigabit-fiber
Enables or disables forcing of gigabit fiber media. If this is enabled for a gigabit fiber interface, the
media setting will be forced, and no auto-negotiation will be performed. If it is disabled, auto-
negotiation will be performed with just a single gigabit fiber option advertised.
forward-error-correction
Enables or disables IEEE 802.3bm Clause 91 Reed-Solomon Forward Error Correction (RS-FEC) on 100G
interfaces. This setting is not valid for LR4 media. This setting must be the same on both ends of the
link.
glob Displays the items that match the glob expression. See help glob for a description of glob expression
syntax.
if-index
Displays the index assigned to this interface. It is a unique identifier assigned for all objects
displayed in the SNMP IF-MIB.
mac-address
Displays the 6-byte ethernet address in not case-sensitive hexadecimal colon notation, for example,
00:0b:09:88:00:9a.
media
Specifies the settings for the interface. The possible values are: 10baseT-full, 10baseT-half, 10GbaseER
full, 10GbaseLR-full, 10GbaseSR-full, 10GbaseT-full, 10SFP+Cu-full, 40GbaseSR4-full, 40GbaseLR4-full,
100baseTX-half, 100baseTX-full, 1000baseLX full, 1000baseCX-full, 1000baseT-full, 1000baseT-half,
1000baseSX-full, auto, and no-phy.
When you set the media option, the system automatically sets either the media-sfp or media-fixed option,
based on whether the interface supports small factor form pluggable (SFP) interfaces, or for combo ports
whether SFP is the preferred port.
media-active
Displays the current media setting for the interface.
media-fixed
Specifies the settings for a fixed (non-pluggable) interface. Use this option only with a combo port to
specify the media type for the fixed interface, when it is not the preferred port.
media-max
Displays the maximum media value for the interface.
media-sfp
Specifies the settings for an SFP (pluggable) interface. Note that you use this option only with a combo
port to specify the media type for the SFP interface, when it is not the preferred port.
module-description
Displays an optics module description about the interface. It is only available on a
SFP/SFP+/XFP/QSFP+/QSFP28 unit.
transmitter-technology
Displays the transmitter technology of the pluggable unit on an interface. It is only available on a
QSFP+/QSFP28 unit.
mtu Displays the Maximum Transmission Unit (MTU) of the interface, which is the maximum number of bytes in a
frame without IP fragmentation.
name Specifies an interface name, for example 3.1, where 3 is the physical slot number holding the network
interface hardware and 1 is the physical port number of that interface on that hardware. Another example
is mgmt, the name given to the management interface.
no-mgmt
Ensures that no changes are made to the mgmt interfaces when all is specified. This is especially
convenient when disabling all traffic interfaces using the disabled command.
[pending | not-pending]
Pending indicates that the slot with which the interface is associated does not contain a blade. Not-
pending indicates that the slot with which the interface is associated is not a cluster member. The
default value is pending.
port-fwd-mode
Specifies the port forwarding mode. The default value is l3.
The options are:
l3 Specifies to use the l3 mode. This is the traditional mode of operation of BIGIP, wherein BIGIP
forwards traffic between 2 VLANs.
passive
Specifies to use the passive mode. Use this mode to enable the BIGIP to process out of band traffic.
In this mode, the BIGIP assumes the received traffic is a copy of real inline traffic, and while it
processes it like regular traffic, traffic received on such an interface is never forwarded out.
virtual-wire
Specifies to use the virtual-wire mode. Use this mode to enable the BIGIP to operate like a L2
switch - transparent to the neighboring devices. Packets received on a virtual-wire interface can
only be forwarded to another virtual-wire-configured interface. Such traffic retains the L2 header
and is forwarded to the same VLAN.
prefer-port
Indicates which side of a combo port the interface uses, if both sides of the port have the potential for
external links. The default value is sfp. Do not use this option for non-combo ports.
regex
Displays the items that match the regular expression. The regular expression must be preceded by an at
sign (@[regular expression]) to indicate that the identifier is a regular expression. See help regex for
a description of regular expression syntax.
sflow
Specifies sFlow settings for the interface:
poll-interval
Specifies the maximum interval in seconds between two pollings. The default value is 0. To enable
this setting, you must also set the poll-interval-global setting to no.
poll-interval-global
Specifies whether the global interface poll-interval setting, which is available under sys sflow
global-settings module, overrides the object-level poll-interval setting. The default value is yes.
The available values are:
no Specifies to use the object-level poll-interval setting.
yes Specifies to use the global interface poll-interval setting.
serial
Displays the serial number of the pluggable unit on an interface. It is only available on a
SFP/SFP+/XFP/QSFP+/QSFP28 unit.
stp Enables or disables STP. If you disable STP, no STP, RSTP, or MSTP packets are transmitted or
received on the interface or trunk, and spanning tree has no control over forwarding or learning on
the port or the trunk. The default value is enabled.
stp-auto-edge-port
Sets the STP automatic edge port detection for the interface. The default value is enabled. When STP
automatic edge port detection is set to enabled on an interface, the system monitors the interface
for incoming STP, RSTP, or MSTP packets. If no such packets are received for a sufficient period of
time (about three seconds), the interface is automatically given edge port status. When automatic
edge port detection is set to disabled on an interface, the system does not automatically give the
interface the edge port status. Any STP setting set on a per-interface basis applies to all spanning
tree instances.
stp-edge-port
Sets STP edge port detection. The default value is true.
stp-link-type
Specifies the STP link type for the interface. The default value is auto.
The spanning tree system includes important optimizations that can only be used on point-to-point
links. That is, on links that connect just two bridges. If these optimizations are used on shared
links, incorrect or unstable behavior may result. By default, the implementation assumes that full-
duplex links are point-to-point and that half-duplex links are shared.
The options are:
auto Specifies that the system determines the spanning tree link type, which is based on the duplex
setting.
p2p Specifies that the system uses the optimizations for point-to-point spanning tree links. Point-
to-point links connect only two spanning tree bridges.
shared
Specifies that the system uses the optimizations for shared spanning tree links. Shared links
connect two or more spanning tree bridges.
stp-reset
Resets STP, which forces a migration check.
qinq-ethertype
Specifies the ether-type value used for the packets handled on this port when it is a member in a
QinQ vlan. The ether-type can be set to any string containing a valid hexadecimal 16 bits number,
or any of the well known ether-types: 0x8100, 0x9100, 0x88a8. Default value is set to 0x8100.
bundle
Sets the bundle capability on the port.
bundle-speed
Sets the bundle-speed on the port when bundle capability is enabled.
if-index
Displays the index assigned to this interface. It is a unique identifier assigned for all objects
displayed in the SNMP IF-MIB.
vendor
Displays the name of the vendor of the pluggable unit on an interface. It is only available on a
SFP/SFP+/XFP/QSFP+/QSFP28 unit.
vendor-partnum
Displays the part number programmed by the vendor of the pluggable unit on an interface. It is only
available on a SFP/SFP+/XFP/QSFP+/QSFP28 unit.
vendor-oui
Displays the vendor OUI of the pluggable unit on an interface. It is only available on a
SFP/SFP+/XFP/QSFP+/QSFP28 unit.
vendor-revision
Displays the vendor revision of the pluggable unit on an interface. It is only available on a
SFP/SFP+/XFP/QSFP+QSFP28 unit.
SEE ALSO
edit, glob, list, modify, regex, reset-stats, show, tmsh
COPYRIGHT
No part of this program may be reproduced or transmitted in any form or by any means, electronic or
mechanical, including photocopying, recording, or information storage and retrieval systems, for any purpose
other than the purchaser's personal use, without the express written permission of F5 Networks, Inc.
F5 Networks and BIG-IP (c) Copyright 2008-2013, 2016. All rights reserved.
BIG-IP 2018-05-08 net interface(1)