bsd/net/if_llreach.h

   1 /*
   2  * Copyright (c) 2011-2014 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 #ifndef _NET_IF_LLREACH_H_
  30 #define _NET_IF_LLREACH_H_
  31
  32 #ifdef PRIVATE
  33 #ifdef  __cplusplus
  34 extern "C" {
  35 #endif
  36
  37 #include <sys/types.h>
  38
  39 /*
  40  * Per-interface link-layer reachability information (private).
  41  */
  42 #define IF_LLREACHINFO_ADDRLEN          64      /* max ll addr len */
  43 #define IF_LLREACHINFO_RESERVED2        16      /* more reserved bits */
  44
  45 struct if_llreach_info {
  46         u_int32_t               lri_refcnt;     /* reference count */
  47         u_int32_t               lri_ifindex;    /* interface index */
  48         u_int64_t               lri_expire;     /* expiration (calendar) time */
  49         u_int32_t               lri_probes;     /* total # of probes */
  50         u_int16_t               lri_reserved;   /* for future use */
  51         u_int16_t               lri_proto;      /* ll proto */
  52         u_int8_t                lri_addr[IF_LLREACHINFO_ADDRLEN]; /* ll addr */
  53         int32_t                 lri_rssi;       /* received signal strength */
  54         int32_t                 lri_lqm;        /* link quality metric */
  55         int32_t                 lri_npm;        /* node proximity metric */
  56         u_int8_t                lri_reserved2[IF_LLREACHINFO_RESERVED2];
  57 };
  58
  59 #ifdef XNU_KERNEL_PRIVATE
  60 #include <sys/tree.h>
  61 #include <kern/locks.h>
  62 #include <net/ethernet.h>
  63 #include <netinet/in.h>
  64 #if INET6
  65 #include <netinet6/in6_var.h>
  66 #include <netinet6/nd6.h>
  67 #endif /* INET6 */
  68
  69 /*
  70  * Per-interface link-layer reachability.  (Currently only for ARP/NDP/Ethernet.)
  71  */
  72 #define IF_LLREACH_MAXLEN       ETHER_ADDR_LEN
  73
  74 struct if_llreach {
  75         decl_lck_mtx_data(, lr_lock);
  76         RB_ENTRY(if_llreach)    lr_link;        /* RB tree links */
  77         struct ifnet            *lr_ifp;        /* back pointer to ifnet */
  78         u_int32_t               lr_refcnt;      /* reference count */
  79         u_int32_t               lr_reqcnt;      /* RB tree request count */
  80         u_int32_t               lr_debug;       /* see ifa_debug flags */
  81         u_int32_t               lr_probes;      /* number of probes so far */
  82         u_int64_t               lr_basecal;     /* base calendar time */
  83         u_int64_t               lr_baseup;      /* base uptime */
  84         u_int64_t               lr_lastrcvd;    /* last-heard-of timestamp */
  85         u_int32_t               lr_basereachable; /* baseline time */
  86         u_int32_t               lr_reachable;   /* reachable time */
  87         struct lr_key_s {
  88                 u_int16_t       proto;          /* ll proto */
  89                 u_int8_t        addr[IF_LLREACH_MAXLEN]; /* ll addr */
  90         } lr_key;
  91         int32_t                 lr_rssi;        /* received signal strength */
  92         int32_t                 lr_lqm;         /* link quality metric */
  93         int32_t                 lr_npm;         /* node proximity metric */
  94 };
  95
  96 RB_PROTOTYPE_SC_PREV(__private_extern__, ll_reach_tree, if_llreach,
  97     ls_link, ifllr_cmp);
  98
  99 #define IFLR_LOCK_ASSERT_HELD(_iflr)                                    \
 100         lck_mtx_assert(&(_iflr)->lr_lock, LCK_MTX_ASSERT_OWNED)
 101
 102 #define IFLR_LOCK_ASSERT_NOTHELD(_iflr)                         \
 103         lck_mtx_assert(&(_iflr)->lr_lock, LCK_MTX_ASSERT_NOTOWNED)
 104
 105 #define IFLR_LOCK(_iflr)                                                \
 106         lck_mtx_lock(&(_iflr)->lr_lock)
 107
 108 #define IFLR_LOCK_SPIN(_iflr)                                           \
 109         lck_mtx_lock_spin(&(_iflr)->lr_lock)
 110
 111 #define IFLR_CONVERT_LOCK(_iflr) do {                                   \
 112         IFLR_LOCK_ASSERT_HELD(_iflr);                                   \
 113         lck_mtx_convert_spin(&(_iflr)->lr_lock);                        \
 114 } while (0)
 115
 116 #define IFLR_UNLOCK(_iflr)                                              \
 117         lck_mtx_unlock(&(_iflr)->lr_lock)
 118
 119 #define IFLR_ADDREF(_iflr)                                              \
 120         iflr_addref(_iflr, 0)
 121
 122 #define IFLR_ADDREF_LOCKED(_iflr)                                       \
 123         iflr_addref(_iflr, 1)
 124
 125 #define IFLR_REMREF(_iflr)                                              \
 126         iflr_remref(_iflr)
 127
 128 struct ifnet_llreach_info;      /* forward declaration */
 129
 130 extern void ifnet_llreach_init(void);
 131 extern void ifnet_llreach_ifattach(struct ifnet *, boolean_t);
 132 extern void ifnet_llreach_ifdetach(struct ifnet *);
 133 extern struct if_llreach *ifnet_llreach_alloc(struct ifnet *, u_int16_t, void *,
 134     unsigned int, u_int64_t);
 135 extern void ifnet_llreach_free(struct if_llreach *);
 136 extern int ifnet_llreach_reachable(struct if_llreach *);
 137 extern int ifnet_llreach_reachable_delta(struct if_llreach *, u_int64_t);
 138 extern void ifnet_llreach_set_reachable(struct ifnet *, u_int16_t, void *,
 139     unsigned int);
 140 extern u_int64_t ifnet_llreach_up2calexp(struct if_llreach *, u_int64_t);
 141 extern u_int64_t ifnet_llreach_up2upexp(struct if_llreach *, u_int64_t);
 142 extern int ifnet_llreach_get_defrouter(struct ifnet *, int,
 143     struct ifnet_llreach_info *);
 144 extern void ifnet_lr2ri(struct if_llreach *, struct rt_reach_info *);
 145 extern void ifnet_lr2iflri(struct if_llreach *, struct ifnet_llreach_info *);
 146 extern void ifnet_lr2lri(struct if_llreach *, struct if_llreach_info *);
 147 extern void iflr_addref(struct if_llreach *, int);
 148 extern void iflr_remref(struct if_llreach *);
 149 #endif /* XNU_KERNEL_PRIVATE */
 150
 151 #ifdef  __cplusplus
 152 }
 153 #endif
 154 #endif /* PRIVATE */
 155 #endif /* !_NET_IF_LLREACH_H_ */