OpenBSD manual page server

Manual Page Search Parameters

AGGR(4) Device Drivers Manual AGGR(4)

aggr
IEEE 802.1AX Link Aggregation network interface

pseudo-device aggr

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:

active|passive
Set the LACP mode to either active or passive. The default is active mode.
fast|slow
Set the LACP timeout speed to either fast or slow. The default is slow timeouts.
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.
child-iface
Add child-iface as a port.
child-iface
Remove the port child-iface.

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

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

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

IEEE 802.1AX Link Aggregation.

The aggr driver first appeared in OpenBSD 6.6.
July 5, 2019 OpenBSD-current