3、Ftrace使用例子

内核使用例子

#include <linux/kernel.h>
#include <linux/module.h>

// 要跟踪的函数
static int example_function(int arg)
{
    printk(KERN_INFO "Example function called with argument: %d\n", arg);
    return arg + 1;
}

// 模块初始化函数
static int __init ftrace_debug_init(void)
{
    // 开启Ftrace功能
    if (register_trace_sched_function_call()) {
        printk(KERN_ERR "Failed to register trace function: sched_function_call\n");
        return -1;
    }

    printk(KERN_INFO "Ftrace enabled\n");

    // 调用要跟踪的函数
    int result = example_function(42);
    printk(KERN_INFO "Function result: %d\n", result);

    return 0;
}

// 模块清理函数
static void __exit ftrace_debug_exit(void)
{
    // 关闭Ftrace功能
    unregister_trace_sched_function_call();

    printk(KERN_INFO "Ftrace disabled\n");
}

module_init(ftrace_debug_init);
module_exit(ftrace_debug_exit);

MODULE_LICENSE("GPL");

在这个例子中，我们使用了Ftrace的 register_trace_sched_function_call() 函数来开启Ftrace跟踪功能，并指定要跟踪的函数。在模块初始化函数 ftrace_debug_init 中，我们开启了对 example_function 函数的跟踪。跟踪启动后，我们调用了 example_function 函数，并在内核日志中输出函数的调用参数和返回结果。

执行该模块后，您可以在内核日志中查看Ftrace的调试结果。例如，通过执行以下命令查看内核日志：

$ dmesg

您将在输出中看到类似以下的调试结果：

[12345.678901] sched_function_call: example_function <- 42
[12345.678902] sched_function_ret: example_function -> 43
[12345.678903] Function result: 43

上述示例中，12345.678901 是距离系统启动后的时间戳，sched_function_call 表示调用了 example_function 函数，并打印了参数值 42，sched_function_ret 表示函数返回了结果 43，Function result: 43 表示函数的返回结果。

应用层例子

#include <stdio.h>

int add_numbers(int a, int b)
{
    int result = a + b;
    return result;
}

int main()
{
    int x = 10;
    int y = 20;
    int sum = 0;

    sum = add_numbers(x, y);
    printf("Sum: %d\n", sum);

    return 0;
}

在这个示例中，存在一个名为 add_numbers 的函数，用于将两个整数相加并返回结果。在 main 函数中，我们调用了 add_numbers 函数，并打印出结果。

通过使用Ftrace，我们可以详细分析 add_numbers 函数的执行过程，包括参数传递和返回结果。下面是使用Ftrace进行跟踪的步骤：

确保系统已启用Ftrace功能。可以通过在终端中执行以下命令来检查，并根据需要加载相关模块：

$ cat /sys/kernel/debug/tracing/available_tracers

打开Ftrace跟踪，并选择要跟踪的内核函数。可以通过在终端中执行以下命令来启用并配置Ftrace：

$ echo function > /sys/kernel/debug/tracing/current_tracer
$ echo add_numbers > /sys/kernel/debug/tracing/set_ftrace_filter

运行C代码，并触发所需的函数调用。您可以通过编译和执行上述C代码来触发函数调用。

分析Ftrace的输出结果。Ftrace会将跟踪结果输出到 trace 文件中。您可以使用以下命令查看跟踪的结果：

$ cat /sys/kernel/debug/tracing/trace

在Ftrace的输出结果中，您将看到类似以下的跟踪信息：

  add_numbers-1234  [000] d..2 12345.678901: add_numbers: (10, 20) --> 30

上述示例显示了 add_numbers 函数的跟踪信息，包括函数的名称、PID、调用顺序和参数。在示例中，您可以看到 add_numbers 函数被调用，参数为 (10, 20)，并返回结果 30。