8 Star 4 Fork 2

openEuler / A-Tune-BPF-Collection

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
该仓库未声明开源许可证文件(LICENSE),使用请关注具体项目描述及其代码上游依赖。
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README
MulanPSL-2.0

A-Tune-BPF-Collection

介绍

A-Tune-BPF-Collection是BPF工具集,这些BPF程序用以跟踪内核行为模式以实时细粒度地调整内核参数,达到提升系统性能的目标。

软件架构

readahead_tune为例来介绍A-Tune-BPF-Collection中的BPF程序。

readahead_tune包含两部分:

  • BPF program(readahead_tune.bpf):加载到内核的BPF program以跟踪ext4/xfs文件系统的文件读操作
  • BPF control program(readahead_tune):读取配置文件,配置BPF program的参数,随即加载BPF program到内核

安装教程

通过rpm命令或者yum安装A-Tune-BPF-Collection rpm包:

# yum install A-Tune-BPF-Collection
or
# rpm -ivh A-Tune-BPF-Collection-{version}.x86_64.rpm

使用说明

readahead_tune为例介绍A-Tune-BPF-Collection中的BPF程序程序使用:

  1. (可选)默认配置文件会安装在/etc/sysconfig/readahead_tune.conf,也可以自己新建配置文件,通过start_readahead_tune命令-c|--config选项指令配置文件路径。若未指定配置文件,则会使用默认安装的配置文件。

    注意:仅支持通过完整路径名指定配置文件,相对路径会无法识别;配置文件中若存在不合法的选项配置或者配置选项缺失,都会使用该选项的默认配置值。
  2. 通过start_readahead_tune命令启动/加载readahead_tune.bpf BPF Program。命令使用方法可以使用start_readahead_tune -h|--help帮助命令。

  3. 通过stop_readahead_tune命令停止/卸载readahead_tune.bpf BPF Program。

源码编译

  1. 安装编译依赖:
sudo dnf install make clang llvm libbpf-devel dwarves kernel-debuginfo bpftool -y
  1. 编译:
make

编译过程中可能遇到kenrl-debuginforpm包提供vmlinux路径与uname -r不一致的情况导致编译失败。这是由于当前运行的内核版本与kernel-debuginfo的版本不一致。openEuler yum源的kernel版本较高,可以执行dnf update kernel升级当前kernel到yum源的kernel版本,重启系统,kernel版本便与kernel-debuginfo版本一致,再重新编译。

测试

执行测试用例
make check

执行测试用例依赖于源码构建,会自动编译。测试用例运行结果信息示例如下所示:

   CHECK
    PASS: tst-common_helper
    Test Summary:
      Unsupport: 0
      Fail: 0
      Pass: 1

会显示每个测试用例的执行结果,如tst-common_helper测试用例执行成功。最后以Test Summary:行开头总结所有测试用例执行情况。Unsupport表示不支持在当前测试平台上运行的测试用例数目,Fail表示失败的测试用例数目,Pass表示成功的测试用例数目。

新增测试用例

如果要新增对源码中目标文件中的函数进行测试,则在test目录下新增前缀为tst-,后半部分与测试目标文件名一致的测试文件。如要对common_helper.c中的函数进行测试,则新建名为tst-common_helper.c的测试文件。

测试文件中的测试用例定义在int do_test(void)函数中,测试用例首先应该检查能否在测试平台上进行运行,如果不支持,则返回2(unsupport);测试用例运行失败返回1(fail);成功则返回0(pass)。在测试文件结尾添加#include "test/test-driver.c"语句即可。

参与贡献

  1. Fork 本仓库
  2. 新建 Feat_xxx 分支
  3. 提交代码
  4. 新建 Pull Request

特技

  1. 使用 Readme_XXX.md 来支持不同的语言,例如 Readme_en.md, Readme_zh.md
  2. Gitee 官方博客 blog.gitee.com
  3. 你可以 https://gitee.com/explore 这个地址来了解 Gitee 上的优秀开源项目
  4. GVP 全称是 Gitee 最有价值开源项目,是综合评定出的优秀开源项目
  5. Gitee 官方提供的使用手册 https://gitee.com/help
  6. Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 https://gitee.com/gitee-stars/

空文件

简介

A-Tune-BPF-Collection is BPF based tunning tools collection 展开 收起
C 等 3 种语言
MulanPSL-2.0
取消

贡献者

全部

近期动态

加载更多
不能加载更多了
1
https://gitee.com/openeuler/A-Tune-BPF-Collection.git
git@gitee.com:openeuler/A-Tune-BPF-Collection.git
openeuler
A-Tune-BPF-Collection
A-Tune-BPF-Collection
master

搜索帮助