ieee8023ad_lacp.c revision 191692
1/*	$NetBSD: ieee8023ad_lacp.c,v 1.3 2005/12/11 12:24:54 christos Exp $	*/
2
3/*-
4 * Copyright (c)2005 YAMAMOTO Takashi,
5 * Copyright (c)2008 Andrew Thompson <thompsa@FreeBSD.org>
6 * All rights reserved.
7 *
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
10 * are met:
11 * 1. Redistributions of source code must retain the above copyright
12 *    notice, this list of conditions and the following disclaimer.
13 * 2. Redistributions in binary form must reproduce the above copyright
14 *    notice, this list of conditions and the following disclaimer in the
15 *    documentation and/or other materials provided with the distribution.
16 *
17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
18 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
21 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27 * SUCH DAMAGE.
28 */
29
30#include <sys/cdefs.h>
31__FBSDID("$FreeBSD: head/sys/net/ieee8023ad_lacp.c 191692 2009-04-30 14:25:44Z thompsa $");
32
33#include <sys/param.h>
34#include <sys/callout.h>
35#include <sys/mbuf.h>
36#include <sys/systm.h>
37#include <sys/malloc.h>
38#include <sys/kernel.h> /* hz */
39#include <sys/socket.h> /* for net/if.h */
40#include <sys/sockio.h>
41#include <machine/stdarg.h>
42#include <sys/lock.h>
43#include <sys/rwlock.h>
44
45#include <net/if.h>
46#include <net/if_dl.h>
47#include <net/ethernet.h>
48#include <net/if_media.h>
49#include <net/if_types.h>
50
51#include <net/if_lagg.h>
52#include <net/ieee8023ad_lacp.h>
53
54/*
55 * actor system priority and port priority.
56 * XXX should be configurable.
57 */
58
59#define	LACP_SYSTEM_PRIO	0x8000
60#define	LACP_PORT_PRIO		0x8000
61
62const uint8_t ethermulticastaddr_slowprotocols[ETHER_ADDR_LEN] =
63    { 0x01, 0x80, 0xc2, 0x00, 0x00, 0x02 };
64
65static const struct tlv_template lacp_info_tlv_template[] = {
66	{ LACP_TYPE_ACTORINFO,
67	    sizeof(struct tlvhdr) + sizeof(struct lacp_peerinfo) },
68	{ LACP_TYPE_PARTNERINFO,
69	    sizeof(struct tlvhdr) + sizeof(struct lacp_peerinfo) },
70	{ LACP_TYPE_COLLECTORINFO,
71	    sizeof(struct tlvhdr) + sizeof(struct lacp_collectorinfo) },
72	{ 0, 0 },
73};
74
75static const struct tlv_template marker_info_tlv_template[] = {
76	{ MARKER_TYPE_INFO,
77	    sizeof(struct tlvhdr) + sizeof(struct lacp_markerinfo) },
78	{ 0, 0 },
79};
80
81static const struct tlv_template marker_response_tlv_template[] = {
82	{ MARKER_TYPE_RESPONSE,
83	    sizeof(struct tlvhdr) + sizeof(struct lacp_markerinfo) },
84	{ 0, 0 },
85};
86
87typedef void (*lacp_timer_func_t)(struct lacp_port *);
88
89static void	lacp_fill_actorinfo(struct lacp_port *, struct lacp_peerinfo *);
90static void	lacp_fill_markerinfo(struct lacp_port *,
91		    struct lacp_markerinfo *);
92
93static uint64_t	lacp_aggregator_bandwidth(struct lacp_aggregator *);
94static void	lacp_suppress_distributing(struct lacp_softc *,
95		    struct lacp_aggregator *);
96static void	lacp_transit_expire(void *);
97static void	lacp_update_portmap(struct lacp_softc *);
98static void	lacp_select_active_aggregator(struct lacp_softc *);
99static uint16_t	lacp_compose_key(struct lacp_port *);
100static int	tlv_check(const void *, size_t, const struct tlvhdr *,
101		    const struct tlv_template *, boolean_t);
102static void	lacp_tick(void *);
103
104static void	lacp_fill_aggregator_id(struct lacp_aggregator *,
105		    const struct lacp_port *);
106static void	lacp_fill_aggregator_id_peer(struct lacp_peerinfo *,
107		    const struct lacp_peerinfo *);
108static int	lacp_aggregator_is_compatible(const struct lacp_aggregator *,
109		    const struct lacp_port *);
110static int	lacp_peerinfo_is_compatible(const struct lacp_peerinfo *,
111		    const struct lacp_peerinfo *);
112
113static struct lacp_aggregator *lacp_aggregator_get(struct lacp_softc *,
114		    struct lacp_port *);
115static void	lacp_aggregator_addref(struct lacp_softc *,
116		    struct lacp_aggregator *);
117static void	lacp_aggregator_delref(struct lacp_softc *,
118		    struct lacp_aggregator *);
119
120/* receive machine */
121
122static int	lacp_pdu_input(struct lacp_port *, struct mbuf *);
123static int	lacp_marker_input(struct lacp_port *, struct mbuf *);
124static void	lacp_sm_rx(struct lacp_port *, const struct lacpdu *);
125static void	lacp_sm_rx_timer(struct lacp_port *);
126static void	lacp_sm_rx_set_expired(struct lacp_port *);
127static void	lacp_sm_rx_update_ntt(struct lacp_port *,
128		    const struct lacpdu *);
129static void	lacp_sm_rx_record_pdu(struct lacp_port *,
130		    const struct lacpdu *);
131static void	lacp_sm_rx_update_selected(struct lacp_port *,
132		    const struct lacpdu *);
133static void	lacp_sm_rx_record_default(struct lacp_port *);
134static void	lacp_sm_rx_update_default_selected(struct lacp_port *);
135static void	lacp_sm_rx_update_selected_from_peerinfo(struct lacp_port *,
136		    const struct lacp_peerinfo *);
137
138/* mux machine */
139
140static void	lacp_sm_mux(struct lacp_port *);
141static void	lacp_set_mux(struct lacp_port *, enum lacp_mux_state);
142static void	lacp_sm_mux_timer(struct lacp_port *);
143
144/* periodic transmit machine */
145
146static void	lacp_sm_ptx_update_timeout(struct lacp_port *, uint8_t);
147static void	lacp_sm_ptx_tx_schedule(struct lacp_port *);
148static void	lacp_sm_ptx_timer(struct lacp_port *);
149
150/* transmit machine */
151
152static void	lacp_sm_tx(struct lacp_port *);
153static void	lacp_sm_assert_ntt(struct lacp_port *);
154
155static void	lacp_run_timers(struct lacp_port *);
156static int	lacp_compare_peerinfo(const struct lacp_peerinfo *,
157		    const struct lacp_peerinfo *);
158static int	lacp_compare_systemid(const struct lacp_systemid *,
159		    const struct lacp_systemid *);
160static void	lacp_port_enable(struct lacp_port *);
161static void	lacp_port_disable(struct lacp_port *);
162static void	lacp_select(struct lacp_port *);
163static void	lacp_unselect(struct lacp_port *);
164static void	lacp_disable_collecting(struct lacp_port *);
165static void	lacp_enable_collecting(struct lacp_port *);
166static void	lacp_disable_distributing(struct lacp_port *);
167static void	lacp_enable_distributing(struct lacp_port *);
168static int	lacp_xmit_lacpdu(struct lacp_port *);
169static int	lacp_xmit_marker(struct lacp_port *);
170
171#if defined(LACP_DEBUG)
172static void	lacp_dump_lacpdu(const struct lacpdu *);
173static const char *lacp_format_partner(const struct lacp_peerinfo *, char *,
174		    size_t);
175static const char *lacp_format_lagid(const struct lacp_peerinfo *,
176		    const struct lacp_peerinfo *, char *, size_t);
177static const char *lacp_format_lagid_aggregator(const struct lacp_aggregator *,
178		    char *, size_t);
179static const char *lacp_format_state(uint8_t, char *, size_t);
180static const char *lacp_format_mac(const uint8_t *, char *, size_t);
181static const char *lacp_format_systemid(const struct lacp_systemid *, char *,
182		    size_t);
183static const char *lacp_format_portid(const struct lacp_portid *, char *,
184		    size_t);
185static void	lacp_dprintf(const struct lacp_port *, const char *, ...)
186		    __attribute__((__format__(__printf__, 2, 3)));
187#define	LACP_DPRINTF(a)	lacp_dprintf a
188#else
189#define LACP_DPRINTF(a) /* nothing */
190#endif
191
192/*
193 * partner administration variables.
194 * XXX should be configurable.
195 */
196
197static const struct lacp_peerinfo lacp_partner_admin = {
198	.lip_systemid = { .lsi_prio = 0xffff },
199	.lip_portid = { .lpi_prio = 0xffff },
200#if 1
201	/* optimistic */
202	.lip_state = LACP_STATE_SYNC | LACP_STATE_AGGREGATION |
203	    LACP_STATE_COLLECTING | LACP_STATE_DISTRIBUTING,
204#else
205	/* pessimistic */
206	.lip_state = 0,
207#endif
208};
209
210static const lacp_timer_func_t lacp_timer_funcs[LACP_NTIMER] = {
211	[LACP_TIMER_CURRENT_WHILE] = lacp_sm_rx_timer,
212	[LACP_TIMER_PERIODIC] = lacp_sm_ptx_timer,
213	[LACP_TIMER_WAIT_WHILE] = lacp_sm_mux_timer,
214};
215
216struct mbuf *
217lacp_input(struct lagg_port *lgp, struct mbuf *m)
218{
219	struct lacp_port *lp = LACP_PORT(lgp);
220	uint8_t subtype;
221
222	if (m->m_pkthdr.len < sizeof(struct ether_header) + sizeof(subtype)) {
223		m_freem(m);
224		return (NULL);
225	}
226
227	m_copydata(m, sizeof(struct ether_header), sizeof(subtype), &subtype);
228	switch (subtype) {
229		case SLOWPROTOCOLS_SUBTYPE_LACP:
230			lacp_pdu_input(lp, m);
231			return (NULL);
232
233		case SLOWPROTOCOLS_SUBTYPE_MARKER:
234			lacp_marker_input(lp, m);
235			return (NULL);
236	}
237
238	/* Not a subtype we are interested in */
239	return (m);
240}
241
242/*
243 * lacp_pdu_input: process lacpdu
244 */
245static int
246lacp_pdu_input(struct lacp_port *lp, struct mbuf *m)
247{
248	struct lacp_softc *lsc = lp->lp_lsc;
249	struct lacpdu *du;
250	int error = 0;
251
252	if (m->m_pkthdr.len != sizeof(*du)) {
253		goto bad;
254	}
255
256	if ((m->m_flags & M_MCAST) == 0) {
257		goto bad;
258	}
259
260	if (m->m_len < sizeof(*du)) {
261		m = m_pullup(m, sizeof(*du));
262		if (m == NULL) {
263			return (ENOMEM);
264		}
265	}
266
267	du = mtod(m, struct lacpdu *);
268
269	if (memcmp(&du->ldu_eh.ether_dhost,
270	    &ethermulticastaddr_slowprotocols, ETHER_ADDR_LEN)) {
271		goto bad;
272	}
273
274	/*
275	 * ignore the version for compatibility with
276	 * the future protocol revisions.
277	 */
278#if 0
279	if (du->ldu_sph.sph_version != 1) {
280		goto bad;
281	}
282#endif
283
284	/*
285	 * ignore tlv types for compatibility with
286	 * the future protocol revisions.
287	 */
288	if (tlv_check(du, sizeof(*du), &du->ldu_tlv_actor,
289	    lacp_info_tlv_template, FALSE)) {
290		goto bad;
291	}
292
293#if defined(LACP_DEBUG)
294	LACP_DPRINTF((lp, "lacpdu receive\n"));
295	lacp_dump_lacpdu(du);
296#endif /* defined(LACP_DEBUG) */
297
298	LACP_LOCK(lsc);
299	lacp_sm_rx(lp, du);
300	LACP_UNLOCK(lsc);
301
302	m_freem(m);
303	return (error);
304
305bad:
306	m_freem(m);
307	return (EINVAL);
308}
309
310static void
311lacp_fill_actorinfo(struct lacp_port *lp, struct lacp_peerinfo *info)
312{
313	struct lagg_port *lgp = lp->lp_lagg;
314	struct lagg_softc *sc = lgp->lp_softc;
315
316	info->lip_systemid.lsi_prio = htons(LACP_SYSTEM_PRIO);
317	memcpy(&info->lip_systemid.lsi_mac,
318	    IF_LLADDR(sc->sc_ifp), ETHER_ADDR_LEN);
319	info->lip_portid.lpi_prio = htons(LACP_PORT_PRIO);
320	info->lip_portid.lpi_portno = htons(lp->lp_ifp->if_index);
321	info->lip_state = lp->lp_state;
322}
323
324static void
325lacp_fill_markerinfo(struct lacp_port *lp, struct lacp_markerinfo *info)
326{
327	struct ifnet *ifp = lp->lp_ifp;
328
329	/* Fill in the port index and system id (encoded as the MAC) */
330	info->mi_rq_port = htons(ifp->if_index);
331	memcpy(&info->mi_rq_system, lp->lp_systemid.lsi_mac, ETHER_ADDR_LEN);
332	info->mi_rq_xid = htonl(0);
333}
334
335static int
336lacp_xmit_lacpdu(struct lacp_port *lp)
337{
338	struct lagg_port *lgp = lp->lp_lagg;
339	struct mbuf *m;
340	struct lacpdu *du;
341	int error;
342
343	LACP_LOCK_ASSERT(lp->lp_lsc);
344
345	m = m_gethdr(M_DONTWAIT, MT_DATA);
346	if (m == NULL) {
347		return (ENOMEM);
348	}
349	m->m_len = m->m_pkthdr.len = sizeof(*du);
350
351	du = mtod(m, struct lacpdu *);
352	memset(du, 0, sizeof(*du));
353
354	memcpy(&du->ldu_eh.ether_dhost, ethermulticastaddr_slowprotocols,
355	    ETHER_ADDR_LEN);
356	memcpy(&du->ldu_eh.ether_shost, lgp->lp_lladdr, ETHER_ADDR_LEN);
357	du->ldu_eh.ether_type = htons(ETHERTYPE_SLOW);
358
359	du->ldu_sph.sph_subtype = SLOWPROTOCOLS_SUBTYPE_LACP;
360	du->ldu_sph.sph_version = 1;
361
362	TLV_SET(&du->ldu_tlv_actor, LACP_TYPE_ACTORINFO, sizeof(du->ldu_actor));
363	du->ldu_actor = lp->lp_actor;
364
365	TLV_SET(&du->ldu_tlv_partner, LACP_TYPE_PARTNERINFO,
366	    sizeof(du->ldu_partner));
367	du->ldu_partner = lp->lp_partner;
368
369	TLV_SET(&du->ldu_tlv_collector, LACP_TYPE_COLLECTORINFO,
370	    sizeof(du->ldu_collector));
371	du->ldu_collector.lci_maxdelay = 0;
372
373#if defined(LACP_DEBUG)
374	LACP_DPRINTF((lp, "lacpdu transmit\n"));
375	lacp_dump_lacpdu(du);
376#endif /* defined(LACP_DEBUG) */
377
378	m->m_flags |= M_MCAST;
379
380	/*
381	 * XXX should use higher priority queue.
382	 * otherwise network congestion can break aggregation.
383	 */
384
385	error = lagg_enqueue(lp->lp_ifp, m);
386	return (error);
387}
388
389static int
390lacp_xmit_marker(struct lacp_port *lp)
391{
392	struct lagg_port *lgp = lp->lp_lagg;
393	struct mbuf *m;
394	struct markerdu *mdu;
395	int error;
396
397	LACP_LOCK_ASSERT(lp->lp_lsc);
398
399	m = m_gethdr(M_DONTWAIT, MT_DATA);
400	if (m == NULL) {
401		return (ENOMEM);
402	}
403	m->m_len = m->m_pkthdr.len = sizeof(*mdu);
404
405	mdu = mtod(m, struct markerdu *);
406	memset(mdu, 0, sizeof(*mdu));
407
408	memcpy(&mdu->mdu_eh.ether_dhost, ethermulticastaddr_slowprotocols,
409	    ETHER_ADDR_LEN);
410	memcpy(&mdu->mdu_eh.ether_shost, lgp->lp_lladdr, ETHER_ADDR_LEN);
411	mdu->mdu_eh.ether_type = htons(ETHERTYPE_SLOW);
412
413	mdu->mdu_sph.sph_subtype = SLOWPROTOCOLS_SUBTYPE_MARKER;
414	mdu->mdu_sph.sph_version = 1;
415
416	/* Bump the transaction id and copy over the marker info */
417	lp->lp_marker.mi_rq_xid = htonl(ntohl(lp->lp_marker.mi_rq_xid) + 1);
418	TLV_SET(&mdu->mdu_tlv, MARKER_TYPE_INFO, sizeof(mdu->mdu_info));
419	mdu->mdu_info = lp->lp_marker;
420
421	LACP_DPRINTF((lp, "marker transmit, port=%u, sys=%6D, id=%u\n",
422	    ntohs(mdu->mdu_info.mi_rq_port), mdu->mdu_info.mi_rq_system, ":",
423	    ntohl(mdu->mdu_info.mi_rq_xid)));
424
425	m->m_flags |= M_MCAST;
426	error = lagg_enqueue(lp->lp_ifp, m);
427	return (error);
428}
429
430void
431lacp_linkstate(struct lagg_port *lgp)
432{
433	struct lacp_port *lp = LACP_PORT(lgp);
434	struct lacp_softc *lsc = lp->lp_lsc;
435	struct ifnet *ifp = lgp->lp_ifp;
436	struct ifmediareq ifmr;
437	int error = 0;
438	u_int media;
439	uint8_t old_state;
440	uint16_t old_key;
441
442	bzero((char *)&ifmr, sizeof(ifmr));
443	error = (*ifp->if_ioctl)(ifp, SIOCGIFMEDIA, (caddr_t)&ifmr);
444	if (error != 0)
445		return;
446
447	LACP_LOCK(lsc);
448	media = ifmr.ifm_active;
449	LACP_DPRINTF((lp, "media changed 0x%x -> 0x%x, ether = %d, fdx = %d, "
450	    "link = %d\n", lp->lp_media, media, IFM_TYPE(media) == IFM_ETHER,
451	    (media & IFM_FDX) != 0, ifp->if_link_state == LINK_STATE_UP));
452	old_state = lp->lp_state;
453	old_key = lp->lp_key;
454
455	lp->lp_media = media;
456	/*
457	 * If the port is not an active full duplex Ethernet link then it can
458	 * not be aggregated.
459	 */
460	if (IFM_TYPE(media) != IFM_ETHER || (media & IFM_FDX) == 0 ||
461	    ifp->if_link_state != LINK_STATE_UP) {
462		lacp_port_disable(lp);
463	} else {
464		lacp_port_enable(lp);
465	}
466	lp->lp_key = lacp_compose_key(lp);
467
468	if (old_state != lp->lp_state || old_key != lp->lp_key) {
469		LACP_DPRINTF((lp, "-> UNSELECTED\n"));
470		lp->lp_selected = LACP_UNSELECTED;
471	}
472	LACP_UNLOCK(lsc);
473}
474
475static void
476lacp_tick(void *arg)
477{
478	struct lacp_softc *lsc = arg;
479	struct lacp_port *lp;
480
481	LIST_FOREACH(lp, &lsc->lsc_ports, lp_next) {
482		if ((lp->lp_state & LACP_STATE_AGGREGATION) == 0)
483			continue;
484
485		lacp_run_timers(lp);
486
487		lacp_select(lp);
488		lacp_sm_mux(lp);
489		lacp_sm_tx(lp);
490		lacp_sm_ptx_tx_schedule(lp);
491	}
492	callout_reset(&lsc->lsc_callout, hz, lacp_tick, lsc);
493}
494
495int
496lacp_port_create(struct lagg_port *lgp)
497{
498	struct lagg_softc *sc = lgp->lp_softc;
499	struct lacp_softc *lsc = LACP_SOFTC(sc);
500	struct lacp_port *lp;
501	struct ifnet *ifp = lgp->lp_ifp;
502	struct sockaddr_dl sdl;
503	struct ifmultiaddr *rifma = NULL;
504	int error;
505
506	boolean_t active = TRUE; /* XXX should be configurable */
507	boolean_t fast = FALSE; /* XXX should be configurable */
508
509	bzero((char *)&sdl, sizeof(sdl));
510	sdl.sdl_len = sizeof(sdl);
511	sdl.sdl_family = AF_LINK;
512	sdl.sdl_index = ifp->if_index;
513	sdl.sdl_type = IFT_ETHER;
514	sdl.sdl_alen = ETHER_ADDR_LEN;
515
516	bcopy(&ethermulticastaddr_slowprotocols,
517	    LLADDR(&sdl), ETHER_ADDR_LEN);
518	error = if_addmulti(ifp, (struct sockaddr *)&sdl, &rifma);
519	if (error) {
520		printf("%s: ADDMULTI failed on %s\n", __func__, lgp->lp_ifname);
521		return (error);
522	}
523
524	lp = malloc(sizeof(struct lacp_port),
525	    M_DEVBUF, M_NOWAIT|M_ZERO);
526	if (lp == NULL)
527		return (ENOMEM);
528
529	LACP_LOCK(lsc);
530	lgp->lp_psc = (caddr_t)lp;
531	lp->lp_ifp = ifp;
532	lp->lp_lagg = lgp;
533	lp->lp_lsc = lsc;
534	lp->lp_ifma = rifma;
535
536	LIST_INSERT_HEAD(&lsc->lsc_ports, lp, lp_next);
537
538	lacp_fill_actorinfo(lp, &lp->lp_actor);
539	lacp_fill_markerinfo(lp, &lp->lp_marker);
540	lp->lp_state =
541	    (active ? LACP_STATE_ACTIVITY : 0) |
542	    (fast ? LACP_STATE_TIMEOUT : 0);
543	lp->lp_aggregator = NULL;
544	lacp_sm_rx_set_expired(lp);
545	LACP_UNLOCK(lsc);
546	lacp_linkstate(lgp);
547
548	return (0);
549}
550
551void
552lacp_port_destroy(struct lagg_port *lgp)
553{
554	struct lacp_port *lp = LACP_PORT(lgp);
555	struct lacp_softc *lsc = lp->lp_lsc;
556	int i;
557
558	LACP_LOCK(lsc);
559	for (i = 0; i < LACP_NTIMER; i++) {
560		LACP_TIMER_DISARM(lp, i);
561	}
562
563	lacp_disable_collecting(lp);
564	lacp_disable_distributing(lp);
565	lacp_unselect(lp);
566
567	/* The address may have already been removed by if_purgemaddrs() */
568	if (!lgp->lp_detaching)
569		if_delmulti_ifma(lp->lp_ifma);
570
571	LIST_REMOVE(lp, lp_next);
572	LACP_UNLOCK(lsc);
573	free(lp, M_DEVBUF);
574}
575
576void
577lacp_req(struct lagg_softc *sc, caddr_t data)
578{
579	struct lacp_opreq *req = (struct lacp_opreq *)data;
580	struct lacp_softc *lsc = LACP_SOFTC(sc);
581	struct lacp_aggregator *la = lsc->lsc_active_aggregator;
582
583	LACP_LOCK(lsc);
584	bzero(req, sizeof(struct lacp_opreq));
585	if (la != NULL) {
586		req->actor_prio = ntohs(la->la_actor.lip_systemid.lsi_prio);
587		memcpy(&req->actor_mac, &la->la_actor.lip_systemid.lsi_mac,
588		    ETHER_ADDR_LEN);
589		req->actor_key = ntohs(la->la_actor.lip_key);
590		req->actor_portprio = ntohs(la->la_actor.lip_portid.lpi_prio);
591		req->actor_portno = ntohs(la->la_actor.lip_portid.lpi_portno);
592		req->actor_state = la->la_actor.lip_state;
593
594		req->partner_prio = ntohs(la->la_partner.lip_systemid.lsi_prio);
595		memcpy(&req->partner_mac, &la->la_partner.lip_systemid.lsi_mac,
596		    ETHER_ADDR_LEN);
597		req->partner_key = ntohs(la->la_partner.lip_key);
598		req->partner_portprio = ntohs(la->la_partner.lip_portid.lpi_prio);
599		req->partner_portno = ntohs(la->la_partner.lip_portid.lpi_portno);
600		req->partner_state = la->la_partner.lip_state;
601	}
602	LACP_UNLOCK(lsc);
603}
604
605void
606lacp_portreq(struct lagg_port *lgp, caddr_t data)
607{
608	struct lacp_opreq *req = (struct lacp_opreq *)data;
609	struct lacp_port *lp = LACP_PORT(lgp);
610	struct lacp_softc *lsc = lp->lp_lsc;
611
612	LACP_LOCK(lsc);
613	req->actor_prio = ntohs(lp->lp_actor.lip_systemid.lsi_prio);
614	memcpy(&req->actor_mac, &lp->lp_actor.lip_systemid.lsi_mac,
615	    ETHER_ADDR_LEN);
616	req->actor_key = ntohs(lp->lp_actor.lip_key);
617	req->actor_portprio = ntohs(lp->lp_actor.lip_portid.lpi_prio);
618	req->actor_portno = ntohs(lp->lp_actor.lip_portid.lpi_portno);
619	req->actor_state = lp->lp_actor.lip_state;
620
621	req->partner_prio = ntohs(lp->lp_partner.lip_systemid.lsi_prio);
622	memcpy(&req->partner_mac, &lp->lp_partner.lip_systemid.lsi_mac,
623	    ETHER_ADDR_LEN);
624	req->partner_key = ntohs(lp->lp_partner.lip_key);
625	req->partner_portprio = ntohs(lp->lp_partner.lip_portid.lpi_prio);
626	req->partner_portno = ntohs(lp->lp_partner.lip_portid.lpi_portno);
627	req->partner_state = lp->lp_partner.lip_state;
628	LACP_UNLOCK(lsc);
629}
630
631static void
632lacp_disable_collecting(struct lacp_port *lp)
633{
634	LACP_DPRINTF((lp, "collecting disabled\n"));
635	lp->lp_state &= ~LACP_STATE_COLLECTING;
636}
637
638static void
639lacp_enable_collecting(struct lacp_port *lp)
640{
641	LACP_DPRINTF((lp, "collecting enabled\n"));
642	lp->lp_state |= LACP_STATE_COLLECTING;
643}
644
645static void
646lacp_disable_distributing(struct lacp_port *lp)
647{
648	struct lacp_aggregator *la = lp->lp_aggregator;
649	struct lacp_softc *lsc = lp->lp_lsc;
650#if defined(LACP_DEBUG)
651	char buf[LACP_LAGIDSTR_MAX+1];
652#endif /* defined(LACP_DEBUG) */
653
654	LACP_LOCK_ASSERT(lsc);
655
656	if (la == NULL || (lp->lp_state & LACP_STATE_DISTRIBUTING) == 0) {
657		return;
658	}
659
660	KASSERT(!TAILQ_EMPTY(&la->la_ports), ("no aggregator ports"));
661	KASSERT(la->la_nports > 0, ("nports invalid (%d)", la->la_nports));
662	KASSERT(la->la_refcnt >= la->la_nports, ("aggregator refcnt invalid"));
663
664	LACP_DPRINTF((lp, "disable distributing on aggregator %s, "
665	    "nports %d -> %d\n",
666	    lacp_format_lagid_aggregator(la, buf, sizeof(buf)),
667	    la->la_nports, la->la_nports - 1));
668
669	TAILQ_REMOVE(&la->la_ports, lp, lp_dist_q);
670	la->la_nports--;
671
672	if (lsc->lsc_active_aggregator == la) {
673		lacp_suppress_distributing(lsc, la);
674		lacp_select_active_aggregator(lsc);
675		/* regenerate the port map, the active aggregator has changed */
676		lacp_update_portmap(lsc);
677	}
678
679	lp->lp_state &= ~LACP_STATE_DISTRIBUTING;
680}
681
682static void
683lacp_enable_distributing(struct lacp_port *lp)
684{
685	struct lacp_aggregator *la = lp->lp_aggregator;
686	struct lacp_softc *lsc = lp->lp_lsc;
687#if defined(LACP_DEBUG)
688	char buf[LACP_LAGIDSTR_MAX+1];
689#endif /* defined(LACP_DEBUG) */
690
691	LACP_LOCK_ASSERT(lsc);
692
693	if ((lp->lp_state & LACP_STATE_DISTRIBUTING) != 0) {
694		return;
695	}
696
697	LACP_DPRINTF((lp, "enable distributing on aggregator %s, "
698	    "nports %d -> %d\n",
699	    lacp_format_lagid_aggregator(la, buf, sizeof(buf)),
700	    la->la_nports, la->la_nports + 1));
701
702	KASSERT(la->la_refcnt > la->la_nports, ("aggregator refcnt invalid"));
703	TAILQ_INSERT_HEAD(&la->la_ports, lp, lp_dist_q);
704	la->la_nports++;
705
706	lp->lp_state |= LACP_STATE_DISTRIBUTING;
707
708	if (lsc->lsc_active_aggregator == la) {
709		lacp_suppress_distributing(lsc, la);
710		lacp_update_portmap(lsc);
711	} else
712		/* try to become the active aggregator */
713		lacp_select_active_aggregator(lsc);
714}
715
716static void
717lacp_transit_expire(void *vp)
718{
719	struct lacp_softc *lsc = vp;
720
721	LACP_LOCK_ASSERT(lsc);
722
723	LACP_DPRINTF((NULL, "%s\n", __func__));
724	lsc->lsc_suppress_distributing = FALSE;
725}
726
727int
728lacp_attach(struct lagg_softc *sc)
729{
730	struct lacp_softc *lsc;
731
732	lsc = malloc(sizeof(struct lacp_softc),
733	    M_DEVBUF, M_NOWAIT|M_ZERO);
734	if (lsc == NULL)
735		return (ENOMEM);
736
737	sc->sc_psc = (caddr_t)lsc;
738	lsc->lsc_softc = sc;
739
740	lsc->lsc_hashkey = arc4random();
741	lsc->lsc_active_aggregator = NULL;
742	LACP_LOCK_INIT(lsc);
743	TAILQ_INIT(&lsc->lsc_aggregators);
744	LIST_INIT(&lsc->lsc_ports);
745
746	callout_init_mtx(&lsc->lsc_transit_callout, &lsc->lsc_mtx, 0);
747	callout_init_mtx(&lsc->lsc_callout, &lsc->lsc_mtx, 0);
748
749	/* if the lagg is already up then do the same */
750	if (sc->sc_ifp->if_drv_flags & IFF_DRV_RUNNING)
751		lacp_init(sc);
752
753	return (0);
754}
755
756int
757lacp_detach(struct lagg_softc *sc)
758{
759	struct lacp_softc *lsc = LACP_SOFTC(sc);
760
761	KASSERT(TAILQ_EMPTY(&lsc->lsc_aggregators),
762	    ("aggregators still active"));
763	KASSERT(lsc->lsc_active_aggregator == NULL,
764	    ("aggregator still attached"));
765
766	sc->sc_psc = NULL;
767	callout_drain(&lsc->lsc_transit_callout);
768	callout_drain(&lsc->lsc_callout);
769
770	LACP_LOCK_DESTROY(lsc);
771	free(lsc, M_DEVBUF);
772	return (0);
773}
774
775void
776lacp_init(struct lagg_softc *sc)
777{
778	struct lacp_softc *lsc = LACP_SOFTC(sc);
779
780	LACP_LOCK(lsc);
781	callout_reset(&lsc->lsc_callout, hz, lacp_tick, lsc);
782	LACP_UNLOCK(lsc);
783}
784
785void
786lacp_stop(struct lagg_softc *sc)
787{
788	struct lacp_softc *lsc = LACP_SOFTC(sc);
789
790	LACP_LOCK(lsc);
791	callout_stop(&lsc->lsc_transit_callout);
792	callout_stop(&lsc->lsc_callout);
793	LACP_UNLOCK(lsc);
794}
795
796struct lagg_port *
797lacp_select_tx_port(struct lagg_softc *sc, struct mbuf *m)
798{
799	struct lacp_softc *lsc = LACP_SOFTC(sc);
800	struct lacp_portmap *pm;
801	struct lacp_port *lp;
802	uint32_t hash;
803
804	if (__predict_false(lsc->lsc_suppress_distributing)) {
805		LACP_DPRINTF((NULL, "%s: waiting transit\n", __func__));
806		return (NULL);
807	}
808
809	pm = &lsc->lsc_pmap[lsc->lsc_activemap];
810	if (pm->pm_count == 0) {
811		LACP_DPRINTF((NULL, "%s: no active aggregator\n", __func__));
812		return (NULL);
813	}
814
815	if (m->m_flags & M_FLOWID)
816		hash = m->m_pkthdr.flowid;
817	else
818		hash = lagg_hashmbuf(m, lsc->lsc_hashkey);
819	hash %= pm->pm_count;
820	lp = pm->pm_map[hash];
821
822	KASSERT((lp->lp_state & LACP_STATE_DISTRIBUTING) != 0,
823	    ("aggregated port is not distributing"));
824
825	return (lp->lp_lagg);
826}
827/*
828 * lacp_suppress_distributing: drop transmit packets for a while
829 * to preserve packet ordering.
830 */
831
832static void
833lacp_suppress_distributing(struct lacp_softc *lsc, struct lacp_aggregator *la)
834{
835	struct lacp_port *lp;
836
837	if (lsc->lsc_active_aggregator != la) {
838		return;
839	}
840
841	LACP_DPRINTF((NULL, "%s\n", __func__));
842	lsc->lsc_suppress_distributing = TRUE;
843
844	/* send a marker frame down each port to verify the queues are empty */
845	LIST_FOREACH(lp, &lsc->lsc_ports, lp_next) {
846		lp->lp_flags |= LACP_PORT_MARK;
847		lacp_xmit_marker(lp);
848	}
849
850	/* set a timeout for the marker frames */
851	callout_reset(&lsc->lsc_transit_callout,
852	    LACP_TRANSIT_DELAY * hz / 1000, lacp_transit_expire, lsc);
853}
854
855static int
856lacp_compare_peerinfo(const struct lacp_peerinfo *a,
857    const struct lacp_peerinfo *b)
858{
859	return (memcmp(a, b, offsetof(struct lacp_peerinfo, lip_state)));
860}
861
862static int
863lacp_compare_systemid(const struct lacp_systemid *a,
864    const struct lacp_systemid *b)
865{
866	return (memcmp(a, b, sizeof(*a)));
867}
868
869#if 0	/* unused */
870static int
871lacp_compare_portid(const struct lacp_portid *a,
872    const struct lacp_portid *b)
873{
874	return (memcmp(a, b, sizeof(*a)));
875}
876#endif
877
878static uint64_t
879lacp_aggregator_bandwidth(struct lacp_aggregator *la)
880{
881	struct lacp_port *lp;
882	uint64_t speed;
883
884	lp = TAILQ_FIRST(&la->la_ports);
885	if (lp == NULL) {
886		return (0);
887	}
888
889	speed = ifmedia_baudrate(lp->lp_media);
890	speed *= la->la_nports;
891	if (speed == 0) {
892		LACP_DPRINTF((lp, "speed 0? media=0x%x nports=%d\n",
893		    lp->lp_media, la->la_nports));
894	}
895
896	return (speed);
897}
898
899/*
900 * lacp_select_active_aggregator: select an aggregator to be used to transmit
901 * packets from lagg(4) interface.
902 */
903
904static void
905lacp_select_active_aggregator(struct lacp_softc *lsc)
906{
907	struct lagg_softc *sc = lsc->lsc_softc;
908	struct lacp_aggregator *la;
909	struct lacp_aggregator *best_la = NULL;
910	uint64_t best_speed = 0;
911#if defined(LACP_DEBUG)
912	char buf[LACP_LAGIDSTR_MAX+1];
913#endif /* defined(LACP_DEBUG) */
914
915	LACP_DPRINTF((NULL, "%s:\n", __func__));
916
917	TAILQ_FOREACH(la, &lsc->lsc_aggregators, la_q) {
918		uint64_t speed;
919
920		if (la->la_nports == 0) {
921			continue;
922		}
923
924		speed = lacp_aggregator_bandwidth(la);
925		LACP_DPRINTF((NULL, "%s, speed=%jd, nports=%d\n",
926		    lacp_format_lagid_aggregator(la, buf, sizeof(buf)),
927		    speed, la->la_nports));
928
929		/* This aggregator is chosen if
930		 *      the partner has a better system priority
931		 *  or, the total aggregated speed is higher
932		 *  or, it is already the chosen aggregator
933		 */
934		if ((best_la != NULL && LACP_SYS_PRI(la->la_partner) <
935		     LACP_SYS_PRI(best_la->la_partner)) ||
936		    speed > best_speed ||
937		    (speed == best_speed &&
938		    la == lsc->lsc_active_aggregator)) {
939			best_la = la;
940			best_speed = speed;
941		}
942	}
943
944	KASSERT(best_la == NULL || best_la->la_nports > 0,
945	    ("invalid aggregator refcnt"));
946	KASSERT(best_la == NULL || !TAILQ_EMPTY(&best_la->la_ports),
947	    ("invalid aggregator list"));
948
949#if defined(LACP_DEBUG)
950	if (lsc->lsc_active_aggregator != best_la) {
951		LACP_DPRINTF((NULL, "active aggregator changed\n"));
952		LACP_DPRINTF((NULL, "old %s\n",
953		    lacp_format_lagid_aggregator(lsc->lsc_active_aggregator,
954		    buf, sizeof(buf))));
955	} else {
956		LACP_DPRINTF((NULL, "active aggregator not changed\n"));
957	}
958	LACP_DPRINTF((NULL, "new %s\n",
959	    lacp_format_lagid_aggregator(best_la, buf, sizeof(buf))));
960#endif /* defined(LACP_DEBUG) */
961
962	if (lsc->lsc_active_aggregator != best_la) {
963		sc->sc_ifp->if_baudrate = best_speed;
964		lsc->lsc_active_aggregator = best_la;
965		lacp_update_portmap(lsc);
966		if (best_la) {
967			lacp_suppress_distributing(lsc, best_la);
968		}
969	}
970}
971
972/*
973 * Updated the inactive portmap array with the new list of ports and
974 * make it live.
975 */
976static void
977lacp_update_portmap(struct lacp_softc *lsc)
978{
979	struct lacp_aggregator *la;
980	struct lacp_portmap *p;
981	struct lacp_port *lp;
982	u_int newmap;
983	int i;
984
985	newmap = lsc->lsc_activemap == 0 ? 1 : 0;
986	p = &lsc->lsc_pmap[newmap];
987	la = lsc->lsc_active_aggregator;
988	bzero(p, sizeof(struct lacp_portmap));
989
990	if (la != NULL && la->la_nports > 0) {
991		p->pm_count = la->la_nports;
992		i = 0;
993		TAILQ_FOREACH(lp, &la->la_ports, lp_dist_q)
994			p->pm_map[i++] = lp;
995		KASSERT(i == p->pm_count, ("Invalid port count"));
996	}
997
998	/* switch the active portmap over */
999	atomic_store_rel_int(&lsc->lsc_activemap, newmap);
1000	LACP_DPRINTF((NULL, "Set table %d with %d ports\n",
1001		    lsc->lsc_activemap,
1002		    lsc->lsc_pmap[lsc->lsc_activemap].pm_count));
1003}
1004
1005static uint16_t
1006lacp_compose_key(struct lacp_port *lp)
1007{
1008	struct lagg_port *lgp = lp->lp_lagg;
1009	struct lagg_softc *sc = lgp->lp_softc;
1010	u_int media = lp->lp_media;
1011	uint16_t key;
1012
1013	if ((lp->lp_state & LACP_STATE_AGGREGATION) == 0) {
1014
1015		/*
1016		 * non-aggregatable links should have unique keys.
1017		 *
1018		 * XXX this isn't really unique as if_index is 16 bit.
1019		 */
1020
1021		/* bit 0..14:	(some bits of) if_index of this port */
1022		key = lp->lp_ifp->if_index;
1023		/* bit 15:	1 */
1024		key |= 0x8000;
1025	} else {
1026		u_int subtype = IFM_SUBTYPE(media);
1027
1028		KASSERT(IFM_TYPE(media) == IFM_ETHER, ("invalid media type"));
1029		KASSERT((media & IFM_FDX) != 0, ("aggregating HDX interface"));
1030
1031		/* bit 0..4:	IFM_SUBTYPE */
1032		key = subtype;
1033		/* bit 5..14:	(some bits of) if_index of lagg device */
1034		key |= 0x7fe0 & ((sc->sc_ifp->if_index) << 5);
1035		/* bit 15:	0 */
1036	}
1037	return (htons(key));
1038}
1039
1040static void
1041lacp_aggregator_addref(struct lacp_softc *lsc, struct lacp_aggregator *la)
1042{
1043#if defined(LACP_DEBUG)
1044	char buf[LACP_LAGIDSTR_MAX+1];
1045#endif
1046
1047	LACP_DPRINTF((NULL, "%s: lagid=%s, refcnt %d -> %d\n",
1048	    __func__,
1049	    lacp_format_lagid(&la->la_actor, &la->la_partner,
1050	    buf, sizeof(buf)),
1051	    la->la_refcnt, la->la_refcnt + 1));
1052
1053	KASSERT(la->la_refcnt > 0, ("refcount <= 0"));
1054	la->la_refcnt++;
1055	KASSERT(la->la_refcnt > la->la_nports, ("invalid refcount"));
1056}
1057
1058static void
1059lacp_aggregator_delref(struct lacp_softc *lsc, struct lacp_aggregator *la)
1060{
1061#if defined(LACP_DEBUG)
1062	char buf[LACP_LAGIDSTR_MAX+1];
1063#endif
1064
1065	LACP_DPRINTF((NULL, "%s: lagid=%s, refcnt %d -> %d\n",
1066	    __func__,
1067	    lacp_format_lagid(&la->la_actor, &la->la_partner,
1068	    buf, sizeof(buf)),
1069	    la->la_refcnt, la->la_refcnt - 1));
1070
1071	KASSERT(la->la_refcnt > la->la_nports, ("invalid refcnt"));
1072	la->la_refcnt--;
1073	if (la->la_refcnt > 0) {
1074		return;
1075	}
1076
1077	KASSERT(la->la_refcnt == 0, ("refcount not zero"));
1078	KASSERT(lsc->lsc_active_aggregator != la, ("aggregator active"));
1079
1080	TAILQ_REMOVE(&lsc->lsc_aggregators, la, la_q);
1081
1082	free(la, M_DEVBUF);
1083}
1084
1085/*
1086 * lacp_aggregator_get: allocate an aggregator.
1087 */
1088
1089static struct lacp_aggregator *
1090lacp_aggregator_get(struct lacp_softc *lsc, struct lacp_port *lp)
1091{
1092	struct lacp_aggregator *la;
1093
1094	la = malloc(sizeof(*la), M_DEVBUF, M_NOWAIT);
1095	if (la) {
1096		la->la_refcnt = 1;
1097		la->la_nports = 0;
1098		TAILQ_INIT(&la->la_ports);
1099		la->la_pending = 0;
1100		TAILQ_INSERT_TAIL(&lsc->lsc_aggregators, la, la_q);
1101	}
1102
1103	return (la);
1104}
1105
1106/*
1107 * lacp_fill_aggregator_id: setup a newly allocated aggregator from a port.
1108 */
1109
1110static void
1111lacp_fill_aggregator_id(struct lacp_aggregator *la, const struct lacp_port *lp)
1112{
1113	lacp_fill_aggregator_id_peer(&la->la_partner, &lp->lp_partner);
1114	lacp_fill_aggregator_id_peer(&la->la_actor, &lp->lp_actor);
1115
1116	la->la_actor.lip_state = lp->lp_state & LACP_STATE_AGGREGATION;
1117}
1118
1119static void
1120lacp_fill_aggregator_id_peer(struct lacp_peerinfo *lpi_aggr,
1121    const struct lacp_peerinfo *lpi_port)
1122{
1123	memset(lpi_aggr, 0, sizeof(*lpi_aggr));
1124	lpi_aggr->lip_systemid = lpi_port->lip_systemid;
1125	lpi_aggr->lip_key = lpi_port->lip_key;
1126}
1127
1128/*
1129 * lacp_aggregator_is_compatible: check if a port can join to an aggregator.
1130 */
1131
1132static int
1133lacp_aggregator_is_compatible(const struct lacp_aggregator *la,
1134    const struct lacp_port *lp)
1135{
1136	if (!(lp->lp_state & LACP_STATE_AGGREGATION) ||
1137	    !(lp->lp_partner.lip_state & LACP_STATE_AGGREGATION)) {
1138		return (0);
1139	}
1140
1141	if (!(la->la_actor.lip_state & LACP_STATE_AGGREGATION)) {
1142		return (0);
1143	}
1144
1145	if (!lacp_peerinfo_is_compatible(&la->la_partner, &lp->lp_partner)) {
1146		return (0);
1147	}
1148
1149	if (!lacp_peerinfo_is_compatible(&la->la_actor, &lp->lp_actor)) {
1150		return (0);
1151	}
1152
1153	return (1);
1154}
1155
1156static int
1157lacp_peerinfo_is_compatible(const struct lacp_peerinfo *a,
1158    const struct lacp_peerinfo *b)
1159{
1160	if (memcmp(&a->lip_systemid, &b->lip_systemid,
1161	    sizeof(a->lip_systemid))) {
1162		return (0);
1163	}
1164
1165	if (memcmp(&a->lip_key, &b->lip_key, sizeof(a->lip_key))) {
1166		return (0);
1167	}
1168
1169	return (1);
1170}
1171
1172static void
1173lacp_port_enable(struct lacp_port *lp)
1174{
1175	lp->lp_state |= LACP_STATE_AGGREGATION;
1176}
1177
1178static void
1179lacp_port_disable(struct lacp_port *lp)
1180{
1181	lacp_set_mux(lp, LACP_MUX_DETACHED);
1182
1183	lp->lp_state &= ~LACP_STATE_AGGREGATION;
1184	lp->lp_selected = LACP_UNSELECTED;
1185	lacp_sm_rx_record_default(lp);
1186	lp->lp_partner.lip_state &= ~LACP_STATE_AGGREGATION;
1187	lp->lp_state &= ~LACP_STATE_EXPIRED;
1188}
1189
1190/*
1191 * lacp_select: select an aggregator.  create one if necessary.
1192 */
1193static void
1194lacp_select(struct lacp_port *lp)
1195{
1196	struct lacp_softc *lsc = lp->lp_lsc;
1197	struct lacp_aggregator *la;
1198#if defined(LACP_DEBUG)
1199	char buf[LACP_LAGIDSTR_MAX+1];
1200#endif
1201
1202	if (lp->lp_aggregator) {
1203		return;
1204	}
1205
1206	KASSERT(!LACP_TIMER_ISARMED(lp, LACP_TIMER_WAIT_WHILE),
1207	    ("timer_wait_while still active"));
1208
1209	LACP_DPRINTF((lp, "port lagid=%s\n",
1210	    lacp_format_lagid(&lp->lp_actor, &lp->lp_partner,
1211	    buf, sizeof(buf))));
1212
1213	TAILQ_FOREACH(la, &lsc->lsc_aggregators, la_q) {
1214		if (lacp_aggregator_is_compatible(la, lp)) {
1215			break;
1216		}
1217	}
1218
1219	if (la == NULL) {
1220		la = lacp_aggregator_get(lsc, lp);
1221		if (la == NULL) {
1222			LACP_DPRINTF((lp, "aggregator creation failed\n"));
1223
1224			/*
1225			 * will retry on the next tick.
1226			 */
1227
1228			return;
1229		}
1230		lacp_fill_aggregator_id(la, lp);
1231		LACP_DPRINTF((lp, "aggregator created\n"));
1232	} else {
1233		LACP_DPRINTF((lp, "compatible aggregator found\n"));
1234		if (la->la_refcnt == LACP_MAX_PORTS)
1235			return;
1236		lacp_aggregator_addref(lsc, la);
1237	}
1238
1239	LACP_DPRINTF((lp, "aggregator lagid=%s\n",
1240	    lacp_format_lagid(&la->la_actor, &la->la_partner,
1241	    buf, sizeof(buf))));
1242
1243	lp->lp_aggregator = la;
1244	lp->lp_selected = LACP_SELECTED;
1245}
1246
1247/*
1248 * lacp_unselect: finish unselect/detach process.
1249 */
1250
1251static void
1252lacp_unselect(struct lacp_port *lp)
1253{
1254	struct lacp_softc *lsc = lp->lp_lsc;
1255	struct lacp_aggregator *la = lp->lp_aggregator;
1256
1257	KASSERT(!LACP_TIMER_ISARMED(lp, LACP_TIMER_WAIT_WHILE),
1258	    ("timer_wait_while still active"));
1259
1260	if (la == NULL) {
1261		return;
1262	}
1263
1264	lp->lp_aggregator = NULL;
1265	lacp_aggregator_delref(lsc, la);
1266}
1267
1268/* mux machine */
1269
1270static void
1271lacp_sm_mux(struct lacp_port *lp)
1272{
1273	enum lacp_mux_state new_state;
1274	boolean_t p_sync =
1275		    (lp->lp_partner.lip_state & LACP_STATE_SYNC) != 0;
1276	boolean_t p_collecting =
1277	    (lp->lp_partner.lip_state & LACP_STATE_COLLECTING) != 0;
1278	enum lacp_selected selected = lp->lp_selected;
1279	struct lacp_aggregator *la;
1280
1281	/* LACP_DPRINTF((lp, "%s: state %d\n", __func__, lp->lp_mux_state)); */
1282
1283re_eval:
1284	la = lp->lp_aggregator;
1285	KASSERT(lp->lp_mux_state == LACP_MUX_DETACHED || la != NULL,
1286	    ("MUX not detached"));
1287	new_state = lp->lp_mux_state;
1288	switch (lp->lp_mux_state) {
1289	case LACP_MUX_DETACHED:
1290		if (selected != LACP_UNSELECTED) {
1291			new_state = LACP_MUX_WAITING;
1292		}
1293		break;
1294	case LACP_MUX_WAITING:
1295		KASSERT(la->la_pending > 0 ||
1296		    !LACP_TIMER_ISARMED(lp, LACP_TIMER_WAIT_WHILE),
1297		    ("timer_wait_while still active"));
1298		if (selected == LACP_SELECTED && la->la_pending == 0) {
1299			new_state = LACP_MUX_ATTACHED;
1300		} else if (selected == LACP_UNSELECTED) {
1301			new_state = LACP_MUX_DETACHED;
1302		}
1303		break;
1304	case LACP_MUX_ATTACHED:
1305		if (selected == LACP_SELECTED && p_sync) {
1306			new_state = LACP_MUX_COLLECTING;
1307		} else if (selected != LACP_SELECTED) {
1308			new_state = LACP_MUX_DETACHED;
1309		}
1310		break;
1311	case LACP_MUX_COLLECTING:
1312		if (selected == LACP_SELECTED && p_sync && p_collecting) {
1313			new_state = LACP_MUX_DISTRIBUTING;
1314		} else if (selected != LACP_SELECTED || !p_sync) {
1315			new_state = LACP_MUX_ATTACHED;
1316		}
1317		break;
1318	case LACP_MUX_DISTRIBUTING:
1319		if (selected != LACP_SELECTED || !p_sync || !p_collecting) {
1320			new_state = LACP_MUX_COLLECTING;
1321		}
1322		break;
1323	default:
1324		panic("%s: unknown state", __func__);
1325	}
1326
1327	if (lp->lp_mux_state == new_state) {
1328		return;
1329	}
1330
1331	lacp_set_mux(lp, new_state);
1332	goto re_eval;
1333}
1334
1335static void
1336lacp_set_mux(struct lacp_port *lp, enum lacp_mux_state new_state)
1337{
1338	struct lacp_aggregator *la = lp->lp_aggregator;
1339
1340	if (lp->lp_mux_state == new_state) {
1341		return;
1342	}
1343
1344	switch (new_state) {
1345	case LACP_MUX_DETACHED:
1346		lp->lp_state &= ~LACP_STATE_SYNC;
1347		lacp_disable_distributing(lp);
1348		lacp_disable_collecting(lp);
1349		lacp_sm_assert_ntt(lp);
1350		/* cancel timer */
1351		if (LACP_TIMER_ISARMED(lp, LACP_TIMER_WAIT_WHILE)) {
1352			KASSERT(la->la_pending > 0,
1353			    ("timer_wait_while not active"));
1354			la->la_pending--;
1355		}
1356		LACP_TIMER_DISARM(lp, LACP_TIMER_WAIT_WHILE);
1357		lacp_unselect(lp);
1358		break;
1359	case LACP_MUX_WAITING:
1360		LACP_TIMER_ARM(lp, LACP_TIMER_WAIT_WHILE,
1361		    LACP_AGGREGATE_WAIT_TIME);
1362		la->la_pending++;
1363		break;
1364	case LACP_MUX_ATTACHED:
1365		lp->lp_state |= LACP_STATE_SYNC;
1366		lacp_disable_collecting(lp);
1367		lacp_sm_assert_ntt(lp);
1368		break;
1369	case LACP_MUX_COLLECTING:
1370		lacp_enable_collecting(lp);
1371		lacp_disable_distributing(lp);
1372		lacp_sm_assert_ntt(lp);
1373		break;
1374	case LACP_MUX_DISTRIBUTING:
1375		lacp_enable_distributing(lp);
1376		break;
1377	default:
1378		panic("%s: unknown state", __func__);
1379	}
1380
1381	LACP_DPRINTF((lp, "mux_state %d -> %d\n", lp->lp_mux_state, new_state));
1382
1383	lp->lp_mux_state = new_state;
1384}
1385
1386static void
1387lacp_sm_mux_timer(struct lacp_port *lp)
1388{
1389	struct lacp_aggregator *la = lp->lp_aggregator;
1390#if defined(LACP_DEBUG)
1391	char buf[LACP_LAGIDSTR_MAX+1];
1392#endif
1393
1394	KASSERT(la->la_pending > 0, ("no pending event"));
1395
1396	LACP_DPRINTF((lp, "%s: aggregator %s, pending %d -> %d\n", __func__,
1397	    lacp_format_lagid(&la->la_actor, &la->la_partner,
1398	    buf, sizeof(buf)),
1399	    la->la_pending, la->la_pending - 1));
1400
1401	la->la_pending--;
1402}
1403
1404/* periodic transmit machine */
1405
1406static void
1407lacp_sm_ptx_update_timeout(struct lacp_port *lp, uint8_t oldpstate)
1408{
1409	if (LACP_STATE_EQ(oldpstate, lp->lp_partner.lip_state,
1410	    LACP_STATE_TIMEOUT)) {
1411		return;
1412	}
1413
1414	LACP_DPRINTF((lp, "partner timeout changed\n"));
1415
1416	/*
1417	 * FAST_PERIODIC -> SLOW_PERIODIC
1418	 * or
1419	 * SLOW_PERIODIC (-> PERIODIC_TX) -> FAST_PERIODIC
1420	 *
1421	 * let lacp_sm_ptx_tx_schedule to update timeout.
1422	 */
1423
1424	LACP_TIMER_DISARM(lp, LACP_TIMER_PERIODIC);
1425
1426	/*
1427	 * if timeout has been shortened, assert NTT.
1428	 */
1429
1430	if ((lp->lp_partner.lip_state & LACP_STATE_TIMEOUT)) {
1431		lacp_sm_assert_ntt(lp);
1432	}
1433}
1434
1435static void
1436lacp_sm_ptx_tx_schedule(struct lacp_port *lp)
1437{
1438	int timeout;
1439
1440	if (!(lp->lp_state & LACP_STATE_ACTIVITY) &&
1441	    !(lp->lp_partner.lip_state & LACP_STATE_ACTIVITY)) {
1442
1443		/*
1444		 * NO_PERIODIC
1445		 */
1446
1447		LACP_TIMER_DISARM(lp, LACP_TIMER_PERIODIC);
1448		return;
1449	}
1450
1451	if (LACP_TIMER_ISARMED(lp, LACP_TIMER_PERIODIC)) {
1452		return;
1453	}
1454
1455	timeout = (lp->lp_partner.lip_state & LACP_STATE_TIMEOUT) ?
1456	    LACP_FAST_PERIODIC_TIME : LACP_SLOW_PERIODIC_TIME;
1457
1458	LACP_TIMER_ARM(lp, LACP_TIMER_PERIODIC, timeout);
1459}
1460
1461static void
1462lacp_sm_ptx_timer(struct lacp_port *lp)
1463{
1464	lacp_sm_assert_ntt(lp);
1465}
1466
1467static void
1468lacp_sm_rx(struct lacp_port *lp, const struct lacpdu *du)
1469{
1470	int timeout;
1471
1472	/*
1473	 * check LACP_DISABLED first
1474	 */
1475
1476	if (!(lp->lp_state & LACP_STATE_AGGREGATION)) {
1477		return;
1478	}
1479
1480	/*
1481	 * check loopback condition.
1482	 */
1483
1484	if (!lacp_compare_systemid(&du->ldu_actor.lip_systemid,
1485	    &lp->lp_actor.lip_systemid)) {
1486		return;
1487	}
1488
1489	/*
1490	 * EXPIRED, DEFAULTED, CURRENT -> CURRENT
1491	 */
1492
1493	lacp_sm_rx_update_selected(lp, du);
1494	lacp_sm_rx_update_ntt(lp, du);
1495	lacp_sm_rx_record_pdu(lp, du);
1496
1497	timeout = (lp->lp_state & LACP_STATE_TIMEOUT) ?
1498	    LACP_SHORT_TIMEOUT_TIME : LACP_LONG_TIMEOUT_TIME;
1499	LACP_TIMER_ARM(lp, LACP_TIMER_CURRENT_WHILE, timeout);
1500
1501	lp->lp_state &= ~LACP_STATE_EXPIRED;
1502
1503	/*
1504	 * kick transmit machine without waiting the next tick.
1505	 */
1506
1507	lacp_sm_tx(lp);
1508}
1509
1510static void
1511lacp_sm_rx_set_expired(struct lacp_port *lp)
1512{
1513	lp->lp_partner.lip_state &= ~LACP_STATE_SYNC;
1514	lp->lp_partner.lip_state |= LACP_STATE_TIMEOUT;
1515	LACP_TIMER_ARM(lp, LACP_TIMER_CURRENT_WHILE, LACP_SHORT_TIMEOUT_TIME);
1516	lp->lp_state |= LACP_STATE_EXPIRED;
1517}
1518
1519static void
1520lacp_sm_rx_timer(struct lacp_port *lp)
1521{
1522	if ((lp->lp_state & LACP_STATE_EXPIRED) == 0) {
1523		/* CURRENT -> EXPIRED */
1524		LACP_DPRINTF((lp, "%s: CURRENT -> EXPIRED\n", __func__));
1525		lacp_sm_rx_set_expired(lp);
1526	} else {
1527		/* EXPIRED -> DEFAULTED */
1528		LACP_DPRINTF((lp, "%s: EXPIRED -> DEFAULTED\n", __func__));
1529		lacp_sm_rx_update_default_selected(lp);
1530		lacp_sm_rx_record_default(lp);
1531		lp->lp_state &= ~LACP_STATE_EXPIRED;
1532	}
1533}
1534
1535static void
1536lacp_sm_rx_record_pdu(struct lacp_port *lp, const struct lacpdu *du)
1537{
1538	boolean_t active;
1539	uint8_t oldpstate;
1540#if defined(LACP_DEBUG)
1541	char buf[LACP_STATESTR_MAX+1];
1542#endif
1543
1544	/* LACP_DPRINTF((lp, "%s\n", __func__)); */
1545
1546	oldpstate = lp->lp_partner.lip_state;
1547
1548	active = (du->ldu_actor.lip_state & LACP_STATE_ACTIVITY)
1549	    || ((lp->lp_state & LACP_STATE_ACTIVITY) &&
1550	    (du->ldu_partner.lip_state & LACP_STATE_ACTIVITY));
1551
1552	lp->lp_partner = du->ldu_actor;
1553	if (active &&
1554	    ((LACP_STATE_EQ(lp->lp_state, du->ldu_partner.lip_state,
1555	    LACP_STATE_AGGREGATION) &&
1556	    !lacp_compare_peerinfo(&lp->lp_actor, &du->ldu_partner))
1557	    || (du->ldu_partner.lip_state & LACP_STATE_AGGREGATION) == 0)) {
1558		/* XXX nothing? */
1559	} else {
1560		lp->lp_partner.lip_state &= ~LACP_STATE_SYNC;
1561	}
1562
1563	lp->lp_state &= ~LACP_STATE_DEFAULTED;
1564
1565	if (oldpstate != lp->lp_partner.lip_state) {
1566		LACP_DPRINTF((lp, "old pstate %s\n",
1567		    lacp_format_state(oldpstate, buf, sizeof(buf))));
1568		LACP_DPRINTF((lp, "new pstate %s\n",
1569		    lacp_format_state(lp->lp_partner.lip_state, buf,
1570		    sizeof(buf))));
1571	}
1572
1573	lacp_sm_ptx_update_timeout(lp, oldpstate);
1574}
1575
1576static void
1577lacp_sm_rx_update_ntt(struct lacp_port *lp, const struct lacpdu *du)
1578{
1579	/* LACP_DPRINTF((lp, "%s\n", __func__)); */
1580
1581	if (lacp_compare_peerinfo(&lp->lp_actor, &du->ldu_partner) ||
1582	    !LACP_STATE_EQ(lp->lp_state, du->ldu_partner.lip_state,
1583	    LACP_STATE_ACTIVITY | LACP_STATE_SYNC | LACP_STATE_AGGREGATION)) {
1584		LACP_DPRINTF((lp, "%s: assert ntt\n", __func__));
1585		lacp_sm_assert_ntt(lp);
1586	}
1587}
1588
1589static void
1590lacp_sm_rx_record_default(struct lacp_port *lp)
1591{
1592	uint8_t oldpstate;
1593
1594	/* LACP_DPRINTF((lp, "%s\n", __func__)); */
1595
1596	oldpstate = lp->lp_partner.lip_state;
1597	lp->lp_partner = lacp_partner_admin;
1598	lp->lp_state |= LACP_STATE_DEFAULTED;
1599	lacp_sm_ptx_update_timeout(lp, oldpstate);
1600}
1601
1602static void
1603lacp_sm_rx_update_selected_from_peerinfo(struct lacp_port *lp,
1604    const struct lacp_peerinfo *info)
1605{
1606	/* LACP_DPRINTF((lp, "%s\n", __func__)); */
1607
1608	if (lacp_compare_peerinfo(&lp->lp_partner, info) ||
1609	    !LACP_STATE_EQ(lp->lp_partner.lip_state, info->lip_state,
1610	    LACP_STATE_AGGREGATION)) {
1611		lp->lp_selected = LACP_UNSELECTED;
1612		/* mux machine will clean up lp->lp_aggregator */
1613	}
1614}
1615
1616static void
1617lacp_sm_rx_update_selected(struct lacp_port *lp, const struct lacpdu *du)
1618{
1619	/* LACP_DPRINTF((lp, "%s\n", __func__)); */
1620
1621	lacp_sm_rx_update_selected_from_peerinfo(lp, &du->ldu_actor);
1622}
1623
1624static void
1625lacp_sm_rx_update_default_selected(struct lacp_port *lp)
1626{
1627	/* LACP_DPRINTF((lp, "%s\n", __func__)); */
1628
1629	lacp_sm_rx_update_selected_from_peerinfo(lp, &lacp_partner_admin);
1630}
1631
1632/* transmit machine */
1633
1634static void
1635lacp_sm_tx(struct lacp_port *lp)
1636{
1637	int error;
1638
1639	if (!(lp->lp_state & LACP_STATE_AGGREGATION)
1640#if 1
1641	    || (!(lp->lp_state & LACP_STATE_ACTIVITY)
1642	    && !(lp->lp_partner.lip_state & LACP_STATE_ACTIVITY))
1643#endif
1644	    ) {
1645		lp->lp_flags &= ~LACP_PORT_NTT;
1646	}
1647
1648	if (!(lp->lp_flags & LACP_PORT_NTT)) {
1649		return;
1650	}
1651
1652	/* Rate limit to 3 PDUs per LACP_FAST_PERIODIC_TIME */
1653	if (ppsratecheck(&lp->lp_last_lacpdu, &lp->lp_lacpdu_sent,
1654		    (3 / LACP_FAST_PERIODIC_TIME)) == 0) {
1655		LACP_DPRINTF((lp, "rate limited pdu\n"));
1656		return;
1657	}
1658
1659	error = lacp_xmit_lacpdu(lp);
1660
1661	if (error == 0) {
1662		lp->lp_flags &= ~LACP_PORT_NTT;
1663	} else {
1664		LACP_DPRINTF((lp, "lacpdu transmit failure, error %d\n",
1665		    error));
1666	}
1667}
1668
1669static void
1670lacp_sm_assert_ntt(struct lacp_port *lp)
1671{
1672
1673	lp->lp_flags |= LACP_PORT_NTT;
1674}
1675
1676static void
1677lacp_run_timers(struct lacp_port *lp)
1678{
1679	int i;
1680
1681	for (i = 0; i < LACP_NTIMER; i++) {
1682		KASSERT(lp->lp_timer[i] >= 0,
1683		    ("invalid timer value %d", lp->lp_timer[i]));
1684		if (lp->lp_timer[i] == 0) {
1685			continue;
1686		} else if (--lp->lp_timer[i] <= 0) {
1687			if (lacp_timer_funcs[i]) {
1688				(*lacp_timer_funcs[i])(lp);
1689			}
1690		}
1691	}
1692}
1693
1694int
1695lacp_marker_input(struct lacp_port *lp, struct mbuf *m)
1696{
1697	struct lacp_softc *lsc = lp->lp_lsc;
1698	struct lagg_port *lgp = lp->lp_lagg;
1699	struct lacp_port *lp2;
1700	struct markerdu *mdu;
1701	int error = 0;
1702	int pending = 0;
1703
1704	if (m->m_pkthdr.len != sizeof(*mdu)) {
1705		goto bad;
1706	}
1707
1708	if ((m->m_flags & M_MCAST) == 0) {
1709		goto bad;
1710	}
1711
1712	if (m->m_len < sizeof(*mdu)) {
1713		m = m_pullup(m, sizeof(*mdu));
1714		if (m == NULL) {
1715			return (ENOMEM);
1716		}
1717	}
1718
1719	mdu = mtod(m, struct markerdu *);
1720
1721	if (memcmp(&mdu->mdu_eh.ether_dhost,
1722	    &ethermulticastaddr_slowprotocols, ETHER_ADDR_LEN)) {
1723		goto bad;
1724	}
1725
1726	if (mdu->mdu_sph.sph_version != 1) {
1727		goto bad;
1728	}
1729
1730	switch (mdu->mdu_tlv.tlv_type) {
1731	case MARKER_TYPE_INFO:
1732		if (tlv_check(mdu, sizeof(*mdu), &mdu->mdu_tlv,
1733		    marker_info_tlv_template, TRUE)) {
1734			goto bad;
1735		}
1736		mdu->mdu_tlv.tlv_type = MARKER_TYPE_RESPONSE;
1737		memcpy(&mdu->mdu_eh.ether_dhost,
1738		    &ethermulticastaddr_slowprotocols, ETHER_ADDR_LEN);
1739		memcpy(&mdu->mdu_eh.ether_shost,
1740		    lgp->lp_lladdr, ETHER_ADDR_LEN);
1741		error = lagg_enqueue(lp->lp_ifp, m);
1742		break;
1743
1744	case MARKER_TYPE_RESPONSE:
1745		if (tlv_check(mdu, sizeof(*mdu), &mdu->mdu_tlv,
1746		    marker_response_tlv_template, TRUE)) {
1747			goto bad;
1748		}
1749		LACP_DPRINTF((lp, "marker response, port=%u, sys=%6D, id=%u\n",
1750		    ntohs(mdu->mdu_info.mi_rq_port), mdu->mdu_info.mi_rq_system,
1751		    ":", ntohl(mdu->mdu_info.mi_rq_xid)));
1752
1753		/* Verify that it is the last marker we sent out */
1754		if (memcmp(&mdu->mdu_info, &lp->lp_marker,
1755		    sizeof(struct lacp_markerinfo)))
1756			goto bad;
1757
1758		LACP_LOCK(lsc);
1759		lp->lp_flags &= ~LACP_PORT_MARK;
1760
1761		if (lsc->lsc_suppress_distributing) {
1762			/* Check if any ports are waiting for a response */
1763			LIST_FOREACH(lp2, &lsc->lsc_ports, lp_next) {
1764				if (lp2->lp_flags & LACP_PORT_MARK) {
1765					pending = 1;
1766					break;
1767				}
1768			}
1769
1770			if (pending == 0) {
1771				/* All interface queues are clear */
1772				LACP_DPRINTF((NULL, "queue flush complete\n"));
1773				lsc->lsc_suppress_distributing = FALSE;
1774			}
1775		}
1776		LACP_UNLOCK(lsc);
1777		m_freem(m);
1778		break;
1779
1780	default:
1781		goto bad;
1782	}
1783
1784	return (error);
1785
1786bad:
1787	LACP_DPRINTF((lp, "bad marker frame\n"));
1788	m_freem(m);
1789	return (EINVAL);
1790}
1791
1792static int
1793tlv_check(const void *p, size_t size, const struct tlvhdr *tlv,
1794    const struct tlv_template *tmpl, boolean_t check_type)
1795{
1796	while (/* CONSTCOND */ 1) {
1797		if ((const char *)tlv - (const char *)p + sizeof(*tlv) > size) {
1798			return (EINVAL);
1799		}
1800		if ((check_type && tlv->tlv_type != tmpl->tmpl_type) ||
1801		    tlv->tlv_length != tmpl->tmpl_length) {
1802			return (EINVAL);
1803		}
1804		if (tmpl->tmpl_type == 0) {
1805			break;
1806		}
1807		tlv = (const struct tlvhdr *)
1808		    ((const char *)tlv + tlv->tlv_length);
1809		tmpl++;
1810	}
1811
1812	return (0);
1813}
1814
1815#if defined(LACP_DEBUG)
1816const char *
1817lacp_format_mac(const uint8_t *mac, char *buf, size_t buflen)
1818{
1819	snprintf(buf, buflen, "%02X-%02X-%02X-%02X-%02X-%02X",
1820	    (int)mac[0],
1821	    (int)mac[1],
1822	    (int)mac[2],
1823	    (int)mac[3],
1824	    (int)mac[4],
1825	    (int)mac[5]);
1826
1827	return (buf);
1828}
1829
1830const char *
1831lacp_format_systemid(const struct lacp_systemid *sysid,
1832    char *buf, size_t buflen)
1833{
1834	char macbuf[LACP_MACSTR_MAX+1];
1835
1836	snprintf(buf, buflen, "%04X,%s",
1837	    ntohs(sysid->lsi_prio),
1838	    lacp_format_mac(sysid->lsi_mac, macbuf, sizeof(macbuf)));
1839
1840	return (buf);
1841}
1842
1843const char *
1844lacp_format_portid(const struct lacp_portid *portid, char *buf, size_t buflen)
1845{
1846	snprintf(buf, buflen, "%04X,%04X",
1847	    ntohs(portid->lpi_prio),
1848	    ntohs(portid->lpi_portno));
1849
1850	return (buf);
1851}
1852
1853const char *
1854lacp_format_partner(const struct lacp_peerinfo *peer, char *buf, size_t buflen)
1855{
1856	char sysid[LACP_SYSTEMIDSTR_MAX+1];
1857	char portid[LACP_PORTIDSTR_MAX+1];
1858
1859	snprintf(buf, buflen, "(%s,%04X,%s)",
1860	    lacp_format_systemid(&peer->lip_systemid, sysid, sizeof(sysid)),
1861	    ntohs(peer->lip_key),
1862	    lacp_format_portid(&peer->lip_portid, portid, sizeof(portid)));
1863
1864	return (buf);
1865}
1866
1867const char *
1868lacp_format_lagid(const struct lacp_peerinfo *a,
1869    const struct lacp_peerinfo *b, char *buf, size_t buflen)
1870{
1871	char astr[LACP_PARTNERSTR_MAX+1];
1872	char bstr[LACP_PARTNERSTR_MAX+1];
1873
1874#if 0
1875	/*
1876	 * there's a convention to display small numbered peer
1877	 * in the left.
1878	 */
1879
1880	if (lacp_compare_peerinfo(a, b) > 0) {
1881		const struct lacp_peerinfo *t;
1882
1883		t = a;
1884		a = b;
1885		b = t;
1886	}
1887#endif
1888
1889	snprintf(buf, buflen, "[%s,%s]",
1890	    lacp_format_partner(a, astr, sizeof(astr)),
1891	    lacp_format_partner(b, bstr, sizeof(bstr)));
1892
1893	return (buf);
1894}
1895
1896const char *
1897lacp_format_lagid_aggregator(const struct lacp_aggregator *la,
1898    char *buf, size_t buflen)
1899{
1900	if (la == NULL) {
1901		return ("(none)");
1902	}
1903
1904	return (lacp_format_lagid(&la->la_actor, &la->la_partner, buf, buflen));
1905}
1906
1907const char *
1908lacp_format_state(uint8_t state, char *buf, size_t buflen)
1909{
1910	snprintf(buf, buflen, "%b", state, LACP_STATE_BITS);
1911	return (buf);
1912}
1913
1914static void
1915lacp_dump_lacpdu(const struct lacpdu *du)
1916{
1917	char buf[LACP_PARTNERSTR_MAX+1];
1918	char buf2[LACP_STATESTR_MAX+1];
1919
1920	printf("actor=%s\n",
1921	    lacp_format_partner(&du->ldu_actor, buf, sizeof(buf)));
1922	printf("actor.state=%s\n",
1923	    lacp_format_state(du->ldu_actor.lip_state, buf2, sizeof(buf2)));
1924	printf("partner=%s\n",
1925	    lacp_format_partner(&du->ldu_partner, buf, sizeof(buf)));
1926	printf("partner.state=%s\n",
1927	    lacp_format_state(du->ldu_partner.lip_state, buf2, sizeof(buf2)));
1928
1929	printf("maxdelay=%d\n", ntohs(du->ldu_collector.lci_maxdelay));
1930}
1931
1932static void
1933lacp_dprintf(const struct lacp_port *lp, const char *fmt, ...)
1934{
1935	va_list va;
1936
1937	if (lp) {
1938		printf("%s: ", lp->lp_ifp->if_xname);
1939	}
1940
1941	va_start(va, fmt);
1942	vprintf(fmt, va);
1943	va_end(va);
1944}
1945#endif
1946