include/uapi/linux/if_bridge.h

   1 /*
   2  *      Linux ethernet bridge
   3  *
   4  *      Authors:
   5  *      Lennert Buytenhek               <buytenh@gnu.org>
   6  *
   7  *      This program is free software; you can redistribute it and/or
   8  *      modify it under the terms of the GNU General Public License
   9  *      as published by the Free Software Foundation; either version
  10  *      2 of the License, or (at your option) any later version.
  11  */
  12
  13 #ifndef _UAPI_LINUX_IF_BRIDGE_H
  14 #define _UAPI_LINUX_IF_BRIDGE_H
  15
  16 #include <linux/types.h>
  17 #include <linux/if_ether.h>
  18 #include <linux/in6.h>
  19
  20 #define SYSFS_BRIDGE_ATTR       "bridge"
  21 #define SYSFS_BRIDGE_FDB        "brforward"
  22 #define SYSFS_BRIDGE_PORT_SUBDIR "brif"
  23 #define SYSFS_BRIDGE_PORT_ATTR  "brport"
  24 #define SYSFS_BRIDGE_PORT_LINK  "bridge"
  25
  26 #define BRCTL_VERSION 1
  27
  28 #define BRCTL_GET_VERSION 0
  29 #define BRCTL_GET_BRIDGES 1
  30 #define BRCTL_ADD_BRIDGE 2
  31 #define BRCTL_DEL_BRIDGE 3
  32 #define BRCTL_ADD_IF 4
  33 #define BRCTL_DEL_IF 5
  34 #define BRCTL_GET_BRIDGE_INFO 6
  35 #define BRCTL_GET_PORT_LIST 7
  36 #define BRCTL_SET_BRIDGE_FORWARD_DELAY 8
  37 #define BRCTL_SET_BRIDGE_HELLO_TIME 9
  38 #define BRCTL_SET_BRIDGE_MAX_AGE 10
  39 #define BRCTL_SET_AGEING_TIME 11
  40 #define BRCTL_SET_GC_INTERVAL 12
  41 #define BRCTL_GET_PORT_INFO 13
  42 #define BRCTL_SET_BRIDGE_STP_STATE 14
  43 #define BRCTL_SET_BRIDGE_PRIORITY 15
  44 #define BRCTL_SET_PORT_PRIORITY 16
  45 #define BRCTL_SET_PATH_COST 17
  46 #define BRCTL_GET_FDB_ENTRIES 18
  47
  48 #define BR_STATE_DISABLED 0
  49 #define BR_STATE_LISTENING 1
  50 #define BR_STATE_LEARNING 2
  51 #define BR_STATE_FORWARDING 3
  52 #define BR_STATE_BLOCKING 4
  53
  54 struct __bridge_info {
  55         __u64 designated_root;
  56         __u64 bridge_id;
  57         __u32 root_path_cost;
  58         __u32 max_age;
  59         __u32 hello_time;
  60         __u32 forward_delay;
  61         __u32 bridge_max_age;
  62         __u32 bridge_hello_time;
  63         __u32 bridge_forward_delay;
  64         __u8 topology_change;
  65         __u8 topology_change_detected;
  66         __u8 root_port;
  67         __u8 stp_enabled;
  68         __u32 ageing_time;
  69         __u32 gc_interval;
  70         __u32 hello_timer_value;
  71         __u32 tcn_timer_value;
  72         __u32 topology_change_timer_value;
  73         __u32 gc_timer_value;
  74 };
  75
  76 struct __port_info {
  77         __u64 designated_root;
  78         __u64 designated_bridge;
  79         __u16 port_id;
  80         __u16 designated_port;
  81         __u32 path_cost;
  82         __u32 designated_cost;
  83         __u8 state;
  84         __u8 top_change_ack;
  85         __u8 config_pending;
  86         __u8 unused0;
  87         __u32 message_age_timer_value;
  88         __u32 forward_delay_timer_value;
  89         __u32 hold_timer_value;
  90 };
  91
  92 struct __fdb_entry {
  93         __u8 mac_addr[ETH_ALEN];
  94         __u8 port_no;
  95         __u8 is_local;
  96         __u32 ageing_timer_value;
  97         __u8 port_hi;
  98         __u8 pad0;
  99         __u16 unused;
 100 };
 101
 102 /* Bridge Flags */
 103 #define BRIDGE_FLAGS_MASTER     1       /* Bridge command to/from master */
 104 #define BRIDGE_FLAGS_SELF       2       /* Bridge command to/from lowerdev */
 105
 106 #define BRIDGE_MODE_VEB         0       /* Default loopback mode */
 107 #define BRIDGE_MODE_VEPA        1       /* 802.1Qbg defined VEPA mode */
 108 #define BRIDGE_MODE_UNDEF       0xFFFF  /* mode undefined */
 109
 110 /* Bridge management nested attributes
 111  * [IFLA_AF_SPEC] = {
 112  *     [IFLA_BRIDGE_FLAGS]
 113  *     [IFLA_BRIDGE_MODE]
 114  *     [IFLA_BRIDGE_VLAN_INFO]
 115  * }
 116  */
 117 enum {
 118         IFLA_BRIDGE_FLAGS,
 119         IFLA_BRIDGE_MODE,
 120         IFLA_BRIDGE_VLAN_INFO,
 121         __IFLA_BRIDGE_MAX,
 122 };
 123 #define IFLA_BRIDGE_MAX (__IFLA_BRIDGE_MAX - 1)
 124
 125 #define BRIDGE_VLAN_INFO_MASTER (1<<0)  /* Operate on Bridge device as well */
 126 #define BRIDGE_VLAN_INFO_PVID   (1<<1)  /* VLAN is PVID, ingress untagged */
 127 #define BRIDGE_VLAN_INFO_UNTAGGED       (1<<2)  /* VLAN egresses untagged */
 128 #define BRIDGE_VLAN_INFO_RANGE_BEGIN    (1<<3) /* VLAN is start of vlan range */
 129 #define BRIDGE_VLAN_INFO_RANGE_END      (1<<4) /* VLAN is end of vlan range */
 130 #define BRIDGE_VLAN_INFO_BRENTRY        (1<<5) /* Global bridge VLAN entry */
 131
 132 struct bridge_vlan_info {
 133         __u16 flags;
 134         __u16 vid;
 135 };
 136
 137 struct bridge_vlan_xstats {
 138         __u64 rx_bytes;
 139         __u64 rx_packets;
 140         __u64 tx_bytes;
 141         __u64 tx_packets;
 142         __u16 vid;
 143         __u16 flags;
 144         __u32 pad2;
 145 };
 146
 147 /* Bridge multicast database attributes
 148  * [MDBA_MDB] = {
 149  *     [MDBA_MDB_ENTRY] = {
 150  *         [MDBA_MDB_ENTRY_INFO] {
 151  *              struct br_mdb_entry
 152  *              [MDBA_MDB_EATTR attributes]
 153  *         }
 154  *     }
 155  * }
 156  * [MDBA_ROUTER] = {
 157  *    [MDBA_ROUTER_PORT] = {
 158  *        u32 ifindex
 159  *        [MDBA_ROUTER_PATTR attributes]
 160  *    }
 161  * }
 162  */
 163 enum {
 164         MDBA_UNSPEC,
 165         MDBA_MDB,
 166         MDBA_ROUTER,
 167         __MDBA_MAX,
 168 };
 169 #define MDBA_MAX (__MDBA_MAX - 1)
 170
 171 enum {
 172         MDBA_MDB_UNSPEC,
 173         MDBA_MDB_ENTRY,
 174         __MDBA_MDB_MAX,
 175 };
 176 #define MDBA_MDB_MAX (__MDBA_MDB_MAX - 1)
 177
 178 enum {
 179         MDBA_MDB_ENTRY_UNSPEC,
 180         MDBA_MDB_ENTRY_INFO,
 181         __MDBA_MDB_ENTRY_MAX,
 182 };
 183 #define MDBA_MDB_ENTRY_MAX (__MDBA_MDB_ENTRY_MAX - 1)
 184
 185 /* per mdb entry additional attributes */
 186 enum {
 187         MDBA_MDB_EATTR_UNSPEC,
 188         MDBA_MDB_EATTR_TIMER,
 189         __MDBA_MDB_EATTR_MAX
 190 };
 191 #define MDBA_MDB_EATTR_MAX (__MDBA_MDB_EATTR_MAX - 1)
 192
 193 /* multicast router types */
 194 enum {
 195         MDB_RTR_TYPE_DISABLED,
 196         MDB_RTR_TYPE_TEMP_QUERY,
 197         MDB_RTR_TYPE_PERM,
 198         MDB_RTR_TYPE_TEMP
 199 };
 200
 201 enum {
 202         MDBA_ROUTER_UNSPEC,
 203         MDBA_ROUTER_PORT,
 204         __MDBA_ROUTER_MAX,
 205 };
 206 #define MDBA_ROUTER_MAX (__MDBA_ROUTER_MAX - 1)
 207
 208 /* router port attributes */
 209 enum {
 210         MDBA_ROUTER_PATTR_UNSPEC,
 211         MDBA_ROUTER_PATTR_TIMER,
 212         MDBA_ROUTER_PATTR_TYPE,
 213         __MDBA_ROUTER_PATTR_MAX
 214 };
 215 #define MDBA_ROUTER_PATTR_MAX (__MDBA_ROUTER_PATTR_MAX - 1)
 216
 217 struct br_port_msg {
 218         __u8  family;
 219         __u32 ifindex;
 220 };
 221
 222 struct br_mdb_entry {
 223         __u32 ifindex;
 224 #define MDB_TEMPORARY 0
 225 #define MDB_PERMANENT 1
 226         __u8 state;
 227 #define MDB_FLAGS_OFFLOAD       (1 << 0)
 228         __u8 flags;
 229         __u16 vid;
 230         struct {
 231                 union {
 232                         __be32  ip4;
 233                         struct in6_addr ip6;
 234                 } u;
 235                 __be16          proto;
 236         } addr;
 237 };
 238
 239 enum {
 240         MDBA_SET_ENTRY_UNSPEC,
 241         MDBA_SET_ENTRY,
 242         __MDBA_SET_ENTRY_MAX,
 243 };
 244 #define MDBA_SET_ENTRY_MAX (__MDBA_SET_ENTRY_MAX - 1)
 245
 246 /* Embedded inside LINK_XSTATS_TYPE_BRIDGE */
 247 enum {
 248         BRIDGE_XSTATS_UNSPEC,
 249         BRIDGE_XSTATS_VLAN,
 250         BRIDGE_XSTATS_MCAST,
 251         BRIDGE_XSTATS_PAD,
 252         __BRIDGE_XSTATS_MAX
 253 };
 254 #define BRIDGE_XSTATS_MAX (__BRIDGE_XSTATS_MAX - 1)
 255
 256 enum {
 257         BR_MCAST_DIR_RX,
 258         BR_MCAST_DIR_TX,
 259         BR_MCAST_DIR_SIZE
 260 };
 261
 262 /* IGMP/MLD statistics */
 263 struct br_mcast_stats {
 264         __u64 igmp_v1queries[BR_MCAST_DIR_SIZE];
 265         __u64 igmp_v2queries[BR_MCAST_DIR_SIZE];
 266         __u64 igmp_v3queries[BR_MCAST_DIR_SIZE];
 267         __u64 igmp_leaves[BR_MCAST_DIR_SIZE];
 268         __u64 igmp_v1reports[BR_MCAST_DIR_SIZE];
 269         __u64 igmp_v2reports[BR_MCAST_DIR_SIZE];
 270         __u64 igmp_v3reports[BR_MCAST_DIR_SIZE];
 271         __u64 igmp_parse_errors;
 272
 273         __u64 mld_v1queries[BR_MCAST_DIR_SIZE];
 274         __u64 mld_v2queries[BR_MCAST_DIR_SIZE];
 275         __u64 mld_leaves[BR_MCAST_DIR_SIZE];
 276         __u64 mld_v1reports[BR_MCAST_DIR_SIZE];
 277         __u64 mld_v2reports[BR_MCAST_DIR_SIZE];
 278         __u64 mld_parse_errors;
 279
 280         __u64 mcast_bytes[BR_MCAST_DIR_SIZE];
 281         __u64 mcast_packets[BR_MCAST_DIR_SIZE];
 282 };
 283 #endif /* _UAPI_LINUX_IF_BRIDGE_H */