OSDN Git Service

e4b7cc1f3f0db8232aacef09f1e2339df7ca1086
[android-x86/system-netd.git] / server / RouteController.cpp
1 /*
2  * Copyright (C) 2014 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16
17 #include "RouteController.h"
18
19 #include <arpa/inet.h>
20 #include <errno.h>
21 #include <fcntl.h>
22 #include <linux/fib_rules.h>
23 #include <net/if.h>
24 #include <sys/stat.h>
25
26 #include <private/android_filesystem_config.h>
27
28 #include <map>
29
30 #include "Fwmark.h"
31 #include "UidRanges.h"
32 #include "DummyNetwork.h"
33
34 #include "android-base/file.h"
35 #define LOG_TAG "Netd"
36 #include "log/log.h"
37 #include "logwrap/logwrap.h"
38 #include "netutils/ifc.h"
39 #include "resolv_netid.h"
40
41 using android::base::WriteStringToFile;
42
43 namespace {
44
45 // BEGIN CONSTANTS --------------------------------------------------------------------------------
46
47 const uint32_t RULE_PRIORITY_VPN_OVERRIDE_SYSTEM = 10000;
48 const uint32_t RULE_PRIORITY_VPN_OVERRIDE_OIF    = 10500;
49 const uint32_t RULE_PRIORITY_VPN_OUTPUT_TO_LOCAL = 11000;
50 const uint32_t RULE_PRIORITY_SECURE_VPN          = 12000;
51 const uint32_t RULE_PRIORITY_EXPLICIT_NETWORK    = 13000;
52 const uint32_t RULE_PRIORITY_OUTPUT_INTERFACE    = 14000;
53 const uint32_t RULE_PRIORITY_LEGACY_SYSTEM       = 15000;
54 const uint32_t RULE_PRIORITY_LEGACY_NETWORK      = 16000;
55 const uint32_t RULE_PRIORITY_LOCAL_NETWORK       = 17000;
56 const uint32_t RULE_PRIORITY_TETHERING           = 18000;
57 const uint32_t RULE_PRIORITY_IMPLICIT_NETWORK    = 19000;
58 const uint32_t RULE_PRIORITY_BYPASSABLE_VPN      = 20000;
59 const uint32_t RULE_PRIORITY_VPN_FALLTHROUGH     = 21000;
60 const uint32_t RULE_PRIORITY_DEFAULT_NETWORK     = 22000;
61 const uint32_t RULE_PRIORITY_DIRECTLY_CONNECTED  = 23000;
62 const uint32_t RULE_PRIORITY_UNREACHABLE         = 32000;
63
64 const uint32_t ROUTE_TABLE_LOCAL_NETWORK  = 97;
65 const uint32_t ROUTE_TABLE_LEGACY_NETWORK = 98;
66 const uint32_t ROUTE_TABLE_LEGACY_SYSTEM  = 99;
67
68 const char* const ROUTE_TABLE_NAME_LOCAL_NETWORK  = "local_network";
69 const char* const ROUTE_TABLE_NAME_LEGACY_NETWORK = "legacy_network";
70 const char* const ROUTE_TABLE_NAME_LEGACY_SYSTEM  = "legacy_system";
71
72 const char* const ROUTE_TABLE_NAME_LOCAL = "local";
73 const char* const ROUTE_TABLE_NAME_MAIN  = "main";
74
75 // TODO: These values aren't defined by the Linux kernel, because our UID routing changes are not
76 // upstream (yet?), so we can't just pick them up from kernel headers. When (if?) the changes make
77 // it upstream, we'll remove this and rely on the kernel header values. For now, add a static assert
78 // that will warn us if upstream has given these values some other meaning.
79 const uint16_t FRA_UID_START = 18;
80 const uint16_t FRA_UID_END   = 19;
81 static_assert(FRA_UID_START > FRA_MAX,
82              "Android-specific FRA_UID_{START,END} values also assigned in Linux uapi. "
83              "Check that these values match what the kernel does and then update this assertion.");
84
85 const uint16_t NETLINK_REQUEST_FLAGS = NLM_F_REQUEST | NLM_F_ACK;
86 const uint16_t NETLINK_CREATE_REQUEST_FLAGS = NETLINK_REQUEST_FLAGS | NLM_F_CREATE | NLM_F_EXCL;
87
88 const sockaddr_nl NETLINK_ADDRESS = {AF_NETLINK, 0, 0, 0};
89
90 const uint8_t AF_FAMILIES[] = {AF_INET, AF_INET6};
91
92 const char* const IP_VERSIONS[] = {"-4", "-6"};
93
94 const uid_t UID_ROOT = 0;
95 const char* const IIF_LOOPBACK = "lo";
96 const char* const IIF_NONE = NULL;
97 const char* const OIF_NONE = NULL;
98 const bool ACTION_ADD = true;
99 const bool ACTION_DEL = false;
100 const bool MODIFY_NON_UID_BASED_RULES = true;
101
102 const char* const RT_TABLES_PATH = "/data/misc/net/rt_tables";
103 const mode_t RT_TABLES_MODE = S_IRUSR | S_IWUSR | S_IRGRP | S_IROTH;  // mode 0644, rw-r--r--
104
105 const unsigned ROUTE_FLUSH_ATTEMPTS = 2;
106
107 // Avoids "non-constant-expression cannot be narrowed from type 'unsigned int' to 'unsigned short'"
108 // warnings when using RTA_LENGTH(x) inside static initializers (even when x is already uint16_t).
109 constexpr uint16_t U16_RTA_LENGTH(uint16_t x) {
110     return RTA_LENGTH(x);
111 }
112
113 // These are practically const, but can't be declared so, because they are used to initialize
114 // non-const pointers ("void* iov_base") in iovec arrays.
115 rtattr FRATTR_PRIORITY  = { U16_RTA_LENGTH(sizeof(uint32_t)), FRA_PRIORITY };
116 rtattr FRATTR_TABLE     = { U16_RTA_LENGTH(sizeof(uint32_t)), FRA_TABLE };
117 rtattr FRATTR_FWMARK    = { U16_RTA_LENGTH(sizeof(uint32_t)), FRA_FWMARK };
118 rtattr FRATTR_FWMASK    = { U16_RTA_LENGTH(sizeof(uint32_t)), FRA_FWMASK };
119 rtattr FRATTR_UID_START = { U16_RTA_LENGTH(sizeof(uid_t)),    FRA_UID_START };
120 rtattr FRATTR_UID_END   = { U16_RTA_LENGTH(sizeof(uid_t)),    FRA_UID_END };
121
122 rtattr RTATTR_TABLE     = { U16_RTA_LENGTH(sizeof(uint32_t)), RTA_TABLE };
123 rtattr RTATTR_OIF       = { U16_RTA_LENGTH(sizeof(uint32_t)), RTA_OIF };
124
125 uint8_t PADDING_BUFFER[RTA_ALIGNTO] = {0, 0, 0, 0};
126
127 // END CONSTANTS ----------------------------------------------------------------------------------
128
129 // No locks needed because RouteController is accessed only from one thread (in CommandListener).
130 std::map<std::string, uint32_t> interfaceToTable;
131
132 uint32_t getRouteTableForInterface(const char* interface) {
133     uint32_t index = if_nametoindex(interface);
134     if (index) {
135         index += RouteController::ROUTE_TABLE_OFFSET_FROM_INDEX;
136         interfaceToTable[interface] = index;
137         return index;
138     }
139     // If the interface goes away if_nametoindex() will return 0 but we still need to know
140     // the index so we can remove the rules and routes.
141     auto iter = interfaceToTable.find(interface);
142     if (iter == interfaceToTable.end()) {
143         ALOGE("cannot find interface %s", interface);
144         return RT_TABLE_UNSPEC;
145     }
146     return iter->second;
147 }
148
149 void addTableName(uint32_t table, const std::string& name, std::string* contents) {
150     char tableString[UINT32_STRLEN];
151     snprintf(tableString, sizeof(tableString), "%u", table);
152     *contents += tableString;
153     *contents += " ";
154     *contents += name;
155     *contents += "\n";
156 }
157
158 // Doesn't return success/failure as the file is optional; it's okay if we fail to update it.
159 void updateTableNamesFile() {
160     std::string contents;
161
162     addTableName(RT_TABLE_LOCAL, ROUTE_TABLE_NAME_LOCAL, &contents);
163     addTableName(RT_TABLE_MAIN,  ROUTE_TABLE_NAME_MAIN,  &contents);
164
165     addTableName(ROUTE_TABLE_LOCAL_NETWORK,  ROUTE_TABLE_NAME_LOCAL_NETWORK,  &contents);
166     addTableName(ROUTE_TABLE_LEGACY_NETWORK, ROUTE_TABLE_NAME_LEGACY_NETWORK, &contents);
167     addTableName(ROUTE_TABLE_LEGACY_SYSTEM,  ROUTE_TABLE_NAME_LEGACY_SYSTEM,  &contents);
168
169     for (const auto& entry : interfaceToTable) {
170         addTableName(entry.second, entry.first, &contents);
171     }
172
173     if (!WriteStringToFile(contents, RT_TABLES_PATH, RT_TABLES_MODE, AID_SYSTEM, AID_WIFI)) {
174         ALOGE("failed to write to %s (%s)", RT_TABLES_PATH, strerror(errno));
175         return;
176     }
177 }
178
179 // Sends a netlink request and expects an ack.
180 // |iov| is an array of struct iovec that contains the netlink message payload.
181 // The netlink header is generated by this function based on |action| and |flags|.
182 // Returns -errno if there was an error or if the kernel reported an error.
183
184 // Disable optimizations in ASan build.
185 // ASan reports an out-of-bounds 32-bit(!) access in the first loop of the
186 // function (over iov[]).
187 #ifdef __clang__
188 #if __has_feature(address_sanitizer)
189 __attribute__((optnone))
190 #endif
191 #endif
192 WARN_UNUSED_RESULT int sendNetlinkRequest(uint16_t action, uint16_t flags, iovec* iov, int iovlen) {
193     nlmsghdr nlmsg = {
194         .nlmsg_type = action,
195         .nlmsg_flags = flags,
196     };
197     iov[0].iov_base = &nlmsg;
198     iov[0].iov_len = sizeof(nlmsg);
199     for (int i = 0; i < iovlen; ++i) {
200         nlmsg.nlmsg_len += iov[i].iov_len;
201     }
202
203     int ret;
204     struct {
205         nlmsghdr msg;
206         nlmsgerr err;
207     } response;
208
209     int sock = socket(AF_NETLINK, SOCK_DGRAM | SOCK_CLOEXEC, NETLINK_ROUTE);
210     if (sock != -1 &&
211             connect(sock, reinterpret_cast<const sockaddr*>(&NETLINK_ADDRESS),
212                     sizeof(NETLINK_ADDRESS)) != -1 &&
213             writev(sock, iov, iovlen) != -1 &&
214             (ret = recv(sock, &response, sizeof(response), 0)) != -1) {
215         if (ret == sizeof(response)) {
216             ret = response.err.error;  // Netlink errors are negative errno.
217             if (ret) {
218                 ALOGE("netlink response contains error (%s)", strerror(-ret));
219             }
220         } else {
221             ALOGE("bad netlink response message size (%d != %zu)", ret, sizeof(response));
222             ret = -EBADMSG;
223         }
224     } else {
225         ALOGE("netlink socket/connect/writev/recv failed (%s)", strerror(errno));
226         ret = -errno;
227     }
228
229     if (sock != -1) {
230         close(sock);
231     }
232
233     return ret;
234 }
235
236 // Returns 0 on success or negative errno on failure.
237 int padInterfaceName(const char* input, char* name, size_t* length, uint16_t* padding) {
238     if (!input) {
239         *length = 0;
240         *padding = 0;
241         return 0;
242     }
243     *length = strlcpy(name, input, IFNAMSIZ) + 1;
244     if (*length > IFNAMSIZ) {
245         ALOGE("interface name too long (%zu > %u)", *length, IFNAMSIZ);
246         return -ENAMETOOLONG;
247     }
248     *padding = RTA_SPACE(*length) - RTA_LENGTH(*length);
249     return 0;
250 }
251
252 // Adds or removes a routing rule for IPv4 and IPv6.
253 //
254 // + If |priority| is RULE_PRIORITY_UNREACHABLE, the rule returns ENETUNREACH (i.e., specifies an
255 //   action of FR_ACT_UNREACHABLE). Otherwise, the rule specifies an action of FR_ACT_TO_TBL.
256 // + If |table| is non-zero, the rule points at the specified routing table. Otherwise, the table is
257 //   unspecified. An unspecified table is only allowed when deleting a rule.
258 // + If |mask| is non-zero, the rule matches the specified fwmark and mask. Otherwise, |fwmark| is
259 //   ignored.
260 // + If |iif| is non-NULL, the rule matches the specified incoming interface.
261 // + If |oif| is non-NULL, the rule matches the specified outgoing interface.
262 // + If |uidStart| and |uidEnd| are not INVALID_UID, the rule matches packets from UIDs in that
263 //   range (inclusive). Otherwise, the rule matches packets from all UIDs.
264 //
265 // Returns 0 on success or negative errno on failure.
266 WARN_UNUSED_RESULT int modifyIpRule(uint16_t action, uint32_t priority, uint32_t table,
267                                     uint32_t fwmark, uint32_t mask, const char* iif,
268                                     const char* oif, uid_t uidStart, uid_t uidEnd) {
269     // Ensure that if you set a bit in the fwmark, it's not being ignored by the mask.
270     if (fwmark & ~mask) {
271         ALOGE("mask 0x%x does not select all the bits set in fwmark 0x%x", mask, fwmark);
272         return -ERANGE;
273     }
274
275     // Interface names must include exactly one terminating NULL and be properly padded, or older
276     // kernels will refuse to delete rules.
277     char iifName[IFNAMSIZ], oifName[IFNAMSIZ];
278     size_t iifLength, oifLength;
279     uint16_t iifPadding, oifPadding;
280     if (int ret = padInterfaceName(iif, iifName, &iifLength, &iifPadding)) {
281         return ret;
282     }
283     if (int ret = padInterfaceName(oif, oifName, &oifLength, &oifPadding)) {
284         return ret;
285     }
286
287     // Either both start and end UID must be specified, or neither.
288     if ((uidStart == INVALID_UID) != (uidEnd == INVALID_UID)) {
289         ALOGE("incompatible start and end UIDs (%u vs %u)", uidStart, uidEnd);
290         return -EUSERS;
291     }
292     bool isUidRule = (uidStart != INVALID_UID);
293
294     // Assemble a rule request and put it in an array of iovec structures.
295     fib_rule_hdr rule = {
296         .action = static_cast<uint8_t>(priority != RULE_PRIORITY_UNREACHABLE ? FR_ACT_TO_TBL :
297                                                                                FR_ACT_UNREACHABLE),
298         // Note that here we're implicitly setting rule.table to 0. When we want to specify a
299         // non-zero table, we do this via the FRATTR_TABLE attribute.
300     };
301
302     // Don't ever create a rule that looks up table 0, because table 0 is the local table.
303     // It's OK to specify a table ID of 0 when deleting a rule, because that doesn't actually select
304     // table 0, it's a wildcard that matches anything.
305     if (table == RT_TABLE_UNSPEC && rule.action == FR_ACT_TO_TBL && action != RTM_DELRULE) {
306         ALOGE("RT_TABLE_UNSPEC only allowed when deleting rules");
307         return -ENOTUNIQ;
308     }
309
310     rtattr fraIifName = { U16_RTA_LENGTH(iifLength), FRA_IIFNAME };
311     rtattr fraOifName = { U16_RTA_LENGTH(oifLength), FRA_OIFNAME };
312
313     iovec iov[] = {
314         { NULL,              0 },
315         { &rule,             sizeof(rule) },
316         { &FRATTR_PRIORITY,  sizeof(FRATTR_PRIORITY) },
317         { &priority,         sizeof(priority) },
318         { &FRATTR_TABLE,     table != RT_TABLE_UNSPEC ? sizeof(FRATTR_TABLE) : 0 },
319         { &table,            table != RT_TABLE_UNSPEC ? sizeof(table) : 0 },
320         { &FRATTR_FWMARK,    mask ? sizeof(FRATTR_FWMARK) : 0 },
321         { &fwmark,           mask ? sizeof(fwmark) : 0 },
322         { &FRATTR_FWMASK,    mask ? sizeof(FRATTR_FWMASK) : 0 },
323         { &mask,             mask ? sizeof(mask) : 0 },
324         { &FRATTR_UID_START, isUidRule ? sizeof(FRATTR_UID_START) : 0 },
325         { &uidStart,         isUidRule ? sizeof(uidStart) : 0 },
326         { &FRATTR_UID_END,   isUidRule ? sizeof(FRATTR_UID_END) : 0 },
327         { &uidEnd,           isUidRule ? sizeof(uidEnd) : 0 },
328         { &fraIifName,       iif != IIF_NONE ? sizeof(fraIifName) : 0 },
329         { iifName,           iifLength },
330         { PADDING_BUFFER,    iifPadding },
331         { &fraOifName,       oif != OIF_NONE ? sizeof(fraOifName) : 0 },
332         { oifName,           oifLength },
333         { PADDING_BUFFER,    oifPadding },
334     };
335
336     uint16_t flags = (action == RTM_NEWRULE) ? NETLINK_CREATE_REQUEST_FLAGS : NETLINK_REQUEST_FLAGS;
337     for (size_t i = 0; i < ARRAY_SIZE(AF_FAMILIES); ++i) {
338         rule.family = AF_FAMILIES[i];
339         if (int ret = sendNetlinkRequest(action, flags, iov, ARRAY_SIZE(iov))) {
340             return ret;
341         }
342     }
343
344     return 0;
345 }
346
347 WARN_UNUSED_RESULT int modifyIpRule(uint16_t action, uint32_t priority, uint32_t table,
348                                     uint32_t fwmark, uint32_t mask) {
349     return modifyIpRule(action, priority, table, fwmark, mask, IIF_NONE, OIF_NONE, INVALID_UID,
350                         INVALID_UID);
351 }
352
353 // Adds or deletes an IPv4 or IPv6 route.
354 // Returns 0 on success or negative errno on failure.
355 WARN_UNUSED_RESULT int modifyIpRoute(uint16_t action, uint32_t table, const char* interface,
356                                      const char* destination, const char* nexthop) {
357     // At least the destination must be non-null.
358     if (!destination) {
359         ALOGE("null destination");
360         return -EFAULT;
361     }
362
363     // Parse the prefix.
364     uint8_t rawAddress[sizeof(in6_addr)];
365     uint8_t family;
366     uint8_t prefixLength;
367     int rawLength = parsePrefix(destination, &family, rawAddress, sizeof(rawAddress),
368                                 &prefixLength);
369     if (rawLength < 0) {
370         ALOGE("parsePrefix failed for destination %s (%s)", destination, strerror(-rawLength));
371         return rawLength;
372     }
373
374     if (static_cast<size_t>(rawLength) > sizeof(rawAddress)) {
375         ALOGE("impossible! address too long (%d vs %zu)", rawLength, sizeof(rawAddress));
376         return -ENOBUFS;  // Cannot happen; parsePrefix only supports IPv4 and IPv6.
377     }
378
379     uint8_t type = RTN_UNICAST;
380     uint32_t ifindex;
381     uint8_t rawNexthop[sizeof(in6_addr)];
382
383     if (nexthop && !strcmp(nexthop, "unreachable")) {
384         type = RTN_UNREACHABLE;
385         // 'interface' is likely non-NULL, as the caller (modifyRoute()) likely used it to lookup
386         // the table number. But it's an error to specify an interface ("dev ...") or a nexthop for
387         // unreachable routes, so nuke them. (IPv6 allows them to be specified; IPv4 doesn't.)
388         interface = OIF_NONE;
389         nexthop = NULL;
390     } else if (nexthop && !strcmp(nexthop, "throw")) {
391         type = RTN_THROW;
392         interface = OIF_NONE;
393         nexthop = NULL;
394     } else {
395         // If an interface was specified, find the ifindex.
396         if (interface != OIF_NONE) {
397             ifindex = if_nametoindex(interface);
398             if (!ifindex) {
399                 ALOGE("cannot find interface %s", interface);
400                 return -ENODEV;
401             }
402         }
403
404         // If a nexthop was specified, parse it as the same family as the prefix.
405         if (nexthop && inet_pton(family, nexthop, rawNexthop) <= 0) {
406             ALOGE("inet_pton failed for nexthop %s", nexthop);
407             return -EINVAL;
408         }
409     }
410
411     // Assemble a rtmsg and put it in an array of iovec structures.
412     rtmsg route = {
413         .rtm_protocol = RTPROT_STATIC,
414         .rtm_type = type,
415         .rtm_family = family,
416         .rtm_dst_len = prefixLength,
417         .rtm_scope = static_cast<uint8_t>(nexthop ? RT_SCOPE_UNIVERSE : RT_SCOPE_LINK),
418     };
419
420     rtattr rtaDst     = { U16_RTA_LENGTH(rawLength), RTA_DST };
421     rtattr rtaGateway = { U16_RTA_LENGTH(rawLength), RTA_GATEWAY };
422
423     iovec iov[] = {
424         { NULL,          0 },
425         { &route,        sizeof(route) },
426         { &RTATTR_TABLE, sizeof(RTATTR_TABLE) },
427         { &table,        sizeof(table) },
428         { &rtaDst,       sizeof(rtaDst) },
429         { rawAddress,    static_cast<size_t>(rawLength) },
430         { &RTATTR_OIF,   interface != OIF_NONE ? sizeof(RTATTR_OIF) : 0 },
431         { &ifindex,      interface != OIF_NONE ? sizeof(ifindex) : 0 },
432         { &rtaGateway,   nexthop ? sizeof(rtaGateway) : 0 },
433         { rawNexthop,    nexthop ? static_cast<size_t>(rawLength) : 0 },
434     };
435
436     uint16_t flags = (action == RTM_NEWROUTE) ? NETLINK_CREATE_REQUEST_FLAGS :
437                                                 NETLINK_REQUEST_FLAGS;
438     return sendNetlinkRequest(action, flags, iov, ARRAY_SIZE(iov));
439 }
440
441 // An iptables rule to mark incoming packets on a network with the netId of the network.
442 //
443 // This is so that the kernel can:
444 // + Use the right fwmark for (and thus correctly route) replies (e.g.: TCP RST, ICMP errors, ping
445 //   replies, SYN-ACKs, etc).
446 // + Mark sockets that accept connections from this interface so that the connection stays on the
447 //   same interface.
448 WARN_UNUSED_RESULT int modifyIncomingPacketMark(unsigned netId, const char* interface,
449                                                 Permission permission, bool add) {
450     Fwmark fwmark;
451
452     fwmark.netId = netId;
453     fwmark.explicitlySelected = true;
454     fwmark.protectedFromVpn = true;
455     fwmark.permission = permission;
456
457     char markString[UINT32_HEX_STRLEN];
458     snprintf(markString, sizeof(markString), "0x%x", fwmark.intValue);
459
460     if (execIptables(V4V6, "-t", "mangle", add ? "-A" : "-D", "INPUT", "-i", interface, "-j",
461                      "MARK", "--set-mark", markString, NULL)) {
462         ALOGE("failed to change iptables rule that sets incoming packet mark");
463         return -EREMOTEIO;
464     }
465
466     return 0;
467 }
468
469 // A rule to route responses to the local network forwarded via the VPN.
470 //
471 // When a VPN is in effect, packets from the local network to upstream networks are forwarded into
472 // the VPN's tunnel interface. When the VPN forwards the responses, they emerge out of the tunnel.
473 WARN_UNUSED_RESULT int modifyVpnOutputToLocalRule(const char* vpnInterface, bool add) {
474     return modifyIpRule(add ? RTM_NEWRULE : RTM_DELRULE, RULE_PRIORITY_VPN_OUTPUT_TO_LOCAL,
475                         ROUTE_TABLE_LOCAL_NETWORK, MARK_UNSET, MARK_UNSET, vpnInterface, OIF_NONE,
476                         INVALID_UID, INVALID_UID);
477 }
478
479 // A rule to route all traffic from a given set of UIDs to go over the VPN.
480 //
481 // Notice that this rule doesn't use the netId. I.e., no matter what netId the user's socket may
482 // have, if they are subject to this VPN, their traffic has to go through it. Allows the traffic to
483 // bypass the VPN if the protectedFromVpn bit is set.
484 WARN_UNUSED_RESULT int modifyVpnUidRangeRule(uint32_t table, uid_t uidStart, uid_t uidEnd,
485                                              bool secure, bool add) {
486     Fwmark fwmark;
487     Fwmark mask;
488
489     fwmark.protectedFromVpn = false;
490     mask.protectedFromVpn = true;
491
492     uint32_t priority;
493
494     if (secure) {
495         priority = RULE_PRIORITY_SECURE_VPN;
496     } else {
497         priority = RULE_PRIORITY_BYPASSABLE_VPN;
498
499         fwmark.explicitlySelected = false;
500         mask.explicitlySelected = true;
501     }
502
503     return modifyIpRule(add ? RTM_NEWRULE : RTM_DELRULE, priority, table, fwmark.intValue,
504                         mask.intValue, IIF_LOOPBACK, OIF_NONE, uidStart, uidEnd);
505 }
506
507 // A rule to allow system apps to send traffic over this VPN even if they are not part of the target
508 // set of UIDs.
509 //
510 // This is needed for DnsProxyListener to correctly resolve a request for a user who is in the
511 // target set, but where the DnsProxyListener itself is not.
512 WARN_UNUSED_RESULT int modifyVpnSystemPermissionRule(unsigned netId, uint32_t table, bool secure,
513                                                      bool add) {
514     Fwmark fwmark;
515     Fwmark mask;
516
517     fwmark.netId = netId;
518     mask.netId = FWMARK_NET_ID_MASK;
519
520     fwmark.permission = PERMISSION_SYSTEM;
521     mask.permission = PERMISSION_SYSTEM;
522
523     uint32_t priority = secure ? RULE_PRIORITY_SECURE_VPN : RULE_PRIORITY_BYPASSABLE_VPN;
524
525     return modifyIpRule(add ? RTM_NEWRULE : RTM_DELRULE, priority, table, fwmark.intValue,
526                         mask.intValue);
527 }
528
529 // A rule to route traffic based on an explicitly chosen network.
530 //
531 // Supports apps that use the multinetwork APIs to restrict their traffic to a network.
532 //
533 // Even though we check permissions at the time we set a netId into the fwmark of a socket, we need
534 // to check it again in the rules here, because a network's permissions may have been updated via
535 // modifyNetworkPermission().
536 WARN_UNUSED_RESULT int modifyExplicitNetworkRule(unsigned netId, uint32_t table,
537                                                  Permission permission, uid_t uidStart,
538                                                  uid_t uidEnd, bool add) {
539     Fwmark fwmark;
540     Fwmark mask;
541
542     fwmark.netId = netId;
543     mask.netId = FWMARK_NET_ID_MASK;
544
545     fwmark.explicitlySelected = true;
546     mask.explicitlySelected = true;
547
548     fwmark.permission = permission;
549     mask.permission = permission;
550
551     return modifyIpRule(add ? RTM_NEWRULE : RTM_DELRULE, RULE_PRIORITY_EXPLICIT_NETWORK, table,
552                         fwmark.intValue, mask.intValue, IIF_NONE, OIF_NONE, uidStart, uidEnd);
553 }
554
555 // A rule to route traffic based on a chosen outgoing interface.
556 //
557 // Supports apps that use SO_BINDTODEVICE or IP_PKTINFO options and the kernel that already knows
558 // the outgoing interface (typically for link-local communications).
559 WARN_UNUSED_RESULT int modifyOutputInterfaceRules(const char* interface, uint32_t table,
560                                                   Permission permission, uid_t uidStart,
561                                                   uid_t uidEnd, bool add) {
562     Fwmark fwmark;
563     Fwmark mask;
564
565     fwmark.permission = permission;
566     mask.permission = permission;
567
568     // If this rule does not specify a UID range, then also add a corresponding high-priority rule
569     // for UID. This covers forwarded packets and system daemons such as the tethering DHCP server.
570     if (uidStart == INVALID_UID && uidEnd == INVALID_UID) {
571         if (int ret = modifyIpRule(add ? RTM_NEWRULE : RTM_DELRULE, RULE_PRIORITY_VPN_OVERRIDE_OIF,
572                                    table, fwmark.intValue, mask.intValue, IIF_NONE, interface,
573                                    UID_ROOT, UID_ROOT)) {
574             return ret;
575         }
576     }
577
578     return modifyIpRule(add ? RTM_NEWRULE : RTM_DELRULE, RULE_PRIORITY_OUTPUT_INTERFACE, table,
579                         fwmark.intValue, mask.intValue, IIF_NONE, interface, uidStart, uidEnd);
580 }
581
582 // A rule to route traffic based on the chosen network.
583 //
584 // This is for sockets that have not explicitly requested a particular network, but have been
585 // bound to one when they called connect(). This ensures that sockets connected on a particular
586 // network stay on that network even if the default network changes.
587 WARN_UNUSED_RESULT int modifyImplicitNetworkRule(unsigned netId, uint32_t table,
588                                                  Permission permission, bool add) {
589     Fwmark fwmark;
590     Fwmark mask;
591
592     fwmark.netId = netId;
593     mask.netId = FWMARK_NET_ID_MASK;
594
595     fwmark.explicitlySelected = false;
596     mask.explicitlySelected = true;
597
598     fwmark.permission = permission;
599     mask.permission = permission;
600
601     return modifyIpRule(add ? RTM_NEWRULE : RTM_DELRULE, RULE_PRIORITY_IMPLICIT_NETWORK, table,
602                         fwmark.intValue, mask.intValue);
603 }
604
605 // A rule to enable split tunnel VPNs.
606 //
607 // If a packet with a VPN's netId doesn't find a route in the VPN's routing table, it's allowed to
608 // go over the default network, provided it wasn't explicitly restricted to the VPN and has the
609 // permissions required by the default network.
610 WARN_UNUSED_RESULT int modifyVpnFallthroughRule(uint16_t action, unsigned vpnNetId,
611                                                 const char* physicalInterface,
612                                                 Permission permission) {
613     uint32_t table = getRouteTableForInterface(physicalInterface);
614     if (table == RT_TABLE_UNSPEC) {
615         return -ESRCH;
616     }
617
618     Fwmark fwmark;
619     Fwmark mask;
620
621     fwmark.netId = vpnNetId;
622     mask.netId = FWMARK_NET_ID_MASK;
623
624     fwmark.explicitlySelected = false;
625     mask.explicitlySelected = true;
626
627     fwmark.permission = permission;
628     mask.permission = permission;
629
630     return modifyIpRule(action, RULE_PRIORITY_VPN_FALLTHROUGH, table, fwmark.intValue,
631                         mask.intValue);
632 }
633
634 // Add rules to allow legacy routes added through the requestRouteToHost() API.
635 WARN_UNUSED_RESULT int addLegacyRouteRules() {
636     Fwmark fwmark;
637     Fwmark mask;
638
639     fwmark.explicitlySelected = false;
640     mask.explicitlySelected = true;
641
642     // Rules to allow legacy routes to override the default network.
643     if (int ret = modifyIpRule(RTM_NEWRULE, RULE_PRIORITY_LEGACY_SYSTEM, ROUTE_TABLE_LEGACY_SYSTEM,
644                                fwmark.intValue, mask.intValue)) {
645         return ret;
646     }
647     if (int ret = modifyIpRule(RTM_NEWRULE, RULE_PRIORITY_LEGACY_NETWORK,
648                                ROUTE_TABLE_LEGACY_NETWORK, fwmark.intValue, mask.intValue)) {
649         return ret;
650     }
651
652     fwmark.permission = PERMISSION_SYSTEM;
653     mask.permission = PERMISSION_SYSTEM;
654
655     // A rule to allow legacy routes from system apps to override VPNs.
656     return modifyIpRule(RTM_NEWRULE, RULE_PRIORITY_VPN_OVERRIDE_SYSTEM, ROUTE_TABLE_LEGACY_SYSTEM,
657                         fwmark.intValue, mask.intValue);
658 }
659
660 // Add rules to lookup the local network when specified explicitly or otherwise.
661 WARN_UNUSED_RESULT int addLocalNetworkRules(unsigned localNetId) {
662     if (int ret = modifyExplicitNetworkRule(localNetId, ROUTE_TABLE_LOCAL_NETWORK, PERMISSION_NONE,
663                                             INVALID_UID, INVALID_UID, ACTION_ADD)) {
664         return ret;
665     }
666
667     Fwmark fwmark;
668     Fwmark mask;
669
670     fwmark.explicitlySelected = false;
671     mask.explicitlySelected = true;
672
673     return modifyIpRule(RTM_NEWRULE, RULE_PRIORITY_LOCAL_NETWORK, ROUTE_TABLE_LOCAL_NETWORK,
674                         fwmark.intValue, mask.intValue);
675 }
676
677 int configureDummyNetwork() {
678     const char *interface = DummyNetwork::INTERFACE_NAME;
679     uint32_t table = getRouteTableForInterface(interface);
680     if (table == RT_TABLE_UNSPEC) {
681         // getRouteTableForInterface has already looged an error.
682         return -ESRCH;
683     }
684
685     ifc_init();
686     int ret = ifc_up(interface);
687     ifc_close();
688     if (ret) {
689         ALOGE("Can't bring up %s: %s", interface, strerror(errno));
690         return -errno;
691     }
692
693     if ((ret = modifyOutputInterfaceRules(interface, table, PERMISSION_NONE,
694                                           INVALID_UID, INVALID_UID, ACTION_ADD))) {
695         ALOGE("Can't create oif rules for %s: %s", interface, strerror(-ret));
696         return ret;
697     }
698
699     if ((ret = modifyIpRoute(RTM_NEWROUTE, table, interface, "0.0.0.0/0", NULL))) {
700         ALOGE("Can't add IPv4 default route to %s: %s", interface, strerror(-ret));
701         return ret;
702     }
703
704     if ((ret = modifyIpRoute(RTM_NEWROUTE, table, interface, "::/0", NULL))) {
705         ALOGE("Can't add IPv6 default route to %s: %s", interface, strerror(-ret));
706         return ret;
707     }
708
709     return 0;
710 }
711
712 // Add a new rule to look up the 'main' table, with the same selectors as the "default network"
713 // rule, but with a lower priority. We will never create routes in the main table; it should only be
714 // used for directly-connected routes implicitly created by the kernel when adding IP addresses.
715 // This is necessary, for example, when adding a route through a directly-connected gateway: in
716 // order to add the route, there must already be a directly-connected route that covers the gateway.
717 WARN_UNUSED_RESULT int addDirectlyConnectedRule() {
718     Fwmark fwmark;
719     Fwmark mask;
720
721     fwmark.netId = NETID_UNSET;
722     mask.netId = FWMARK_NET_ID_MASK;
723
724     return modifyIpRule(RTM_NEWRULE, RULE_PRIORITY_DIRECTLY_CONNECTED, RT_TABLE_MAIN,
725                         fwmark.intValue, mask.intValue, IIF_NONE, OIF_NONE, UID_ROOT, UID_ROOT);
726 }
727
728 // Add an explicit unreachable rule close to the end of the prioriy list to make it clear that
729 // relying on the kernel-default "from all lookup main" rule at priority 32766 is not intended
730 // behaviour. We do flush the kernel-default rules at startup, but having an explicit unreachable
731 // rule will hopefully make things even clearer.
732 WARN_UNUSED_RESULT int addUnreachableRule() {
733     return modifyIpRule(RTM_NEWRULE, RULE_PRIORITY_UNREACHABLE, RT_TABLE_UNSPEC, MARK_UNSET,
734                         MARK_UNSET);
735 }
736
737 WARN_UNUSED_RESULT int modifyLocalNetwork(unsigned netId, const char* interface, bool add) {
738     if (int ret = modifyIncomingPacketMark(netId, interface, PERMISSION_NONE, add)) {
739         return ret;
740     }
741     return modifyOutputInterfaceRules(interface, ROUTE_TABLE_LOCAL_NETWORK, PERMISSION_NONE,
742                                       INVALID_UID, INVALID_UID, add);
743 }
744
745 WARN_UNUSED_RESULT int modifyPhysicalNetwork(unsigned netId, const char* interface,
746                                              Permission permission, bool add) {
747     uint32_t table = getRouteTableForInterface(interface);
748     if (table == RT_TABLE_UNSPEC) {
749         return -ESRCH;
750     }
751
752     if (int ret = modifyIncomingPacketMark(netId, interface, permission, add)) {
753         return ret;
754     }
755     if (int ret = modifyExplicitNetworkRule(netId, table, permission, INVALID_UID, INVALID_UID,
756                                             add)) {
757         return ret;
758     }
759     if (int ret = modifyOutputInterfaceRules(interface, table, permission, INVALID_UID, INVALID_UID,
760                                             add)) {
761         return ret;
762     }
763     return modifyImplicitNetworkRule(netId, table, permission, add);
764 }
765
766 WARN_UNUSED_RESULT int modifyVirtualNetwork(unsigned netId, const char* interface,
767                                             const UidRanges& uidRanges, bool secure, bool add,
768                                             bool modifyNonUidBasedRules) {
769     uint32_t table = getRouteTableForInterface(interface);
770     if (table == RT_TABLE_UNSPEC) {
771         return -ESRCH;
772     }
773
774     for (const UidRanges::Range& range : uidRanges.getRanges()) {
775         if (int ret = modifyVpnUidRangeRule(table, range.first, range.second, secure, add)) {
776             return ret;
777         }
778         if (int ret = modifyExplicitNetworkRule(netId, table, PERMISSION_NONE, range.first,
779                                                 range.second, add)) {
780             return ret;
781         }
782         if (int ret = modifyOutputInterfaceRules(interface, table, PERMISSION_NONE, range.first,
783                                                  range.second, add)) {
784             return ret;
785         }
786     }
787
788     if (modifyNonUidBasedRules) {
789         if (int ret = modifyIncomingPacketMark(netId, interface, PERMISSION_NONE, add)) {
790             return ret;
791         }
792         if (int ret = modifyVpnOutputToLocalRule(interface, add)) {
793             return ret;
794         }
795         if (int ret = modifyVpnSystemPermissionRule(netId, table, secure, add)) {
796             return ret;
797         }
798         return modifyExplicitNetworkRule(netId, table, PERMISSION_NONE, UID_ROOT, UID_ROOT, add);
799     }
800
801     return 0;
802 }
803
804 WARN_UNUSED_RESULT int modifyDefaultNetwork(uint16_t action, const char* interface,
805                                             Permission permission) {
806     uint32_t table = getRouteTableForInterface(interface);
807     if (table == RT_TABLE_UNSPEC) {
808         return -ESRCH;
809     }
810
811     Fwmark fwmark;
812     Fwmark mask;
813
814     fwmark.netId = NETID_UNSET;
815     mask.netId = FWMARK_NET_ID_MASK;
816
817     fwmark.permission = permission;
818     mask.permission = permission;
819
820     return modifyIpRule(action, RULE_PRIORITY_DEFAULT_NETWORK, table, fwmark.intValue,
821                         mask.intValue);
822 }
823
824 WARN_UNUSED_RESULT int modifyTetheredNetwork(uint16_t action, const char* inputInterface,
825                                              const char* outputInterface) {
826     uint32_t table = getRouteTableForInterface(outputInterface);
827     if (table == RT_TABLE_UNSPEC) {
828         return -ESRCH;
829     }
830
831     return modifyIpRule(action, RULE_PRIORITY_TETHERING, table, MARK_UNSET, MARK_UNSET,
832                         inputInterface, OIF_NONE, INVALID_UID, INVALID_UID);
833 }
834
835 // Returns 0 on success or negative errno on failure.
836 WARN_UNUSED_RESULT int flushRules() {
837     for (size_t i = 0; i < ARRAY_SIZE(IP_VERSIONS); ++i) {
838         const char* argv[] = {
839             IP_PATH,
840             IP_VERSIONS[i],
841             "rule",
842             "flush",
843         };
844         if (android_fork_execvp(ARRAY_SIZE(argv), const_cast<char**>(argv), NULL, false, false)) {
845             ALOGE("failed to flush rules");
846             return -EREMOTEIO;
847         }
848     }
849     return 0;
850 }
851
852 // Adds or removes an IPv4 or IPv6 route to the specified table and, if it's a directly-connected
853 // route, to the main table as well.
854 // Returns 0 on success or negative errno on failure.
855 WARN_UNUSED_RESULT int modifyRoute(uint16_t action, const char* interface, const char* destination,
856                                    const char* nexthop, RouteController::TableType tableType) {
857     uint32_t table;
858     switch (tableType) {
859         case RouteController::INTERFACE: {
860             table = getRouteTableForInterface(interface);
861             if (table == RT_TABLE_UNSPEC) {
862                 return -ESRCH;
863             }
864             break;
865         }
866         case RouteController::LOCAL_NETWORK: {
867             table = ROUTE_TABLE_LOCAL_NETWORK;
868             break;
869         }
870         case RouteController::LEGACY_NETWORK: {
871             table = ROUTE_TABLE_LEGACY_NETWORK;
872             break;
873         }
874         case RouteController::LEGACY_SYSTEM: {
875             table = ROUTE_TABLE_LEGACY_SYSTEM;
876             break;
877         }
878     }
879
880     int ret = modifyIpRoute(action, table, interface, destination, nexthop);
881     // Trying to add a route that already exists shouldn't cause an error.
882     if (ret && !(action == RTM_NEWROUTE && ret == -EEXIST)) {
883         return ret;
884     }
885
886     return 0;
887 }
888
889 // Returns 0 on success or negative errno on failure.
890 WARN_UNUSED_RESULT int flushRoutes(const char* interface) {
891     uint32_t table = getRouteTableForInterface(interface);
892     if (table == RT_TABLE_UNSPEC) {
893         return -ESRCH;
894     }
895
896     char tableString[UINT32_STRLEN];
897     snprintf(tableString, sizeof(tableString), "%u", table);
898
899     int ret = 0;
900     for (size_t i = 0; i < ARRAY_SIZE(IP_VERSIONS); ++i) {
901         const char* argv[] = {
902             IP_PATH,
903             IP_VERSIONS[i],
904             "route",
905             "flush",
906             "table",
907             tableString,
908         };
909
910         // A flush works by dumping routes and deleting each route as it's returned, and it can
911         // fail if something else deletes the route between the dump and the delete. This can
912         // happen, for example, if an interface goes down while we're trying to flush its routes.
913         // So try multiple times and only return an error if the last attempt fails.
914         //
915         // TODO: replace this with our own netlink code.
916         unsigned attempts = 0;
917         int err;
918         do {
919             err = android_fork_execvp(ARRAY_SIZE(argv), const_cast<char**>(argv),
920                                       NULL, false, false);
921             ++attempts;
922         } while (err != 0 && attempts < ROUTE_FLUSH_ATTEMPTS);
923         if (err) {
924             ALOGE("failed to flush %s routes in table %s after %d attempts",
925                   IP_VERSIONS[i], tableString, attempts);
926             ret = -EREMOTEIO;
927         }
928     }
929
930     // If we failed to flush routes, the caller may elect to keep this interface around, so keep
931     // track of its name.
932     if (!ret) {
933         interfaceToTable.erase(interface);
934     }
935
936     return ret;
937 }
938
939 WARN_UNUSED_RESULT int clearTetheringRules(const char* inputInterface) {
940     int ret = 0;
941     while (ret == 0) {
942         ret = modifyIpRule(RTM_DELRULE, RULE_PRIORITY_TETHERING, 0, MARK_UNSET, MARK_UNSET,
943                            inputInterface, OIF_NONE, INVALID_UID, INVALID_UID);
944     }
945
946     if (ret == -ENOENT) {
947         return 0;
948     } else {
949         return ret;
950     }
951 }
952
953 }  // namespace
954
955 int RouteController::Init(unsigned localNetId) {
956     if (int ret = flushRules()) {
957         return ret;
958     }
959     if (int ret = addLegacyRouteRules()) {
960         return ret;
961     }
962     if (int ret = addLocalNetworkRules(localNetId)) {
963         return ret;
964     }
965     if (int ret = addDirectlyConnectedRule()) {
966         return ret;
967     }
968     if (int ret = addUnreachableRule()) {
969         return ret;
970     }
971     // Don't complain if we can't add the dummy network, since not all devices support it.
972     configureDummyNetwork();
973
974     updateTableNamesFile();
975     return 0;
976 }
977
978 int RouteController::addInterfaceToLocalNetwork(unsigned netId, const char* interface) {
979     return modifyLocalNetwork(netId, interface, ACTION_ADD);
980 }
981
982 int RouteController::removeInterfaceFromLocalNetwork(unsigned netId, const char* interface) {
983     return modifyLocalNetwork(netId, interface, ACTION_DEL);
984 }
985
986 int RouteController::addInterfaceToPhysicalNetwork(unsigned netId, const char* interface,
987                                                    Permission permission) {
988     if (int ret = modifyPhysicalNetwork(netId, interface, permission, ACTION_ADD)) {
989         return ret;
990     }
991     updateTableNamesFile();
992     return 0;
993 }
994
995 int RouteController::removeInterfaceFromPhysicalNetwork(unsigned netId, const char* interface,
996                                                         Permission permission) {
997     if (int ret = modifyPhysicalNetwork(netId, interface, permission, ACTION_DEL)) {
998         return ret;
999     }
1000     if (int ret = flushRoutes(interface)) {
1001         return ret;
1002     }
1003     if (int ret = clearTetheringRules(interface)) {
1004         return ret;
1005     }
1006     updateTableNamesFile();
1007     return 0;
1008 }
1009
1010 int RouteController::addInterfaceToVirtualNetwork(unsigned netId, const char* interface,
1011                                                   bool secure, const UidRanges& uidRanges) {
1012     if (int ret = modifyVirtualNetwork(netId, interface, uidRanges, secure, ACTION_ADD,
1013                                        MODIFY_NON_UID_BASED_RULES)) {
1014         return ret;
1015     }
1016     updateTableNamesFile();
1017     return 0;
1018 }
1019
1020 int RouteController::removeInterfaceFromVirtualNetwork(unsigned netId, const char* interface,
1021                                                        bool secure, const UidRanges& uidRanges) {
1022     if (int ret = modifyVirtualNetwork(netId, interface, uidRanges, secure, ACTION_DEL,
1023                                        MODIFY_NON_UID_BASED_RULES)) {
1024         return ret;
1025     }
1026     if (int ret = flushRoutes(interface)) {
1027         return ret;
1028     }
1029     updateTableNamesFile();
1030     return 0;
1031 }
1032
1033 int RouteController::modifyPhysicalNetworkPermission(unsigned netId, const char* interface,
1034                                                      Permission oldPermission,
1035                                                      Permission newPermission) {
1036     // Add the new rules before deleting the old ones, to avoid race conditions.
1037     if (int ret = modifyPhysicalNetwork(netId, interface, newPermission, ACTION_ADD)) {
1038         return ret;
1039     }
1040     return modifyPhysicalNetwork(netId, interface, oldPermission, ACTION_DEL);
1041 }
1042
1043 int RouteController::addUsersToVirtualNetwork(unsigned netId, const char* interface, bool secure,
1044                                               const UidRanges& uidRanges) {
1045     return modifyVirtualNetwork(netId, interface, uidRanges, secure, ACTION_ADD,
1046                                 !MODIFY_NON_UID_BASED_RULES);
1047 }
1048
1049 int RouteController::removeUsersFromVirtualNetwork(unsigned netId, const char* interface,
1050                                                    bool secure, const UidRanges& uidRanges) {
1051     return modifyVirtualNetwork(netId, interface, uidRanges, secure, ACTION_DEL,
1052                                 !MODIFY_NON_UID_BASED_RULES);
1053 }
1054
1055 int RouteController::addInterfaceToDefaultNetwork(const char* interface, Permission permission) {
1056     return modifyDefaultNetwork(RTM_NEWRULE, interface, permission);
1057 }
1058
1059 int RouteController::removeInterfaceFromDefaultNetwork(const char* interface,
1060                                                        Permission permission) {
1061     return modifyDefaultNetwork(RTM_DELRULE, interface, permission);
1062 }
1063
1064 int RouteController::addRoute(const char* interface, const char* destination, const char* nexthop,
1065                               TableType tableType) {
1066     return modifyRoute(RTM_NEWROUTE, interface, destination, nexthop, tableType);
1067 }
1068
1069 int RouteController::removeRoute(const char* interface, const char* destination,
1070                                  const char* nexthop, TableType tableType) {
1071     return modifyRoute(RTM_DELROUTE, interface, destination, nexthop, tableType);
1072 }
1073
1074 int RouteController::enableTethering(const char* inputInterface, const char* outputInterface) {
1075     return modifyTetheredNetwork(RTM_NEWRULE, inputInterface, outputInterface);
1076 }
1077
1078 int RouteController::disableTethering(const char* inputInterface, const char* outputInterface) {
1079     return modifyTetheredNetwork(RTM_DELRULE, inputInterface, outputInterface);
1080 }
1081
1082 int RouteController::addVirtualNetworkFallthrough(unsigned vpnNetId, const char* physicalInterface,
1083                                                   Permission permission) {
1084     return modifyVpnFallthroughRule(RTM_NEWRULE, vpnNetId, physicalInterface, permission);
1085 }
1086
1087 int RouteController::removeVirtualNetworkFallthrough(unsigned vpnNetId,
1088                                                      const char* physicalInterface,
1089                                                      Permission permission) {
1090     return modifyVpnFallthroughRule(RTM_DELRULE, vpnNetId, physicalInterface, permission);
1091 }