include/linux/if.h

   1 /*
   2  * INET         An implementation of the TCP/IP protocol suite for the LINUX
   3  *              operating system.  INET is implemented using the  BSD Socket
   4  *              interface as the means of communication with the user level.
   5  *
   6  *              Global definitions for the INET interface module.
   7  *
   8  * Version:     @(#)if.h        1.0.2   04/18/93
   9  *
  10  * Authors:     Original taken from Berkeley UNIX 4.3, (c) UCB 1982-1988
  11  *              Ross Biro
  12  *              Fred N. van Kempen, <waltje@uWalt.NL.Mugnet.ORG>
  13  *
  14  *              This program is free software; you can redistribute it and/or
  15  *              modify it under the terms of the GNU General Public License
  16  *              as published by the Free Software Foundation; either version
  17  *              2 of the License, or (at your option) any later version.
  18  */
  19 #ifndef _LINUX_IF_H
  20 #define _LINUX_IF_H
  21
  22 #include <linux/types.h>                /* for "__kernel_caddr_t" et al */
  23 #include <linux/socket.h>               /* for "struct sockaddr" et al  */
  24 #include <linux/compiler.h>             /* for "__user" et al           */
  25
  26 #define IFNAMSIZ        16
  27 #include <linux/hdlc/ioctl.h>
  28
  29 /* Standard interface flags (netdevice->flags). */
  30 #define IFF_UP          0x1             /* interface is up              */
  31 #define IFF_BROADCAST   0x2             /* broadcast address valid      */
  32 #define IFF_DEBUG       0x4             /* turn on debugging            */
  33 #define IFF_LOOPBACK    0x8             /* is a loopback net            */
  34 #define IFF_POINTOPOINT 0x10            /* interface is has p-p link    */
  35 #define IFF_NOTRAILERS  0x20            /* avoid use of trailers        */
  36 #define IFF_RUNNING     0x40            /* interface RFC2863 OPER_UP    */
  37 #define IFF_NOARP       0x80            /* no ARP protocol              */
  38 #define IFF_PROMISC     0x100           /* receive all packets          */
  39 #define IFF_ALLMULTI    0x200           /* receive all multicast packets*/
  40
  41 #define IFF_MASTER      0x400           /* master of a load balancer    */
  42 #define IFF_SLAVE       0x800           /* slave of a load balancer     */
  43
  44 #define IFF_MULTICAST   0x1000          /* Supports multicast           */
  45
  46 #define IFF_PORTSEL     0x2000          /* can set media type           */
  47 #define IFF_AUTOMEDIA   0x4000          /* auto media select active     */
  48 #define IFF_DYNAMIC     0x8000          /* dialup device with changing addresses*/
  49
  50 #define IFF_LOWER_UP    0x10000         /* driver signals L1 up         */
  51 #define IFF_DORMANT     0x20000         /* driver signals dormant       */
  52
  53 #define IFF_VOLATILE    (IFF_LOOPBACK|IFF_POINTOPOINT|IFF_BROADCAST|\
  54                 IFF_MASTER|IFF_SLAVE|IFF_RUNNING|IFF_LOWER_UP|IFF_DORMANT)
  55
  56 /* Private (from user) interface flags (netdevice->priv_flags). */
  57 #define IFF_802_1Q_VLAN 0x1             /* 802.1Q VLAN device.          */
  58 #define IFF_EBRIDGE     0x2             /* Ethernet bridging device.    */
  59 #define IFF_SLAVE_INACTIVE      0x4     /* bonding slave not the curr. active */
  60 #define IFF_MASTER_8023AD       0x8     /* bonding master, 802.3ad.     */
  61 #define IFF_MASTER_ALB  0x10            /* bonding master, balance-alb. */
  62 #define IFF_BONDING     0x20            /* bonding master or slave      */
  63
  64 #define IF_GET_IFACE    0x0001          /* for querying only */
  65 #define IF_GET_PROTO    0x0002
  66
  67 /* For definitions see hdlc.h */
  68 #define IF_IFACE_V35    0x1000          /* V.35 serial interface        */
  69 #define IF_IFACE_V24    0x1001          /* V.24 serial interface        */
  70 #define IF_IFACE_X21    0x1002          /* X.21 serial interface        */
  71 #define IF_IFACE_T1     0x1003          /* T1 telco serial interface    */
  72 #define IF_IFACE_E1     0x1004          /* E1 telco serial interface    */
  73 #define IF_IFACE_SYNC_SERIAL 0x1005     /* can't be set by software     */
  74 #define IF_IFACE_X21D   0x1006          /* X.21 Dual Clocking (FarSite) */
  75
  76 /* For definitions see hdlc.h */
  77 #define IF_PROTO_HDLC   0x2000          /* raw HDLC protocol            */
  78 #define IF_PROTO_PPP    0x2001          /* PPP protocol                 */
  79 #define IF_PROTO_CISCO  0x2002          /* Cisco HDLC protocol          */
  80 #define IF_PROTO_FR     0x2003          /* Frame Relay protocol         */
  81 #define IF_PROTO_FR_ADD_PVC 0x2004      /*    Create FR PVC             */
  82 #define IF_PROTO_FR_DEL_PVC 0x2005      /*    Delete FR PVC             */
  83 #define IF_PROTO_X25    0x2006          /* X.25                         */
  84 #define IF_PROTO_HDLC_ETH 0x2007        /* raw HDLC, Ethernet emulation */
  85 #define IF_PROTO_FR_ADD_ETH_PVC 0x2008  /*  Create FR Ethernet-bridged PVC */
  86 #define IF_PROTO_FR_DEL_ETH_PVC 0x2009  /*  Delete FR Ethernet-bridged PVC */
  87 #define IF_PROTO_FR_PVC 0x200A          /* for reading PVC status       */
  88 #define IF_PROTO_FR_ETH_PVC 0x200B
  89 #define IF_PROTO_RAW    0x200C          /* RAW Socket                   */
  90
  91 /* RFC 2863 operational status */
  92 enum {
  93         IF_OPER_UNKNOWN,
  94         IF_OPER_NOTPRESENT,
  95         IF_OPER_DOWN,
  96         IF_OPER_LOWERLAYERDOWN,
  97         IF_OPER_TESTING,
  98         IF_OPER_DORMANT,
  99         IF_OPER_UP,
 100 };
 101
 102 /* link modes */
 103 enum {
 104         IF_LINK_MODE_DEFAULT,
 105         IF_LINK_MODE_DORMANT,   /* limit upward transition to dormant */
 106 };
 107
 108 /*
 109  *      Device mapping structure. I'd just gone off and designed a
 110  *      beautiful scheme using only loadable modules with arguments
 111  *      for driver options and along come the PCMCIA people 8)
 112  *
 113  *      Ah well. The get() side of this is good for WDSETUP, and it'll
 114  *      be handy for debugging things. The set side is fine for now and
 115  *      being very small might be worth keeping for clean configuration.
 116  */
 117
 118 struct ifmap
 119 {
 120         unsigned long mem_start;
 121         unsigned long mem_end;
 122         unsigned short base_addr;
 123         unsigned char irq;
 124         unsigned char dma;
 125         unsigned char port;
 126         /* 3 bytes spare */
 127 };
 128
 129 struct if_settings
 130 {
 131         unsigned int type;      /* Type of physical device or protocol */
 132         unsigned int size;      /* Size of the data allocated by the caller */
 133         union {
 134                 /* {atm/eth/dsl}_settings anyone ? */
 135                 raw_hdlc_proto          __user *raw_hdlc;
 136                 cisco_proto             __user *cisco;
 137                 fr_proto                __user *fr;
 138                 fr_proto_pvc            __user *fr_pvc;
 139                 fr_proto_pvc_info       __user *fr_pvc_info;
 140
 141                 /* interface settings */
 142                 sync_serial_settings    __user *sync;
 143                 te1_settings            __user *te1;
 144         } ifs_ifsu;
 145 };
 146
 147 /*
 148  * Interface request structure used for socket
 149  * ioctl's.  All interface ioctl's must have parameter
 150  * definitions which begin with ifr_name.  The
 151  * remainder may be interface specific.
 152  */
 153
 154 struct ifreq
 155 {
 156 #define IFHWADDRLEN     6
 157         union
 158         {
 159                 char    ifrn_name[IFNAMSIZ];            /* if name, e.g. "en0" */
 160         } ifr_ifrn;
 161
 162         union {
 163                 struct  sockaddr ifru_addr;
 164                 struct  sockaddr ifru_dstaddr;
 165                 struct  sockaddr ifru_broadaddr;
 166                 struct  sockaddr ifru_netmask;
 167                 struct  sockaddr ifru_hwaddr;
 168                 short   ifru_flags;
 169                 int     ifru_ivalue;
 170                 int     ifru_mtu;
 171                 struct  ifmap ifru_map;
 172                 char    ifru_slave[IFNAMSIZ];   /* Just fits the size */
 173                 char    ifru_newname[IFNAMSIZ];
 174                 void __user *   ifru_data;
 175                 struct  if_settings ifru_settings;
 176         } ifr_ifru;
 177 };
 178
 179 #define ifr_name        ifr_ifrn.ifrn_name      /* interface name       */
 180 #define ifr_hwaddr      ifr_ifru.ifru_hwaddr    /* MAC address          */
 181 #define ifr_addr        ifr_ifru.ifru_addr      /* address              */
 182 #define ifr_dstaddr     ifr_ifru.ifru_dstaddr   /* other end of p-p lnk */
 183 #define ifr_broadaddr   ifr_ifru.ifru_broadaddr /* broadcast address    */
 184 #define ifr_netmask     ifr_ifru.ifru_netmask   /* interface net mask   */
 185 #define ifr_flags       ifr_ifru.ifru_flags     /* flags                */
 186 #define ifr_metric      ifr_ifru.ifru_ivalue    /* metric               */
 187 #define ifr_mtu         ifr_ifru.ifru_mtu       /* mtu                  */
 188 #define ifr_map         ifr_ifru.ifru_map       /* device map           */
 189 #define ifr_slave       ifr_ifru.ifru_slave     /* slave device         */
 190 #define ifr_data        ifr_ifru.ifru_data      /* for use by interface */
 191 #define ifr_ifindex     ifr_ifru.ifru_ivalue    /* interface index      */
 192 #define ifr_bandwidth   ifr_ifru.ifru_ivalue    /* link bandwidth       */
 193 #define ifr_qlen        ifr_ifru.ifru_ivalue    /* Queue length         */
 194 #define ifr_newname     ifr_ifru.ifru_newname   /* New name             */
 195 #define ifr_settings    ifr_ifru.ifru_settings  /* Device/proto settings*/
 196
 197 /*
 198  * Structure used in SIOCGIFCONF request.
 199  * Used to retrieve interface configuration
 200  * for machine (useful for programs which
 201  * must know all networks accessible).
 202  */
 203
 204 struct ifconf
 205 {
 206         int     ifc_len;                        /* size of buffer       */
 207         union
 208         {
 209                 char __user *ifcu_buf;
 210                 struct ifreq __user *ifcu_req;
 211         } ifc_ifcu;
 212 };
 213 #define ifc_buf ifc_ifcu.ifcu_buf               /* buffer address       */
 214 #define ifc_req ifc_ifcu.ifcu_req               /* array of structures  */
 215
 216 /* The struct should be in sync with struct net_device_stats */
 217 struct rtnl_link_stats
 218 {
 219         __u32   rx_packets;             /* total packets received       */
 220         __u32   tx_packets;             /* total packets transmitted    */
 221         __u32   rx_bytes;               /* total bytes received         */
 222         __u32   tx_bytes;               /* total bytes transmitted      */
 223         __u32   rx_errors;              /* bad packets received         */
 224         __u32   tx_errors;              /* packet transmit problems     */
 225         __u32   rx_dropped;             /* no space in linux buffers    */
 226         __u32   tx_dropped;             /* no space available in linux  */
 227         __u32   multicast;              /* multicast packets received   */
 228         __u32   collisions;
 229
 230         /* detailed rx_errors: */
 231         __u32   rx_length_errors;
 232         __u32   rx_over_errors;         /* receiver ring buff overflow  */
 233         __u32   rx_crc_errors;          /* recved pkt with crc error    */
 234         __u32   rx_frame_errors;        /* recv'd frame alignment error */
 235         __u32   rx_fifo_errors;         /* recv'r fifo overrun          */
 236         __u32   rx_missed_errors;       /* receiver missed packet       */
 237
 238         /* detailed tx_errors */
 239         __u32   tx_aborted_errors;
 240         __u32   tx_carrier_errors;
 241         __u32   tx_fifo_errors;
 242         __u32   tx_heartbeat_errors;
 243         __u32   tx_window_errors;
 244
 245         /* for cslip etc */
 246         __u32   rx_compressed;
 247         __u32   tx_compressed;
 248 };
 249
 250 /* The struct should be in sync with struct ifmap */
 251 struct rtnl_link_ifmap
 252 {
 253         __u64   mem_start;
 254         __u64   mem_end;
 255         __u64   base_addr;
 256         __u16   irq;
 257         __u8    dma;
 258         __u8    port;
 259 };
 260
 261 enum
 262 {
 263         IFLA_UNSPEC,
 264         IFLA_ADDRESS,
 265         IFLA_BROADCAST,
 266         IFLA_IFNAME,
 267         IFLA_MTU,
 268         IFLA_LINK,
 269         IFLA_QDISC,
 270         IFLA_STATS,
 271         IFLA_COST,
 272 #define IFLA_COST IFLA_COST
 273         IFLA_PRIORITY,
 274 #define IFLA_PRIORITY IFLA_PRIORITY
 275         IFLA_MASTER,
 276 #define IFLA_MASTER IFLA_MASTER
 277         IFLA_WIRELESS,          /* Wireless Extension event - see wireless.h */
 278 #define IFLA_WIRELESS IFLA_WIRELESS
 279         IFLA_PROTINFO,          /* Protocol specific information for a link */
 280 #define IFLA_PROTINFO IFLA_PROTINFO
 281         IFLA_TXQLEN,
 282 #define IFLA_TXQLEN IFLA_TXQLEN
 283         IFLA_MAP,
 284 #define IFLA_MAP IFLA_MAP
 285         IFLA_WEIGHT,
 286 #define IFLA_WEIGHT IFLA_WEIGHT
 287         IFLA_OPERSTATE,
 288         IFLA_LINKMODE,
 289         __IFLA_MAX
 290 };
 291
 292
 293 #define IFLA_MAX (__IFLA_MAX - 1)
 294
 295 /* ifi_flags.
 296
 297    IFF_* flags.
 298
 299    The only change is:
 300    IFF_LOOPBACK, IFF_BROADCAST and IFF_POINTOPOINT are
 301    more not changeable by user. They describe link media
 302    characteristics and set by device driver.
 303
 304    Comments:
 305    - Combination IFF_BROADCAST|IFF_POINTOPOINT is invalid
 306    - If neither of these three flags are set;
 307      the interface is NBMA.
 308
 309    - IFF_MULTICAST does not mean anything special:
 310    multicasts can be used on all not-NBMA links.
 311    IFF_MULTICAST means that this media uses special encapsulation
 312    for multicast frames. Apparently, all IFF_POINTOPOINT and
 313    IFF_BROADCAST devices are able to use multicasts too.
 314  */
 315
 316 /* IFLA_LINK.
 317    For usual devices it is equal ifi_index.
 318    If it is a "virtual interface" (f.e. tunnel), ifi_link
 319    can point to real physical interface (f.e. for bandwidth calculations),
 320    or maybe 0, what means, that real media is unknown (usual
 321    for IPIP tunnels, when route to endpoint is allowed to change)
 322  */
 323
 324 /* Subtype attributes for IFLA_PROTINFO */
 325 enum
 326 {
 327         IFLA_INET6_UNSPEC,
 328         IFLA_INET6_FLAGS,       /* link flags                   */
 329         IFLA_INET6_CONF,        /* sysctl parameters            */
 330         IFLA_INET6_STATS,       /* statistics                   */
 331         IFLA_INET6_MCAST,       /* MC things. What of them?     */
 332         IFLA_INET6_CACHEINFO,   /* time values and max reasm size */
 333         __IFLA_INET6_MAX
 334 };
 335
 336 #define IFLA_INET6_MAX  (__IFLA_INET6_MAX - 1)
 337
 338 struct ifla_cacheinfo
 339 {
 340         __u32   max_reasm_len;
 341         __u32   tstamp;         /* ipv6InterfaceTable updated timestamp */
 342         __u32   reachable_time;
 343         __u32   retrans_time;
 344 };
 345
 346 #endif /* _LINUX_IF_H */