if_lagg.h revision 171661
1/* $OpenBSD: if_trunk.h,v 1.11 2007/01/31 06:20:19 reyk Exp $ */ 2 3/* 4 * Copyright (c) 2005, 2006 Reyk Floeter <reyk@openbsd.org> 5 * 6 * Permission to use, copy, modify, and distribute this software for any 7 * purpose with or without fee is hereby granted, provided that the above 8 * copyright notice and this permission notice appear in all copies. 9 * 10 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 11 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 12 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 13 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 14 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 15 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 16 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 17 * 18 * $FreeBSD: head/sys/net/if_lagg.h 171661 2007-07-30 20:17:22Z thompsa $ 19 */ 20 21#ifndef _NET_LAGG_H 22#define _NET_LAGG_H 23 24/* 25 * Global definitions 26 */ 27 28#define LAGG_MAX_PORTS 32 /* logically */ 29#define LAGG_MAX_NAMESIZE 32 /* name of a protocol */ 30#define LAGG_MAX_STACKING 4 /* maximum number of stacked laggs */ 31 32/* Port flags */ 33#define LAGG_PORT_SLAVE 0x00000000 /* normal enslaved port */ 34#define LAGG_PORT_MASTER 0x00000001 /* primary port */ 35#define LAGG_PORT_STACK 0x00000002 /* stacked lagg port */ 36#define LAGG_PORT_ACTIVE 0x00000004 /* port is active */ 37#define LAGG_PORT_COLLECTING 0x00000008 /* port is receiving frames */ 38#define LAGG_PORT_DISTRIBUTING 0x00000010 /* port is sending frames */ 39#define LAGG_PORT_DISABLED 0x00000020 /* port is disabled */ 40#define LAGG_PORT_BITS "\20\01MASTER\02STACK\03ACTIVE\04COLLECTING" \ 41 "\05DISTRIBUTING\06DISABLED" 42 43/* Supported lagg PROTOs */ 44#define LAGG_PROTO_NONE 0 /* no lagg protocol defined */ 45#define LAGG_PROTO_ROUNDROBIN 1 /* simple round robin */ 46#define LAGG_PROTO_FAILOVER 2 /* active failover */ 47#define LAGG_PROTO_LOADBALANCE 3 /* loadbalance */ 48#define LAGG_PROTO_LACP 4 /* 802.3ad lacp */ 49#define LAGG_PROTO_ETHERCHANNEL 5 /* Cisco FEC */ 50#define LAGG_PROTO_MAX 6 51 52struct lagg_protos { 53 const char *lpr_name; 54 int lpr_proto; 55}; 56 57#define LAGG_PROTO_DEFAULT LAGG_PROTO_FAILOVER 58#define LAGG_PROTOS { \ 59 { "failover", LAGG_PROTO_FAILOVER }, \ 60 { "fec", LAGG_PROTO_ETHERCHANNEL }, \ 61 { "lacp", LAGG_PROTO_LACP }, \ 62 { "loadbalance", LAGG_PROTO_LOADBALANCE }, \ 63 { "roundrobin", LAGG_PROTO_ROUNDROBIN }, \ 64 { "none", LAGG_PROTO_NONE }, \ 65 { "default", LAGG_PROTO_DEFAULT } \ 66} 67 68/* 69 * lagg ioctls. 70 */ 71 72/* 73 * LACP current operational parameters structure. 74 */ 75struct lacp_opreq { 76 uint16_t actor_prio; 77 uint8_t actor_mac[ETHER_ADDR_LEN]; 78 uint16_t actor_key; 79 uint16_t actor_portprio; 80 uint16_t actor_portno; 81 uint8_t actor_state; 82 uint16_t partner_prio; 83 uint8_t partner_mac[ETHER_ADDR_LEN]; 84 uint16_t partner_key; 85 uint16_t partner_portprio; 86 uint16_t partner_portno; 87 uint8_t partner_state; 88}; 89 90/* lagg port settings */ 91struct lagg_reqport { 92 char rp_ifname[IFNAMSIZ]; /* name of the lagg */ 93 char rp_portname[IFNAMSIZ]; /* name of the port */ 94 u_int32_t rp_prio; /* port priority */ 95 u_int32_t rp_flags; /* port flags */ 96 union { 97 struct lacp_opreq rpsc_lacp; 98 } rp_psc; 99#define rp_lacpreq rp_psc.rpsc_lacp 100}; 101 102#define SIOCGLAGGPORT _IOWR('i', 140, struct lagg_reqport) 103#define SIOCSLAGGPORT _IOW('i', 141, struct lagg_reqport) 104#define SIOCSLAGGDELPORT _IOW('i', 142, struct lagg_reqport) 105 106/* lagg, ports and options */ 107struct lagg_reqall { 108 char ra_ifname[IFNAMSIZ]; /* name of the lagg */ 109 u_int ra_proto; /* lagg protocol */ 110 111 size_t ra_size; /* size of buffer */ 112 struct lagg_reqport *ra_port; /* allocated buffer */ 113 int ra_ports; /* total port count */ 114 union { 115 struct lacp_opreq rpsc_lacp; 116 } ra_psc; 117#define ra_lacpreq ra_psc.rpsc_lacp 118}; 119 120#define SIOCGLAGG _IOWR('i', 143, struct lagg_reqall) 121#define SIOCSLAGG _IOW('i', 144, struct lagg_reqall) 122 123#ifdef _KERNEL 124/* 125 * Internal kernel part 126 */ 127 128#define lp_ifname lp_ifp->if_xname /* interface name */ 129#define lp_link_state lp_ifp->if_link_state /* link state */ 130 131#define LAGG_PORTACTIVE(_tp) ( \ 132 ((_tp)->lp_link_state == LINK_STATE_UP) && \ 133 ((_tp)->lp_ifp->if_flags & IFF_UP) \ 134) 135 136struct lagg_ifreq { 137 union { 138 struct ifreq ifreq; 139 struct { 140 char ifr_name[IFNAMSIZ]; 141 struct sockaddr_storage ifr_ss; 142 } ifreq_storage; 143 } ifreq; 144}; 145 146#define sc_ifflags sc_ifp->if_flags /* flags */ 147#define sc_ifname sc_ifp->if_xname /* name */ 148#define sc_capabilities sc_ifp->if_capabilities /* capabilities */ 149 150#define IFCAP_LAGG_MASK 0xffff0000 /* private capabilities */ 151#define IFCAP_LAGG_FULLDUPLEX 0x00010000 /* full duplex with >1 ports */ 152 153/* Private data used by the loadbalancing protocol */ 154struct lagg_lb { 155 u_int32_t lb_key; 156 struct lagg_port *lb_ports[LAGG_MAX_PORTS]; 157}; 158 159struct lagg_mc { 160 struct ifmultiaddr *mc_ifma; 161 SLIST_ENTRY(lagg_mc) mc_entries; 162}; 163 164/* List of interfaces to have the MAC address modified */ 165struct lagg_llq { 166 struct ifnet *llq_ifp; 167 uint8_t llq_lladdr[ETHER_ADDR_LEN]; 168 SLIST_ENTRY(lagg_llq) llq_entries; 169}; 170 171struct lagg_softc { 172 struct ifnet *sc_ifp; /* virtual interface */ 173 struct rwlock sc_mtx; 174 int sc_proto; /* lagg protocol */ 175 u_int sc_count; /* number of ports */ 176 struct lagg_port *sc_primary; /* primary port */ 177 struct ifmedia sc_media; /* media config */ 178 caddr_t sc_psc; /* protocol data */ 179 180 SLIST_HEAD(__tplhd, lagg_port) sc_ports; /* list of interfaces */ 181 SLIST_ENTRY(lagg_softc) sc_entries; 182 183 struct task sc_lladdr_task; 184 SLIST_HEAD(__llqhd, lagg_llq) sc_llq_head; /* interfaces to program 185 the lladdr on */ 186 187 /* lagg protocol callbacks */ 188 int (*sc_detach)(struct lagg_softc *); 189 int (*sc_start)(struct lagg_softc *, struct mbuf *); 190 struct mbuf *(*sc_input)(struct lagg_softc *, struct lagg_port *, 191 struct mbuf *); 192 int (*sc_port_create)(struct lagg_port *); 193 void (*sc_port_destroy)(struct lagg_port *); 194 void (*sc_linkstate)(struct lagg_port *); 195 void (*sc_init)(struct lagg_softc *); 196 void (*sc_stop)(struct lagg_softc *); 197 void (*sc_lladdr)(struct lagg_softc *); 198 void (*sc_req)(struct lagg_softc *, caddr_t); 199 void (*sc_portreq)(struct lagg_port *, caddr_t); 200}; 201 202struct lagg_port { 203 struct ifnet *lp_ifp; /* physical interface */ 204 struct lagg_softc *lp_softc; /* parent lagg */ 205 uint8_t lp_lladdr[ETHER_ADDR_LEN]; 206 207 u_char lp_iftype; /* interface type */ 208 uint32_t lp_prio; /* port priority */ 209 uint32_t lp_flags; /* port flags */ 210 int lp_ifflags; /* saved ifp flags */ 211 void *lh_cookie; /* if state hook */ 212 caddr_t lp_psc; /* protocol data */ 213 int lp_detaching; /* ifnet is detaching */ 214 215 SLIST_HEAD(__mclhd, lagg_mc) lp_mc_head; /* multicast addresses */ 216 217 /* Redirected callbacks */ 218 int (*lp_ioctl)(struct ifnet *, u_long, caddr_t); 219 int (*lp_output)(struct ifnet *, struct mbuf *, struct sockaddr *, 220 struct rtentry *); 221 222 SLIST_ENTRY(lagg_port) lp_entries; 223}; 224 225#define LAGG_LOCK_INIT(_sc) rw_init(&(_sc)->sc_mtx, "if_lagg rwlock") 226#define LAGG_LOCK_DESTROY(_sc) rw_destroy(&(_sc)->sc_mtx) 227#define LAGG_RLOCK(_sc) rw_rlock(&(_sc)->sc_mtx) 228#define LAGG_WLOCK(_sc) rw_wlock(&(_sc)->sc_mtx) 229#define LAGG_RUNLOCK(_sc) rw_runlock(&(_sc)->sc_mtx) 230#define LAGG_WUNLOCK(_sc) rw_wunlock(&(_sc)->sc_mtx) 231#define LAGG_RLOCK_ASSERT(_sc) rw_assert(&(_sc)->sc_mtx, RA_RLOCKED) 232#define LAGG_WLOCK_ASSERT(_sc) rw_assert(&(_sc)->sc_mtx, RA_WLOCKED) 233 234extern struct mbuf *(*lagg_input_p)(struct ifnet *, struct mbuf *); 235extern void (*lagg_linkstate_p)(struct ifnet *, int ); 236 237int lagg_enqueue(struct ifnet *, struct mbuf *); 238uint32_t lagg_hashmbuf(struct mbuf *, uint32_t); 239 240#endif /* _KERNEL */ 241 242#endif /* _NET_LAGG_H */ 243