NAME

aggr — IEEE 802.1AX Link Aggregation network interface

SYNOPSIS

pseudo-device aggr

DESCRIPTION

The aggr driver implements IEEE 802.1AX (formerly 802.3ad) Link Aggregation for combining one or more Ethernet interfaces into a single logical interface. The Link Aggregation Control Protocol (LACP) is used to negotiate the aggregation of member interfaces with a partner device.

aggr interfaces must be configured to use one or more Ethernet interfaces as ports, and communicate with a partner device over those ports using LACP. Member interfaces that negotiate with a partner device are aggregated into a single logical link. Packets transmitted through an aggr interface select an aggregated interface for transmission. Packets received by an aggregated device appear to be received by the aggr interface it is a member of.

aggr interfaces can be created at runtime using the ifconfig aggrN create command or by setting up a hostname.if(5) configuration file for netstart(8). The interface itself can be configured with ifconfig(8); see its manual page for more information.

aggr interfaces may be configured with ifconfig(8) and netstart(8) using the following options:

lacpmode active|passive

Set the LACP mode to either active or passive. The default is active mode.

lacptimeout fast|slow

Set the LACP timeout speed to either fast or slow. The default is slow timeouts.

lladdr etheraddr|random

Change the link layer address (MAC address) of the interface. This should be specified as six colon-separated hex values, or can be chosen randomly. By default a random MAC address is generated when an interface is created.

trunkport child-iface

Add child-iface as a port.

-trunkport child-iface

Remove the port child-iface.

Other forms of aggregation of Ethernet interfaces are available using the trunk(4) driver.

EXAMPLES

Create an aggr virtual interface on top of two physical interfaces:

# ifconfig aggr0 create
# ifconfig aggr0 trunkport em0
# ifconfig aggr0 trunkport em1
# ifconfig aggr0 10.1.1.100/24
# ifconfig aggr0 up

SEE ALSO

inet(4), ip(4), netintro(4), trunk(4), hostname.if(5), ifconfig(8), netstart(8)

STANDARDS

IEEE 802.1AX Link Aggregation.

HISTORY

The aggr driver first appeared in OpenBSD 6.6.