2 * Copyright (c) 2011-2020 Apple Inc. All rights reserved.
4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
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.
15 * Please obtain a copy of the License at
16 * http://www.opensource.apple.com/apsl/ and read it before using this file.
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.
26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
29 #ifndef _NET_IF_LLREACH_H_
30 #define _NET_IF_LLREACH_H_
37 #include <sys/types.h>
40 * Per-interface link-layer reachability information (private).
42 #define IF_LLREACHINFO_ADDRLEN 64 /* max ll addr len */
43 #define IF_LLREACHINFO_RESERVED2 16 /* more reserved bits */
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
];
59 #ifdef XNU_KERNEL_PRIVATE
61 #include <kern/locks.h>
62 #include <net/ethernet.h>
63 #include <netinet/in.h>
64 #include <netinet6/in6_var.h>
65 #include <netinet6/nd6.h>
68 * Per-interface link-layer reachability. (Currently only for ARP/NDP/Ethernet.)
70 #define IF_LLREACH_MAXLEN ETHER_ADDR_LEN
73 decl_lck_mtx_data(, lr_lock
);
74 RB_ENTRY(if_llreach
) lr_link
; /* RB tree links */
75 struct ifnet
*lr_ifp
; /* back pointer to ifnet */
76 u_int32_t lr_refcnt
; /* reference count */
77 u_int32_t lr_reqcnt
; /* RB tree request count */
78 u_int32_t lr_debug
; /* see ifa_debug flags */
79 u_int32_t lr_probes
; /* number of probes so far */
80 u_int64_t lr_basecal
; /* base calendar time */
81 u_int64_t lr_baseup
; /* base uptime */
82 u_int64_t lr_lastrcvd
; /* last-heard-of timestamp */
83 u_int32_t lr_basereachable
; /* baseline time */
84 u_int32_t lr_reachable
; /* reachable time */
86 u_int16_t proto
; /* ll proto */
87 u_int8_t addr
[IF_LLREACH_MAXLEN
]; /* ll addr */
89 int32_t lr_rssi
; /* received signal strength */
90 int32_t lr_lqm
; /* link quality metric */
91 int32_t lr_npm
; /* node proximity metric */
94 RB_PROTOTYPE_SC_PREV(__private_extern__
, ll_reach_tree
, if_llreach
,
97 #define IFLR_LOCK_ASSERT_HELD(_iflr) \
98 LCK_MTX_ASSERT(&(_iflr)->lr_lock, LCK_MTX_ASSERT_OWNED)
100 #define IFLR_LOCK_ASSERT_NOTHELD(_iflr) \
101 LCK_MTX_ASSERT(&(_iflr)->lr_lock, LCK_MTX_ASSERT_NOTOWNED)
103 #define IFLR_LOCK(_iflr) \
104 lck_mtx_lock(&(_iflr)->lr_lock)
106 #define IFLR_LOCK_SPIN(_iflr) \
107 lck_mtx_lock_spin(&(_iflr)->lr_lock)
109 #define IFLR_CONVERT_LOCK(_iflr) do { \
110 IFLR_LOCK_ASSERT_HELD(_iflr); \
111 lck_mtx_convert_spin(&(_iflr)->lr_lock); \
114 #define IFLR_UNLOCK(_iflr) \
115 lck_mtx_unlock(&(_iflr)->lr_lock)
117 #define IFLR_ADDREF(_iflr) \
118 iflr_addref(_iflr, 0)
120 #define IFLR_ADDREF_LOCKED(_iflr) \
121 iflr_addref(_iflr, 1)
123 #define IFLR_REMREF(_iflr) \
126 struct ifnet_llreach_info
; /* forward declaration */
128 extern void ifnet_llreach_ifattach(struct ifnet
*, boolean_t
);
129 extern void ifnet_llreach_ifdetach(struct ifnet
*);
130 extern struct if_llreach
*ifnet_llreach_alloc(struct ifnet
*, u_int16_t
, void *,
131 unsigned int, u_int32_t
);
132 extern void ifnet_llreach_free(struct if_llreach
*);
133 extern int ifnet_llreach_reachable(struct if_llreach
*);
134 extern int ifnet_llreach_reachable_delta(struct if_llreach
*, u_int64_t
);
135 extern void ifnet_llreach_set_reachable(struct ifnet
*, u_int16_t
, void *,
137 extern u_int64_t
ifnet_llreach_up2calexp(struct if_llreach
*, u_int64_t
);
138 extern u_int64_t
ifnet_llreach_up2upexp(struct if_llreach
*, u_int64_t
);
139 extern int ifnet_llreach_get_defrouter(struct ifnet
*, sa_family_t
,
140 struct ifnet_llreach_info
*);
141 extern void ifnet_lr2ri(struct if_llreach
*, struct rt_reach_info
*);
142 extern void ifnet_lr2iflri(struct if_llreach
*, struct ifnet_llreach_info
*);
143 extern void ifnet_lr2lri(struct if_llreach
*, struct if_llreach_info
*);
144 extern void iflr_addref(struct if_llreach
*, int);
145 extern void iflr_remref(struct if_llreach
*);
146 #endif /* XNU_KERNEL_PRIVATE */
152 #endif /* !_NET_IF_LLREACH_H_ */