OBSERVE. ANALYZE. ACT.
Support Login

CLI ยท Version 26.2

Interface Commands

Show and configure FlowDirector traffic ports, including speed, breakout, FEC, loopback, transceiver hints, direction, and data diode mode.

UI Path: CLI > config interface ID: cli-interface-commands
Workflow
  1. Use show interface to inspect all traffic ports.
  2. Use show interface to inspect one port.
  3. Use config interface ? to list editable fields.
  4. Use speed and fec help after selecting a port because choices are model and mode dependent.

Purpose

Use show interface and config interface to inspect and configure FlowDirector traffic ports.

Command Group

show interface [port]
config interface <port-list> [parameters...]

Port selectors are model-aware. On FlowDirector-12K, native ports are P1 through P32. Breakout child ports use slash notation, such as P3/0.

Show Commands

show interface

Purpose: display all visible traffic ports.

Syntax:

show interface

show interface

Purpose: display one port's configuration and status.

Syntax:

show interface P3
show interface P3/0

Typical output:

Port Selection           : P3
User Given Port Name     : P3
Administrative State     : true
Auto Negotiation         : Disable
Auto Negotiation Speeds  :
Speed Selection          : 2x100G
FEC Selection            : RS544
Loopback                 : NONE
Transceiver Type         : auto
Traffic Direction        : rxtx
Data Diode Port, Tx Only : false
Display Diagnosis Output : false

Configure Interface

config interface

Purpose: change FlowDirector traffic port settings.

Syntax pattern:

config interface <port-list> [name <name>] [admin <true|false>] [autoneg <Enable|Disable>] [autoneg_speed <speed>] [speed <speed>] [fec <fec>] [loopback <mode>] [transceiver_hint <hint>] [direction <dir>] [data_diode_tx_only <true|false>] [diagnostic_enable <true|false>]

Use the live help for the selected port:

config interface P3 ?

Typical parameter help:

name                     - User given port name
admin                    - Set the port to be enabled or disabled
autoneg                  - Port autonegotiation selection
autoneg_speed            - Auto Negotiation port speed selection
speed                    - Port speed selection
fec                      - Port speed selection
loopback                 - Loopback settings
transceiver_hint         - Type of transceiver
direction                - Allowed traffic redirection
data_diode_tx_only       - Force the port to keep transmitting when physical receive/link is down
diagnostic_enable        - Execute and display diagnosis output

Dynamic Values

Several fields are dynamic API-backed values. They depend on the selected port, current breakout mode, and sometimes earlier command parameters.

Speed

Use:

config interface P3 speed ?

to list the speeds supported by that port and current model.

FlowDirector-12K examples include native and breakout modes such as:

400G
2x200G
2x100G
4x100G
2x40G
8x50G
8x25G
8x10G

Supported choices depend on port capability and current configuration.

FEC

FEC choices depend on speed. Query FEC after setting or selecting speed:

config interface P3 speed 400G fec ?
config interface P3 speed 4x100G fec ?
config interface P3 speed 8x10G fec ?

FlowDirector-12K 400G FEC choices:

RS272                    - Low-Latency RS-FEC (RS272)
RS528                    - CL91-RS-FEC (RS528)
RS544                    - KP-FEC (RS544)

FlowDirector-12K 8x10G FEC choice:

NONE                     - Disable-FEC

When a speed change makes the current FEC invalid, the UI and CLI workflow should use the backend default for the new speed. For example, merging back to 400G defaults to RS544.

Loopback

Use:

config interface P3 loopback ?

to list loopback modes.

Transceiver Hint

Use:

config interface P3 transceiver_hint ?

to list available transceiver hints. The default is normally auto.

Examples

Set a native 400G port with KP-FEC:

config interface P3 speed 400G fec RS544

Break out a port to 4x100G:

config interface P3 speed 4x100G fec RS544

Set 8x10G breakout with FEC disabled:

config interface P3 speed 8x10G fec NONE

Enable MAC loopback:

config interface P6/0 loopback MAC

Enable data diode Tx-only behavior:

config interface P25/0 data_diode_tx_only true

Notes

  • Changing speed or breakout mode can remap BCM logical ports. The vfabric backend refreshes front-panel to backend-port mapping after changes.
  • Some operations are disruptive and may briefly drop link.
  • FEC and speed validation is model-specific.
  • Use diagnostic_enable true when you need workflow output with additional port diagnostic lines.

Troubleshooting

FEC Selection Is Empty Or Invalid

Run:

config interface <port> speed <speed> fec ?

If the current FEC is not listed, choose one of the displayed values. On FlowDirector-12K, 400G defaults to RS544.

Speed Change Fails

Check that all child ports in a port macro are disabled or eligible for the requested flexport mode. Then inspect backend logs or run:

diag vfabric dump ports

Check:

show interface <port>
diag transceiver low-power

Confirm the port is administratively enabled, the speed/FEC matches the transceiver, and the module is not in low-power mode.