RouteController.h revision 95684ba176a9fe5ea59207d7202e47fa12bbfdbe 
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#ifndef NETD_SERVER_ROUTE_CONTROLLER_H
18#define NETD_SERVER_ROUTE_CONTROLLER_H
19
20#include "NetdConstants.h"
21#include "Permission.h"
22
23#include <sys/types.h>
24
25class UidRanges;
26
27class RouteController {
28public:
29    // How the routing table number is determined for route modification requests.
30    enum TableType {
31        INTERFACE,       // Compute the table number based on the interface index.
32        LOCAL_NETWORK,   // A fixed table used for routes to directly-connected clients/peers.
33        LEGACY_NETWORK,  // Use a fixed table that's used to override the default network.
34        LEGACY_SYSTEM,   // A fixed table, only modifiable by system apps; overrides VPNs too.
35    };
36
37    static const int ROUTE_TABLE_OFFSET_FROM_INDEX = 1000;
38
39    static int Init(unsigned localNetId) WARN_UNUSED_RESULT;
40
41    static int addInterfaceToLocalNetwork(unsigned netId, const char* interface) WARN_UNUSED_RESULT;
42    static int removeInterfaceFromLocalNetwork(unsigned netId,
43                                               const char* interface) WARN_UNUSED_RESULT;
44
45    static int addInterfaceToPhysicalNetwork(unsigned netId, const char* interface,
46                                             Permission permission) WARN_UNUSED_RESULT;
47    static int removeInterfaceFromPhysicalNetwork(unsigned netId, const char* interface,
48                                                  Permission permission) WARN_UNUSED_RESULT;
49
50    static int addInterfaceToVirtualNetwork(unsigned netId, const char* interface, bool secure,
51                                            const UidRanges& uidRanges) WARN_UNUSED_RESULT;
52    static int removeInterfaceFromVirtualNetwork(unsigned netId, const char* interface, bool secure,
53                                                 const UidRanges& uidRanges) WARN_UNUSED_RESULT;
54
55    static int modifyPhysicalNetworkPermission(unsigned netId, const char* interface,
56                                               Permission oldPermission,
57                                               Permission newPermission) WARN_UNUSED_RESULT;
58
59    static int addUsersToVirtualNetwork(unsigned netId, const char* interface, bool secure,
60                                        const UidRanges& uidRanges) WARN_UNUSED_RESULT;
61    static int removeUsersFromVirtualNetwork(unsigned netId, const char* interface, bool secure,
62                                             const UidRanges& uidRanges) WARN_UNUSED_RESULT;
63
64    static int addInterfaceToDefaultNetwork(const char* interface,
65                                            Permission permission) WARN_UNUSED_RESULT;
66    static int removeInterfaceFromDefaultNetwork(const char* interface,
67                                                 Permission permission) WARN_UNUSED_RESULT;
68
69    static int addRoute(const char* interface, const char* destination, const char* nexthop,
70                        TableType tableType) WARN_UNUSED_RESULT;
71    static int removeRoute(const char* interface, const char* destination, const char* nexthop,
72                           TableType tableType) WARN_UNUSED_RESULT;
73
74    static int enableTethering(const char* inputInterface,
75                               const char* outputInterface) WARN_UNUSED_RESULT;
76    static int disableTethering(const char* inputInterface,
77                                const char* outputInterface) WARN_UNUSED_RESULT;
78};
79
80#endif  // NETD_SERVER_ROUTE_CONTROLLER_H
81