xref: /freebsd/sys/net/ieee8023ad_lacp.c (revision 884a2a699669ec61e2366e3e358342dbc94be24a)
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$");
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 
62 const uint8_t ethermulticastaddr_slowprotocols[ETHER_ADDR_LEN] =
63     { 0x01, 0x80, 0xc2, 0x00, 0x00, 0x02 };
64 
65 static 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 
75 static 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 
81 static 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 
87 typedef void (*lacp_timer_func_t)(struct lacp_port *);
88 
89 static void	lacp_fill_actorinfo(struct lacp_port *, struct lacp_peerinfo *);
90 static void	lacp_fill_markerinfo(struct lacp_port *,
91 		    struct lacp_markerinfo *);
92 
93 static uint64_t	lacp_aggregator_bandwidth(struct lacp_aggregator *);
94 static void	lacp_suppress_distributing(struct lacp_softc *,
95 		    struct lacp_aggregator *);
96 static void	lacp_transit_expire(void *);
97 static void	lacp_update_portmap(struct lacp_softc *);
98 static void	lacp_select_active_aggregator(struct lacp_softc *);
99 static uint16_t	lacp_compose_key(struct lacp_port *);
100 static int	tlv_check(const void *, size_t, const struct tlvhdr *,
101 		    const struct tlv_template *, boolean_t);
102 static void	lacp_tick(void *);
103 
104 static void	lacp_fill_aggregator_id(struct lacp_aggregator *,
105 		    const struct lacp_port *);
106 static void	lacp_fill_aggregator_id_peer(struct lacp_peerinfo *,
107 		    const struct lacp_peerinfo *);
108 static int	lacp_aggregator_is_compatible(const struct lacp_aggregator *,
109 		    const struct lacp_port *);
110 static int	lacp_peerinfo_is_compatible(const struct lacp_peerinfo *,
111 		    const struct lacp_peerinfo *);
112 
113 static struct lacp_aggregator *lacp_aggregator_get(struct lacp_softc *,
114 		    struct lacp_port *);
115 static void	lacp_aggregator_addref(struct lacp_softc *,
116 		    struct lacp_aggregator *);
117 static void	lacp_aggregator_delref(struct lacp_softc *,
118 		    struct lacp_aggregator *);
119 
120 /* receive machine */
121 
122 static int	lacp_pdu_input(struct lacp_port *, struct mbuf *);
123 static int	lacp_marker_input(struct lacp_port *, struct mbuf *);
124 static void	lacp_sm_rx(struct lacp_port *, const struct lacpdu *);
125 static void	lacp_sm_rx_timer(struct lacp_port *);
126 static void	lacp_sm_rx_set_expired(struct lacp_port *);
127 static void	lacp_sm_rx_update_ntt(struct lacp_port *,
128 		    const struct lacpdu *);
129 static void	lacp_sm_rx_record_pdu(struct lacp_port *,
130 		    const struct lacpdu *);
131 static void	lacp_sm_rx_update_selected(struct lacp_port *,
132 		    const struct lacpdu *);
133 static void	lacp_sm_rx_record_default(struct lacp_port *);
134 static void	lacp_sm_rx_update_default_selected(struct lacp_port *);
135 static void	lacp_sm_rx_update_selected_from_peerinfo(struct lacp_port *,
136 		    const struct lacp_peerinfo *);
137 
138 /* mux machine */
139 
140 static void	lacp_sm_mux(struct lacp_port *);
141 static void	lacp_set_mux(struct lacp_port *, enum lacp_mux_state);
142 static void	lacp_sm_mux_timer(struct lacp_port *);
143 
144 /* periodic transmit machine */
145 
146 static void	lacp_sm_ptx_update_timeout(struct lacp_port *, uint8_t);
147 static void	lacp_sm_ptx_tx_schedule(struct lacp_port *);
148 static void	lacp_sm_ptx_timer(struct lacp_port *);
149 
150 /* transmit machine */
151 
152 static void	lacp_sm_tx(struct lacp_port *);
153 static void	lacp_sm_assert_ntt(struct lacp_port *);
154 
155 static void	lacp_run_timers(struct lacp_port *);
156 static int	lacp_compare_peerinfo(const struct lacp_peerinfo *,
157 		    const struct lacp_peerinfo *);
158 static int	lacp_compare_systemid(const struct lacp_systemid *,
159 		    const struct lacp_systemid *);
160 static void	lacp_port_enable(struct lacp_port *);
161 static void	lacp_port_disable(struct lacp_port *);
162 static void	lacp_select(struct lacp_port *);
163 static void	lacp_unselect(struct lacp_port *);
164 static void	lacp_disable_collecting(struct lacp_port *);
165 static void	lacp_enable_collecting(struct lacp_port *);
166 static void	lacp_disable_distributing(struct lacp_port *);
167 static void	lacp_enable_distributing(struct lacp_port *);
168 static int	lacp_xmit_lacpdu(struct lacp_port *);
169 static int	lacp_xmit_marker(struct lacp_port *);
170 
171 #if defined(LACP_DEBUG)
172 static void	lacp_dump_lacpdu(const struct lacpdu *);
173 static const char *lacp_format_partner(const struct lacp_peerinfo *, char *,
174 		    size_t);
175 static const char *lacp_format_lagid(const struct lacp_peerinfo *,
176 		    const struct lacp_peerinfo *, char *, size_t);
177 static const char *lacp_format_lagid_aggregator(const struct lacp_aggregator *,
178 		    char *, size_t);
179 static const char *lacp_format_state(uint8_t, char *, size_t);
180 static const char *lacp_format_mac(const uint8_t *, char *, size_t);
181 static const char *lacp_format_systemid(const struct lacp_systemid *, char *,
182 		    size_t);
183 static const char *lacp_format_portid(const struct lacp_portid *, char *,
184 		    size_t);
185 static 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 
197 static 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 
210 static 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 
216 struct mbuf *
217 lacp_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  */
245 static int
246 lacp_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 
305 bad:
306 	m_freem(m);
307 	return (EINVAL);
308 }
309 
310 static void
311 lacp_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 
324 static void
325 lacp_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 
335 static int
336 lacp_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 
389 static int
390 lacp_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 
430 void
431 lacp_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 
475 static void
476 lacp_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 
495 int
496 lacp_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 
551 void
552 lacp_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 
576 void
577 lacp_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 
605 void
606 lacp_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 
631 static void
632 lacp_disable_collecting(struct lacp_port *lp)
633 {
634 	LACP_DPRINTF((lp, "collecting disabled\n"));
635 	lp->lp_state &= ~LACP_STATE_COLLECTING;
636 }
637 
638 static void
639 lacp_enable_collecting(struct lacp_port *lp)
640 {
641 	LACP_DPRINTF((lp, "collecting enabled\n"));
642 	lp->lp_state |= LACP_STATE_COLLECTING;
643 }
644 
645 static void
646 lacp_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 
682 static void
683 lacp_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 
716 static void
717 lacp_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 
727 int
728 lacp_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 
756 int
757 lacp_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 
775 void
776 lacp_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 
785 void
786 lacp_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 
796 struct lagg_port *
797 lacp_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 
832 static void
833 lacp_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 
855 static int
856 lacp_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 
862 static int
863 lacp_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 */
870 static int
871 lacp_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 
878 static uint64_t
879 lacp_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 
904 static void
905 lacp_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  */
976 static void
977 lacp_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 
1005 static uint16_t
1006 lacp_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 
1040 static void
1041 lacp_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 
1058 static void
1059 lacp_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 
1089 static struct lacp_aggregator *
1090 lacp_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 
1110 static void
1111 lacp_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 
1119 static void
1120 lacp_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 
1132 static int
1133 lacp_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 
1156 static int
1157 lacp_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 
1172 static void
1173 lacp_port_enable(struct lacp_port *lp)
1174 {
1175 	lp->lp_state |= LACP_STATE_AGGREGATION;
1176 }
1177 
1178 static void
1179 lacp_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  */
1193 static void
1194 lacp_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 
1251 static void
1252 lacp_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 
1270 static void
1271 lacp_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 
1283 re_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 
1335 static void
1336 lacp_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 
1386 static void
1387 lacp_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 
1406 static void
1407 lacp_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 
1435 static void
1436 lacp_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 
1461 static void
1462 lacp_sm_ptx_timer(struct lacp_port *lp)
1463 {
1464 	lacp_sm_assert_ntt(lp);
1465 }
1466 
1467 static void
1468 lacp_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 
1510 static void
1511 lacp_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 
1519 static void
1520 lacp_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 
1535 static void
1536 lacp_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 
1576 static void
1577 lacp_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 
1589 static void
1590 lacp_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 
1602 static void
1603 lacp_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 
1616 static void
1617 lacp_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 
1624 static void
1625 lacp_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 
1634 static void
1635 lacp_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 
1669 static void
1670 lacp_sm_assert_ntt(struct lacp_port *lp)
1671 {
1672 
1673 	lp->lp_flags |= LACP_PORT_NTT;
1674 }
1675 
1676 static void
1677 lacp_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 
1694 int
1695 lacp_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 
1786 bad:
1787 	LACP_DPRINTF((lp, "bad marker frame\n"));
1788 	m_freem(m);
1789 	return (EINVAL);
1790 }
1791 
1792 static int
1793 tlv_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)
1816 const char *
1817 lacp_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 
1830 const char *
1831 lacp_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 
1843 const char *
1844 lacp_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 
1853 const char *
1854 lacp_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 
1867 const char *
1868 lacp_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 
1896 const char *
1897 lacp_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 
1907 const char *
1908 lacp_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 
1914 static void
1915 lacp_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 
1932 static void
1933 lacp_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