Home | History | Annotate | Line # | Download | only in lagg
      1 /*	$NetBSD: if_lagg_lacp.h,v 1.5 2023/11/22 03:49:13 yamaguchi Exp $	*/
      2 
      3 /*
      4  * Copyright (c) 2021 Internet Initiative Japan Inc.
      5  * All rights reserved.
      6  *
      7  * Redistribution and use in source and binary forms, with or without
      8  * modification, are permitted provided that the following conditions
      9  * are met:
     10  * 1. Redistributions of source code must retain the above copyright
     11  *    notice, this list of conditions and the following disclaimer.
     12  * 2. Redistributions in binary form must reproduce the above copyright
     13  *    notice, this list of conditions and the following disclaimer in the
     14  *    documentation and/or other materials provided with the distribution.
     15  *
     16  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
     17  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
     18  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     19  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
     20  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     21  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     22  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
     23  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
     24  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     25  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     26  * POSSIBILITY OF SUCH DAMAGE.
     27  */
     28 
     29 #ifndef _NET_LAGG_IF_LAGG_LACP_H_
     30 #define _NET_LAGG_IF_LAGG_LACP_H_
     31 
     32 /* timeout values (in sec) */
     33 #define LACP_FAST_PERIODIC_TIME		1
     34 #define LACP_SLOW_PERIODIC_TIME		30
     35 #define LACP_SHORT_TIMEOUT_TIME		(3 * LACP_FAST_PERIODIC_TIME)
     36 #define LACP_LONG_TIMEOUT_TIME		(3 * LACP_SLOW_PERIODIC_TIME)
     37 #define LACP_CHURN_DETECTION_TIME	60
     38 #define LACP_AGGREGATE_WAIT_TIME	2
     39 #define LACP_TRANSIT_DELAY		3
     40 
     41 #define LACP_MAX_PORTS		16
     42 #define LACP_SYSTEM_PRIO	0x8000U
     43 #define LACP_PORT_PRIO		LAGG_PORT_PRIO
     44 #define LACP_SENDDU_PPS		3
     45 #define LACP_RCVDU_LIMIT	(LACP_SENDDU_PPS * LACP_MAX_PORTS)
     46 
     47 #define LACP_PARTNER_ADMIN_OPTIMISTIC	(LACP_STATE_SYNC | \
     48 					LACP_STATE_AGGREGATION | \
     49 					LACP_STATE_COLLECTING | \
     50 					LACP_STATE_DISTRIBUTING)
     51 #define LACP_PARTNER_ADMIN_STRICT	0
     52 
     53 #define TLV_TYPE_TERMINATE	0
     54 
     55 #define LACP_TYPE_TERMINATE	TLV_TYPE_TERMINATE
     56 #define LACP_TYPE_ACTORINFO	1
     57 #define LACP_TYPE_PARTNERINFO	2
     58 #define LACP_TYPE_COLLECTORINFO	3
     59 
     60 #define MARKER_TYPE_TERMINATE	TLV_TYPE_TERMINATE
     61 #define MARKER_TYPE_INFO	1
     62 #define MARKER_TYPE_RESPONSE	2
     63 
     64 struct tlvhdr {
     65 	uint8_t		 tlv_type;
     66 	uint8_t		 tlv_length;
     67 } __packed;
     68 
     69 struct tlv {
     70 	uint8_t		 tlv_t;
     71 	uint8_t		 tlv_l;
     72 	void		*tlv_v;
     73 };
     74 
     75 static inline void
     76 tlv_set(struct tlvhdr *th, uint8_t t, uint8_t l)
     77 {
     78 
     79 	th->tlv_type = t;
     80 	th->tlv_length = sizeof(*th) + l;
     81 }
     82 
     83 struct lacpdu_peerinfo {
     84 	uint16_t	 lpi_system_prio;
     85 	uint8_t		 lpi_system_mac[LACP_MAC_LEN];
     86 	uint16_t	 lpi_key;
     87 	uint16_t	 lpi_port_prio;
     88 	uint16_t	 lpi_port_no;
     89 	uint8_t		 lpi_state;
     90 	uint8_t		 lpi_resv[3];
     91 } __packed;
     92 
     93 struct lacpdu_collectorinfo {
     94 	uint16_t	 lci_maxdelay;
     95 	uint8_t		 lci_resv[12];
     96 } __packed;
     97 
     98 struct lacpdu {
     99 	struct ether_header	 ldu_eh;
    100 	struct slowprothdr	 ldu_sph;
    101 
    102 	struct tlvhdr		 ldu_tlv_actor;
    103 	struct lacpdu_peerinfo	 ldu_actor;
    104 	struct tlvhdr		 ldu_tlv_partner;
    105 	struct lacpdu_peerinfo	 ldu_partner;
    106 
    107 	struct tlvhdr		 ldu_tlv_collector;
    108 	struct lacpdu_collectorinfo
    109 				 ldu_collector;
    110 
    111 	struct tlvhdr		 ldu_tlv_term;
    112 	uint8_t			 ldu_resv[50];
    113 } __packed;
    114 
    115 struct markerdu_info {
    116 	uint16_t	 mi_rq_port;
    117 	uint8_t		 mi_rq_system[LACP_MAC_LEN];
    118 	uint32_t	 mi_rq_xid;
    119 	uint8_t		 mi_pad[2];
    120 } __packed;
    121 
    122 struct markerdu {
    123 	struct ether_header	 mdu_eh;
    124 	struct slowprothdr	 mdu_sph;
    125 
    126 	struct tlvhdr		 mdu_tlv_info;
    127 	struct markerdu_info	 mdu_info;
    128 
    129 	struct tlvhdr		 mdu_tlv_term;
    130 	uint8_t			 mdu_resv[90];
    131 } __packed;
    132 #endif
    133