1/*
2 * Copyright (c) 2011-2020 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
34extern "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
45struct 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#include <netinet6/in6_var.h>
65#include <netinet6/nd6.h>
66
67/*
68 * Per-interface link-layer reachability. (Currently only for ARP/NDP/Ethernet.)
69 */
70#define IF_LLREACH_MAXLEN ETHER_ADDR_LEN
71
72struct if_llreach {
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 */
85 struct lr_key_s {
86 u_int16_t proto; /* ll proto */
87 u_int8_t addr[IF_LLREACH_MAXLEN]; /* ll addr */
88 } lr_key;
89 int32_t lr_rssi; /* received signal strength */
90 int32_t lr_lqm; /* link quality metric */
91 int32_t lr_npm; /* node proximity metric */
92};
93
94RB_PROTOTYPE_SC_PREV(__private_extern__, ll_reach_tree, if_llreach,
95 ls_link, ifllr_cmp);
96
97#define IFLR_LOCK_ASSERT_HELD(_iflr) \
98 LCK_MTX_ASSERT(&(_iflr)->lr_lock, LCK_MTX_ASSERT_OWNED)
99
100#define IFLR_LOCK_ASSERT_NOTHELD(_iflr) \
101 LCK_MTX_ASSERT(&(_iflr)->lr_lock, LCK_MTX_ASSERT_NOTOWNED)
102
103#define IFLR_LOCK(_iflr) \
104 lck_mtx_lock(&(_iflr)->lr_lock)
105
106#define IFLR_LOCK_SPIN(_iflr) \
107 lck_mtx_lock_spin(&(_iflr)->lr_lock)
108
109#define IFLR_CONVERT_LOCK(_iflr) do { \
110 IFLR_LOCK_ASSERT_HELD(_iflr); \
111 lck_mtx_convert_spin(&(_iflr)->lr_lock); \
112} while (0)
113
114#define IFLR_UNLOCK(_iflr) \
115 lck_mtx_unlock(&(_iflr)->lr_lock)
116
117#define IFLR_ADDREF(_iflr) \
118 iflr_addref(_iflr, 0)
119
120#define IFLR_ADDREF_LOCKED(_iflr) \
121 iflr_addref(_iflr, 1)
122
123#define IFLR_REMREF(_iflr) \
124 iflr_remref(_iflr)
125
126struct ifnet_llreach_info; /* forward declaration */
127
128extern void ifnet_llreach_ifattach(struct ifnet *, boolean_t);
129extern void ifnet_llreach_ifdetach(struct ifnet *);
130extern struct if_llreach *ifnet_llreach_alloc(struct ifnet *, u_int16_t, void *,
131 unsigned int, u_int32_t);
132extern void ifnet_llreach_free(struct if_llreach *);
133extern int ifnet_llreach_reachable(struct if_llreach *);
134extern int ifnet_llreach_reachable_delta(struct if_llreach *, u_int64_t);
135extern void ifnet_llreach_set_reachable(struct ifnet *, u_int16_t, void *,
136 unsigned int);
137extern u_int64_t ifnet_llreach_up2calexp(struct if_llreach *, u_int64_t);
138extern u_int64_t ifnet_llreach_up2upexp(struct if_llreach *, u_int64_t);
139extern int ifnet_llreach_get_defrouter(struct ifnet *, sa_family_t,
140 struct ifnet_llreach_info *);
141extern void ifnet_lr2ri(struct if_llreach *, struct rt_reach_info *);
142extern void ifnet_lr2iflri(struct if_llreach *, struct ifnet_llreach_info *);
143extern void ifnet_lr2lri(struct if_llreach *, struct if_llreach_info *);
144extern void iflr_addref(struct if_llreach *, int);
145extern void iflr_remref(struct if_llreach *);
146#endif /* XNU_KERNEL_PRIVATE */
147
148#ifdef __cplusplus
149}
150#endif
151#endif /* PRIVATE */
152#endif /* !_NET_IF_LLREACH_H_ */
153