From 8a080f41783fd2724f617d41085e8ed3e4c19f74 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E4=BA=91=E5=BE=AE?= <1067852565@qq.com> Date: Fri, 24 Mar 2023 02:56:29 +0800 Subject: [PATCH] Improve hello world and add template documents (#16) * rename ecli to ecli run * improve hello world document * update template documents * update bcc link --- README.md | 10 +++-- chatGPT.md | 28 ++++++------ src/1-helloworld/README.md | 70 ++++++++++++++++++++--------- src/10-hardirqs/README.md | 2 +- src/11-bootstrap/README.md | 2 +- src/19-lsm-connect/README.md | 2 +- src/2-kprobe-unlink/README.md | 2 +- src/20-tc/README.md | 2 +- src/3-fentry-unlink/README.md | 2 +- src/4-opensnoop/README.md | 2 +- src/5-uprobe-bashreadline/README.md | 2 +- src/6-sigsnoop/README.md | 2 +- src/9-runqlat/README.md | 6 +-- src/SUMMARY.md | 7 +-- 14 files changed, 83 insertions(+), 56 deletions(-) diff --git a/README.md b/README.md index ceadfb1..835c48c 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,12 @@ -# 基于 libbpf 的 eBPF 开发者教程：通过 20 个小工具一步步学习 eBPF +# eBPF 开发者教程：通过 20 个小工具一步步学习 eBPF -这是一个基于 `CO-RE`（一次编译，到处运行）的 `libbpf` 的 eBPF 的开发教程，提供了从入门到进阶的 eBPF 开发实践，包括基本概念、代码实例、实际应用等内容。除了通常的教程文本内容，我们也希望通过 ChatGPT 等工具，为您提供交互式的 eBPF 学习体验！ +这是一个基于 `CO-RE`（一次编译，到处运行）的 eBPF 的开发教程，提供了从入门到进阶的 eBPF 开发实践，包括基本概念、代码实例、实际应用等内容。本教程主要基于 libbpf 框架，不过也包含了 BCC 的开发者教程文档：[bcc-documents](src\bcc-documents) + +除了通常的教程文本内容，我们也希望通过 ChatGPT 等工具，为您提供交互式的 eBPF 学习体验！ 本教程不会进行复杂的概念讲解和场景介绍，主要希望提供一些 eBPF 小工具的案例（**非常短小，从二十行代码开始入门！**），来帮助 eBPF 应用的开发者快速上手 eBPF 的开发方法和技巧。教程内容可以在目录中找到，每个目录都是一个独立的 eBPF 工具案例。 -在学习 eBPF 的过程中，我们受到了 [bcc python developer tutorial](https://github.com/iovisor/bcc/blob/master/docs/tutorial_bcc_python_developer.md) 的许多启发和帮助，但从 2022 年的角度出发，使用 libbpf 开发 eBPF 的应用是目前相对更好的选择。但目前似乎很少有基于 libbpf 和 BPF CO-RE 出发的、通过案例和工具介绍 eBPF 开发的教程，因此我们发起了这个项目，采用类似 bcc python developer tutorial 的组织方式，但使用 CO-RE 的 libbpf 进行开发。 +在学习 eBPF 的过程中，我们受到了 [bcc python developer tutorial](src\bcc-documents/tutorial_bcc_python_developer.md) 的许多启发和帮助，但从 2022 年的角度出发，使用 libbpf 开发 eBPF 的应用是目前相对更好的选择。但目前似乎很少有基于 libbpf 和 BPF CO-RE 出发的、通过案例和工具介绍 eBPF 开发的教程，因此我们发起了这个项目，采用类似 bcc python developer tutorial 的组织方式，但使用 CO-RE 的 libbpf 进行开发。 本项目主要基于 [libbpf-boostrap](https://github.com/libbpf/libbpf-bootstrap) 和 [eunomia-bpf](https://github.com/eunomia-bpf/eunomia-bpf) 两个框架完成，并使用 eunomia-bpf 帮助简化一部分 libbpf eBPF 用户态代码的编写，让开发者专注于内核态的 eBPF 代码的开发。 @@ -13,7 +15,7 @@ Gitee 镜像： > - 我们还提供了一个使用 ChatGPT ，通过自然语言描述即可自动编写 eBPF 程序和追踪 Linux 系统的小工具，可以让您交互式地学习 eBPF 程序：[GPTtrace](https://github.com/eunomia-bpf/GPTtrace) -> - 欢迎在本仓库的 issue 或 discussion 中提出任意关于 eBPF 学习的疑惑和问题，或者生产实践中遇到的 bug，我们会尽力帮助您解答！ +> - 欢迎在本仓库的 issue 或 discussion 中提出任意关于 eBPF 学习的疑惑和问题，或者实践中遇到的 bug，我们会尽力帮助您解答！ ## 目录 diff --git a/chatGPT.md b/chatGPT.md index 971fe41..6997ee2 100644 --- a/chatGPT.md +++ b/chatGPT.md @@ -51,7 +51,7 @@ Packing ebpf object and config into package.json... 然后运行： ```console -sudo ecli package.json +sudo ecli run package.json ``` 在 /sys/kernel/debug/tracing/trace_pipe 文件中，应该能看到类似下面的 kprobe 演示输出： @@ -158,7 +158,7 @@ docker run -it -v `pwd`/:/src/ yunwei37/ebpm:latest 然后使用 ecli 运行编译后的程序： ```console -$ sudo ecli ./package.json +$ sudo ecli run ./package.json Runing eBPF program... ``` @@ -209,7 +209,7 @@ Packing ebpf object and config into package.json... > 使用 ecli 命令运行编译后的程序： ```console -$ sudo ecli ./package.json +$ sudo ecli run ./package.json Runing eBPF program... ``` @@ -477,7 +477,7 @@ docker run -it -v `pwd`/:/src/ yunwei37/ebpm:latest > 然后使用 ecli 运行编译后的程序： ```sh -$ sudo ecli ./package.json +$ sudo ecli run ./package.json Runing eBPF program... ``` > 运行这段程序后，可以通过查看 /sys/kernel/debug/tracing/trace_pipe 文件来查看 eBPF 程序的输出： @@ -892,7 +892,7 @@ docker run -it -v `pwd`/:/src/ yunwei37/ebpm:latest 然后使用 ecli 运行编译后的程序： ```console -$ sudo ecli ./package.json +$ sudo ecli run ./package.json Runing eBPF program... ``` @@ -908,7 +908,7 @@ $ sudo cat /sys/kernel/debug/tracing/trace_pipe > > 请注意，使用 ecc 编译程序后，会生成一个 package.json 文件，其中包含编译后的 eBPF 程序和配置信息。运行 eBPF 程序时，需要指定该文件，以便 ecli 命令能够找到并运行 eBPF 程序。例如，可以使用以下命令运行 eBPF 程序： ``` -$ sudo ecli ./package.json +$ sudo ecli run ./package.json ``` > 如果您还有任何问题，请随时告诉我，我很乐意帮助您解决问题。 @@ -969,7 +969,7 @@ Packing ebpf object and config into package.json... 然后运行： ```console -sudo ecli package.json +sudo ecli run package.json ``` 在 /sys/kernel/debug/tracing/trace_pipe 文件中，应该能看到类似下面的 kprobe 演示输出： @@ -1039,7 +1039,7 @@ ecc kprobe-link.bpf.c ``` > 编译后，您会得到一个 package.json 文件。您可以使用 ecli 命令运行该程序： ``` -sudo ecli package.json +sudo ecli run package.json ``` > 运行该程序后，您可以查看 /sys/kernel/debug/tracing/trace_pipe 文件，以查看程序的输出。请注意，编译和运行 eBPF 程序的步骤可能会有所不同，具体取决于使用的工具和系统环境。如果您在编 @@ -1100,7 +1100,7 @@ Packing ebpf object and config into package.json... > 然后运行： ``` -sudo ecli package.json +sudo ecli run package.json ``` > 在 /sys/kernel/debug/tracing/trace_pipe 文件中，应该能看到类似下面的输出： @@ -1182,7 +1182,7 @@ Packing ebpf object and config into package.json... > 然后使用 ecli 运行编译后的程序： ``` -$ sudo ecli ./package.json +$ sudo ecli run ./package.json Runing eBPF program... ``` > 在 /sys/kernel/debug/tracing/trace_pipe 文件中，应该能看到类似下面的输出： @@ -1423,7 +1423,7 @@ Packing ebpf object and config into package.json... ``` ```shell -$ sudo ecli ./package.json +$ sudo ecli run ./package.json ... Successfully started! Please run `sudo cat /sys/kernel/debug/tracing/trace_pipe` to see output of the BPF program. ...... @@ -1691,7 +1691,7 @@ char LICENSE[] SEC("license") = "GPL"; 它的输出结果类似这样： ```console -$ sudo ecli examples/bpftools/runqlat/package.json +$ sudo ecli run examples/bpftools/runqlat/package.json key = 4294967295 comm = rcu_preempt @@ -1734,11 +1734,11 @@ struct { > 正确的。该程序使用 BPF hash map 来记录每个线程的执行时间，并使用 BPF sample hash map 来定期输出每个线程的直方图。您可以通过在 /sys/kernel/debug/tracing/ 文件系统中执行 "cat runqslat" 来查看输出。 -不，应该通过 sudo ecli examples/bpftools/runqlat/package.json 来查看输出。 +不，应该通过 sudo ecli run examples/bpftools/runqlat/package.json 来查看输出。 > 对，这样就可以看到输出的直方图了。例如： ``` -$ sudo ecli examples/bpftools/runqlat/package.json +$ sudo ecli run examples/bpftools/runqlat/package.json key = 4294967295 comm = rcu_preempt diff --git a/src/1-helloworld/README.md b/src/1-helloworld/README.md index f86e821..1bf770d 100644 --- a/src/1-helloworld/README.md +++ b/src/1-helloworld/README.md @@ -1,34 +1,40 @@ # eBPF 入门开发实践教程二：Hello World，基本框架和开发流程 -eBPF (Extended Berkeley Packet Filter) 是 Linux 内核上的一个强大的网络和性能分析工具。它允许开发者在内核运行时动态加载、更新和运行用户定义的代码。 +在本篇博客中，我们将深入探讨eBPF（Extended Berkeley Packet Filter）的基本框架和开发流程。eBPF是一种在Linux内核上运行的强大网络和性能分析工具，它为开发者提供了在内核运行时动态加载、更新和运行用户定义代码的能力。这使得开发者可以实现高效、安全的内核级别的网络监控、性能分析和故障排查等功能。 -本文是 eBPF 入门开发实践教程的第二篇，主要介绍 eBPF 的基本框架和开发流程。 +本文是eBPF入门开发实践教程的第二篇，我们将重点关注如何编写一个简单的eBPF程序，并通过实际例子演示整个开发流程。在阅读本教程之前，建议您先学习第一篇教程，以便对eBPF的基本概念有个大致的了解。 -开发 eBPF 程序可以使用多种工具，如 BCC、eunomia-bpf 等。不同的工具有不同的特点，但基本流程大致相同。 +在开发eBPF程序时，有多种开发框架可供选择，如 BCC（BPF Compiler Collection）libbpf、cilium/ebpf、eunomia-bpf 等。虽然不同工具的特点各异，但它们的基本开发流程大致相同。在接下来的内容中，我们将深入了解这些流程，并以 Hello World 程序为例，带领读者逐步掌握eBPF开发的基本技巧。 -## 开发 eBPF 程序的流程 +本教程将帮助您了解eBPF程序的基本结构、编译和加载过程、用户空间与内核空间的交互方式以及调试与优化技巧。通过学习本教程，您将掌握eBPF开发的基本知识，并为后续进一步学习和实践奠定坚实的基础。 -下面以 BCC 工具为例，介绍 eBPF 程序的基本开发流程。 +## eBPF开发环境准备与基本开发流程 -1. 安装编译环境和依赖。使用 BCC 开发 eBPF 程序需要安装 LLVM/Clang 和 bcc，以及其它的依赖库。 -2. 编写 eBPF 程序。eBPF 程序主要由两部分构成：内核态部分和用户态部分。内核态部分包含 eBPF 程序的实际逻辑，用户态部分负责加载、运行和监控内核态程序。 -3. 编译和加载 eBPF 程序。使用 bcc 工具将 eBPF 程序编译成机器码，然后使用用户态代码加载并运行该程序。 -4. 运行程序并处理数据。eBPF 程序在内核运行时会触发事件，并将事件相关的信息传递给用户态程序。用户态程序负责处理这些信息并将结果输出。 -5. 结束程序。当 eBPF 程序运行完成后，用户态程序可以卸载并结束运行。 +在开始编写eBPF程序之前，我们需要准备一个合适的开发环境，并了解eBPF程序的基本开发流程。本部分将详细介绍这些内容。 -通过这个过程，你可以开发出一个能够在内核中运行的 eBPF 程序。 +### 安装必要的软件和工具 -## 使用 eunomia-bpf 开发 eBPF 程序 +要开发eBPF程序，您需要安装以下软件和工具： -eunomia-bpf 是一个开源的 eBPF 动态加载运行时和开发工具链，它的目的是简化 eBPF 程序的开发、构建、分发、运行。它基于 libbpf 的 CO-RE 轻量级开发框架，支持通过用户态 WASM 虚拟机控制 eBPF 程序的加载和执行，并将预编译的 eBPF 程序打包为通用的 JSON 或 WASM 模块进行分发。使用 eunomia-bpf 可以大幅简化 eBPF 程序的开发流程。 +- Linux 内核：由于eBPF是内核技术，因此您需要具备较新版本的Linux内核（推荐4.8及以上版本），以支持eBPF功能。 +- LLVM 和 Clang：这些工具用于编译eBPF程序。安装最新版本的LLVM和Clang可以确保您获得最佳的eBPF支持。 -使用 eunomia-bpf 开发 eBPF 程序的流程也大致相同，只是细节略有不同。 +eBPF 程序主要由两部分构成：内核态部分和用户态部分。内核态部分包含 eBPF 程序的实际逻辑，用户态部分负责加载、运行和监控内核态程序。当您选择了合适的开发框架后，如 BCC（BPF Compiler Collection）、libbpf、cilium/ebpf或eunomia-bpf等，您可以开始进行用户态和内核态程序的开发。以 BCC 工具为例，我们将介绍 eBPF 程序的基本开发流程： -1. 安装编译环境和依赖。使用 eunomia-bpf 开发 eBPF 程序需要安装 eunomia-bpf 工具链和运行时库，以及其它的依赖库。 -2. 编写 eBPF 程序。eBPF 程序主要由两部分构成：内核态部分和用户态部分。内核态部分包含 eBPF 程序的实际逻辑，用户态部分负责加载、运行和监控内核态程序。使用 eunomia-bpf，只需编写内核态代码即可，无需编写用户态代码。 -3. 编译和加载 eBPF 程序。使用 eunomia-bpf 工具链将 eBPF 程序编译成机器码，并将编译后的代码打包为可以在任何系统上运行的模块。然后使用 eunomia-bpf 运行时库加载并运行该模块。 -4. 运行程序并处理数据。eBPF 程序在内核运行时会触发事件，并将事件相关的信息传递给用户态程序。eunomia-bpf 的运行时库负责处理这些信息并将结果输出。 -5. 结束程序。当 eBPF 程序运行完成后，eunomia-bpf 的运行时库可以卸载并结束运行 +当您选择了合适的开发框架后，如BCC（BPF Compiler Collection）、libbpf、cilium/ebpf或eunomia-bpf等，您可以开始进行用户态和内核态程序的开发。以BCC工具为例，我们将介绍eBPF程序的基本开发流程： + +1. 安装BCC工具：根据您的Linux发行版，按照BCC官方文档的指南安装BCC工具和相关依赖。 +2. 编写eBPF程序（C语言）：使用C语言编写一个简单的eBPF程序，例如Hello World程序。该程序可以在内核空间执行并完成特定任务，如统计网络数据包数量。 +3. 编写用户态程序（Python或C等）：使用Python、C等语言编写用户态程序，用于加载、运行eBPF程序以及与之交互。在这个程序中，您需要使用BCC提供的API来加载和操作内核态的eBPF程序。 +4. 编译eBPF程序：使用BCC工具，将C语言编写的eBPF程序编译成内核可以执行的字节码。BCC会在运行时动态从源码编译eBPF程序。 +5. 加载并运行eBPF程序：在用户态程序中，使用BCC提供的API加载编译好的eBPF程序到内核空间，然后运行该程序。 +6. 与eBPF程序交互：用户态程序通过BCC提供的API与eBPF程序交互，实现数据收集、分析和展示等功能。例如，您可以使用BCC API读取eBPF程序中的map数据，以获取网络数据包统计信息。 +7. 卸载eBPF程序：当不再需要eBPF程序时，用户态程序应使用BCC API将其从内核空间卸载。 +8. 调试与优化：使用 bpftool 等工具进行eBPF程序的调试和优化，提高程序性能和稳定性。 + +通过以上流程，您可以使用BCC工具开发、编译、运行和调试eBPF程序。请注意，其他框架（如libbpf、cilium/ebpf和eunomia-bpf）的开发流程大致相似但略有不同，因此在选择框架时，请参考相应的官方文档和示例。 + +通过这个过程，你可以开发出一个能够在内核中运行的 eBPF 程序。eunomia-bpf 是一个开源的 eBPF 动态加载运行时和开发工具链，它的目的是简化 eBPF 程序的开发、构建、分发、运行。它基于 libbpf 的 CO-RE 轻量级开发框架，支持通过用户态 WASM 虚拟机控制 eBPF 程序的加载和执行，并将预编译的 eBPF 程序打包为通用的 JSON 或 WASM 模块进行分发。我们会使用 eunomia-bpf 进行演示。 ## 下载安装 eunomia-bpf 开发工具 @@ -63,6 +69,10 @@ Packing ebpf object and config into /src/package.json... ## Hello World - minimal eBPF program +我们会先从一个简单的 eBPF 程序开始，它会在内核中打印一条消息。我们会使用 eunomia-bpf 的编译器工具链将其编译为 bpf 字节码文件，然后使用 ecli 工具加载并运行该程序。作为示例，我们可以暂时省略用户态程序的部分。 + +```c + ```c /* SPDX-License-Identifier: (LGPL-2.1 OR BSD-2-Clause) */ #define BPF_NO_GLOBAL_DATA @@ -110,7 +120,7 @@ docker run -it -v `pwd`/:/src/ yunwei37/ebpm:latest 然后使用 ecli 运行编译后的程序： ```console -$ sudo ecli ./package.json +$ sudo ecli run ./package.json Runing eBPF program... ``` @@ -136,6 +146,24 @@ $ sudo cat /sys/kernel/debug/tracing/trace_pipe 跟踪点（tracepoints）是内核静态插桩技术，跟踪点在技术上只是放置在内核源代码中的跟踪函数，实际上就是在源码中插入的一些带有控制条件的探测点，这些探测点允许事后再添加处理函数。比如在内核中，最常见的静态跟踪方法就是 printk，即输出日志。又比如：在系统调用、调度程序事件、文件系统操作和磁盘 I/O 的开始和结束时都有跟踪点。 于 2009 年在 Linux 2.6.32 版本中首次提供。跟踪点是一种稳定的 API，数量有限。 +## GitHub 模板：轻松构建 eBPF 项目和开发环境 + +面对创建一个 eBPF 项目，您是否对如何开始搭建环境以及选择编程语言感到困惑？别担心，我们为您准备了一系列 GitHub 模板，以便您快速启动一个全新的eBPF项目。只需在GitHub上点击 `Use this template` 按钮，即可开始使用。 + +- ：基于C语言和 libbpf 框架的eBPF项目模板 +- ：基于C语言和cilium/ebpf框架的eBPF项目模板 +- ：基于Rust语言和libbpf-rs框架的eBPF项目模板 +- ：基于C语言和eunomia-bpf框架的eBPF项目模板 + +这些启动模板包含以下功能： + +- 一个 Makefile，让您可以一键构建项目 +- 一个 Dockerfile，用于为您的 eBPF 项目自动创建一个容器化环境并发布到 Github Packages +- GitHub Actions，用于自动化构建、测试和发布流程 +- eBPF 开发所需的所有依赖项 + +> 通过将现有仓库设置为模板，您和其他人可以快速生成具有相同基础结构的新仓库，从而省去了手动创建和配置的繁琐过程。借助 GitHub 模板仓库，开发者可以专注于项目的核心功能和逻辑，而无需为基础设置和结构浪费时间。更多关于模板仓库的信息，请参阅官方文档：https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-template-repository + ## 总结 eBPF 程序的开发和使用流程可以概括为如下几个步骤： @@ -149,4 +177,4 @@ eBPF 程序的开发和使用流程可以概括为如下几个步骤： 需要注意的是，BPF 程序的执行是在内核空间进行的，因此需要使用特殊的工具和技术来编写、编译和调试 BPF 程序。eunomia-bpf 是一个开源的 BPF 编译器和工具包，它可以帮助开发者快速和简单地编写和运行 BPF 程序。 -完整的教程和源代码已经全部开源，可以在 中查看。 +本教程的文档和源代码已经全部开源，可以在 中查看。 diff --git a/src/10-hardirqs/README.md b/src/10-hardirqs/README.md index bac7856..8aad03e 100644 --- a/src/10-hardirqs/README.md +++ b/src/10-hardirqs/README.md @@ -166,7 +166,7 @@ Packing ebpf object and config into package.json... 然后运行： ```console -sudo ecli ./package.json +sudo ecli run ./package.json ``` ## 总结 diff --git a/src/11-bootstrap/README.md b/src/11-bootstrap/README.md index 82104e7..b32fa42 100644 --- a/src/11-bootstrap/README.md +++ b/src/11-bootstrap/README.md @@ -158,7 +158,7 @@ int handle_exit(struct trace_event_raw_sched_process_template* ctx) $ ecc bootstrap.bpf.c Compiling bpf object... Packing ebpf object and config into package.json... -$ sudo ecli package.json +$ sudo ecli run package.json Runing eBPF program... ``` diff --git a/src/19-lsm-connect/README.md b/src/19-lsm-connect/README.md index 3b94131..106d9ab 100644 --- a/src/19-lsm-connect/README.md +++ b/src/19-lsm-connect/README.md @@ -29,7 +29,7 @@ Packing ebpf object and config into package.json... Run: ```console -sudo ecli examples/bpftools/lsm-connect/package.json +sudo ecli run examples/bpftools/lsm-connect/package.json ``` ## 总结 diff --git a/src/2-kprobe-unlink/README.md b/src/2-kprobe-unlink/README.md index 30f0bac..984ed4f 100644 --- a/src/2-kprobe-unlink/README.md +++ b/src/2-kprobe-unlink/README.md @@ -75,7 +75,7 @@ Packing ebpf object and config into package.json... 然后运行： ```console -sudo ecli package.json +sudo ecli run package.json ``` 在另外一个窗口中： diff --git a/src/20-tc/README.md b/src/20-tc/README.md index b87d66a..b153656 100644 --- a/src/20-tc/README.md +++ b/src/20-tc/README.md @@ -67,7 +67,7 @@ Packing ebpf object and config into package.json... ``` ```shell -$ sudo ecli ./package.json +$ sudo ecli run ./package.json ... Successfully started! Please run `sudo cat /sys/kernel/debug/tracing/trace_pipe` to see output of the BPF program. ...... diff --git a/src/3-fentry-unlink/README.md b/src/3-fentry-unlink/README.md index 439ff00..b534022 100644 --- a/src/3-fentry-unlink/README.md +++ b/src/3-fentry-unlink/README.md @@ -48,7 +48,7 @@ eunomia-bpf 是一个结合 Wasm 的开源 eBPF 动态加载运行时和开发 $ ecc fentry-link.bpf.c Compiling bpf object... Packing ebpf object and config into package.json... -$ sudo ecli package.json +$ sudo ecli run package.json Runing eBPF program... ``` diff --git a/src/4-opensnoop/README.md b/src/4-opensnoop/README.md index e08a952..cdc0f33 100644 --- a/src/4-opensnoop/README.md +++ b/src/4-opensnoop/README.md @@ -43,7 +43,7 @@ eunomia-bpf 是一个结合 Wasm 的开源 eBPF 动态加载运行时和开发 $ ecc fentry-link.bpf.c Compiling bpf object... Packing ebpf object and config into package.json... -$ sudo ecli package.json +$ sudo ecli run package.json Runing eBPF program... ``` diff --git a/src/5-uprobe-bashreadline/README.md b/src/5-uprobe-bashreadline/README.md index 571f4aa..617d1c0 100644 --- a/src/5-uprobe-bashreadline/README.md +++ b/src/5-uprobe-bashreadline/README.md @@ -89,7 +89,7 @@ eunomia-bpf 是一个结合 Wasm 的开源 eBPF 动态加载运行时和开发 $ ecc bashreadline.bpf.c bashreadline.h Compiling bpf object... Packing ebpf object and config into package.json... -$ sudo ecli package.json +$ sudo ecli run package.json Runing eBPF program... ``` diff --git a/src/6-sigsnoop/README.md b/src/6-sigsnoop/README.md index 9a21964..ab4f047 100755 --- a/src/6-sigsnoop/README.md +++ b/src/6-sigsnoop/README.md @@ -106,7 +106,7 @@ $ ecc sigsnoop.bpf.c sigsnoop.h Compiling bpf object... Generating export types... Packing ebpf object and config into package.json... -$ sudo ecli package.json +$ sudo ecli run package.json Runing eBPF program... ``` diff --git a/src/9-runqlat/README.md b/src/9-runqlat/README.md index e2157d3..513293a 100755 --- a/src/9-runqlat/README.md +++ b/src/9-runqlat/README.md @@ -211,7 +211,7 @@ Packing ebpf object and config into package.json... Run: ```console -$ sudo ecli examples/bpftools/runqlat/package.json -h +$ sudo ecli run examples/bpftools/runqlat/package.json -h Usage: runqlat_bpf [--help] [--version] [--verbose] [--filter_cg] [--targ_per_process] [--targ_per_thread] [--targ_per_pidns] [--targ_ms] [--targ_tgid VAR] A simple eBPF program @@ -230,7 +230,7 @@ Optional arguments: Built with eunomia-bpf framework. See https://github.com/eunomia-bpf/eunomia-bpf for more information. -$ sudo ecli examples/bpftools/runqlat/package.json +$ sudo ecli run examples/bpftools/runqlat/package.json key = 4294967295 comm = rcu_preempt @@ -251,7 +251,7 @@ comm = rcu_preempt 8192 -> 16383 : 0 | | 16384 -> 32767 : 1 | | -$ sudo ecli examples/bpftools/runqlat/package.json --targ_per_process +$ sudo ecli run examples/bpftools/runqlat/package.json --targ_per_process key = 3189 comm = cpptools diff --git a/src/SUMMARY.md b/src/SUMMARY.md index 007d623..43bae71 100644 --- a/src/SUMMARY.md +++ b/src/SUMMARY.md @@ -1,6 +1,6 @@ # Summary -# eBPF 入门开发实践教程 +# eBPF 实践教程：基于 libbpf 和 CO-RE - [eBPF 入门开发实践教程一：介绍 eBPF 的基本概念、常见的开发工具](0-introduce/README.md) - [eBPF 入门开发实践教程二：Hello World，基本框架和开发流程](1-helloworld/README.md) @@ -14,9 +14,6 @@ - [eBPF 入门开发实践教程九：一个 Linux 内核 BPF 程序，通过柱状图来总结调度程序运行队列延迟，显示任务等待运行在 CPU 上的时间长度](9-runqlat/README.md) - [eBPF 入门开发实践教程十：在 eBPF 中使用 hardirqs 或 softirqs 捕获中断事件](10-hardirqs/README.md) - [eBPF 入门开发实践教程十一：在 eBPF 中使用 bootstrap 开发用户态程序并跟踪 exec() 和 exit() 系统调用](11-bootstrap/README.md) - -# eBPF入门实践教程 - - [eBPF入门实践教程：使用 libbpf-bootstrap 开发程序统计 TCP 连接延时](13-tcpconnlat/README.md) - [eBPF 入门实践教程：编写 eBPF 程序 tcpconnlat 测量 tcp 连接延时](13-tcpconnlat/tcpconnlat.md) - [eBPF入门实践教程：使用 libbpf-bootstrap 开发程序统计 TCP 连接延时](14-tcpstates/README.md) @@ -27,7 +24,7 @@ - [eBPF 入门实践教程：使用 LSM 进行安全检测防御](19-lsm-connect/README.md) - [eBPF 入门实践教程：使用 eBPF 进行 tc 流量控制](20-tc/README.md) -# bcc Guide +# bcc 开发者教程 - [BPF Features by Linux Kernel Version](bcc-documents/kernel-versions.md) - [Kernel Configuration for BPF Features](bcc-documents/kernel_config.md)