2 * IEEE 802.1D Generic Attribute Registration Protocol (GARP)
4 * Copyright (c) 2008 Patrick McHardy <kaber@trash.net>
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License
8 * version 2 as published by the Free Software Foundation.
10 #include <linux/kernel.h>
11 #include <linux/timer.h>
12 #include <linux/skbuff.h>
13 #include <linux/netdevice.h>
14 #include <linux/etherdevice.h>
15 #include <linux/rtnetlink.h>
16 #include <linux/llc.h>
17 #include <linux/slab.h>
18 #include <linux/module.h>
20 #include <net/llc_pdu.h>
22 #include <asm/unaligned.h>
24 static unsigned int garp_join_time __read_mostly = 200;
25 module_param(garp_join_time, uint, 0644);
26 MODULE_PARM_DESC(garp_join_time, "Join time in ms (default 200ms)");
27 MODULE_LICENSE("GPL");
29 static const struct garp_state_trans {
32 } garp_applicant_state_table[GARP_APPLICANT_MAX + 1][GARP_EVENT_MAX + 1] = {
33 [GARP_APPLICANT_VA] = {
34 [GARP_EVENT_TRANSMIT_PDU] = { .state = GARP_APPLICANT_AA,
35 .action = GARP_ACTION_S_JOIN_IN },
36 [GARP_EVENT_R_JOIN_IN] = { .state = GARP_APPLICANT_AA },
37 [GARP_EVENT_R_JOIN_EMPTY] = { .state = GARP_APPLICANT_VA },
38 [GARP_EVENT_R_EMPTY] = { .state = GARP_APPLICANT_VA },
39 [GARP_EVENT_R_LEAVE_IN] = { .state = GARP_APPLICANT_VA },
40 [GARP_EVENT_R_LEAVE_EMPTY] = { .state = GARP_APPLICANT_VP },
41 [GARP_EVENT_REQ_JOIN] = { .state = GARP_APPLICANT_INVALID },
42 [GARP_EVENT_REQ_LEAVE] = { .state = GARP_APPLICANT_LA },
44 [GARP_APPLICANT_AA] = {
45 [GARP_EVENT_TRANSMIT_PDU] = { .state = GARP_APPLICANT_QA,
46 .action = GARP_ACTION_S_JOIN_IN },
47 [GARP_EVENT_R_JOIN_IN] = { .state = GARP_APPLICANT_QA },
48 [GARP_EVENT_R_JOIN_EMPTY] = { .state = GARP_APPLICANT_VA },
49 [GARP_EVENT_R_EMPTY] = { .state = GARP_APPLICANT_VA },
50 [GARP_EVENT_R_LEAVE_IN] = { .state = GARP_APPLICANT_VA },
51 [GARP_EVENT_R_LEAVE_EMPTY] = { .state = GARP_APPLICANT_VP },
52 [GARP_EVENT_REQ_JOIN] = { .state = GARP_APPLICANT_INVALID },
53 [GARP_EVENT_REQ_LEAVE] = { .state = GARP_APPLICANT_LA },
55 [GARP_APPLICANT_QA] = {
56 [GARP_EVENT_TRANSMIT_PDU] = { .state = GARP_APPLICANT_INVALID },
57 [GARP_EVENT_R_JOIN_IN] = { .state = GARP_APPLICANT_QA },
58 [GARP_EVENT_R_JOIN_EMPTY] = { .state = GARP_APPLICANT_VA },
59 [GARP_EVENT_R_EMPTY] = { .state = GARP_APPLICANT_VA },
60 [GARP_EVENT_R_LEAVE_IN] = { .state = GARP_APPLICANT_VP },
61 [GARP_EVENT_R_LEAVE_EMPTY] = { .state = GARP_APPLICANT_VP },
62 [GARP_EVENT_REQ_JOIN] = { .state = GARP_APPLICANT_INVALID },
63 [GARP_EVENT_REQ_LEAVE] = { .state = GARP_APPLICANT_LA },
65 [GARP_APPLICANT_LA] = {
66 [GARP_EVENT_TRANSMIT_PDU] = { .state = GARP_APPLICANT_VO,
67 .action = GARP_ACTION_S_LEAVE_EMPTY },
68 [GARP_EVENT_R_JOIN_IN] = { .state = GARP_APPLICANT_LA },
69 [GARP_EVENT_R_JOIN_EMPTY] = { .state = GARP_APPLICANT_VO },
70 [GARP_EVENT_R_EMPTY] = { .state = GARP_APPLICANT_LA },
71 [GARP_EVENT_R_LEAVE_IN] = { .state = GARP_APPLICANT_LA },
72 [GARP_EVENT_R_LEAVE_EMPTY] = { .state = GARP_APPLICANT_VO },
73 [GARP_EVENT_REQ_JOIN] = { .state = GARP_APPLICANT_VA },
74 [GARP_EVENT_REQ_LEAVE] = { .state = GARP_APPLICANT_INVALID },
76 [GARP_APPLICANT_VP] = {
77 [GARP_EVENT_TRANSMIT_PDU] = { .state = GARP_APPLICANT_AA,
78 .action = GARP_ACTION_S_JOIN_IN },
79 [GARP_EVENT_R_JOIN_IN] = { .state = GARP_APPLICANT_AP },
80 [GARP_EVENT_R_JOIN_EMPTY] = { .state = GARP_APPLICANT_VP },
81 [GARP_EVENT_R_EMPTY] = { .state = GARP_APPLICANT_VP },
82 [GARP_EVENT_R_LEAVE_IN] = { .state = GARP_APPLICANT_VP },
83 [GARP_EVENT_R_LEAVE_EMPTY] = { .state = GARP_APPLICANT_VP },
84 [GARP_EVENT_REQ_JOIN] = { .state = GARP_APPLICANT_INVALID },
85 [GARP_EVENT_REQ_LEAVE] = { .state = GARP_APPLICANT_VO },
87 [GARP_APPLICANT_AP] = {
88 [GARP_EVENT_TRANSMIT_PDU] = { .state = GARP_APPLICANT_QA,
89 .action = GARP_ACTION_S_JOIN_IN },
90 [GARP_EVENT_R_JOIN_IN] = { .state = GARP_APPLICANT_QP },
91 [GARP_EVENT_R_JOIN_EMPTY] = { .state = GARP_APPLICANT_VP },
92 [GARP_EVENT_R_EMPTY] = { .state = GARP_APPLICANT_VP },
93 [GARP_EVENT_R_LEAVE_IN] = { .state = GARP_APPLICANT_VP },
94 [GARP_EVENT_R_LEAVE_EMPTY] = { .state = GARP_APPLICANT_VP },
95 [GARP_EVENT_REQ_JOIN] = { .state = GARP_APPLICANT_INVALID },
96 [GARP_EVENT_REQ_LEAVE] = { .state = GARP_APPLICANT_AO },
98 [GARP_APPLICANT_QP] = {
99 [GARP_EVENT_TRANSMIT_PDU] = { .state = GARP_APPLICANT_INVALID },
100 [GARP_EVENT_R_JOIN_IN] = { .state = GARP_APPLICANT_QP },
101 [GARP_EVENT_R_JOIN_EMPTY] = { .state = GARP_APPLICANT_VP },
102 [GARP_EVENT_R_EMPTY] = { .state = GARP_APPLICANT_VP },
103 [GARP_EVENT_R_LEAVE_IN] = { .state = GARP_APPLICANT_VP },
104 [GARP_EVENT_R_LEAVE_EMPTY] = { .state = GARP_APPLICANT_VP },
105 [GARP_EVENT_REQ_JOIN] = { .state = GARP_APPLICANT_INVALID },
106 [GARP_EVENT_REQ_LEAVE] = { .state = GARP_APPLICANT_QO },
108 [GARP_APPLICANT_VO] = {
109 [GARP_EVENT_TRANSMIT_PDU] = { .state = GARP_APPLICANT_INVALID },
110 [GARP_EVENT_R_JOIN_IN] = { .state = GARP_APPLICANT_AO },
111 [GARP_EVENT_R_JOIN_EMPTY] = { .state = GARP_APPLICANT_VO },
112 [GARP_EVENT_R_EMPTY] = { .state = GARP_APPLICANT_VO },
113 [GARP_EVENT_R_LEAVE_IN] = { .state = GARP_APPLICANT_VO },
114 [GARP_EVENT_R_LEAVE_EMPTY] = { .state = GARP_APPLICANT_VO },
115 [GARP_EVENT_REQ_JOIN] = { .state = GARP_APPLICANT_VP },
116 [GARP_EVENT_REQ_LEAVE] = { .state = GARP_APPLICANT_INVALID },
118 [GARP_APPLICANT_AO] = {
119 [GARP_EVENT_TRANSMIT_PDU] = { .state = GARP_APPLICANT_INVALID },
120 [GARP_EVENT_R_JOIN_IN] = { .state = GARP_APPLICANT_QO },
121 [GARP_EVENT_R_JOIN_EMPTY] = { .state = GARP_APPLICANT_VO },
122 [GARP_EVENT_R_EMPTY] = { .state = GARP_APPLICANT_VO },
123 [GARP_EVENT_R_LEAVE_IN] = { .state = GARP_APPLICANT_VO },
124 [GARP_EVENT_R_LEAVE_EMPTY] = { .state = GARP_APPLICANT_VO },
125 [GARP_EVENT_REQ_JOIN] = { .state = GARP_APPLICANT_AP },
126 [GARP_EVENT_REQ_LEAVE] = { .state = GARP_APPLICANT_INVALID },
128 [GARP_APPLICANT_QO] = {
129 [GARP_EVENT_TRANSMIT_PDU] = { .state = GARP_APPLICANT_INVALID },
130 [GARP_EVENT_R_JOIN_IN] = { .state = GARP_APPLICANT_QO },
131 [GARP_EVENT_R_JOIN_EMPTY] = { .state = GARP_APPLICANT_VO },
132 [GARP_EVENT_R_EMPTY] = { .state = GARP_APPLICANT_VO },
133 [GARP_EVENT_R_LEAVE_IN] = { .state = GARP_APPLICANT_VO },
134 [GARP_EVENT_R_LEAVE_EMPTY] = { .state = GARP_APPLICANT_VO },
135 [GARP_EVENT_REQ_JOIN] = { .state = GARP_APPLICANT_QP },
136 [GARP_EVENT_REQ_LEAVE] = { .state = GARP_APPLICANT_INVALID },
140 static int garp_attr_cmp(const struct garp_attr *attr,
141 const void *data, u8 len, u8 type)
143 if (attr->type != type)
144 return attr->type - type;
145 if (attr->dlen != len)
146 return attr->dlen - len;
147 return memcmp(attr->data, data, len);
150 static struct garp_attr *garp_attr_lookup(const struct garp_applicant *app,
151 const void *data, u8 len, u8 type)
153 struct rb_node *parent = app->gid.rb_node;
154 struct garp_attr *attr;
158 attr = rb_entry(parent, struct garp_attr, node);
159 d = garp_attr_cmp(attr, data, len, type);
161 parent = parent->rb_left;
163 parent = parent->rb_right;
170 static struct garp_attr *garp_attr_create(struct garp_applicant *app,
171 const void *data, u8 len, u8 type)
173 struct rb_node *parent = NULL, **p = &app->gid.rb_node;
174 struct garp_attr *attr;
179 attr = rb_entry(parent, struct garp_attr, node);
180 d = garp_attr_cmp(attr, data, len, type);
182 p = &parent->rb_left;
184 p = &parent->rb_right;
186 /* The attribute already exists; re-use it. */
190 attr = kmalloc(sizeof(*attr) + len, GFP_ATOMIC);
193 attr->state = GARP_APPLICANT_VO;
196 memcpy(attr->data, data, len);
198 rb_link_node(&attr->node, parent, p);
199 rb_insert_color(&attr->node, &app->gid);
203 static void garp_attr_destroy(struct garp_applicant *app, struct garp_attr *attr)
205 rb_erase(&attr->node, &app->gid);
209 static void garp_attr_destroy_all(struct garp_applicant *app)
211 struct rb_node *node, *next;
212 struct garp_attr *attr;
214 for (node = rb_first(&app->gid);
215 next = node ? rb_next(node) : NULL, node != NULL;
217 attr = rb_entry(node, struct garp_attr, node);
218 garp_attr_destroy(app, attr);
222 static int garp_pdu_init(struct garp_applicant *app)
225 struct garp_pdu_hdr *gp;
227 #define LLC_RESERVE sizeof(struct llc_pdu_un)
228 skb = alloc_skb(app->dev->mtu + LL_RESERVED_SPACE(app->dev),
234 skb->protocol = htons(ETH_P_802_2);
235 skb_reserve(skb, LL_RESERVED_SPACE(app->dev) + LLC_RESERVE);
237 gp = __skb_put(skb, sizeof(*gp));
238 put_unaligned(htons(GARP_PROTOCOL_ID), &gp->protocol);
244 static int garp_pdu_append_end_mark(struct garp_applicant *app)
246 if (skb_tailroom(app->pdu) < sizeof(u8))
248 __skb_put_u8(app->pdu, GARP_END_MARK);
252 static void garp_pdu_queue(struct garp_applicant *app)
257 garp_pdu_append_end_mark(app);
258 garp_pdu_append_end_mark(app);
260 llc_pdu_header_init(app->pdu, LLC_PDU_TYPE_U, LLC_SAP_BSPAN,
261 LLC_SAP_BSPAN, LLC_PDU_CMD);
262 llc_pdu_init_as_ui_cmd(app->pdu);
263 llc_mac_hdr_init(app->pdu, app->dev->dev_addr,
264 app->app->proto.group_address);
266 skb_queue_tail(&app->queue, app->pdu);
270 static void garp_queue_xmit(struct garp_applicant *app)
274 while ((skb = skb_dequeue(&app->queue)))
278 static int garp_pdu_append_msg(struct garp_applicant *app, u8 attrtype)
280 struct garp_msg_hdr *gm;
282 if (skb_tailroom(app->pdu) < sizeof(*gm))
284 gm = __skb_put(app->pdu, sizeof(*gm));
285 gm->attrtype = attrtype;
286 garp_cb(app->pdu)->cur_type = attrtype;
290 static int garp_pdu_append_attr(struct garp_applicant *app,
291 const struct garp_attr *attr,
292 enum garp_attr_event event)
294 struct garp_attr_hdr *ga;
299 err = garp_pdu_init(app);
304 if (garp_cb(app->pdu)->cur_type != attr->type) {
305 if (garp_cb(app->pdu)->cur_type &&
306 garp_pdu_append_end_mark(app) < 0)
308 if (garp_pdu_append_msg(app, attr->type) < 0)
312 len = sizeof(*ga) + attr->dlen;
313 if (skb_tailroom(app->pdu) < len)
315 ga = __skb_put(app->pdu, len);
318 memcpy(ga->data, attr->data, attr->dlen);
326 static void garp_attr_event(struct garp_applicant *app,
327 struct garp_attr *attr, enum garp_event event)
329 enum garp_applicant_state state;
331 state = garp_applicant_state_table[attr->state][event].state;
332 if (state == GARP_APPLICANT_INVALID)
335 switch (garp_applicant_state_table[attr->state][event].action) {
336 case GARP_ACTION_NONE:
338 case GARP_ACTION_S_JOIN_IN:
339 /* When appending the attribute fails, don't update state in
340 * order to retry on next TRANSMIT_PDU event. */
341 if (garp_pdu_append_attr(app, attr, GARP_JOIN_IN) < 0)
344 case GARP_ACTION_S_LEAVE_EMPTY:
345 garp_pdu_append_attr(app, attr, GARP_LEAVE_EMPTY);
346 /* As a pure applicant, sending a leave message implies that
347 * the attribute was unregistered and can be destroyed. */
348 garp_attr_destroy(app, attr);
357 int garp_request_join(const struct net_device *dev,
358 const struct garp_application *appl,
359 const void *data, u8 len, u8 type)
361 struct garp_port *port = rtnl_dereference(dev->garp_port);
362 struct garp_applicant *app = rtnl_dereference(port->applicants[appl->type]);
363 struct garp_attr *attr;
365 spin_lock_bh(&app->lock);
366 attr = garp_attr_create(app, data, len, type);
368 spin_unlock_bh(&app->lock);
371 garp_attr_event(app, attr, GARP_EVENT_REQ_JOIN);
372 spin_unlock_bh(&app->lock);
375 EXPORT_SYMBOL_GPL(garp_request_join);
377 void garp_request_leave(const struct net_device *dev,
378 const struct garp_application *appl,
379 const void *data, u8 len, u8 type)
381 struct garp_port *port = rtnl_dereference(dev->garp_port);
382 struct garp_applicant *app = rtnl_dereference(port->applicants[appl->type]);
383 struct garp_attr *attr;
385 spin_lock_bh(&app->lock);
386 attr = garp_attr_lookup(app, data, len, type);
388 spin_unlock_bh(&app->lock);
391 garp_attr_event(app, attr, GARP_EVENT_REQ_LEAVE);
392 spin_unlock_bh(&app->lock);
394 EXPORT_SYMBOL_GPL(garp_request_leave);
396 static void garp_gid_event(struct garp_applicant *app, enum garp_event event)
398 struct rb_node *node, *next;
399 struct garp_attr *attr;
401 for (node = rb_first(&app->gid);
402 next = node ? rb_next(node) : NULL, node != NULL;
404 attr = rb_entry(node, struct garp_attr, node);
405 garp_attr_event(app, attr, event);
409 static void garp_join_timer_arm(struct garp_applicant *app)
413 delay = (u64)msecs_to_jiffies(garp_join_time) * prandom_u32() >> 32;
414 mod_timer(&app->join_timer, jiffies + delay);
417 static void garp_join_timer(unsigned long data)
419 struct garp_applicant *app = (struct garp_applicant *)data;
421 spin_lock(&app->lock);
422 garp_gid_event(app, GARP_EVENT_TRANSMIT_PDU);
424 spin_unlock(&app->lock);
426 garp_queue_xmit(app);
427 garp_join_timer_arm(app);
430 static int garp_pdu_parse_end_mark(struct sk_buff *skb)
432 if (!pskb_may_pull(skb, sizeof(u8)))
434 if (*skb->data == GARP_END_MARK) {
435 skb_pull(skb, sizeof(u8));
441 static int garp_pdu_parse_attr(struct garp_applicant *app, struct sk_buff *skb,
444 const struct garp_attr_hdr *ga;
445 struct garp_attr *attr;
446 enum garp_event event;
449 if (!pskb_may_pull(skb, sizeof(*ga)))
451 ga = (struct garp_attr_hdr *)skb->data;
452 if (ga->len < sizeof(*ga))
455 if (!pskb_may_pull(skb, ga->len))
457 skb_pull(skb, ga->len);
458 dlen = sizeof(*ga) - ga->len;
460 if (attrtype > app->app->maxattr)
467 garp_gid_event(app, GARP_EVENT_R_LEAVE_EMPTY);
469 case GARP_JOIN_EMPTY:
470 event = GARP_EVENT_R_JOIN_EMPTY;
473 event = GARP_EVENT_R_JOIN_IN;
475 case GARP_LEAVE_EMPTY:
476 event = GARP_EVENT_R_LEAVE_EMPTY;
479 event = GARP_EVENT_R_EMPTY;
487 attr = garp_attr_lookup(app, ga->data, dlen, attrtype);
490 garp_attr_event(app, attr, event);
494 static int garp_pdu_parse_msg(struct garp_applicant *app, struct sk_buff *skb)
496 const struct garp_msg_hdr *gm;
498 if (!pskb_may_pull(skb, sizeof(*gm)))
500 gm = (struct garp_msg_hdr *)skb->data;
501 if (gm->attrtype == 0)
503 skb_pull(skb, sizeof(*gm));
505 while (skb->len > 0) {
506 if (garp_pdu_parse_attr(app, skb, gm->attrtype) < 0)
508 if (garp_pdu_parse_end_mark(skb) < 0)
514 static void garp_pdu_rcv(const struct stp_proto *proto, struct sk_buff *skb,
515 struct net_device *dev)
517 struct garp_application *appl = proto->data;
518 struct garp_port *port;
519 struct garp_applicant *app;
520 const struct garp_pdu_hdr *gp;
522 port = rcu_dereference(dev->garp_port);
525 app = rcu_dereference(port->applicants[appl->type]);
529 if (!pskb_may_pull(skb, sizeof(*gp)))
531 gp = (struct garp_pdu_hdr *)skb->data;
532 if (get_unaligned(&gp->protocol) != htons(GARP_PROTOCOL_ID))
534 skb_pull(skb, sizeof(*gp));
536 spin_lock(&app->lock);
537 while (skb->len > 0) {
538 if (garp_pdu_parse_msg(app, skb) < 0)
540 if (garp_pdu_parse_end_mark(skb) < 0)
543 spin_unlock(&app->lock);
548 static int garp_init_port(struct net_device *dev)
550 struct garp_port *port;
552 port = kzalloc(sizeof(*port), GFP_KERNEL);
555 rcu_assign_pointer(dev->garp_port, port);
559 static void garp_release_port(struct net_device *dev)
561 struct garp_port *port = rtnl_dereference(dev->garp_port);
564 for (i = 0; i <= GARP_APPLICATION_MAX; i++) {
565 if (rtnl_dereference(port->applicants[i]))
568 RCU_INIT_POINTER(dev->garp_port, NULL);
569 kfree_rcu(port, rcu);
572 int garp_init_applicant(struct net_device *dev, struct garp_application *appl)
574 struct garp_applicant *app;
579 if (!rtnl_dereference(dev->garp_port)) {
580 err = garp_init_port(dev);
586 app = kzalloc(sizeof(*app), GFP_KERNEL);
590 err = dev_mc_add(dev, appl->proto.group_address);
597 spin_lock_init(&app->lock);
598 skb_queue_head_init(&app->queue);
599 rcu_assign_pointer(dev->garp_port->applicants[appl->type], app);
600 setup_timer(&app->join_timer, garp_join_timer, (unsigned long)app);
601 garp_join_timer_arm(app);
607 garp_release_port(dev);
611 EXPORT_SYMBOL_GPL(garp_init_applicant);
613 void garp_uninit_applicant(struct net_device *dev, struct garp_application *appl)
615 struct garp_port *port = rtnl_dereference(dev->garp_port);
616 struct garp_applicant *app = rtnl_dereference(port->applicants[appl->type]);
620 RCU_INIT_POINTER(port->applicants[appl->type], NULL);
622 /* Delete timer and generate a final TRANSMIT_PDU event to flush out
623 * all pending messages before the applicant is gone. */
624 del_timer_sync(&app->join_timer);
626 spin_lock_bh(&app->lock);
627 garp_gid_event(app, GARP_EVENT_TRANSMIT_PDU);
628 garp_attr_destroy_all(app);
630 spin_unlock_bh(&app->lock);
632 garp_queue_xmit(app);
634 dev_mc_del(dev, appl->proto.group_address);
636 garp_release_port(dev);
638 EXPORT_SYMBOL_GPL(garp_uninit_applicant);
640 int garp_register_application(struct garp_application *appl)
642 appl->proto.rcv = garp_pdu_rcv;
643 appl->proto.data = appl;
644 return stp_proto_register(&appl->proto);
646 EXPORT_SYMBOL_GPL(garp_register_application);
648 void garp_unregister_application(struct garp_application *appl)
650 stp_proto_unregister(&appl->proto);
652 EXPORT_SYMBOL_GPL(garp_unregister_application);