grcli-interface - Man Page

Interfaces.

Synopsis

interface add ipip NAME local LOCAL remote REMOTE [[promisc (on|off)] [mtu MTU] [vrf VRF] (up|down)]

Create a new IPIP tunnel interface.

interface add vlan NAME parent PARENT vlan_id VLAN [[promisc (on|off)] [mtu MTU] [vrf VRF] [mac MAC] (up|down)]

Create a new VLAN sub interface.

interface add port NAME devargs DEVARGS [[promisc (on|off)] [mtu MTU] [vrf VRF] [mac MAC] [rxqs N_RXQ] [qsize Q_SIZE] [mode (l3|[xconnect PEER])] (up|down)]

Create a new port.

interface add bond NAME mode (active-backup|lacp) member MEMBER+ [[promisc (on|off)] [mtu MTU] [vrf VRF] ([primary PRIMARY]|[balance (rss|l2|l3+l4)]) [mac MAC] (up|down)]

Create a new bond interface.

interface set ipip NAME [local LOCAL] [remote REMOTE] (up|down) [promisc (on|off)] [mtu MTU] [vrf VRF] [name NEW_NAME]

Modify ipip parameters.

interface set vlan NAME [parent PARENT] [vlan_id VLAN] (up|down) [promisc (on|off)] [mtu MTU] [vrf VRF] [mac MAC] [name NEW_NAME]

Modify VLAN parameters.

interface set port NAME (up|down) [promisc (on|off)] [mtu MTU] [vrf VRF] [mac MAC] [rxqs N_RXQ] [qsize Q_SIZE] [mode (l3|[xconnect PEER])] [name NEW_NAME]

Modify port parameters.

interface set bond NAME [member MEMBER]+ [mode (active-backup|lacp)] (up|down) [promisc (on|off)] [mtu MTU] [vrf VRF] ([primary PRIMARY]|[balance (rss|l2|l3+l4)]) [mac MAC] [name NEW_NAME]

Modify bond parameters.

interface del NAME

Delete an existing interface.

interface stats

Show interface counters.

interface rates

Show interface counter rates.

interface show ([name NAME]|[type TYPE])

Show interface details.

Options

NAME

Show only this interface.

LOCAL

Local tunnel endpoint address.

REMOTE

Remote tunnel endpoint address.

MTU

Maximum transmission unit size.

VRF

L3 addressing/routing domain ID.

PARENT

Parent port interface.

VLAN

VLAN ID.

MAC

Set the bond MAC address.

DEVARGS

DPDK device args.

N_RXQ

Number of Rx queues.

Q_SIZE

Rx/Tx queues size.

PEER

Peer interface for xconnect

MEMBER

Member port interface.

PRIMARY

Primary member.

NEW_NAME

New interface name.

TYPE

Show only this type of interface.

See Also

grcli(1) grcli-route(1)

Reporting Bugs

Report bugs to the grout project issue tracker at <https://github.com/DPDK/grout/issues>.

Referenced By

grcli(1), grcli-address(1), grcli-affinity(1), grcli-dnat44(1), grcli-nexthop(1), grcli-ping6(1), grcli-router-advert(1), grcli-snat44(1), grcli-trace(1), grcli-traceroute6(1).

2025-12-12