xref: /linux/tools/lib/bpf/libbpf_probes.c (revision be239684b18e1cdcafcf8c7face4a2f562c745ad)
1 // SPDX-License-Identifier: (LGPL-2.1 OR BSD-2-Clause)
2 /* Copyright (c) 2019 Netronome Systems, Inc. */
3 
4 #include <errno.h>
5 #include <fcntl.h>
6 #include <string.h>
7 #include <stdlib.h>
8 #include <unistd.h>
9 #include <net/if.h>
10 #include <sys/utsname.h>
11 
12 #include <linux/btf.h>
13 #include <linux/filter.h>
14 #include <linux/kernel.h>
15 #include <linux/version.h>
16 
17 #include "bpf.h"
18 #include "libbpf.h"
19 #include "libbpf_internal.h"
20 
21 /* On Ubuntu LINUX_VERSION_CODE doesn't correspond to info.release,
22  * but Ubuntu provides /proc/version_signature file, as described at
23  * https://ubuntu.com/kernel, with an example contents below, which we
24  * can use to get a proper LINUX_VERSION_CODE.
25  *
26  *   Ubuntu 5.4.0-12.15-generic 5.4.8
27  *
28  * In the above, 5.4.8 is what kernel is actually expecting, while
29  * uname() call will return 5.4.0 in info.release.
30  */
31 static __u32 get_ubuntu_kernel_version(void)
32 {
33 	const char *ubuntu_kver_file = "/proc/version_signature";
34 	__u32 major, minor, patch;
35 	int ret;
36 	FILE *f;
37 
38 	if (faccessat(AT_FDCWD, ubuntu_kver_file, R_OK, AT_EACCESS) != 0)
39 		return 0;
40 
41 	f = fopen(ubuntu_kver_file, "re");
42 	if (!f)
43 		return 0;
44 
45 	ret = fscanf(f, "%*s %*s %u.%u.%u\n", &major, &minor, &patch);
46 	fclose(f);
47 	if (ret != 3)
48 		return 0;
49 
50 	return KERNEL_VERSION(major, minor, patch);
51 }
52 
53 /* On Debian LINUX_VERSION_CODE doesn't correspond to info.release.
54  * Instead, it is provided in info.version. An example content of
55  * Debian 10 looks like the below.
56  *
57  *   utsname::release   4.19.0-22-amd64
58  *   utsname::version   #1 SMP Debian 4.19.260-1 (2022-09-29)
59  *
60  * In the above, 4.19.260 is what kernel is actually expecting, while
61  * uname() call will return 4.19.0 in info.release.
62  */
63 static __u32 get_debian_kernel_version(struct utsname *info)
64 {
65 	__u32 major, minor, patch;
66 	char *p;
67 
68 	p = strstr(info->version, "Debian ");
69 	if (!p) {
70 		/* This is not a Debian kernel. */
71 		return 0;
72 	}
73 
74 	if (sscanf(p, "Debian %u.%u.%u", &major, &minor, &patch) != 3)
75 		return 0;
76 
77 	return KERNEL_VERSION(major, minor, patch);
78 }
79 
80 __u32 get_kernel_version(void)
81 {
82 	__u32 major, minor, patch, version;
83 	struct utsname info;
84 
85 	/* Check if this is an Ubuntu kernel. */
86 	version = get_ubuntu_kernel_version();
87 	if (version != 0)
88 		return version;
89 
90 	uname(&info);
91 
92 	/* Check if this is a Debian kernel. */
93 	version = get_debian_kernel_version(&info);
94 	if (version != 0)
95 		return version;
96 
97 	if (sscanf(info.release, "%u.%u.%u", &major, &minor, &patch) != 3)
98 		return 0;
99 
100 	return KERNEL_VERSION(major, minor, patch);
101 }
102 
103 static int probe_prog_load(enum bpf_prog_type prog_type,
104 			   const struct bpf_insn *insns, size_t insns_cnt,
105 			   char *log_buf, size_t log_buf_sz)
106 {
107 	LIBBPF_OPTS(bpf_prog_load_opts, opts,
108 		.log_buf = log_buf,
109 		.log_size = log_buf_sz,
110 		.log_level = log_buf ? 1 : 0,
111 	);
112 	int fd, err, exp_err = 0;
113 	const char *exp_msg = NULL;
114 	char buf[4096];
115 
116 	switch (prog_type) {
117 	case BPF_PROG_TYPE_CGROUP_SOCK_ADDR:
118 		opts.expected_attach_type = BPF_CGROUP_INET4_CONNECT;
119 		break;
120 	case BPF_PROG_TYPE_CGROUP_SOCKOPT:
121 		opts.expected_attach_type = BPF_CGROUP_GETSOCKOPT;
122 		break;
123 	case BPF_PROG_TYPE_SK_LOOKUP:
124 		opts.expected_attach_type = BPF_SK_LOOKUP;
125 		break;
126 	case BPF_PROG_TYPE_KPROBE:
127 		opts.kern_version = get_kernel_version();
128 		break;
129 	case BPF_PROG_TYPE_LIRC_MODE2:
130 		opts.expected_attach_type = BPF_LIRC_MODE2;
131 		break;
132 	case BPF_PROG_TYPE_TRACING:
133 	case BPF_PROG_TYPE_LSM:
134 		opts.log_buf = buf;
135 		opts.log_size = sizeof(buf);
136 		opts.log_level = 1;
137 		if (prog_type == BPF_PROG_TYPE_TRACING)
138 			opts.expected_attach_type = BPF_TRACE_FENTRY;
139 		else
140 			opts.expected_attach_type = BPF_MODIFY_RETURN;
141 		opts.attach_btf_id = 1;
142 
143 		exp_err = -EINVAL;
144 		exp_msg = "attach_btf_id 1 is not a function";
145 		break;
146 	case BPF_PROG_TYPE_EXT:
147 		opts.log_buf = buf;
148 		opts.log_size = sizeof(buf);
149 		opts.log_level = 1;
150 		opts.attach_btf_id = 1;
151 
152 		exp_err = -EINVAL;
153 		exp_msg = "Cannot replace kernel functions";
154 		break;
155 	case BPF_PROG_TYPE_SYSCALL:
156 		opts.prog_flags = BPF_F_SLEEPABLE;
157 		break;
158 	case BPF_PROG_TYPE_STRUCT_OPS:
159 		exp_err = -524; /* -ENOTSUPP */
160 		break;
161 	case BPF_PROG_TYPE_UNSPEC:
162 	case BPF_PROG_TYPE_SOCKET_FILTER:
163 	case BPF_PROG_TYPE_SCHED_CLS:
164 	case BPF_PROG_TYPE_SCHED_ACT:
165 	case BPF_PROG_TYPE_TRACEPOINT:
166 	case BPF_PROG_TYPE_XDP:
167 	case BPF_PROG_TYPE_PERF_EVENT:
168 	case BPF_PROG_TYPE_CGROUP_SKB:
169 	case BPF_PROG_TYPE_CGROUP_SOCK:
170 	case BPF_PROG_TYPE_LWT_IN:
171 	case BPF_PROG_TYPE_LWT_OUT:
172 	case BPF_PROG_TYPE_LWT_XMIT:
173 	case BPF_PROG_TYPE_SOCK_OPS:
174 	case BPF_PROG_TYPE_SK_SKB:
175 	case BPF_PROG_TYPE_CGROUP_DEVICE:
176 	case BPF_PROG_TYPE_SK_MSG:
177 	case BPF_PROG_TYPE_RAW_TRACEPOINT:
178 	case BPF_PROG_TYPE_RAW_TRACEPOINT_WRITABLE:
179 	case BPF_PROG_TYPE_LWT_SEG6LOCAL:
180 	case BPF_PROG_TYPE_SK_REUSEPORT:
181 	case BPF_PROG_TYPE_FLOW_DISSECTOR:
182 	case BPF_PROG_TYPE_CGROUP_SYSCTL:
183 		break;
184 	case BPF_PROG_TYPE_NETFILTER:
185 		opts.expected_attach_type = BPF_NETFILTER;
186 		break;
187 	default:
188 		return -EOPNOTSUPP;
189 	}
190 
191 	fd = bpf_prog_load(prog_type, NULL, "GPL", insns, insns_cnt, &opts);
192 	err = -errno;
193 	if (fd >= 0)
194 		close(fd);
195 	if (exp_err) {
196 		if (fd >= 0 || err != exp_err)
197 			return 0;
198 		if (exp_msg && !strstr(buf, exp_msg))
199 			return 0;
200 		return 1;
201 	}
202 	return fd >= 0 ? 1 : 0;
203 }
204 
205 int libbpf_probe_bpf_prog_type(enum bpf_prog_type prog_type, const void *opts)
206 {
207 	struct bpf_insn insns[] = {
208 		BPF_MOV64_IMM(BPF_REG_0, 0),
209 		BPF_EXIT_INSN()
210 	};
211 	const size_t insn_cnt = ARRAY_SIZE(insns);
212 	int ret;
213 
214 	if (opts)
215 		return libbpf_err(-EINVAL);
216 
217 	ret = probe_prog_load(prog_type, insns, insn_cnt, NULL, 0);
218 	return libbpf_err(ret);
219 }
220 
221 int libbpf__load_raw_btf(const char *raw_types, size_t types_len,
222 			 const char *str_sec, size_t str_len)
223 {
224 	struct btf_header hdr = {
225 		.magic = BTF_MAGIC,
226 		.version = BTF_VERSION,
227 		.hdr_len = sizeof(struct btf_header),
228 		.type_len = types_len,
229 		.str_off = types_len,
230 		.str_len = str_len,
231 	};
232 	int btf_fd, btf_len;
233 	__u8 *raw_btf;
234 
235 	btf_len = hdr.hdr_len + hdr.type_len + hdr.str_len;
236 	raw_btf = malloc(btf_len);
237 	if (!raw_btf)
238 		return -ENOMEM;
239 
240 	memcpy(raw_btf, &hdr, sizeof(hdr));
241 	memcpy(raw_btf + hdr.hdr_len, raw_types, hdr.type_len);
242 	memcpy(raw_btf + hdr.hdr_len + hdr.type_len, str_sec, hdr.str_len);
243 
244 	btf_fd = bpf_btf_load(raw_btf, btf_len, NULL);
245 
246 	free(raw_btf);
247 	return btf_fd;
248 }
249 
250 static int load_local_storage_btf(void)
251 {
252 	const char strs[] = "\0bpf_spin_lock\0val\0cnt\0l";
253 	/* struct bpf_spin_lock {
254 	 *   int val;
255 	 * };
256 	 * struct val {
257 	 *   int cnt;
258 	 *   struct bpf_spin_lock l;
259 	 * };
260 	 */
261 	__u32 types[] = {
262 		/* int */
263 		BTF_TYPE_INT_ENC(0, BTF_INT_SIGNED, 0, 32, 4),  /* [1] */
264 		/* struct bpf_spin_lock */                      /* [2] */
265 		BTF_TYPE_ENC(1, BTF_INFO_ENC(BTF_KIND_STRUCT, 0, 1), 4),
266 		BTF_MEMBER_ENC(15, 1, 0), /* int val; */
267 		/* struct val */                                /* [3] */
268 		BTF_TYPE_ENC(15, BTF_INFO_ENC(BTF_KIND_STRUCT, 0, 2), 8),
269 		BTF_MEMBER_ENC(19, 1, 0), /* int cnt; */
270 		BTF_MEMBER_ENC(23, 2, 32),/* struct bpf_spin_lock l; */
271 	};
272 
273 	return libbpf__load_raw_btf((char *)types, sizeof(types),
274 				     strs, sizeof(strs));
275 }
276 
277 static int probe_map_create(enum bpf_map_type map_type)
278 {
279 	LIBBPF_OPTS(bpf_map_create_opts, opts);
280 	int key_size, value_size, max_entries;
281 	__u32 btf_key_type_id = 0, btf_value_type_id = 0;
282 	int fd = -1, btf_fd = -1, fd_inner = -1, exp_err = 0, err = 0;
283 
284 	key_size	= sizeof(__u32);
285 	value_size	= sizeof(__u32);
286 	max_entries	= 1;
287 
288 	switch (map_type) {
289 	case BPF_MAP_TYPE_STACK_TRACE:
290 		value_size	= sizeof(__u64);
291 		break;
292 	case BPF_MAP_TYPE_LPM_TRIE:
293 		key_size	= sizeof(__u64);
294 		value_size	= sizeof(__u64);
295 		opts.map_flags	= BPF_F_NO_PREALLOC;
296 		break;
297 	case BPF_MAP_TYPE_CGROUP_STORAGE:
298 	case BPF_MAP_TYPE_PERCPU_CGROUP_STORAGE:
299 		key_size	= sizeof(struct bpf_cgroup_storage_key);
300 		value_size	= sizeof(__u64);
301 		max_entries	= 0;
302 		break;
303 	case BPF_MAP_TYPE_QUEUE:
304 	case BPF_MAP_TYPE_STACK:
305 		key_size	= 0;
306 		break;
307 	case BPF_MAP_TYPE_SK_STORAGE:
308 	case BPF_MAP_TYPE_INODE_STORAGE:
309 	case BPF_MAP_TYPE_TASK_STORAGE:
310 	case BPF_MAP_TYPE_CGRP_STORAGE:
311 		btf_key_type_id = 1;
312 		btf_value_type_id = 3;
313 		value_size = 8;
314 		max_entries = 0;
315 		opts.map_flags = BPF_F_NO_PREALLOC;
316 		btf_fd = load_local_storage_btf();
317 		if (btf_fd < 0)
318 			return btf_fd;
319 		break;
320 	case BPF_MAP_TYPE_RINGBUF:
321 	case BPF_MAP_TYPE_USER_RINGBUF:
322 		key_size = 0;
323 		value_size = 0;
324 		max_entries = sysconf(_SC_PAGE_SIZE);
325 		break;
326 	case BPF_MAP_TYPE_STRUCT_OPS:
327 		/* we'll get -ENOTSUPP for invalid BTF type ID for struct_ops */
328 		opts.btf_vmlinux_value_type_id = 1;
329 		exp_err = -524; /* -ENOTSUPP */
330 		break;
331 	case BPF_MAP_TYPE_BLOOM_FILTER:
332 		key_size = 0;
333 		max_entries = 1;
334 		break;
335 	case BPF_MAP_TYPE_HASH:
336 	case BPF_MAP_TYPE_ARRAY:
337 	case BPF_MAP_TYPE_PROG_ARRAY:
338 	case BPF_MAP_TYPE_PERF_EVENT_ARRAY:
339 	case BPF_MAP_TYPE_PERCPU_HASH:
340 	case BPF_MAP_TYPE_PERCPU_ARRAY:
341 	case BPF_MAP_TYPE_CGROUP_ARRAY:
342 	case BPF_MAP_TYPE_LRU_HASH:
343 	case BPF_MAP_TYPE_LRU_PERCPU_HASH:
344 	case BPF_MAP_TYPE_ARRAY_OF_MAPS:
345 	case BPF_MAP_TYPE_HASH_OF_MAPS:
346 	case BPF_MAP_TYPE_DEVMAP:
347 	case BPF_MAP_TYPE_DEVMAP_HASH:
348 	case BPF_MAP_TYPE_SOCKMAP:
349 	case BPF_MAP_TYPE_CPUMAP:
350 	case BPF_MAP_TYPE_XSKMAP:
351 	case BPF_MAP_TYPE_SOCKHASH:
352 	case BPF_MAP_TYPE_REUSEPORT_SOCKARRAY:
353 		break;
354 	case BPF_MAP_TYPE_UNSPEC:
355 	default:
356 		return -EOPNOTSUPP;
357 	}
358 
359 	if (map_type == BPF_MAP_TYPE_ARRAY_OF_MAPS ||
360 	    map_type == BPF_MAP_TYPE_HASH_OF_MAPS) {
361 		fd_inner = bpf_map_create(BPF_MAP_TYPE_HASH, NULL,
362 					  sizeof(__u32), sizeof(__u32), 1, NULL);
363 		if (fd_inner < 0)
364 			goto cleanup;
365 
366 		opts.inner_map_fd = fd_inner;
367 	}
368 
369 	if (btf_fd >= 0) {
370 		opts.btf_fd = btf_fd;
371 		opts.btf_key_type_id = btf_key_type_id;
372 		opts.btf_value_type_id = btf_value_type_id;
373 	}
374 
375 	fd = bpf_map_create(map_type, NULL, key_size, value_size, max_entries, &opts);
376 	err = -errno;
377 
378 cleanup:
379 	if (fd >= 0)
380 		close(fd);
381 	if (fd_inner >= 0)
382 		close(fd_inner);
383 	if (btf_fd >= 0)
384 		close(btf_fd);
385 
386 	if (exp_err)
387 		return fd < 0 && err == exp_err ? 1 : 0;
388 	else
389 		return fd >= 0 ? 1 : 0;
390 }
391 
392 int libbpf_probe_bpf_map_type(enum bpf_map_type map_type, const void *opts)
393 {
394 	int ret;
395 
396 	if (opts)
397 		return libbpf_err(-EINVAL);
398 
399 	ret = probe_map_create(map_type);
400 	return libbpf_err(ret);
401 }
402 
403 int libbpf_probe_bpf_helper(enum bpf_prog_type prog_type, enum bpf_func_id helper_id,
404 			    const void *opts)
405 {
406 	struct bpf_insn insns[] = {
407 		BPF_EMIT_CALL((__u32)helper_id),
408 		BPF_EXIT_INSN(),
409 	};
410 	const size_t insn_cnt = ARRAY_SIZE(insns);
411 	char buf[4096];
412 	int ret;
413 
414 	if (opts)
415 		return libbpf_err(-EINVAL);
416 
417 	/* we can't successfully load all prog types to check for BPF helper
418 	 * support, so bail out with -EOPNOTSUPP error
419 	 */
420 	switch (prog_type) {
421 	case BPF_PROG_TYPE_TRACING:
422 	case BPF_PROG_TYPE_EXT:
423 	case BPF_PROG_TYPE_LSM:
424 	case BPF_PROG_TYPE_STRUCT_OPS:
425 		return -EOPNOTSUPP;
426 	default:
427 		break;
428 	}
429 
430 	buf[0] = '\0';
431 	ret = probe_prog_load(prog_type, insns, insn_cnt, buf, sizeof(buf));
432 	if (ret < 0)
433 		return libbpf_err(ret);
434 
435 	/* If BPF verifier doesn't recognize BPF helper ID (enum bpf_func_id)
436 	 * at all, it will emit something like "invalid func unknown#181".
437 	 * If BPF verifier recognizes BPF helper but it's not supported for
438 	 * given BPF program type, it will emit "unknown func bpf_sys_bpf#166".
439 	 * In both cases, provided combination of BPF program type and BPF
440 	 * helper is not supported by the kernel.
441 	 * In all other cases, probe_prog_load() above will either succeed (e.g.,
442 	 * because BPF helper happens to accept no input arguments or it
443 	 * accepts one input argument and initial PTR_TO_CTX is fine for
444 	 * that), or we'll get some more specific BPF verifier error about
445 	 * some unsatisfied conditions.
446 	 */
447 	if (ret == 0 && (strstr(buf, "invalid func ") || strstr(buf, "unknown func ")))
448 		return 0;
449 	return 1; /* assume supported */
450 }
451