sysdeps/gnu/net/if.h

   1 /* net/if.h -- declarations for inquiring about network interfaces
   2    Copyright (C) 1997,98,99,2000,2001 Free Software Foundation, Inc.
   3    This file is part of the GNU C Library.
   4
   5    The GNU C Library is free software; you can redistribute it and/or
   6    modify it under the terms of the GNU Lesser General Public
   7    License as published by the Free Software Foundation; either
   8    version 2.1 of the License, or (at your option) any later version.
   9
  10    The GNU C Library is distributed in the hope that it will be useful,
  11    but WITHOUT ANY WARRANTY; without even the implied warranty of
  12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13    Lesser General Public License for more details.
  14
  15    You should have received a copy of the GNU Lesser General Public
  16    License along with the GNU C Library; if not, write to the Free
  17    Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
  18    02111-1307 USA.  */
  19
  20 #ifndef _NET_IF_H
  21 #define _NET_IF_H       1
  22
  23 #include <features.h>
  24
  25 #ifdef __USE_MISC
  26 # include <sys/types.h>
  27 # include <sys/socket.h>
  28 #endif
  29
  30
  31 /* Length of interface name.  */
  32 #define IF_NAMESIZE     16
  33
  34 struct if_nameindex
  35   {
  36     unsigned int if_index;      /* 1, 2, ... */
  37     char *if_name;              /* null terminated name: "eth0", ... */
  38   };
  39
  40
  41 #ifdef __USE_MISC
  42 /* Standard interface flags. */
  43 enum
  44   {
  45     IFF_UP = 0x1,               /* Interface is up.  */
  46 # define IFF_UP IFF_UP
  47     IFF_BROADCAST = 0x2,        /* Broadcast address valid.  */
  48 # define IFF_BROADCAST  IFF_BROADCAST
  49     IFF_DEBUG = 0x4,            /* Turn on debugging.  */
  50 # define IFF_DEBUG      IFF_DEBUG
  51     IFF_LOOPBACK = 0x8,         /* Is a loopback net.  */
  52 # define IFF_LOOPBACK   IFF_LOOPBACK
  53     IFF_POINTOPOINT = 0x10,     /* Interface is point-to-point link.  */
  54 # define IFF_POINTOPOINT IFF_POINTOPOINT
  55     IFF_NOTRAILERS = 0x20,      /* Avoid use of trailers.  */
  56 # define IFF_NOTRAILERS IFF_NOTRAILERS
  57     IFF_RUNNING = 0x40,         /* Resources allocated.  */
  58 # define IFF_RUNNING    IFF_RUNNING
  59     IFF_NOARP = 0x80,           /* No address resolution protocol.  */
  60 # define IFF_NOARP      IFF_NOARP
  61     IFF_PROMISC = 0x100,        /* Receive all packets.  */
  62 # define IFF_PROMISC    IFF_PROMISC
  63
  64     /* Not supported */
  65     IFF_ALLMULTI = 0x200,       /* Receive all multicast packets.  */
  66 # define IFF_ALLMULTI   IFF_ALLMULTI
  67
  68     IFF_MASTER = 0x400,         /* Master of a load balancer.  */
  69 # define IFF_MASTER     IFF_MASTER
  70     IFF_SLAVE = 0x800,          /* Slave of a load balancer.  */
  71 # define IFF_SLAVE      IFF_SLAVE
  72
  73     IFF_MULTICAST = 0x1000,     /* Supports multicast.  */
  74 # define IFF_MULTICAST  IFF_MULTICAST
  75
  76     IFF_PORTSEL = 0x2000,       /* Can set media type.  */
  77 # define IFF_PORTSEL    IFF_PORTSEL
  78     IFF_AUTOMEDIA = 0x4000,     /* Auto media select active.  */
  79 # define IFF_AUTOMEDIA  IFF_AUTOMEDIA
  80     IFF_DYNAMIC = 0x8000        /* Dialup device with changing addresses.  */
  81 # define IFF_DYNAMIC    IFF_DYNAMIC
  82   };
  83
  84 /* The ifaddr structure contains information about one address of an
  85    interface.  They are maintained by the different address families,
  86    are allocated and attached when an address is set, and are linked
  87    together so all addresses for an interface can be located.  */
  88
  89 struct ifaddr
  90   {
  91     struct sockaddr ifa_addr;   /* Address of interface.  */
  92     union
  93       {
  94         struct sockaddr ifu_broadaddr;
  95         struct sockaddr ifu_dstaddr;
  96       } ifa_ifu;
  97     struct iface *ifa_ifp;      /* Back-pointer to interface.  */
  98     struct ifaddr *ifa_next;    /* Next address for interface.  */
  99   };
 100
 101 # define ifa_broadaddr  ifa_ifu.ifu_broadaddr   /* broadcast address    */
 102 # define ifa_dstaddr    ifa_ifu.ifu_dstaddr     /* other end of link    */
 103
 104 /* Device mapping structure. I'd just gone off and designed a
 105    beautiful scheme using only loadable modules with arguments for
 106    driver options and along come the PCMCIA people 8)
 107
 108    Ah well. The get() side of this is good for WDSETUP, and it'll be
 109    handy for debugging things. The set side is fine for now and being
 110    very small might be worth keeping for clean configuration.  */
 111
 112 struct ifmap
 113   {
 114     unsigned long int mem_start;
 115     unsigned long int mem_end;
 116     unsigned short int base_addr;
 117     unsigned char irq;
 118     unsigned char dma;
 119     unsigned char port;
 120     /* 3 bytes spare */
 121   };
 122
 123 /* Interface request structure used for socket ioctl's.  All interface
 124    ioctl's must have parameter definitions which begin with ifr_name.
 125    The remainder may be interface specific.  */
 126
 127 struct ifreq
 128   {
 129 # define IFHWADDRLEN    6
 130 # define IFNAMSIZ       IF_NAMESIZE
 131     union
 132       {
 133         char ifrn_name[IFNAMSIZ];       /* Interface name, e.g. "en0".  */
 134       } ifr_ifrn;
 135
 136     union
 137       {
 138         struct sockaddr ifru_addr;
 139         struct sockaddr ifru_dstaddr;
 140         struct sockaddr ifru_broadaddr;
 141         struct sockaddr ifru_netmask;
 142         struct sockaddr ifru_hwaddr;
 143         short int ifru_flags;
 144         int ifru_ivalue;
 145         int ifru_mtu;
 146         struct ifmap ifru_map;
 147         char ifru_slave[IFNAMSIZ];      /* Just fits the size */
 148         char ifru_newname[IFNAMSIZ];
 149         __caddr_t ifru_data;
 150       } ifr_ifru;
 151   };
 152 # define ifr_name       ifr_ifrn.ifrn_name      /* interface name       */
 153 # define ifr_hwaddr     ifr_ifru.ifru_hwaddr    /* MAC address          */
 154 # define ifr_addr       ifr_ifru.ifru_addr      /* address              */
 155 # define ifr_dstaddr    ifr_ifru.ifru_dstaddr   /* other end of p-p lnk */
 156 # define ifr_broadaddr  ifr_ifru.ifru_broadaddr /* broadcast address    */
 157 # define ifr_netmask    ifr_ifru.ifru_netmask   /* interface net mask   */
 158 # define ifr_flags      ifr_ifru.ifru_flags     /* flags                */
 159 # define ifr_metric     ifr_ifru.ifru_ivalue    /* metric               */
 160 # define ifr_mtu        ifr_ifru.ifru_mtu       /* mtu                  */
 161 # define ifr_map        ifr_ifru.ifru_map       /* device map           */
 162 # define ifr_slave      ifr_ifru.ifru_slave     /* slave device         */
 163 # define ifr_data       ifr_ifru.ifru_data      /* for use by interface */
 164 # define ifr_ifindex    ifr_ifru.ifru_ivalue    /* interface index      */
 165 # define ifr_bandwidth  ifr_ifru.ifru_ivalue    /* link bandwidth       */
 166 # define ifr_qlen       ifr_ifru.ifru_ivalue    /* queue length         */
 167 # define ifr_newname    ifr_ifru.ifru_newname   /* New name             */
 168 # define _IOT_ifreq     _IOT(_IOTS(char),IFNAMSIZ,_IOTS(char),16,0,0)
 169 # define _IOT_ifreq_short _IOT(_IOTS(char),IFNAMSIZ,_IOTS(short),1,0,0)
 170 # define _IOT_ifreq_int _IOT(_IOTS(char),IFNAMSIZ,_IOTS(int),1,0,0)
 171
 172
 173 /* Structure used in SIOCGIFCONF request.  Used to retrieve interface
 174    configuration for machine (useful for programs which must know all
 175    networks accessible).  */
 176
 177 struct ifconf
 178   {
 179     int ifc_len;                        /* Size of buffer.  */
 180     union
 181       {
 182         __caddr_t ifcu_buf;
 183         struct ifreq *ifcu_req;
 184       } ifc_ifcu;
 185   };
 186 # define ifc_buf        ifc_ifcu.ifcu_buf       /* Buffer address.  */
 187 # define ifc_req        ifc_ifcu.ifcu_req       /* Array of structures.  */
 188 # define _IOT_ifconf _IOT(_IOTS(struct ifconf),1,0,0,0,0) /* not right */
 189 #endif  /* Misc.  */
 190
 191 __BEGIN_DECLS
 192
 193 /* Convert an interface name to an index, and vice versa.  */
 194 extern unsigned int if_nametoindex (__const char *__ifname) __THROW;
 195 extern char *if_indextoname (unsigned int __ifindex, char *__ifname) __THROW;
 196
 197 /* Return a list of all interfaces and their indices.  */
 198 extern struct if_nameindex *if_nameindex (void) __THROW;
 199
 200 /* Free the data returned from if_nameindex.  */
 201 extern void if_freenameindex (struct if_nameindex *__ptr) __THROW;
 202
 203 __END_DECLS
 204
 205 #endif /* net/if.h */