Skip to content

Commit a543d78

Browse files
authored
Add moredescription for uprobe btf (#104)
1 parent 2b74656 commit a543d78

File tree

1 file changed

+38
-8
lines changed

1 file changed

+38
-8
lines changed

src/38-btf-uprobe/README.md

Lines changed: 38 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -31,11 +31,9 @@ eBPF 中的 “co-re” 代表“一次编译、到处运行”。这是其关
3131

3232
eBPF也支持追踪用户空间应用程序。Uprobe是一个用户空间探针,允许对用户空间程序进行动态仪表装置。探针位置包括函数入口、特定偏移和函数返回。
3333

34-
BTF是为内核设计的,生成自vmlinux,它可以帮助eBPF程序方便地兼容不同的内核版本。
34+
BTF是为内核设计的,生成自vmlinux,它可以帮助eBPF程序方便地兼容不同的内核版本。但是,用户空间应用程序也需要CO-RE。例如,SSL/TLS uprobe被广泛用于从加密流量中捕获明文数据。它是用用户空间库实现的,如OpenSSL、GnuTLS、NSS等。用户空间应用程序和库也有各种版本,如果我们需要为每个版本编译和维护eBPF程序,那就会很复杂。
3535

36-
但是,用户空间应用程序也需要CO-RE。例如,SSL/TLS uprobe被广泛用于从加密流量中捕获明文数据。它是用用户空间库实现的,如OpenSSL、GnuTLS、NSS等。用户空间应用程序和库也有各种版本,如果我们需要为每个版本编译和维护eBPF程序,那就会很复杂。
37-
38-
下面是一些新的工具和方法来帮助我们为用户空间应用程序启用CO-RE。
36+
下面是一些新的工具和方法,可以帮助我们为用户空间应用程序启用CO-RE。
3937

4038
## 用户空间程序的BTF
4139

@@ -157,7 +155,7 @@ $ sudo cat /sys/kernel/debug/tracing/trace_pipe\
157155
<...>-25809 [001] ...11 27828.314224: bpf_trace_printk: add_test(&d) 1 + 2 = 3
158156
```
159157

160-
结果是不同的,因为两个版本中的struct `data`是不同的。eBPF程序无法与不同版本的用户空间程序兼容。
158+
结果是不同的,因为两个版本中的struct `data`是不同的。eBPF程序无法与不同版本的用户空间程序兼容,我们获取到了错误的结构体偏移量,也会导致我们追踪失败
161159

162160
## 使用用户空间程序的BTF
163161

@@ -255,14 +253,46 @@ $ sudo cat /sys/kernel/debug/tracing/trace_pipe
255253
<...>-26740 [001] ...11 28180.156220: bpf_trace_printk: add_test(&d) 1 + 3 = 4
256254
```
257255

256+
我们的 eBPF 追踪程序也几乎不需要进行任何修改,只需要把包含 kernel 和用户态结构体偏移量的 BTF 加载进来即可。这和旧版本内核上没有 btf 信息的使用方式是一样的:
257+
258+
```c
259+
LIBBPF_OPTS(bpf_object_open_opts , opts,
260+
);
261+
LIBBPF_OPTS(bpf_uprobe_opts, uprobe_opts);
262+
if (argc != 3 && argc != 2) {
263+
fprintf(stderr, "Usage: %s <example-name> [<external-btf>]\n", argv[0]);
264+
return 1;
265+
}
266+
if (argc == 3)
267+
opts.btf_custom_path = argv[2];
268+
269+
/* Set up libbpf errors and debug info callback */
270+
libbpf_set_print(libbpf_print_fn);
271+
272+
/* Cleaner handling of Ctrl-C */
273+
signal(SIGINT, sig_handler);
274+
signal(SIGTERM, sig_handler);
275+
276+
/* Load and verify BPF application */
277+
skel = uprobe_bpf__open_opts(&opts);
278+
if (!skel) {
279+
fprintf(stderr, "Failed to open and load BPF skeleton\n");
280+
return 1;
281+
}
282+
```
283+
284+
实际上,btf 实现重定向需要两个部分,一个是 bpf 程序带的编译时的 btf 信息,一个是内核的 btf 信息。在实际加载 ebpf 程序的时候,libbpf 会根据当前内核上准确的 btf 信息,来修改可能存在错误的 ebpf 指令,确保在不同内核版本上能够兼容。
285+
286+
有趣的是,实际上 libbpf 并不区分这些 btf 信息来自用户态程序还是内核,因此我们只要把用户态的重定向信息一起提供给 libbpf 进行重定向,问题就解决了。
287+
258288
本文的工具和完整的代码在 <https://github.com/eunomia-bpf/bpf-developer-tutorial/tree/main/src/38-btf-uprobe> 开源。
259289
260290
## 结论
261291
262-
- **灵活性和兼容性**在用户空间eBPF程序中使用BTF大大增强了它们在不同版本的用户空间应用程序和库之间的灵活性和兼容性
292+
- **灵活性和兼容性**:在用户空间eBPF程序中使用 BTF 大大增强了它们在不同版本的用户空间应用程序和库之间的灵活性和兼容性
263293
- **简化了复杂性**:这种方法显著减少了维护不同版本的用户空间应用程序的eBPF程序的复杂性,因为它消除了需要多个程序版本的需要。
264-
- **更广泛的应用**虽然你的例子关注于SSL/TLS监控,但是这种方法在性能监控、安全和用户空间应用程序的调试等方面有更广泛的应用
294+
- **更广泛的应用**:这种方法在性能监控、安全和用户空间应用程序的调试等方面也可能能有更广泛的应用。bpftime(https://github.com/eunomia-bpf/bpftime) 是一个开源的基于 LLVM JIT/AOT 的用户态 eBPF 运行时,它可以在用户态运行 eBPF 程序,和内核态的 eBPF 兼容。它在支持 uprobe、syscall trace 和一般的插件扩展的同时,避免了内核态和用户态之间的上下文切换,从而提高了 uprobe 程序的执行效率。借助 libbpf 和 btf 的支持,bpftime 也可以更加动态的扩展用户态应用程序,实现在不同用户态程序版本之间的兼容性
265295
266-
这个示例展示了eBPF在实践中的重要进步,将其强大的功能扩展到更动态地处理用户空间应用程序在Linux环境中。对于处理现代Linux系统复杂性的软件工程师和系统管理员来说,这是一个引人注目的解决方案
296+
这个示例展示了 eBPF 在实践中可以将其强大的 CO-RE 功能扩展到更动态地处理用户空间应用的不同版本变化
267297
268298
如果你想了解更多关于eBPF知识和实践,你可以访问我们的教程代码库<https://github.com/eunomia-bpf/bpf-developer-tutorial>或者网站<https://eunomia.dev/tutorials/>获得更多示例和完整教程。

0 commit comments

Comments
 (0)