1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * Sysfs attributes of bridge ports
4 * Linux ethernet bridge
7 * Stephen Hemminger <shemminger@osdl.org>
10 #include <linux/capability.h>
11 #include <linux/kernel.h>
12 #include <linux/netdevice.h>
13 #include <linux/if_bridge.h>
14 #include <linux/rtnetlink.h>
15 #include <linux/spinlock.h>
16 #include <linux/sched/signal.h>
18 #include "br_private.h"
20 struct brport_attribute
{
21 struct attribute attr
;
22 ssize_t (*show
)(struct net_bridge_port
*, char *);
23 int (*store
)(struct net_bridge_port
*, unsigned long);
24 int (*store_raw
)(struct net_bridge_port
*, char *);
27 #define BRPORT_ATTR_RAW(_name, _mode, _show, _store) \
28 const struct brport_attribute brport_attr_##_name = { \
29 .attr = {.name = __stringify(_name), \
32 .store_raw = _store, \
35 #define BRPORT_ATTR(_name, _mode, _show, _store) \
36 const struct brport_attribute brport_attr_##_name = { \
37 .attr = {.name = __stringify(_name), \
43 #define BRPORT_ATTR_FLAG(_name, _mask) \
44 static ssize_t show_##_name(struct net_bridge_port *p, char *buf) \
46 return sprintf(buf, "%d\n", !!(p->flags & _mask)); \
48 static int store_##_name(struct net_bridge_port *p, unsigned long v) \
50 return store_flag(p, v, _mask); \
52 static BRPORT_ATTR(_name, 0644, \
53 show_##_name, store_##_name)
55 static int store_flag(struct net_bridge_port
*p
, unsigned long v
,
67 if (flags
!= p
->flags
) {
69 br_port_flags_change(p
, mask
);
74 static ssize_t
show_path_cost(struct net_bridge_port
*p
, char *buf
)
76 return sprintf(buf
, "%d\n", p
->path_cost
);
79 static BRPORT_ATTR(path_cost
, 0644,
80 show_path_cost
, br_stp_set_path_cost
);
82 static ssize_t
show_priority(struct net_bridge_port
*p
, char *buf
)
84 return sprintf(buf
, "%d\n", p
->priority
);
87 static BRPORT_ATTR(priority
, 0644,
88 show_priority
, br_stp_set_port_priority
);
90 static ssize_t
show_designated_root(struct net_bridge_port
*p
, char *buf
)
92 return br_show_bridge_id(buf
, &p
->designated_root
);
94 static BRPORT_ATTR(designated_root
, 0444, show_designated_root
, NULL
);
96 static ssize_t
show_designated_bridge(struct net_bridge_port
*p
, char *buf
)
98 return br_show_bridge_id(buf
, &p
->designated_bridge
);
100 static BRPORT_ATTR(designated_bridge
, 0444, show_designated_bridge
, NULL
);
102 static ssize_t
show_designated_port(struct net_bridge_port
*p
, char *buf
)
104 return sprintf(buf
, "%d\n", p
->designated_port
);
106 static BRPORT_ATTR(designated_port
, 0444, show_designated_port
, NULL
);
108 static ssize_t
show_designated_cost(struct net_bridge_port
*p
, char *buf
)
110 return sprintf(buf
, "%d\n", p
->designated_cost
);
112 static BRPORT_ATTR(designated_cost
, 0444, show_designated_cost
, NULL
);
114 static ssize_t
show_port_id(struct net_bridge_port
*p
, char *buf
)
116 return sprintf(buf
, "0x%x\n", p
->port_id
);
118 static BRPORT_ATTR(port_id
, 0444, show_port_id
, NULL
);
120 static ssize_t
show_port_no(struct net_bridge_port
*p
, char *buf
)
122 return sprintf(buf
, "0x%x\n", p
->port_no
);
125 static BRPORT_ATTR(port_no
, 0444, show_port_no
, NULL
);
127 static ssize_t
show_change_ack(struct net_bridge_port
*p
, char *buf
)
129 return sprintf(buf
, "%d\n", p
->topology_change_ack
);
131 static BRPORT_ATTR(change_ack
, 0444, show_change_ack
, NULL
);
133 static ssize_t
show_config_pending(struct net_bridge_port
*p
, char *buf
)
135 return sprintf(buf
, "%d\n", p
->config_pending
);
137 static BRPORT_ATTR(config_pending
, 0444, show_config_pending
, NULL
);
139 static ssize_t
show_port_state(struct net_bridge_port
*p
, char *buf
)
141 return sprintf(buf
, "%d\n", p
->state
);
143 static BRPORT_ATTR(state
, 0444, show_port_state
, NULL
);
145 static ssize_t
show_message_age_timer(struct net_bridge_port
*p
,
148 return sprintf(buf
, "%ld\n", br_timer_value(&p
->message_age_timer
));
150 static BRPORT_ATTR(message_age_timer
, 0444, show_message_age_timer
, NULL
);
152 static ssize_t
show_forward_delay_timer(struct net_bridge_port
*p
,
155 return sprintf(buf
, "%ld\n", br_timer_value(&p
->forward_delay_timer
));
157 static BRPORT_ATTR(forward_delay_timer
, 0444, show_forward_delay_timer
, NULL
);
159 static ssize_t
show_hold_timer(struct net_bridge_port
*p
,
162 return sprintf(buf
, "%ld\n", br_timer_value(&p
->hold_timer
));
164 static BRPORT_ATTR(hold_timer
, 0444, show_hold_timer
, NULL
);
166 static int store_flush(struct net_bridge_port
*p
, unsigned long v
)
168 br_fdb_delete_by_port(p
->br
, p
, 0, 0); // Don't delete local entry
171 static BRPORT_ATTR(flush
, 0200, NULL
, store_flush
);
173 static ssize_t
show_group_fwd_mask(struct net_bridge_port
*p
, char *buf
)
175 return sprintf(buf
, "%#x\n", p
->group_fwd_mask
);
178 static int store_group_fwd_mask(struct net_bridge_port
*p
,
181 if (v
& BR_GROUPFWD_MACPAUSE
)
183 p
->group_fwd_mask
= v
;
187 static BRPORT_ATTR(group_fwd_mask
, 0644, show_group_fwd_mask
,
188 store_group_fwd_mask
);
190 static ssize_t
show_backup_port(struct net_bridge_port
*p
, char *buf
)
192 struct net_bridge_port
*backup_p
;
196 backup_p
= rcu_dereference(p
->backup_port
);
198 ret
= sprintf(buf
, "%s\n", backup_p
->dev
->name
);
204 static int store_backup_port(struct net_bridge_port
*p
, char *buf
)
206 struct net_device
*backup_dev
= NULL
;
207 char *nl
= strchr(buf
, '\n');
212 if (strlen(buf
) > 0) {
213 backup_dev
= __dev_get_by_name(dev_net(p
->dev
), buf
);
218 return nbp_backup_change(p
, backup_dev
);
220 static BRPORT_ATTR_RAW(backup_port
, 0644, show_backup_port
, store_backup_port
);
222 BRPORT_ATTR_FLAG(hairpin_mode
, BR_HAIRPIN_MODE
);
223 BRPORT_ATTR_FLAG(bpdu_guard
, BR_BPDU_GUARD
);
224 BRPORT_ATTR_FLAG(root_block
, BR_ROOT_BLOCK
);
225 BRPORT_ATTR_FLAG(learning
, BR_LEARNING
);
226 BRPORT_ATTR_FLAG(unicast_flood
, BR_FLOOD
);
227 BRPORT_ATTR_FLAG(proxyarp
, BR_PROXYARP
);
228 BRPORT_ATTR_FLAG(proxyarp_wifi
, BR_PROXYARP_WIFI
);
229 BRPORT_ATTR_FLAG(multicast_flood
, BR_MCAST_FLOOD
);
230 BRPORT_ATTR_FLAG(broadcast_flood
, BR_BCAST_FLOOD
);
231 BRPORT_ATTR_FLAG(neigh_suppress
, BR_NEIGH_SUPPRESS
);
232 BRPORT_ATTR_FLAG(isolated
, BR_ISOLATED
);
234 #ifdef CONFIG_BRIDGE_IGMP_SNOOPING
235 static ssize_t
show_multicast_router(struct net_bridge_port
*p
, char *buf
)
237 return sprintf(buf
, "%d\n", p
->multicast_router
);
240 static int store_multicast_router(struct net_bridge_port
*p
,
243 return br_multicast_set_port_router(p
, v
);
245 static BRPORT_ATTR(multicast_router
, 0644, show_multicast_router
,
246 store_multicast_router
);
248 BRPORT_ATTR_FLAG(multicast_fast_leave
, BR_MULTICAST_FAST_LEAVE
);
249 BRPORT_ATTR_FLAG(multicast_to_unicast
, BR_MULTICAST_TO_UNICAST
);
252 static const struct brport_attribute
*brport_attrs
[] = {
253 &brport_attr_path_cost
,
254 &brport_attr_priority
,
255 &brport_attr_port_id
,
256 &brport_attr_port_no
,
257 &brport_attr_designated_root
,
258 &brport_attr_designated_bridge
,
259 &brport_attr_designated_port
,
260 &brport_attr_designated_cost
,
262 &brport_attr_change_ack
,
263 &brport_attr_config_pending
,
264 &brport_attr_message_age_timer
,
265 &brport_attr_forward_delay_timer
,
266 &brport_attr_hold_timer
,
268 &brport_attr_hairpin_mode
,
269 &brport_attr_bpdu_guard
,
270 &brport_attr_root_block
,
271 &brport_attr_learning
,
272 &brport_attr_unicast_flood
,
273 #ifdef CONFIG_BRIDGE_IGMP_SNOOPING
274 &brport_attr_multicast_router
,
275 &brport_attr_multicast_fast_leave
,
276 &brport_attr_multicast_to_unicast
,
278 &brport_attr_proxyarp
,
279 &brport_attr_proxyarp_wifi
,
280 &brport_attr_multicast_flood
,
281 &brport_attr_broadcast_flood
,
282 &brport_attr_group_fwd_mask
,
283 &brport_attr_neigh_suppress
,
284 &brport_attr_isolated
,
285 &brport_attr_backup_port
,
289 #define to_brport_attr(_at) container_of(_at, struct brport_attribute, attr)
291 static ssize_t
brport_show(struct kobject
*kobj
,
292 struct attribute
*attr
, char *buf
)
294 struct brport_attribute
*brport_attr
= to_brport_attr(attr
);
295 struct net_bridge_port
*p
= kobj_to_brport(kobj
);
297 if (!brport_attr
->show
)
300 return brport_attr
->show(p
, buf
);
303 static ssize_t
brport_store(struct kobject
*kobj
,
304 struct attribute
*attr
,
305 const char *buf
, size_t count
)
307 struct brport_attribute
*brport_attr
= to_brport_attr(attr
);
308 struct net_bridge_port
*p
= kobj_to_brport(kobj
);
309 ssize_t ret
= -EINVAL
;
313 if (!ns_capable(dev_net(p
->dev
)->user_ns
, CAP_NET_ADMIN
))
317 return restart_syscall();
319 if (brport_attr
->store_raw
) {
322 buf_copy
= kstrndup(buf
, count
, GFP_KERNEL
);
327 spin_lock_bh(&p
->br
->lock
);
328 ret
= brport_attr
->store_raw(p
, buf_copy
);
329 spin_unlock_bh(&p
->br
->lock
);
331 } else if (brport_attr
->store
) {
332 val
= simple_strtoul(buf
, &endp
, 0);
335 spin_lock_bh(&p
->br
->lock
);
336 ret
= brport_attr
->store(p
, val
);
337 spin_unlock_bh(&p
->br
->lock
);
341 br_ifinfo_notify(RTM_NEWLINK
, NULL
, p
);
350 const struct sysfs_ops brport_sysfs_ops
= {
352 .store
= brport_store
,
356 * Add sysfs entries to ethernet device added to a bridge.
357 * Creates a brport subdirectory with bridge attributes.
358 * Puts symlink in bridge's brif subdirectory
360 int br_sysfs_addif(struct net_bridge_port
*p
)
362 struct net_bridge
*br
= p
->br
;
363 const struct brport_attribute
**a
;
366 err
= sysfs_create_link(&p
->kobj
, &br
->dev
->dev
.kobj
,
367 SYSFS_BRIDGE_PORT_LINK
);
371 for (a
= brport_attrs
; *a
; ++a
) {
372 err
= sysfs_create_file(&p
->kobj
, &((*a
)->attr
));
377 strlcpy(p
->sysfs_name
, p
->dev
->name
, IFNAMSIZ
);
378 return sysfs_create_link(br
->ifobj
, &p
->kobj
, p
->sysfs_name
);
381 /* Rename bridge's brif symlink */
382 int br_sysfs_renameif(struct net_bridge_port
*p
)
384 struct net_bridge
*br
= p
->br
;
387 /* If a rename fails, the rollback will cause another
388 * rename call with the existing name.
390 if (!strncmp(p
->sysfs_name
, p
->dev
->name
, IFNAMSIZ
))
393 err
= sysfs_rename_link(br
->ifobj
, &p
->kobj
,
394 p
->sysfs_name
, p
->dev
->name
);
396 netdev_notice(br
->dev
, "unable to rename link %s to %s",
397 p
->sysfs_name
, p
->dev
->name
);
399 strlcpy(p
->sysfs_name
, p
->dev
->name
, IFNAMSIZ
);