AGGR(4) | Device Drivers Manual | AGGR(4)

# 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 aggr` N `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.

September 2, 2020 | Debian