LXR linux/include/uapi/linux/if

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