bsd/net/if_var.h

   1 /*
   2  * Copyright (c) 2000-2010 Apple Inc. All rights reserved.
   3  *
   4  * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
   5  *
   6  * This file contains Original Code and/or Modifications of Original Code
   7  * as defined in and that are subject to the Apple Public Source License
   8  * Version 2.0 (the 'License'). You may not use this file except in
   9  * compliance with the License. The rights granted to you under the License
  10  * may not be used to create, or enable the creation or redistribution of,
  11  * unlawful or unlicensed copies of an Apple operating system, or to
  12  * circumvent, violate, or enable the circumvention or violation of, any
  13  * terms of an Apple operating system software license agreement.
  14  *
  15  * Please obtain a copy of the License at
  16  * http://www.opensource.apple.com/apsl/ and read it before using this file.
  17  *
  18  * The Original Code and all software distributed under the License are
  19  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
  20  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
  21  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
  22  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
  23  * Please see the License for the specific language governing rights and
  24  * limitations under the License.
  25  *
  26  * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
  27  */
  28 /*
  29  * Copyright (c) 1982, 1986, 1989, 1993
  30  *      The Regents of the University of California.  All rights reserved.
  31  *
  32  * Redistribution and use in source and binary forms, with or without
  33  * modification, are permitted provided that the following conditions
  34  * are met:
  35  * 1. Redistributions of source code must retain the above copyright
  36  *    notice, this list of conditions and the following disclaimer.
  37  * 2. Redistributions in binary form must reproduce the above copyright
  38  *    notice, this list of conditions and the following disclaimer in the
  39  *    documentation and/or other materials provided with the distribution.
  40  * 3. All advertising materials mentioning features or use of this software
  41  *    must display the following acknowledgement:
  42  *      This product includes software developed by the University of
  43  *      California, Berkeley and its contributors.
  44  * 4. Neither the name of the University nor the names of its contributors
  45  *    may be used to endorse or promote products derived from this software
  46  *    without specific prior written permission.
  47  *
  48  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  49  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  50  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  51  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  52  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  53  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  54  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  55  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  56  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  57  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  58  * SUCH DAMAGE.
  59  *
  60  *      From: @(#)if.h  8.1 (Berkeley) 6/10/93
  61  * $FreeBSD: src/sys/net/if_var.h,v 1.18.2.7 2001/07/24 19:10:18 brooks Exp $
  62  */
  63
  64 #ifndef _NET_IF_VAR_H_
  65 #define _NET_IF_VAR_H_
  66
  67 #include <sys/appleapiopts.h>
  68 #include <stdint.h>
  69 #include <sys/types.h>
  70 #include <sys/time.h>
  71 #include <sys/queue.h>          /* get TAILQ macros */
  72 #ifdef KERNEL_PRIVATE
  73 #include <kern/locks.h>
  74 #endif /* KERNEL_PRIVATE */
  75 #ifdef PRIVATE
  76 #include <net/route.h>
  77 #endif
  78
  79 #ifdef KERNEL
  80 #include <net/kpi_interface.h>
  81 #endif /* KERNEL */
  82
  83 #ifdef __APPLE__
  84 #define APPLE_IF_FAM_LOOPBACK  1
  85 #define APPLE_IF_FAM_ETHERNET  2
  86 #define APPLE_IF_FAM_SLIP      3
  87 #define APPLE_IF_FAM_TUN       4
  88 #define APPLE_IF_FAM_VLAN      5
  89 #define APPLE_IF_FAM_PPP       6
  90 #define APPLE_IF_FAM_PVC       7
  91 #define APPLE_IF_FAM_DISC      8
  92 #define APPLE_IF_FAM_MDECAP    9
  93 #define APPLE_IF_FAM_GIF       10
  94 #define APPLE_IF_FAM_FAITH     11
  95 #define APPLE_IF_FAM_STF       12
  96 #define APPLE_IF_FAM_FIREWIRE  13
  97 #define APPLE_IF_FAM_BOND      14
  98 #endif /* __APPLE__ */
  99
 100 /*
 101  * 72 was chosen below because it is the size of a TCP/IP
 102  * header (40) + the minimum mss (32).
 103  */
 104 #define IF_MINMTU       72
 105 #define IF_MAXMTU       65535
 106
 107 /*
 108  * Structures defining a network interface, providing a packet
 109  * transport mechanism (ala level 0 of the PUP protocols).
 110  *
 111  * Each interface accepts output datagrams of a specified maximum
 112  * length, and provides higher level routines with input datagrams
 113  * received from its medium.
 114  *
 115  * Output occurs when the routine if_output is called, with three parameters:
 116  *      (*ifp->if_output)(ifp, m, dst, rt)
 117  * Here m is the mbuf chain to be sent and dst is the destination address.
 118  * The output routine encapsulates the supplied datagram if necessary,
 119  * and then transmits it on its medium.
 120  *
 121  * On input, each interface unwraps the data received by it, and either
 122  * places it on the input queue of a internetwork datagram routine
 123  * and posts the associated software interrupt, or passes the datagram to a raw
 124  * packet input routine.
 125  *
 126  * Routines exist for locating interfaces by their addresses
 127  * or for locating a interface on a certain network, as well as more general
 128  * routing and gateway routines maintaining information used to locate
 129  * interfaces.  These routines live in the files if.c and route.c
 130  */
 131
 132 #define IFNAMSIZ        16
 133
 134 /* This belongs up in socket.h or socketvar.h, depending on how far the
 135  *   event bubbles up.
 136  */
 137
 138 struct net_event_data {
 139         u_int32_t       if_family;
 140         u_int32_t       if_unit;
 141         char            if_name[IFNAMSIZ];
 142 };
 143
 144 #if defined(__LP64__)
 145 #define __need_struct_timeval32
 146 #include <sys/_structs.h>
 147 #define IF_DATA_TIMEVAL timeval32
 148 #else
 149 #define IF_DATA_TIMEVAL timeval
 150 #endif
 151
 152 #pragma pack(4)
 153
 154 /*
 155  * Structure describing information about an interface
 156  * which may be of interest to management entities.
 157  */
 158 struct if_data {
 159         /* generic interface information */
 160         u_char          ifi_type;       /* ethernet, tokenring, etc */
 161         u_char          ifi_typelen;    /* Length of frame type id */
 162         u_char          ifi_physical;   /* e.g., AUI, Thinnet, 10base-T, etc */
 163         u_char          ifi_addrlen;    /* media address length */
 164         u_char          ifi_hdrlen;     /* media header length */
 165         u_char          ifi_recvquota;  /* polling quota for receive intrs */
 166         u_char          ifi_xmitquota;  /* polling quota for xmit intrs */
 167         u_char          ifi_unused1;    /* for future use */
 168         u_int32_t       ifi_mtu;        /* maximum transmission unit */
 169         u_int32_t       ifi_metric;     /* routing metric (external only) */
 170         u_int32_t       ifi_baudrate;   /* linespeed */
 171         /* volatile statistics */
 172         u_int32_t       ifi_ipackets;   /* packets received on interface */
 173         u_int32_t       ifi_ierrors;    /* input errors on interface */
 174         u_int32_t       ifi_opackets;   /* packets sent on interface */
 175         u_int32_t       ifi_oerrors;    /* output errors on interface */
 176         u_int32_t       ifi_collisions; /* collisions on csma interfaces */
 177         u_int32_t       ifi_ibytes;     /* total number of octets received */
 178         u_int32_t       ifi_obytes;     /* total number of octets sent */
 179         u_int32_t       ifi_imcasts;    /* packets received via multicast */
 180         u_int32_t       ifi_omcasts;    /* packets sent via multicast */
 181         u_int32_t       ifi_iqdrops;    /* dropped on input, this interface */
 182         u_int32_t       ifi_noproto;    /* destined for unsupported protocol */
 183         u_int32_t       ifi_recvtiming; /* usec spent receiving when timing */
 184         u_int32_t       ifi_xmittiming; /* usec spent xmitting when timing */
 185         struct IF_DATA_TIMEVAL ifi_lastchange;  /* time of last administrative change */
 186         u_int32_t       ifi_unused2;    /* used to be the default_proto */
 187         u_int32_t       ifi_hwassist;   /* HW offload capabilities */
 188         u_int32_t       ifi_reserved1;  /* for future use */
 189         u_int32_t       ifi_reserved2;  /* for future use */
 190 };
 191
 192 /*
 193  * Structure describing information about an interface
 194  * which may be of interest to management entities.
 195  */
 196 struct if_data64 {
 197         /* generic interface information */
 198         u_char          ifi_type;               /* ethernet, tokenring, etc */
 199         u_char          ifi_typelen;            /* Length of frame type id */
 200         u_char          ifi_physical;           /* e.g., AUI, Thinnet, 10base-T, etc */
 201         u_char          ifi_addrlen;            /* media address length */
 202         u_char          ifi_hdrlen;             /* media header length */
 203         u_char          ifi_recvquota;          /* polling quota for receive intrs */
 204         u_char          ifi_xmitquota;          /* polling quota for xmit intrs */
 205         u_char          ifi_unused1;            /* for future use */
 206         u_int32_t       ifi_mtu;                /* maximum transmission unit */
 207         u_int32_t       ifi_metric;             /* routing metric (external only) */
 208         u_int64_t       ifi_baudrate;           /* linespeed */
 209         /* volatile statistics */
 210         u_int64_t       ifi_ipackets;           /* packets received on interface */
 211         u_int64_t       ifi_ierrors;            /* input errors on interface */
 212         u_int64_t       ifi_opackets;           /* packets sent on interface */
 213         u_int64_t       ifi_oerrors;            /* output errors on interface */
 214         u_int64_t       ifi_collisions;         /* collisions on csma interfaces */
 215         u_int64_t       ifi_ibytes;             /* total number of octets received */
 216         u_int64_t       ifi_obytes;             /* total number of octets sent */
 217         u_int64_t       ifi_imcasts;            /* packets received via multicast */
 218         u_int64_t       ifi_omcasts;            /* packets sent via multicast */
 219         u_int64_t       ifi_iqdrops;            /* dropped on input, this interface */
 220         u_int64_t       ifi_noproto;            /* destined for unsupported protocol */
 221         u_int32_t       ifi_recvtiming;         /* usec spent receiving when timing */
 222         u_int32_t       ifi_xmittiming;         /* usec spent xmitting when timing */
 223         struct IF_DATA_TIMEVAL ifi_lastchange;  /* time of last administrative change */
 224 };
 225
 226 #pragma pack()
 227
 228 #ifdef PRIVATE
 229 /*
 230  * Internal storage of if_data. This is bound to change. Various places in the
 231  * stack will translate this data structure in to the externally visible
 232  * if_data structure above.
 233  */
 234 struct if_data_internal {
 235         /* generic interface information */
 236         u_char          ifi_type;       /* ethernet, tokenring, etc */
 237         u_char          ifi_typelen;    /* Length of frame type id */
 238         u_char          ifi_physical;   /* e.g., AUI, Thinnet, 10base-T, etc */
 239         u_char          ifi_addrlen;    /* media address length */
 240         u_char          ifi_hdrlen;     /* media header length */
 241         u_char          ifi_recvquota;  /* polling quota for receive intrs */
 242         u_char          ifi_xmitquota;  /* polling quota for xmit intrs */
 243         u_char          ifi_unused1;    /* for future use */
 244         u_int32_t       ifi_mtu;        /* maximum transmission unit */
 245         u_int32_t       ifi_metric;     /* routing metric (external only) */
 246         u_int32_t       ifi_baudrate;   /* linespeed */
 247         /* volatile statistics */
 248         u_int64_t       ifi_ipackets;   /* packets received on interface */
 249         u_int64_t       ifi_ierrors;    /* input errors on interface */
 250         u_int64_t       ifi_opackets;   /* packets sent on interface */
 251         u_int64_t       ifi_oerrors;    /* output errors on interface */
 252         u_int64_t       ifi_collisions; /* collisions on csma interfaces */
 253         u_int64_t       ifi_ibytes;     /* total number of octets received */
 254         u_int64_t       ifi_obytes;     /* total number of octets sent */
 255         u_int64_t       ifi_imcasts;    /* packets received via multicast */
 256         u_int64_t       ifi_omcasts;    /* packets sent via multicast */
 257         u_int64_t       ifi_iqdrops;    /* dropped on input, this interface */
 258         u_int64_t       ifi_noproto;    /* destined for unsupported protocol */
 259 #if PKT_PRIORITY
 260         u_int32_t       ifi_obgpackets; /* bg packets sent on interface */
 261         u_int32_t       ifi_obgbytes;   /* total number of bg octets sent */
 262 #endif /* PKT_PRIORITY */
 263         u_int32_t       ifi_recvtiming; /* usec spent receiving when timing */
 264         u_int32_t       ifi_xmittiming; /* usec spent xmitting when timing */
 265 #define IF_LASTCHANGEUPTIME     1       /* lastchange: 1-uptime 0-calendar time */
 266         struct  timeval ifi_lastchange; /* time of last administrative change */
 267         u_int32_t       ifi_hwassist;   /* HW offload capabilities */
 268         u_int32_t       ifi_tso_v4_mtu; /* TCP Segment Offload IPv4 maximum segment size */
 269         u_int32_t       ifi_tso_v6_mtu; /* TCP Segment Offload IPv6 maximum segment size */
 270 };
 271
 272 #define if_mtu          if_data.ifi_mtu
 273 #define if_type         if_data.ifi_type
 274 #define if_typelen      if_data.ifi_typelen
 275 #define if_physical     if_data.ifi_physical
 276 #define if_addrlen      if_data.ifi_addrlen
 277 #define if_hdrlen       if_data.ifi_hdrlen
 278 #define if_metric       if_data.ifi_metric
 279 #define if_baudrate     if_data.ifi_baudrate
 280 #define if_hwassist     if_data.ifi_hwassist
 281 #define if_ipackets     if_data.ifi_ipackets
 282 #define if_ierrors      if_data.ifi_ierrors
 283 #define if_opackets     if_data.ifi_opackets
 284 #define if_oerrors      if_data.ifi_oerrors
 285 #define if_collisions   if_data.ifi_collisions
 286 #define if_ibytes       if_data.ifi_ibytes
 287 #define if_obytes       if_data.ifi_obytes
 288 #define if_imcasts      if_data.ifi_imcasts
 289 #define if_omcasts      if_data.ifi_omcasts
 290 #define if_iqdrops      if_data.ifi_iqdrops
 291 #define if_noproto      if_data.ifi_noproto
 292 #if PKT_PRIORITY
 293 #define if_obgpackets   if_data.ifi_obgpackets
 294 #define if_obgbytes     if_data.ifi_obgbytes
 295 #endif /* PKT_PRIORITY */
 296 #define if_lastchange   if_data.ifi_lastchange
 297 #define if_recvquota    if_data.ifi_recvquota
 298 #define if_xmitquota    if_data.ifi_xmitquota
 299 #define if_iflags       if_data.ifi_iflags
 300 #define if_tso_v4_mtu   if_data.ifi_tso_v4_mtu
 301 #define if_tso_v6_mtu   if_data.ifi_tso_v6_mtu
 302
 303 struct  mbuf;
 304 struct ifaddr;
 305 TAILQ_HEAD(ifnethead, ifnet);   /* we use TAILQs so that the order of */
 306 TAILQ_HEAD(ifaddrhead, ifaddr); /* instantiation is preserved in the list */
 307 TAILQ_HEAD(ifprefixhead, ifprefix);
 308 LIST_HEAD(ifmultihead, ifmultiaddr);
 309 struct tqdummy;
 310 TAILQ_HEAD(tailq_head, tqdummy);
 311
 312 /*
 313  * Forward structure declarations for function prototypes [sic].
 314  */
 315 struct  proc;
 316 struct  rtentry;
 317 struct  socket;
 318 struct  ether_header;
 319 struct  sockaddr_dl;
 320 struct ifnet_filter;
 321
 322 TAILQ_HEAD(ifnet_filter_head, ifnet_filter);
 323 TAILQ_HEAD(ddesc_head_name, dlil_demux_desc);
 324
 325 /* All of the following IF_HWASSIST_* flags are defined
 326  * in kpi_inteface.h as IFNET_* flags. These are redefined
 327  * here as constants to avoid failures to build user level
 328  * programs that can not include kpi_interface.h. It is
 329  * important to keep this in sync with the definitions in
 330  * kpi_interface.h. The corresponding constant for each
 331  * definition is mentioned in the comment.
 332  *
 333  * Bottom 16 bits reserved for hardware checksum
 334  */
 335 #define IF_HWASSIST_CSUM_IP             0x0001  /* will csum IP, IFNET_CSUM_IP */
 336 #define IF_HWASSIST_CSUM_TCP            0x0002  /* will csum TCP, IFNET_CSUM_TCP */
 337 #define IF_HWASSIST_CSUM_UDP            0x0004  /* will csum UDP, IFNET_CSUM_UDP */
 338 #define IF_HWASSIST_CSUM_IP_FRAGS       0x0008  /* will csum IP fragments, IFNET_CSUM_FRAGMENT */
 339 #define IF_HWASSIST_CSUM_FRAGMENT       0x0010  /* will do IP fragmentation, IFNET_IP_FRAGMENT */
 340 #define IF_HWASSIST_CSUM_TCP_SUM16      0x1000  /* simple TCP Sum16 computation, IFNET_CSUM_SUM16 */
 341 #define IF_HWASSIST_CSUM_MASK           0xffff
 342 #define IF_HWASSIST_CSUM_FLAGS(hwassist)        ((hwassist) & IF_HWASSIST_CSUM_MASK)
 343
 344 /* VLAN support */
 345 #define IF_HWASSIST_VLAN_TAGGING        0x00010000      /* supports VLAN tagging, IFNET_VLAN_TAGGING */
 346 #define IF_HWASSIST_VLAN_MTU            0x00020000      /* supports VLAN MTU-sized packet (for software VLAN), IFNET_VLAN_MTU */
 347
 348 /* TCP Segment Offloading support */
 349
 350 #define IF_HWASSIST_TSO_V4              0x00200000      /* will do TCP Segment offload for IPv4, IFNET_TSO_IPV4 */
 351 #define IF_HWASSIST_TSO_V6              0x00400000      /* will do TCP Segment offload for IPv6, IFNET_TSO_IPV6 */
 352
 353 #define IFNET_RW_LOCK 1
 354
 355 #endif /* PRIVATE */
 356 /*
 357  * Structure defining a queue for a network interface.
 358  */
 359 struct  ifqueue {
 360         void *ifq_head;
 361         void *ifq_tail;
 362         int     ifq_len;
 363         int     ifq_maxlen;
 364         int     ifq_drops;
 365 };
 366
 367 #ifdef PRIVATE
 368
 369 struct ddesc_head_str;
 370 struct proto_hash_entry;
 371 struct kev_msg;
 372 struct dlil_threading_info;
 373 #if PF
 374 struct pfi_kif;
 375 #endif /* PF */
 376
 377 /*
 378  * Structure defining a network interface.
 379  *
 380  * (Would like to call this struct ``if'', but C isn't PL/1.)
 381  */
 382 struct ifnet {
 383         void    *if_softc;              /* pointer to driver state */
 384         const char      *if_name;               /* name, e.g. ``en'' or ``lo'' */
 385         TAILQ_ENTRY(ifnet) if_link;     /* all struct ifnets are chained */
 386         struct  ifaddrhead if_addrhead; /* linked list of addresses per if */
 387         u_int32_t       if_refcnt;
 388 #ifdef __KPI_INTERFACE__
 389         ifnet_check_multi       if_check_multi;
 390 #else
 391         void*                           if_check_multi;
 392 #endif /* __KPI_INTERFACE__ */
 393         int     if_pcount;              /* number of promiscuous listeners */
 394         struct  bpf_if *if_bpf;         /* packet filter structure */
 395         u_short if_index;               /* numeric abbreviation for this if  */
 396         short   if_unit;                /* sub-unit for lower level driver */
 397         short   if_timer;               /* time 'til if_watchdog called */
 398         short   if_flags;               /* up/down, broadcast, etc. */
 399         int     if_ipending;            /* interrupts pending */
 400         void    *if_linkmib;            /* link-type-specific MIB data */
 401         size_t  if_linkmiblen;          /* length of above data */
 402         struct  if_data_internal if_data;
 403
 404 /* New with DLIL */
 405 #ifdef BSD_KERNEL_PRIVATE
 406         int     if_usecnt;
 407 #else
 408         int     refcnt;
 409 #endif
 410 #ifdef __KPI_INTERFACE__
 411         ifnet_output_func       if_output;
 412         ifnet_ioctl_func        if_ioctl;
 413         ifnet_set_bpf_tap       if_set_bpf_tap;
 414         ifnet_detached_func     if_free;
 415         ifnet_demux_func        if_demux;
 416         ifnet_event_func        if_event;
 417         ifnet_framer_func       if_framer;
 418         ifnet_family_t          if_family;              /* value assigned by Apple */
 419 #else
 420         void*                           if_output;
 421         void*                           if_ioctl;
 422         void*                           if_set_bpf_tap;
 423         void*                           if_free;
 424         void*                           if_demux;
 425         void*                           if_event;
 426         void*                           if_framer;
 427         u_int32_t                       if_family;              /* value assigned by Apple */
 428 #endif
 429
 430         struct ifnet_filter_head if_flt_head;
 431
 432 /* End DLIL specific */
 433
 434         u_int32_t       if_delayed_detach; /* need to perform delayed detach */
 435         void    *if_private;    /* private to interface */
 436         long    if_eflags;              /* autoaddr, autoaddr done, etc. */
 437
 438         struct  ifmultihead if_multiaddrs; /* multicast addresses configured */
 439         int     if_amcount;             /* number of all-multicast requests */
 440 /* procedure handles */
 441 #ifdef __KPI_INTERFACE__
 442         ifnet_add_proto_func    if_add_proto;
 443         ifnet_del_proto_func    if_del_proto;
 444 #else /* !__KPI_INTERFACE__ */
 445         void*   if_add_proto;
 446         void*   if_del_proto;
 447 #endif /* !__KPI_INTERFACE__ */
 448         struct proto_hash_entry *if_proto_hash;
 449         void                                    *if_kpi_storage;
 450 #if 0
 451         void    *unused_was_init;
 452 #else
 453         struct dlil_threading_info *if_input_thread;
 454 #endif
 455         void    *unused_was_resolvemulti;
 456
 457         struct ifqueue  if_snd;
 458         u_int32_t       unused_2[1];
 459 #ifdef __APPLE__
 460         uintptr_t       family_cookie;
 461         struct  ifprefixhead if_prefixhead; /* list of prefixes per if */
 462
 463 #ifdef _KERN_LOCKS_H_
 464 #if IFNET_RW_LOCK
 465         lck_rw_t *if_lock;              /* Lock to protect this interface */
 466 #else
 467         lck_mtx_t *if_lock;             /* Lock to protect this interface */
 468 #endif
 469 #else
 470         void    *if_lock;
 471 #endif
 472
 473 #else
 474         struct  ifprefixhead if_prefixhead; /* list of prefixes per if */
 475 #endif /* __APPLE__ */
 476         struct {
 477                 u_int32_t       length;
 478                 union {
 479                         u_char  buffer[8];
 480                         u_char  *ptr;
 481                 } u;
 482         } if_broadcast;
 483 #if CONFIG_MACF_NET
 484         struct  label *if_label;        /* interface MAC label */
 485 #endif
 486
 487         u_int32_t       if_wake_properties;
 488 #if PF
 489         struct thread   *if_pf_curthread;
 490         struct pfi_kif  *if_pf_kif;
 491 #endif /* PF */
 492 #ifdef _KERN_LOCKS_H_
 493         lck_mtx_t       *if_fwd_route_lock;
 494 #else
 495         void            *if_fwd_route_lock;
 496 #endif
 497         struct route    if_fwd_route;   /* cached IPv4 forwarding route */
 498         void    *if_bridge;             /* bridge glue */
 499 #if IFNET_ROUTE_REFCNT
 500         u_int32_t       if_want_aggressive_drain;
 501         u_int32_t       if_idle_flags;  /* idle flags */
 502         u_int32_t       if_route_refcnt; /* idle: route ref count */
 503 #endif /* IFNET_ROUTE_REFCNT */
 504 };
 505
 506 #ifndef __APPLE__
 507 /* for compatibility with other BSDs */
 508 #define if_addrlist     if_addrhead
 509 #define if_list         if_link
 510 #endif /* !__APPLE__ */
 511
 512
 513 #endif /* PRIVATE */
 514
 515 #ifdef KERNEL_PRIVATE
 516 /*
 517  * Structure describing a `cloning' interface.
 518  */
 519 struct if_clone {
 520         LIST_ENTRY(if_clone) ifc_list;  /* on list of cloners */
 521         const char *ifc_name;                   /* name of device, e.g. `vlan' */
 522         size_t ifc_namelen;             /* length of name */
 523         u_int32_t ifc_minifs;                   /* minimum number of interfaces */
 524         u_int32_t ifc_maxunit;          /* maximum unit number */
 525         unsigned char *ifc_units;       /* bitmap to handle units */
 526         u_int32_t ifc_bmlen;                    /* bitmap length */
 527
 528         int     (*ifc_create)(struct if_clone *, u_int32_t, void *);
 529         int     (*ifc_destroy)(struct ifnet *);
 530 };
 531
 532 #define IF_CLONE_INITIALIZER(name, create, destroy, minifs, maxunit)    \
 533     { { NULL, NULL }, name, sizeof(name) - 1, minifs, maxunit, NULL, 0, create, destroy }
 534
 535 #define M_CLONE         M_IFADDR
 536
 537 /*
 538  * Bit values in if_ipending
 539  */
 540 #define IFI_RECV        1       /* I want to receive */
 541 #define IFI_XMIT        2       /* I want to transmit */
 542
 543 /*
 544  * Output queues (ifp->if_snd) and slow device input queues (*ifp->if_slowq)
 545  * are queues of messages stored on ifqueue structures
 546  * (defined above).  Entries are added to and deleted from these structures
 547  * by these macros, which should be called with ipl raised to splimp().
 548  */
 549 #define IF_QFULL(ifq)           ((ifq)->ifq_len >= (ifq)->ifq_maxlen)
 550 #define IF_DROP(ifq)            ((ifq)->ifq_drops++)
 551 #define IF_ENQUEUE(ifq, m) { \
 552         (m)->m_nextpkt = 0; \
 553         if ((ifq)->ifq_tail == 0) \
 554                 (ifq)->ifq_head = m; \
 555         else \
 556                 ((struct mbuf*)(ifq)->ifq_tail)->m_nextpkt = m; \
 557         (ifq)->ifq_tail = m; \
 558         (ifq)->ifq_len++; \
 559 }
 560 #define IF_PREPEND(ifq, m) { \
 561         (m)->m_nextpkt = (ifq)->ifq_head; \
 562         if ((ifq)->ifq_tail == 0) \
 563                 (ifq)->ifq_tail = (m); \
 564         (ifq)->ifq_head = (m); \
 565         (ifq)->ifq_len++; \
 566 }
 567 #define IF_DEQUEUE(ifq, m) { \
 568         (m) = (ifq)->ifq_head; \
 569         if (m) { \
 570                 if (((ifq)->ifq_head = (m)->m_nextpkt) == 0) \
 571                         (ifq)->ifq_tail = 0; \
 572                 (m)->m_nextpkt = 0; \
 573                 (ifq)->ifq_len--; \
 574         } \
 575 }
 576
 577 #define IF_ENQ_DROP(ifq, m)     if_enq_drop(ifq, m)
 578
 579 #if defined(__GNUC__) && defined(MT_HEADER)
 580 static __inline int
 581 if_queue_drop(struct ifqueue *ifq, __unused struct mbuf *m)
 582 {
 583         IF_DROP(ifq);
 584         return 0;
 585 }
 586
 587 static __inline int
 588 if_enq_drop(struct ifqueue *ifq, struct mbuf *m)
 589 {
 590         if (IF_QFULL(ifq) &&
 591             !if_queue_drop(ifq, m))
 592                 return 0;
 593         IF_ENQUEUE(ifq, m);
 594         return 1;
 595 }
 596 #else
 597
 598 #ifdef MT_HEADER
 599 int     if_enq_drop(struct ifqueue *, struct mbuf *);
 600 #endif /* MT_HEADER */
 601
 602 #endif /* defined(__GNUC__) && defined(MT_HEADER) */
 603
 604 #endif /* KERNEL_PRIVATE */
 605
 606
 607 #ifdef PRIVATE
 608 /*
 609  * The ifaddr structure contains information about one address
 610  * of an interface.  They are maintained by the different address families,
 611  * are allocated and attached when an address is set, and are linked
 612  * together so all addresses for an interface can be located.
 613  */
 614 struct ifaddr {
 615         struct  sockaddr *ifa_addr;     /* address of interface */
 616         struct  sockaddr *ifa_dstaddr;  /* other end of p-to-p link */
 617 #define ifa_broadaddr   ifa_dstaddr     /* broadcast address interface */
 618         struct  sockaddr *ifa_netmask;  /* used to determine subnet */
 619         struct  ifnet *ifa_ifp;         /* back-pointer to interface */
 620         TAILQ_ENTRY(ifaddr) ifa_link;   /* queue macro glue */
 621         void (*ifa_rtrequest)           /* check or clean routes (+ or -)'d */
 622             (int, struct rtentry *, struct sockaddr *);
 623         uint32_t ifa_flags;             /* mostly rt_flags for cloning */
 624         int32_t ifa_refcnt;             /* ref count, use ifaref, ifafree */
 625         int32_t ifa_metric;             /* cost of going out this interface */
 626         void (*ifa_free)(struct ifaddr *); /* callback fn for freeing */
 627         void (*ifa_trace)               /* callback fn for tracing refs */
 628             (struct ifaddr *, int);
 629         uint32_t ifa_debug;             /* debug flags */
 630 };
 631
 632 /*
 633  * Valid values for ifa_flags
 634  */
 635 #define IFA_ROUTE       RTF_UP          /* route installed (0x1) */
 636 #define IFA_CLONING     RTF_CLONING     /* (0x100) */
 637
 638 /*
 639  * Valid values for ifa_debug
 640  */
 641 #define IFD_ATTACHED    0x1             /* attached to an interface */
 642 #define IFD_ALLOC       0x2             /* dynamically allocated */
 643 #define IFD_DEBUG       0x4             /* has debugging info */
 644
 645 #endif /* PRIVATE */
 646
 647 #ifdef KERNEL_PRIVATE
 648 /*
 649  * The prefix structure contains information about one prefix
 650  * of an interface.  They are maintained by the different address families,
 651  * are allocated and attached when an prefix or an address is set,
 652  * and are linked together so all prefixes for an interface can be located.
 653  */
 654 struct ifprefix {
 655         struct  sockaddr *ifpr_prefix;  /* prefix of interface */
 656         struct  ifnet *ifpr_ifp;        /* back-pointer to interface */
 657         TAILQ_ENTRY(ifprefix) ifpr_list; /* queue macro glue */
 658         u_char  ifpr_plen;              /* prefix length in bits */
 659         u_char  ifpr_type;              /* protocol dependent prefix type */
 660 };
 661 #endif /* KERNEL_PRIVATE */
 662
 663 #ifdef PRIVATE
 664 typedef void (*ifma_protospec_free_func)(void* ifma_protospec);
 665
 666 /*
 667  * Multicast address structure.  This is analogous to the ifaddr
 668  * structure except that it keeps track of multicast addresses.
 669  * Also, the reference count here is a count of requests for this
 670  * address, not a count of pointers to this structure.
 671  */
 672 struct ifmultiaddr {
 673         LIST_ENTRY(ifmultiaddr) ifma_link; /* queue macro glue */
 674         struct  sockaddr *ifma_addr;    /* address this membership is for */
 675         struct ifmultiaddr *ifma_ll;    /* link-layer translation, if any */
 676         struct  ifnet *ifma_ifp;                /* back-pointer to interface */
 677         u_int   ifma_usecount;                  /* use count, protected by ifp's lock */
 678         void    *ifma_protospec;                /* protocol-specific state, if any */
 679         int32_t ifma_refcount;                  /* reference count, atomically protected */
 680         ifma_protospec_free_func ifma_free;     /* function called to free ifma_protospec */
 681 };
 682 #endif /* PRIVATE */
 683
 684 #ifdef KERNEL_PRIVATE
 685 #define IFAREF(ifa) ifaref(ifa)
 686 #define IFAFREE(ifa) ifafree(ifa)
 687
 688 /*
 689  * To preserve kmem compatibility, we define
 690  * ifnet_head to ifnet. This should be temp.
 691  */
 692 #define ifnet_head ifnet
 693 extern  struct ifnethead ifnet_head;
 694 extern struct   ifnet   **ifindex2ifnet;
 695 extern  int ifqmaxlen;
 696 extern  ifnet_t  lo_ifp;
 697 extern  int if_index;
 698 extern  struct ifaddr **ifnet_addrs;
 699
 700 int     if_addmulti(struct ifnet *, const struct sockaddr *, struct ifmultiaddr **);
 701 int     if_allmulti(struct ifnet *, int);
 702 void    if_attach(struct ifnet *);
 703 int     if_delmultiaddr(struct ifmultiaddr *ifma, int locked);
 704 int     if_delmulti(struct ifnet *, const struct sockaddr *);
 705 void    if_down(struct ifnet *);
 706 int     if_down_all(void);
 707 void    if_route(struct ifnet *, int flag, int fam);
 708 void    if_unroute(struct ifnet *, int flag, int fam);
 709 void    if_up(struct ifnet *);
 710 void    if_updown(struct ifnet *ifp, int up);
 711 /*void  ifinit(void));*/ /* declared in systm.h for main( */
 712 int     ifioctl(struct socket *, u_long, caddr_t, struct proc *);
 713 int     ifioctllocked(struct socket *, u_long, caddr_t, struct proc *);
 714 struct  ifnet *ifunit(const char *);
 715 struct  ifnet *if_withname(struct sockaddr *);
 716
 717 int     if_clone_attach(struct if_clone *);
 718 void    if_clone_detach(struct if_clone *);
 719 struct if_clone *
 720         if_clone_lookup(const char *, u_int32_t *);
 721
 722 void    ifnet_lock_assert(struct ifnet *ifp, int what);
 723 void    ifnet_lock_shared(struct ifnet *ifp);
 724 void    ifnet_lock_exclusive(struct ifnet *ifp);
 725 void    ifnet_lock_done(struct ifnet *ifp);
 726
 727 void    ifnet_head_lock_shared(void);
 728 void    ifnet_head_lock_exclusive(void);
 729 void    ifnet_head_done(void);
 730
 731 void    if_attach_ifa(struct ifnet * ifp, struct ifaddr *ifa);
 732 void    if_detach_ifa(struct ifnet * ifp, struct ifaddr *ifa);
 733
 734 void    ifma_reference(struct ifmultiaddr *ifma);
 735 void    ifma_release(struct ifmultiaddr *ifma);
 736
 737 struct  ifaddr *ifa_ifwithaddr(const struct sockaddr *);
 738 struct  ifaddr *ifa_ifwithaddr_scoped(const struct sockaddr *, unsigned int);
 739 struct  ifaddr *ifa_ifwithdstaddr(const struct sockaddr *);
 740 struct  ifaddr *ifa_ifwithnet(const struct sockaddr *);
 741 struct  ifaddr *ifa_ifwithnet_scoped(const struct sockaddr *, unsigned int);
 742 struct  ifaddr *ifa_ifwithroute(int, const struct sockaddr *, const struct sockaddr *);
 743 struct  ifaddr *ifa_ifwithroute_locked(int, const struct sockaddr *, const struct sockaddr *);
 744 struct ifaddr *ifa_ifwithroute_scoped_locked(int, const struct sockaddr *,
 745     const struct sockaddr *, unsigned int);
 746 struct  ifaddr *ifaof_ifpforaddr(const struct sockaddr *, struct ifnet *);
 747 struct  ifaddr *ifa_ifpgetprimary(struct ifnet *, int);
 748 void    ifafree(struct ifaddr *);
 749 void    ifaref(struct ifaddr *);
 750
 751 struct  ifmultiaddr *ifmaof_ifpforaddr(const struct sockaddr *, struct ifnet *);
 752
 753 extern struct in_ifaddr *ifa_foraddr(unsigned int);
 754 extern struct in_ifaddr *ifa_foraddr_scoped(unsigned int, unsigned int);
 755
 756 #ifdef BSD_KERNEL_PRIVATE
 757 enum {
 758         kIfNetUseCount_MayBeZero = 0,
 759         kIfNetUseCount_MustNotBeZero = 1
 760 };
 761
 762 int ifp_use(struct ifnet *ifp, int handle_zero);
 763 int ifp_unuse(struct ifnet *ifp);
 764 void ifp_use_reached_zero(struct ifnet *ifp);
 765
 766 void    if_data_internal_to_if_data(struct ifnet *ifp, const struct if_data_internal *if_data_int,
 767                            struct if_data *if_data);
 768 void    if_data_internal_to_if_data64(struct ifnet *ifp, const struct if_data_internal *if_data_int,
 769                                                            struct if_data64 *if_data64);
 770 #endif /* BSD_KERNEL_PRIVATE */
 771 #endif /* KERNEL_PRIVATE */
 772 #endif /* !_NET_IF_VAR_H_ */