aggr(4) - OpenBSD manual pages (original) (raw)

NAME

aggr —IEEE 802.1AX Link Aggregation network interface

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 ahostname.if(5) configuration file fornetstart(8). The interface itself can be configured withifconfig(8); see its manual page for more information.

A random MAC address is generated when anaggr interface is created. A specific MAC address can be assigned using theifconfig(8) command lladdr etheraddr.

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

STANDARDS

IEEE 802.1AX Link Aggregation.

HISTORY

The aggr driver first appeared inOpenBSD 6.6.