1 /* SPDX-License-Identifier: BSD-2-Clause */ 2 /* 3 * dhcpcd - DHCP client daemon 4 * Copyright (c) 2006-2025 Roy Marples <roy (at) marples.name> 5 * All rights reserved 6 7 * Redistribution and use in source and binary forms, with or without 8 * modification, are permitted provided that the following conditions 9 * are met: 10 * 1. Redistributions of source code must retain the above copyright 11 * notice, this list of conditions and the following disclaimer. 12 * 2. Redistributions in binary form must reproduce the above copyright 13 * notice, this list of conditions and the following disclaimer in the 14 * documentation and/or other materials provided with the distribution. 15 * 16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 17 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 18 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 19 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 20 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 21 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 22 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 23 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 24 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26 * SUCH DAMAGE. 27 */ 28 29 #ifndef INTERFACE_H 30 #define INTERFACE_H 31 32 #include <net/if.h> 33 #include <net/route.h> /* for RTM_ADD et all */ 34 #include <netinet/in.h> 35 #ifdef BSD 36 #include <netinet/in_var.h> /* for IN_IFF_TENTATIVE et all */ 37 #endif 38 39 #include <ifaddrs.h> 40 41 /* If the interface does not support carrier status (ie PPP), 42 * dhcpcd can poll it for the relevant flags periodically */ 43 #define IF_POLL_UP 100 /* milliseconds */ 44 45 /* 46 * Systems which handle 1 address per alias. 47 * Currenly this is just Solaris. 48 * While Linux can do aliased addresses, it is only useful for their 49 * legacy ifconfig(8) tool which cannot display >1 IPv4 address 50 * (it can display many IPv6 addresses which makes the limitation odd). 51 * Linux has ip(8) which is a more feature rich tool, without the above 52 * restriction. 53 */ 54 #ifndef ALIAS_ADDR 55 # ifdef __sun 56 # define ALIAS_ADDR 57 # endif 58 #endif 59 60 #include "config.h" 61 62 /* POSIX defines ioctl request as an int, which Solaris and musl use. 63 * Everyone else use an unsigned long, which happens to be the bigger one 64 * so we use that in our on wire API. */ 65 #ifdef IOCTL_REQUEST_TYPE 66 typedef IOCTL_REQUEST_TYPE ioctl_request_t; 67 #else 68 typedef unsigned long ioctl_request_t; 69 #endif 70 71 #include "dhcpcd.h" 72 #include "ipv4.h" 73 #include "ipv6.h" 74 #include "route.h" 75 76 #define EUI64_ADDR_LEN 8 77 #define INFINIBAND_ADDR_LEN 20 78 79 /* Linux 2.4 doesn't define this */ 80 #ifndef ARPHRD_IEEE1394 81 # define ARPHRD_IEEE1394 24 82 #endif 83 84 /* The BSD's don't define this yet */ 85 #ifndef ARPHRD_INFINIBAND 86 # define ARPHRD_INFINIBAND 32 87 #endif 88 89 /* Maximum frame length. 90 * Support jumbo frames and some extra. */ 91 #define FRAMEHDRLEN_MAX 14 /* only ethernet support */ 92 #define FRAMELEN_MAX (FRAMEHDRLEN_MAX + 9216) 93 94 #define UDPLEN_MAX 64 * 1024 95 96 /* Work out if we have a private address or not 97 * 10/8 98 * 172.16/12 99 * 192.168/16 100 */ 101 #ifndef IN_PRIVATE 102 # define IN_PRIVATE(addr) (((addr & IN_CLASSA_NET) == 0x0a000000) || \ 103 ((addr & 0xfff00000) == 0xac100000) || \ 104 ((addr & IN_CLASSB_NET) == 0xc0a80000)) 105 #endif 106 107 #ifndef CLLADDR 108 #ifdef AF_LINK 109 # define CLLADDR(sdl) (const void *)((sdl)->sdl_data + (sdl)->sdl_nlen) 110 #endif 111 #endif 112 113 #ifdef __sun 114 /* Solaris stupidly defines this for compat with BSD 115 * but then ignores it. */ 116 #undef RTF_CLONING 117 118 /* This interface is busted on DilOS at least. 119 * It used to work, but lukily Solaris can fall back to 120 * IP_PKTINFO. */ 121 #undef IP_RECVIF 122 #endif 123 124 /* Private structures specific to an OS */ 125 #ifdef BSD 126 struct priv { 127 #ifdef INET6 128 int pf_inet6_fd; 129 #endif 130 #if defined(SIOCALIFADDR) && defined(IFLR_ACTIVE) /*NetBSD */ 131 int pf_link_fd; 132 #endif 133 }; 134 #endif 135 #ifdef __linux__ 136 struct priv { 137 int route_fd; 138 int generic_fd; 139 uint32_t route_pid; 140 }; 141 #endif 142 #ifdef __sun 143 struct priv { 144 #ifdef INET6 145 int pf_inet6_fd; 146 #endif 147 }; 148 #endif 149 150 #ifdef __sun 151 /* Solaris getifaddrs is very un-suitable for dhcpcd. 152 * See if-sun.c for details why. */ 153 struct ifaddrs; 154 int if_getifaddrs(struct ifaddrs **); 155 #define getifaddrs if_getifaddrs 156 int if_getsubnet(struct dhcpcd_ctx *, const char *, int, void *, size_t); 157 #endif 158 159 int if_ioctl(struct dhcpcd_ctx *, ioctl_request_t, void *, size_t); 160 #ifdef HAVE_PLEDGE 161 #define pioctl(ctx, req, data, len) if_ioctl((ctx), (req), (data), (len)) 162 #else 163 #define pioctl(ctx, req, data, len) ioctl((ctx)->pf_inet_fd, (req),(data),(len)) 164 #endif 165 int if_setflag(struct interface *, short, short); 166 int if_getmtu(const struct interface *); 167 #define if_up(ifp) if_setflag((ifp), (IFF_UP | IFF_RUNNING), 0) 168 #define if_down(ifp) if_setflag((ifp), 0, IFF_UP); 169 bool if_is_link_up(const struct interface *); 170 bool if_valid_hwaddr(const uint8_t *, size_t); 171 struct if_head *if_discover(struct dhcpcd_ctx *, struct ifaddrs **, 172 int, char * const *); 173 void if_freeifaddrs(struct dhcpcd_ctx *ctx, struct ifaddrs **); 174 void if_markaddrsstale(struct if_head *); 175 void if_learnaddrs(struct dhcpcd_ctx *, struct if_head *, struct ifaddrs **); 176 void if_deletestaleaddrs(struct if_head *); 177 struct interface *if_find(struct if_head *, const char *); 178 struct interface *if_findindex(struct if_head *, unsigned int); 179 struct interface *if_loopback(struct dhcpcd_ctx *); 180 void if_free(struct interface *); 181 int if_carrier(struct interface *, const void *); 182 bool if_roaming(struct interface *); 183 184 #ifdef ALIAS_ADDR 185 int if_makealias(char *, size_t, const char *, int); 186 #endif 187 188 int if_mtu_os(const struct interface *); 189 190 /* 191 * Helper to decode an interface name of bge0:1 to 192 * devname = bge0, drvname = bge0, ppa = 0, lun = 1. 193 * If ppa or lun are invalid they are set to -1. 194 */ 195 struct if_spec { 196 char ifname[IF_NAMESIZE]; 197 char devname[IF_NAMESIZE]; 198 char drvname[IF_NAMESIZE]; 199 int ppa; 200 int vlid; 201 int lun; 202 }; 203 int if_nametospec(const char *, struct if_spec *); 204 205 /* The below functions are provided by if-KERNEL.c */ 206 int os_init(void); 207 int if_conf(struct interface *); 208 int if_init(struct interface *); 209 int if_getssid(struct interface *); 210 int if_ignoregroup(int, const char *); 211 bool if_ignore(struct dhcpcd_ctx *, const char *); 212 int if_vimaster(struct dhcpcd_ctx *ctx, const char *); 213 unsigned short if_vlanid(const struct interface *); 214 char * if_getnetworknamespace(char *, size_t); /* used by udev */ 215 int if_opensockets(struct dhcpcd_ctx *); 216 int if_opensockets_os(struct dhcpcd_ctx *); 217 void if_closesockets(struct dhcpcd_ctx *); 218 void if_closesockets_os(struct dhcpcd_ctx *); 219 int if_handlelink(struct dhcpcd_ctx *); 220 int if_randomisemac(struct interface *); 221 int if_setmac(struct interface *ifp, void *, uint8_t); 222 223 /* dhcpcd uses the same routing flags as BSD. 224 * If the platform doesn't use these flags, 225 * map them in the platform interace file. */ 226 #ifndef RTM_ADD 227 #define RTM_ADD 0x1 /* Add Route */ 228 #define RTM_DELETE 0x2 /* Delete Route */ 229 #define RTM_CHANGE 0x3 /* Change Metrics or flags */ 230 #define RTM_GET 0x4 /* Report Metrics */ 231 #endif 232 233 /* Define SOCK_CLOEXEC and SOCK_NONBLOCK for systems that lack it. 234 * xsocket() in if.c will map them to fctnl FD_CLOEXEC and O_NONBLOCK. */ 235 #ifdef SOCK_CLOEXEC 236 # define HAVE_SOCK_CLOEXEC 237 #else 238 # define SOCK_CLOEXEC 0x10000000 239 #endif 240 #ifdef SOCK_NONBLOCK 241 # define HAVE_SOCK_NONBLOCK 242 #else 243 # define SOCK_NONBLOCK 0x20000000 244 #endif 245 #ifndef SOCK_CXNB 246 #define SOCK_CXNB SOCK_CLOEXEC | SOCK_NONBLOCK 247 #endif 248 int xsocket(int, int, int); 249 int xsocketpair(int, int, int, int[2]); 250 251 int if_route(unsigned char, const struct rt *rt); 252 int if_initrt(struct dhcpcd_ctx *, rb_tree_t *, int); 253 254 int if_missfilter(struct interface *, struct sockaddr *); 255 int if_missfilter_apply(struct dhcpcd_ctx *); 256 257 #ifdef INET 258 int if_address(unsigned char, const struct ipv4_addr *); 259 int if_addrflags(const struct interface *, const struct in_addr *, 260 const char *); 261 262 #endif 263 264 #ifdef INET6 265 void if_disable_rtadv(void); 266 void if_setup_inet6(const struct interface *); 267 int ip6_forwarding(const char *ifname); 268 269 struct ra; 270 struct ipv6_addr; 271 272 int if_applyra(const struct ra *); 273 int if_address6(unsigned char, const struct ipv6_addr *); 274 int if_addrflags6(const struct interface *, const struct in6_addr *, 275 const char *); 276 int if_getlifetime6(struct ipv6_addr *); 277 278 #else 279 #define if_checkipv6(a, b, c) (-1) 280 #endif 281 282 int if_machinearch(char *, size_t); 283 struct interface *if_findifpfromcmsg(struct dhcpcd_ctx *, 284 struct msghdr *, int *); 285 286 #ifdef __linux__ 287 int if_linksocket(struct sockaddr_nl *, int, int); 288 int if_getnetlink(struct dhcpcd_ctx *, struct iovec *, int, int, 289 int (*)(struct dhcpcd_ctx *, void *, struct nlmsghdr *), void *); 290 #endif 291 #endif 292
Indexes created Fri Jun 19 00:25:02 UTC 2026