2 * Sysfs attributes of bridge ports
3 * Linux ethernet bridge
6 * Stephen Hemminger <shemminger@osdl.org>
8 * This program is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU General Public License
10 * as published by the Free Software Foundation; either version
11 * 2 of the License, or (at your option) any later version.
14 #include <linux/capability.h>
15 #include <linux/kernel.h>
16 #include <linux/netdevice.h>
17 #include <linux/if_bridge.h>
18 #include <linux/rtnetlink.h>
19 #include <linux/spinlock.h>
20 #include <linux/times.h>
22 #include "br_private.h"
24 #define to_dev(obj) container_of(obj, struct device, kobj)
25 #define to_bridge(cd) ((struct net_bridge *)(to_net_dev(cd)->priv))
28 * Common code for storing bridge parameters.
30 static ssize_t store_bridge_parm(struct device *d,
31 const char *buf, size_t len,
32 void (*set)(struct net_bridge *, unsigned long))
34 struct net_bridge *br = to_bridge(d);
38 if (!capable(CAP_NET_ADMIN))
41 val = simple_strtoul(buf, &endp, 0);
45 spin_lock_bh(&br->lock);
47 spin_unlock_bh(&br->lock);
52 static ssize_t show_forward_delay(struct device *d,
53 struct device_attribute *attr, char *buf)
55 struct net_bridge *br = to_bridge(d);
56 return sprintf(buf, "%lu\n", jiffies_to_clock_t(br->forward_delay));
59 static void set_forward_delay(struct net_bridge *br, unsigned long val)
61 unsigned long delay = clock_t_to_jiffies(val);
62 br->forward_delay = delay;
63 if (br_is_root_bridge(br))
64 br->bridge_forward_delay = delay;
67 static ssize_t store_forward_delay(struct device *d,
68 struct device_attribute *attr,
69 const char *buf, size_t len)
71 return store_bridge_parm(d, buf, len, set_forward_delay);
73 static DEVICE_ATTR(forward_delay, S_IRUGO | S_IWUSR,
74 show_forward_delay, store_forward_delay);
76 static ssize_t show_hello_time(struct device *d, struct device_attribute *attr,
79 return sprintf(buf, "%lu\n",
80 jiffies_to_clock_t(to_bridge(d)->hello_time));
83 static void set_hello_time(struct net_bridge *br, unsigned long val)
85 unsigned long t = clock_t_to_jiffies(val);
87 if (br_is_root_bridge(br))
88 br->bridge_hello_time = t;
91 static ssize_t store_hello_time(struct device *d,
92 struct device_attribute *attr, const char *buf,
95 return store_bridge_parm(d, buf, len, set_hello_time);
97 static DEVICE_ATTR(hello_time, S_IRUGO | S_IWUSR, show_hello_time,
100 static ssize_t show_max_age(struct device *d, struct device_attribute *attr,
103 return sprintf(buf, "%lu\n",
104 jiffies_to_clock_t(to_bridge(d)->max_age));
107 static void set_max_age(struct net_bridge *br, unsigned long val)
109 unsigned long t = clock_t_to_jiffies(val);
111 if (br_is_root_bridge(br))
112 br->bridge_max_age = t;
115 static ssize_t store_max_age(struct device *d, struct device_attribute *attr,
116 const char *buf, size_t len)
118 return store_bridge_parm(d, buf, len, set_max_age);
120 static DEVICE_ATTR(max_age, S_IRUGO | S_IWUSR, show_max_age, store_max_age);
122 static ssize_t show_ageing_time(struct device *d,
123 struct device_attribute *attr, char *buf)
125 struct net_bridge *br = to_bridge(d);
126 return sprintf(buf, "%lu\n", jiffies_to_clock_t(br->ageing_time));
129 static void set_ageing_time(struct net_bridge *br, unsigned long val)
131 br->ageing_time = clock_t_to_jiffies(val);
134 static ssize_t store_ageing_time(struct device *d,
135 struct device_attribute *attr,
136 const char *buf, size_t len)
138 return store_bridge_parm(d, buf, len, set_ageing_time);
140 static DEVICE_ATTR(ageing_time, S_IRUGO | S_IWUSR, show_ageing_time,
143 static ssize_t show_stp_state(struct device *d,
144 struct device_attribute *attr, char *buf)
146 struct net_bridge *br = to_bridge(d);
147 return sprintf(buf, "%d\n", br->stp_enabled);
151 static ssize_t store_stp_state(struct device *d,
152 struct device_attribute *attr, const char *buf,
155 struct net_bridge *br = to_bridge(d);
159 if (!capable(CAP_NET_ADMIN))
162 val = simple_strtoul(buf, &endp, 0);
167 br_stp_set_enabled(br, val);
171 static DEVICE_ATTR(stp_state, S_IRUGO | S_IWUSR, show_stp_state,
174 static ssize_t show_priority(struct device *d, struct device_attribute *attr,
177 struct net_bridge *br = to_bridge(d);
178 return sprintf(buf, "%d\n",
179 (br->bridge_id.prio[0] << 8) | br->bridge_id.prio[1]);
182 static void set_priority(struct net_bridge *br, unsigned long val)
184 br_stp_set_bridge_priority(br, (u16) val);
187 static ssize_t store_priority(struct device *d, struct device_attribute *attr,
188 const char *buf, size_t len)
190 return store_bridge_parm(d, buf, len, set_priority);
192 static DEVICE_ATTR(priority, S_IRUGO | S_IWUSR, show_priority, store_priority);
194 static ssize_t show_root_id(struct device *d, struct device_attribute *attr,
197 return br_show_bridge_id(buf, &to_bridge(d)->designated_root);
199 static DEVICE_ATTR(root_id, S_IRUGO, show_root_id, NULL);
201 static ssize_t show_bridge_id(struct device *d, struct device_attribute *attr,
204 return br_show_bridge_id(buf, &to_bridge(d)->bridge_id);
206 static DEVICE_ATTR(bridge_id, S_IRUGO, show_bridge_id, NULL);
208 static ssize_t show_root_port(struct device *d, struct device_attribute *attr,
211 return sprintf(buf, "%d\n", to_bridge(d)->root_port);
213 static DEVICE_ATTR(root_port, S_IRUGO, show_root_port, NULL);
215 static ssize_t show_root_path_cost(struct device *d,
216 struct device_attribute *attr, char *buf)
218 return sprintf(buf, "%d\n", to_bridge(d)->root_path_cost);
220 static DEVICE_ATTR(root_path_cost, S_IRUGO, show_root_path_cost, NULL);
222 static ssize_t show_topology_change(struct device *d,
223 struct device_attribute *attr, char *buf)
225 return sprintf(buf, "%d\n", to_bridge(d)->topology_change);
227 static DEVICE_ATTR(topology_change, S_IRUGO, show_topology_change, NULL);
229 static ssize_t show_topology_change_detected(struct device *d,
230 struct device_attribute *attr,
233 struct net_bridge *br = to_bridge(d);
234 return sprintf(buf, "%d\n", br->topology_change_detected);
236 static DEVICE_ATTR(topology_change_detected, S_IRUGO,
237 show_topology_change_detected, NULL);
239 static ssize_t show_hello_timer(struct device *d,
240 struct device_attribute *attr, char *buf)
242 struct net_bridge *br = to_bridge(d);
243 return sprintf(buf, "%ld\n", br_timer_value(&br->hello_timer));
245 static DEVICE_ATTR(hello_timer, S_IRUGO, show_hello_timer, NULL);
247 static ssize_t show_tcn_timer(struct device *d, struct device_attribute *attr,
250 struct net_bridge *br = to_bridge(d);
251 return sprintf(buf, "%ld\n", br_timer_value(&br->tcn_timer));
253 static DEVICE_ATTR(tcn_timer, S_IRUGO, show_tcn_timer, NULL);
255 static ssize_t show_topology_change_timer(struct device *d,
256 struct device_attribute *attr,
259 struct net_bridge *br = to_bridge(d);
260 return sprintf(buf, "%ld\n", br_timer_value(&br->topology_change_timer));
262 static DEVICE_ATTR(topology_change_timer, S_IRUGO, show_topology_change_timer,
265 static ssize_t show_gc_timer(struct device *d, struct device_attribute *attr,
268 struct net_bridge *br = to_bridge(d);
269 return sprintf(buf, "%ld\n", br_timer_value(&br->gc_timer));
271 static DEVICE_ATTR(gc_timer, S_IRUGO, show_gc_timer, NULL);
273 static ssize_t show_group_addr(struct device *d,
274 struct device_attribute *attr, char *buf)
276 struct net_bridge *br = to_bridge(d);
277 return sprintf(buf, "%x:%x:%x:%x:%x:%x\n",
278 br->group_addr[0], br->group_addr[1],
279 br->group_addr[2], br->group_addr[3],
280 br->group_addr[4], br->group_addr[5]);
283 static ssize_t store_group_addr(struct device *d,
284 struct device_attribute *attr,
285 const char *buf, size_t len)
287 struct net_bridge *br = to_bridge(d);
288 unsigned new_addr[6];
291 if (!capable(CAP_NET_ADMIN))
294 if (sscanf(buf, "%x:%x:%x:%x:%x:%x",
295 &new_addr[0], &new_addr[1], &new_addr[2],
296 &new_addr[3], &new_addr[4], &new_addr[5]) != 6)
299 /* Must be 01:80:c2:00:00:0X */
300 for (i = 0; i < 5; i++)
301 if (new_addr[i] != br_group_address[i])
304 if (new_addr[5] & ~0xf)
307 if (new_addr[5] == 1 /* 802.3x Pause address */
308 || new_addr[5] == 2 /* 802.3ad Slow protocols */
309 || new_addr[5] == 3) /* 802.1X PAE address */
312 spin_lock_bh(&br->lock);
313 for (i = 0; i < 6; i++)
314 br->group_addr[i] = new_addr[i];
315 spin_unlock_bh(&br->lock);
319 static DEVICE_ATTR(group_addr, S_IRUGO | S_IWUSR,
320 show_group_addr, store_group_addr);
322 static ssize_t store_flush(struct device *d,
323 struct device_attribute *attr,
324 const char *buf, size_t len)
326 struct net_bridge *br = to_bridge(d);
328 if (!capable(CAP_NET_ADMIN))
334 static DEVICE_ATTR(flush, S_IWUSR, NULL, store_flush);
336 static struct attribute *bridge_attrs[] = {
337 &dev_attr_forward_delay.attr,
338 &dev_attr_hello_time.attr,
339 &dev_attr_max_age.attr,
340 &dev_attr_ageing_time.attr,
341 &dev_attr_stp_state.attr,
342 &dev_attr_priority.attr,
343 &dev_attr_bridge_id.attr,
344 &dev_attr_root_id.attr,
345 &dev_attr_root_path_cost.attr,
346 &dev_attr_root_port.attr,
347 &dev_attr_topology_change.attr,
348 &dev_attr_topology_change_detected.attr,
349 &dev_attr_hello_timer.attr,
350 &dev_attr_tcn_timer.attr,
351 &dev_attr_topology_change_timer.attr,
352 &dev_attr_gc_timer.attr,
353 &dev_attr_group_addr.attr,
354 &dev_attr_flush.attr,
358 static struct attribute_group bridge_group = {
359 .name = SYSFS_BRIDGE_ATTR,
360 .attrs = bridge_attrs,
364 * Export the forwarding information table as a binary file
365 * The records are struct __fdb_entry.
367 * Returns the number of bytes read.
369 static ssize_t brforward_read(struct kobject *kobj,
370 struct bin_attribute *bin_attr,
371 char *buf, loff_t off, size_t count)
373 struct device *dev = to_dev(kobj);
374 struct net_bridge *br = to_bridge(dev);
377 /* must read whole records */
378 if (off % sizeof(struct __fdb_entry) != 0)
381 n = br_fdb_fillbuf(br, buf,
382 count / sizeof(struct __fdb_entry),
383 off / sizeof(struct __fdb_entry));
386 n *= sizeof(struct __fdb_entry);
391 static struct bin_attribute bridge_forward = {
392 .attr = { .name = SYSFS_BRIDGE_FDB,
394 .read = brforward_read,
398 * Add entries in sysfs onto the existing network class device
400 * Adds a attribute group "bridge" containing tuning parameters.
401 * Binary attribute containing the forward table
402 * Sub directory to hold links to interfaces.
404 * Note: the ifobj exists only to be a subdirectory
405 * to hold links. The ifobj exists in same data structure
406 * as it's parent the bridge so reference counting works.
408 int br_sysfs_addbr(struct net_device *dev)
410 struct kobject *brobj = &dev->dev.kobj;
411 struct net_bridge *br = netdev_priv(dev);
414 err = sysfs_create_group(brobj, &bridge_group);
416 pr_info("%s: can't create group %s/%s\n",
417 __FUNCTION__, dev->name, bridge_group.name);
421 err = sysfs_create_bin_file(brobj, &bridge_forward);
423 pr_info("%s: can't create attribute file %s/%s\n",
424 __FUNCTION__, dev->name, bridge_forward.attr.name);
429 kobject_set_name(&br->ifobj, SYSFS_BRIDGE_PORT_SUBDIR);
430 br->ifobj.ktype = NULL;
431 br->ifobj.kset = NULL;
432 br->ifobj.parent = brobj;
434 err = kobject_register(&br->ifobj);
436 pr_info("%s: can't add kobject (directory) %s/%s\n",
437 __FUNCTION__, dev->name, br->ifobj.name);
442 sysfs_remove_bin_file(&dev->dev.kobj, &bridge_forward);
444 sysfs_remove_group(&dev->dev.kobj, &bridge_group);
450 void br_sysfs_delbr(struct net_device *dev)
452 struct kobject *kobj = &dev->dev.kobj;
453 struct net_bridge *br = netdev_priv(dev);
455 kobject_unregister(&br->ifobj);
456 sysfs_remove_bin_file(kobj, &bridge_forward);
457 sysfs_remove_group(kobj, &bridge_group);