AGGR(4)

NAME
aggr - IEEE 802.1AX Link Aggregation (LACP) 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.

A random MAC address is generated when an aggr interface is created. A specific MAC address can be assigned using the ifconfig(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

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.