Line data Source code
1 : /* SPDX-License-Identifier: LGPL-2.1+ */
2 : #ifndef foosdndiscfoo
3 : #define foosdndiscfoo
4 :
5 : /***
6 : Copyright © 2014 Intel Corporation. All rights reserved.
7 :
8 : systemd is free software; you can redistribute it and/or modify it
9 : under the terms of the GNU Lesser General Public License as published by
10 : the Free Software Foundation; either version 2.1 of the License, or
11 : (at your option) any later version.
12 :
13 : systemd is distributed in the hope that it will be useful, but
14 : WITHOUT ANY WARRANTY; without even the implied warranty of
15 : MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 : Lesser General Public License for more details.
17 :
18 : You should have received a copy of the GNU Lesser General Public License
19 : along with systemd; If not, see <http://www.gnu.org/licenses/>.
20 : ***/
21 :
22 : #include <inttypes.h>
23 : #include <net/ethernet.h>
24 : #include <netinet/in.h>
25 : #include <sys/types.h>
26 :
27 : #include "sd-event.h"
28 :
29 : #include "_sd-common.h"
30 :
31 : _SD_BEGIN_DECLARATIONS;
32 :
33 : /* Neightbor Discovery Options, RFC 4861, Section 4.6 and
34 : * https://www.iana.org/assignments/icmpv6-parameters/icmpv6-parameters.xhtml#icmpv6-parameters-5 */
35 : enum {
36 : SD_NDISC_OPTION_SOURCE_LL_ADDRESS = 1,
37 : SD_NDISC_OPTION_TARGET_LL_ADDRESS = 2,
38 : SD_NDISC_OPTION_PREFIX_INFORMATION = 3,
39 : SD_NDISC_OPTION_MTU = 5,
40 : SD_NDISC_OPTION_ROUTE_INFORMATION = 24,
41 : SD_NDISC_OPTION_RDNSS = 25,
42 : SD_NDISC_OPTION_FLAGS_EXTENSION = 26,
43 : SD_NDISC_OPTION_DNSSL = 31,
44 : SD_NDISC_OPTION_CAPTIVE_PORTAL = 37,
45 : };
46 :
47 : /* Route preference, RFC 4191, Section 2.1 */
48 : enum {
49 : SD_NDISC_PREFERENCE_LOW = 3U,
50 : SD_NDISC_PREFERENCE_MEDIUM = 0U,
51 : SD_NDISC_PREFERENCE_HIGH = 1U,
52 : };
53 :
54 : typedef struct sd_ndisc sd_ndisc;
55 : typedef struct sd_ndisc_router sd_ndisc_router;
56 :
57 : typedef enum sd_ndisc_event {
58 : SD_NDISC_EVENT_TIMEOUT,
59 : SD_NDISC_EVENT_ROUTER,
60 : _SD_NDISC_EVENT_MAX,
61 : _SD_NDISC_EVENT_INVALID = -1,
62 : } sd_ndisc_event;
63 :
64 : typedef void (*sd_ndisc_callback_t)(sd_ndisc *nd, sd_ndisc_event event, sd_ndisc_router *rt, void *userdata);
65 :
66 : int sd_ndisc_new(sd_ndisc **ret);
67 : sd_ndisc *sd_ndisc_ref(sd_ndisc *nd);
68 : sd_ndisc *sd_ndisc_unref(sd_ndisc *nd);
69 :
70 : int sd_ndisc_start(sd_ndisc *nd);
71 : int sd_ndisc_stop(sd_ndisc *nd);
72 :
73 : int sd_ndisc_attach_event(sd_ndisc *nd, sd_event *event, int64_t priority);
74 : int sd_ndisc_detach_event(sd_ndisc *nd);
75 : sd_event *sd_ndisc_get_event(sd_ndisc *nd);
76 :
77 : int sd_ndisc_set_callback(sd_ndisc *nd, sd_ndisc_callback_t cb, void *userdata);
78 : int sd_ndisc_set_ifindex(sd_ndisc *nd, int interface_index);
79 : int sd_ndisc_set_mac(sd_ndisc *nd, const struct ether_addr *mac_addr);
80 :
81 : int sd_ndisc_get_mtu(sd_ndisc *nd, uint32_t *ret);
82 : int sd_ndisc_get_hop_limit(sd_ndisc *nd, uint8_t *ret);
83 :
84 : int sd_ndisc_router_from_raw(sd_ndisc_router **ret, const void *raw, size_t raw_size);
85 : sd_ndisc_router *sd_ndisc_router_ref(sd_ndisc_router *rt);
86 : sd_ndisc_router *sd_ndisc_router_unref(sd_ndisc_router *rt);
87 :
88 : int sd_ndisc_router_get_address(sd_ndisc_router *rt, struct in6_addr *ret_addr);
89 : int sd_ndisc_router_get_timestamp(sd_ndisc_router *rt, clockid_t clock, uint64_t *ret);
90 : int sd_ndisc_router_get_raw(sd_ndisc_router *rt, const void **ret, size_t *size);
91 :
92 : int sd_ndisc_router_get_hop_limit(sd_ndisc_router *rt, uint8_t *ret);
93 : int sd_ndisc_router_get_flags(sd_ndisc_router *rt, uint64_t *ret_flags);
94 : int sd_ndisc_router_get_preference(sd_ndisc_router *rt, unsigned *ret);
95 : int sd_ndisc_router_get_lifetime(sd_ndisc_router *rt, uint16_t *ret_lifetime);
96 : int sd_ndisc_router_get_mtu(sd_ndisc_router *rt, uint32_t *ret);
97 :
98 : /* Generic option access */
99 : int sd_ndisc_router_option_rewind(sd_ndisc_router *rt);
100 : int sd_ndisc_router_option_next(sd_ndisc_router *rt);
101 : int sd_ndisc_router_option_get_type(sd_ndisc_router *rt, uint8_t *ret);
102 : int sd_ndisc_router_option_is_type(sd_ndisc_router *rt, uint8_t type);
103 : int sd_ndisc_router_option_get_raw(sd_ndisc_router *rt, const void **ret, size_t *size);
104 :
105 : /* Specific option access: SD_NDISC_OPTION_PREFIX_INFORMATION */
106 : int sd_ndisc_router_prefix_get_valid_lifetime(sd_ndisc_router *rt, uint32_t *ret);
107 : int sd_ndisc_router_prefix_get_preferred_lifetime(sd_ndisc_router *rt, uint32_t *ret);
108 : int sd_ndisc_router_prefix_get_flags(sd_ndisc_router *rt, uint8_t *ret);
109 : int sd_ndisc_router_prefix_get_address(sd_ndisc_router *rt, struct in6_addr *ret_addr);
110 : int sd_ndisc_router_prefix_get_prefixlen(sd_ndisc_router *rt, unsigned *prefixlen);
111 :
112 : /* Specific option access: SD_NDISC_OPTION_ROUTE_INFORMATION */
113 : int sd_ndisc_router_route_get_lifetime(sd_ndisc_router *rt, uint32_t *ret);
114 : int sd_ndisc_router_route_get_address(sd_ndisc_router *rt, struct in6_addr *ret_addr);
115 : int sd_ndisc_router_route_get_prefixlen(sd_ndisc_router *rt, unsigned *prefixlen);
116 : int sd_ndisc_router_route_get_preference(sd_ndisc_router *rt, unsigned *ret);
117 :
118 : /* Specific option access: SD_NDISC_OPTION_RDNSS */
119 : int sd_ndisc_router_rdnss_get_addresses(sd_ndisc_router *rt, const struct in6_addr **ret);
120 : int sd_ndisc_router_rdnss_get_lifetime(sd_ndisc_router *rt, uint32_t *ret);
121 :
122 : /* Specific option access: SD_NDISC_OPTION_DNSSL */
123 : int sd_ndisc_router_dnssl_get_domains(sd_ndisc_router *rt, char ***ret);
124 : int sd_ndisc_router_dnssl_get_lifetime(sd_ndisc_router *rt, uint32_t *ret);
125 :
126 2 : _SD_DEFINE_POINTER_CLEANUP_FUNC(sd_ndisc, sd_ndisc_unref);
127 5 : _SD_DEFINE_POINTER_CLEANUP_FUNC(sd_ndisc_router, sd_ndisc_router_unref);
128 :
129 : _SD_END_DECLARATIONS;
130 :
131 : #endif
|
