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