1 /*
2 * Copyright 2022 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 * bpf_existence_test.cpp - checks that the device has expected BPF programs and maps
17 */
18
19 #include <cstdint>
20 #include <set>
21 #include <string>
22
23 #include <android-modules-utils/sdk_level.h>
24 #include <bpf/BpfUtils.h>
25
26 #include <gtest/gtest.h>
27
28 using std::find;
29 using std::set;
30 using std::string;
31
32 using android::bpf::isAtLeastKernelVersion;
33 using android::modules::sdklevel::IsAtLeastR;
34 using android::modules::sdklevel::IsAtLeastS;
35 using android::modules::sdklevel::IsAtLeastT;
36 using android::modules::sdklevel::IsAtLeastU;
37 using android::modules::sdklevel::IsAtLeastV;
38
39 #define PLATFORM "/sys/fs/bpf/"
40 #define TETHERING "/sys/fs/bpf/tethering/"
41 #define PRIVATE "/sys/fs/bpf/net_private/"
42 #define SHARED "/sys/fs/bpf/net_shared/"
43 #define NETD_RO "/sys/fs/bpf/netd_readonly/"
44 #define NETD "/sys/fs/bpf/netd_shared/"
45
46 class BpfExistenceTest : public ::testing::Test {
47 };
48
49 // Part of Android R platform (for 4.9+), but mainlined in S
50 static const set<string> PLATFORM_ONLY_IN_R = {
51 PLATFORM "map_offload_tether_ingress_map",
52 PLATFORM "map_offload_tether_limit_map",
53 PLATFORM "map_offload_tether_stats_map",
54 PLATFORM "prog_offload_schedcls_ingress_tether_ether",
55 PLATFORM "prog_offload_schedcls_ingress_tether_rawip",
56 };
57
58 // Provided by *current* mainline module for S+ devices
59 static const set<string> MAINLINE_FOR_S_PLUS = {
60 TETHERING "map_offload_tether_dev_map",
61 TETHERING "map_offload_tether_downstream4_map",
62 TETHERING "map_offload_tether_downstream64_map",
63 TETHERING "map_offload_tether_downstream6_map",
64 TETHERING "map_offload_tether_error_map",
65 TETHERING "map_offload_tether_limit_map",
66 TETHERING "map_offload_tether_stats_map",
67 TETHERING "map_offload_tether_upstream4_map",
68 TETHERING "map_offload_tether_upstream6_map",
69 TETHERING "map_test_bitmap",
70 TETHERING "map_test_tether_downstream6_map",
71 TETHERING "map_test_tether2_downstream6_map",
72 TETHERING "map_test_tether3_downstream6_map",
73 TETHERING "prog_offload_schedcls_tether_downstream4_ether",
74 TETHERING "prog_offload_schedcls_tether_downstream4_rawip",
75 TETHERING "prog_offload_schedcls_tether_downstream6_ether",
76 TETHERING "prog_offload_schedcls_tether_downstream6_rawip",
77 TETHERING "prog_offload_schedcls_tether_upstream4_ether",
78 TETHERING "prog_offload_schedcls_tether_upstream4_rawip",
79 TETHERING "prog_offload_schedcls_tether_upstream6_ether",
80 TETHERING "prog_offload_schedcls_tether_upstream6_rawip",
81 };
82
83 // Provided by *current* mainline module for S+ devices with 5.10+ kernels
84 static const set<string> MAINLINE_FOR_S_5_10_PLUS = {
85 TETHERING "prog_test_xdp_drop_ipv4_udp_ether",
86 };
87
88 // Provided by *current* mainline module for T+ devices
89 static const set<string> MAINLINE_FOR_T_PLUS = {
90 SHARED "map_block_blocked_ports_map",
91 SHARED "map_clatd_clat_egress4_map",
92 SHARED "map_clatd_clat_ingress6_map",
93 SHARED "map_dscpPolicy_ipv4_dscp_policies_map",
94 SHARED "map_dscpPolicy_ipv6_dscp_policies_map",
95 SHARED "map_dscpPolicy_socket_policy_cache_map",
96 SHARED "map_gentle_test",
97 SHARED "prog_gentle_skfilter_accept",
98 NETD "map_netd_app_uid_stats_map",
99 NETD "map_netd_configuration_map",
100 NETD "map_netd_cookie_tag_map",
101 NETD "map_netd_data_saver_enabled_map",
102 NETD "map_netd_iface_index_name_map",
103 NETD "map_netd_iface_stats_map",
104 NETD "map_netd_ingress_discard_map",
105 NETD "map_netd_stats_map_A",
106 NETD "map_netd_stats_map_B",
107 NETD "map_netd_uid_counterset_map",
108 NETD "map_netd_uid_owner_map",
109 NETD "map_netd_uid_permission_map",
110 SHARED "prog_clatd_schedcls_egress4_clat_rawip",
111 SHARED "prog_clatd_schedcls_ingress6_clat_ether",
112 SHARED "prog_clatd_schedcls_ingress6_clat_rawip",
113 NETD "prog_netd_cgroupskb_egress_stats",
114 NETD "prog_netd_cgroupskb_ingress_stats",
115 NETD "prog_netd_schedact_ingress_account",
116 NETD "prog_netd_skfilter_allowlist_xtbpf",
117 NETD "prog_netd_skfilter_denylist_xtbpf",
118 NETD "prog_netd_skfilter_egress_xtbpf",
119 NETD "prog_netd_skfilter_ingress_xtbpf",
120 };
121
122 // Provided by *current* mainline module for T+ devices with 4.14+ kernels
123 static const set<string> MAINLINE_FOR_T_4_14_PLUS = {
124 NETD "prog_netd_cgroupsock_inet_create",
125 };
126
127 // Provided by *current* mainline module for T+ devices with 5.4+ kernels
128 static const set<string> MAINLINE_FOR_T_4_19_PLUS = {
129 NETD_RO "prog_block_bind4_block_port",
130 NETD_RO "prog_block_bind6_block_port",
131 };
132
133 // Provided by *current* mainline module for T+ devices with 5.15+ kernels
134 static const set<string> MAINLINE_FOR_T_5_15_PLUS = {
135 SHARED "prog_dscpPolicy_schedcls_set_dscp_ether",
136 };
137
138 // Provided by *current* mainline module for U+ devices
139 static const set<string> MAINLINE_FOR_U_PLUS = {
140 NETD "map_netd_packet_trace_enabled_map",
141 };
142
143 // Provided by *current* mainline module for U+ devices with 5.10+ kernels
144 static const set<string> MAINLINE_FOR_U_5_10_PLUS = {
145 NETD "map_netd_packet_trace_ringbuf",
146 };
147
148 // Provided by *current* mainline module for V+ devices
149 static const set<string> MAINLINE_FOR_V_PLUS = {
150 NETD "prog_netd_connect4_inet4_connect",
151 NETD "prog_netd_connect6_inet6_connect",
152 NETD "prog_netd_recvmsg4_udp4_recvmsg",
153 NETD "prog_netd_recvmsg6_udp6_recvmsg",
154 NETD "prog_netd_sendmsg4_udp4_sendmsg",
155 NETD "prog_netd_sendmsg6_udp6_sendmsg",
156 };
157
158 // Provided by *current* mainline module for V+ devices with 5.4+ kernels
159 static const set<string> MAINLINE_FOR_V_5_4_PLUS = {
160 NETD "prog_netd_getsockopt_prog",
161 NETD "prog_netd_setsockopt_prog",
162 };
163
164 // Provided by *current* mainline module for U+ devices with 5.10+ kernels
165 static const set<string> MAINLINE_FOR_V_5_10_PLUS = {
166 NETD "prog_netd_cgroupsockrelease_inet_release",
167 };
168
addAll(set<string> & a,const set<string> & b)169 static void addAll(set<string>& a, const set<string>& b) {
170 a.insert(b.begin(), b.end());
171 }
172
173 #define DO_EXPECT(B, V) addAll((B) ? mustExist : mustNotExist, (V))
174
TEST_F(BpfExistenceTest,TestPrograms)175 TEST_F(BpfExistenceTest, TestPrograms) {
176 // Only unconfined root is guaranteed to be able to access everything in /sys/fs/bpf.
177 ASSERT_EQ(0, getuid()) << "This test must run as root.";
178
179 set<string> mustExist;
180 set<string> mustNotExist;
181
182 // We do not actually check the platform P/Q (netd) and Q (clatd) things
183 // and only verify the mainline module relevant R+ offload maps & progs.
184 //
185 // The goal of this test is to verify compatibility with the tethering mainline module,
186 // and not to test the platform itself, which may have been modified by vendor or oems,
187 // so we should only test for the removal of stuff that was mainline'd,
188 // and for the presence of mainline stuff.
189
190 // Note: Q is no longer supported by mainline
191 ASSERT_TRUE(IsAtLeastR());
192
193 // R can potentially run on pre-4.9 kernel non-eBPF capable devices.
194 DO_EXPECT(IsAtLeastR() && !IsAtLeastS() && isAtLeastKernelVersion(4, 9, 0), PLATFORM_ONLY_IN_R);
195
196 // S requires Linux Kernel 4.9+ and thus requires eBPF support.
197 if (IsAtLeastS()) ASSERT_TRUE(isAtLeastKernelVersion(4, 9, 0));
198 DO_EXPECT(IsAtLeastS(), MAINLINE_FOR_S_PLUS);
199 DO_EXPECT(IsAtLeastS() && isAtLeastKernelVersion(5, 10, 0), MAINLINE_FOR_S_5_10_PLUS);
200
201 // Nothing added or removed in SCv2.
202
203 // T still only requires Linux Kernel 4.9+.
204 DO_EXPECT(IsAtLeastT(), MAINLINE_FOR_T_PLUS);
205 DO_EXPECT(IsAtLeastT() && isAtLeastKernelVersion(4, 14, 0), MAINLINE_FOR_T_4_14_PLUS);
206 DO_EXPECT(IsAtLeastT() && isAtLeastKernelVersion(4, 19, 0), MAINLINE_FOR_T_4_19_PLUS);
207 DO_EXPECT(IsAtLeastT() && isAtLeastKernelVersion(5, 15, 0), MAINLINE_FOR_T_5_15_PLUS);
208
209 // U requires Linux Kernel 4.14+, but nothing (as yet) added or removed in U.
210 if (IsAtLeastU()) ASSERT_TRUE(isAtLeastKernelVersion(4, 14, 0));
211 DO_EXPECT(IsAtLeastU(), MAINLINE_FOR_U_PLUS);
212 DO_EXPECT(IsAtLeastU() && isAtLeastKernelVersion(5, 10, 0), MAINLINE_FOR_U_5_10_PLUS);
213
214 // V requires Linux Kernel 4.19+, but nothing (as yet) added or removed in V.
215 if (IsAtLeastV()) ASSERT_TRUE(isAtLeastKernelVersion(4, 19, 0));
216 DO_EXPECT(IsAtLeastV(), MAINLINE_FOR_V_PLUS);
217 DO_EXPECT(IsAtLeastV() && isAtLeastKernelVersion(5, 4, 0), MAINLINE_FOR_V_5_4_PLUS);
218 DO_EXPECT(IsAtLeastV() && isAtLeastKernelVersion(5, 10, 0), MAINLINE_FOR_V_5_10_PLUS);
219
220 for (const auto& file : mustExist) {
221 EXPECT_EQ(0, access(file.c_str(), R_OK)) << file << " does not exist";
222 }
223 for (const auto& file : mustNotExist) {
224 int ret = access(file.c_str(), R_OK);
225 int err = errno;
226 EXPECT_EQ(-1, ret) << file << " unexpectedly exists";
227 if (ret == -1) {
228 EXPECT_EQ(ENOENT, err) << " accessing " << file << " failed with errno " << err;
229 }
230 }
231 }
232