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
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#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
74struct 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
96RB_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
128struct ifnet_llreach_info; /* forward declaration */
129
130extern void ifnet_llreach_init(void);
131extern void ifnet_llreach_ifattach(struct ifnet *, boolean_t);
132extern void ifnet_llreach_ifdetach(struct ifnet *);
133extern struct if_llreach *ifnet_llreach_alloc(struct ifnet *, u_int16_t, void *,
134 unsigned int, u_int64_t);
135extern void ifnet_llreach_free(struct if_llreach *);
136extern int ifnet_llreach_reachable(struct if_llreach *);
137extern int ifnet_llreach_reachable_delta(struct if_llreach *, u_int64_t);
138extern void ifnet_llreach_set_reachable(struct ifnet *, u_int16_t, void *,
139 unsigned int);
140extern u_int64_t ifnet_llreach_up2calexp(struct if_llreach *, u_int64_t);
141extern u_int64_t ifnet_llreach_up2upexp(struct if_llreach *, u_int64_t);
142extern int ifnet_llreach_get_defrouter(struct ifnet *, int,
143 struct ifnet_llreach_info *);
144extern void ifnet_lr2ri(struct if_llreach *, struct rt_reach_info *);
145extern void ifnet_lr2iflri(struct if_llreach *, struct ifnet_llreach_info *);
146extern void ifnet_lr2lri(struct if_llreach *, struct if_llreach_info *);
147extern void iflr_addref(struct if_llreach *, int);
148extern 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_ */
156