From nobody Tue Sep 29 13:18:43 2026 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-alma10-1.taild15c8.ts.net [100.103.45.18]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 35E7340F73D; Fri, 7 Aug 2026 21:44:15 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=100.103.45.18 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786139057; cv=none; b=avm4KKxNgqiJ4jAx8sKcjwj5dX/9QGfh0P81kZZ4KHKT/fmL3rHMinzWN0EqMv0XCeINOeNoQpKSYg2ugNfmvzd1V3CpLwHr8UyOp4JkEi61fItR6gHb7lQtIz4HaFNlrjbDOzqW7LGK1OAhp+vsxNZDeE/9BqQqjrsIiNl1Ex0= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786139057; c=relaxed/simple; bh=PgpLUGTVQ9cpmS/93k5L9eHzQDq1uZWcok9j32iq7Kg=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=ULwPj31+bFcv7DrX0rBVBfeVYuyroNCScoI3Fk42WbWP7Cazpmmfj+RMNbX01UwjoQlkmhX0dSK7fOK7BbgLUWaiioFue2HBCsY+SrxkLX0En69sRvNz9etcqQPv2+ZSqSlFSHnV9swHD697uP7THy4NqXl6C/BCydHSrNv70EY= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=hz1JRykw; arc=none smtp.client-ip=100.103.45.18 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="hz1JRykw" Received: by smtp.kernel.org (Postfix) with ESMTPSA id D7F8D1F000E9; Fri, 7 Aug 2026 21:44:13 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=kernel.org; s=k20260515; t=1786139055; bh=C+xXl80bd6x34cCIP2RcHDAoitBXU5S8s9xnaRNvAjs=; h=From:To:Cc:Subject:Date:In-Reply-To:References; b=hz1JRykw1TBu53Dhq3dC8Msll4eE3Jj0UmwRxvrjrGiimGhzN7rQIXdk2PcC8BrKb FbLM0HrtB384WfMDxR8CryQtJX0HE/yuVz12w+zuhYuzUsgg3/A13VmtikuxBGIwkr QKf7HCU6PXYEwspGl9VUNNTgwpiVEUqiZHSPNaAQDmRhz03kNgl0tZHkCill1tis/6 sQNMu3rOUeSbcrl5TAE7U1AcusXcHM+vEsApoZsIUWP1Tvkq/4WT3TS5ELNU1i5sBf ZqgHc0IK0E1E7an/4dM4zMc43vCZpiQl9nstG79shCgrtURCZuhzRX4ZLBK8um2J8r 1lMquUYXZr22g== From: "Masami Hiramatsu (Google)" To: Steven Rostedt , Masami Hiramatsu , Jonathan Corbet , Shuah Khan Cc: Mathieu Desnoyers , linux-kernel@vger.kernel.org, linux-trace-kernel@vger.kernel.org, linux-doc@vger.kernel.org, linux-kselftest@vger.kernel.org Subject: [PATCH v3 1/2] tracing/boot: Add support for eprobe, fprobe, and tprobe events Date: Sat, 8 Aug 2026 06:44:11 +0900 Message-ID: <178613905149.259829.18185480460810689421.stgit@devnote2> X-Mailer: git-send-email 2.43.0 In-Reply-To: <178613904128.259829.16130019979800943264.stgit@devnote2> References: <178613904128.259829.16130019979800943264.stgit@devnote2> User-Agent: StGit/0.19 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable From: Masami Hiramatsu (Google) Boot-time tracing currently supports kprobe-events and synthetic-events under per-event configuration options. Extend boot-time tracing to support newly added dynamic probe types: - event probes (eprobe) under the "eprobes" event group - function probes (fprobe) under the "fprobes" event group - tracepoint probes (tprobe) under the "tracepoints" or "tprobes" event group To support this cleanly, update dyn_event_create() in trace_dynevent.c so that passing NULL as the type parameter delegates to create_dyn_event(), allowing generic creation of any registered dynamic event type from a raw command string. Update Documentation/trace/boottime-trace.rst accordingly to describe the new per-event bootconfig options. Assisted-by: Antigravity:gemini-3.6-flash Signed-off-by: Masami Hiramatsu (Google) Changes in v3: - Check return values of strscpy() and snprintf() in trace_boot_add_probe_= event() to prevent silent buffer truncation when constructing probe event string= s. Changes in v2: - Fix raw command detection logic for eprobes, fprobes, and tprobes by requiring ':' or isspace() after type prefix. - Consolidate duplicate loop logic into trace_boot_add_probe_event() helper function. --- Documentation/trace/boottime-trace.rst | 18 +++++- kernel/trace/trace_boot.c | 97 ++++++++++++++++++++++++++++= ++++ kernel/trace/trace_dynevent.c | 5 ++ 3 files changed, 117 insertions(+), 3 deletions(-) diff --git a/Documentation/trace/boottime-trace.rst b/Documentation/trace/b= oottime-trace.rst index 651f3a2c01de..2c3c1fedb92c 100644 --- a/Documentation/trace/boottime-trace.rst +++ b/Documentation/trace/boottime-trace.rst @@ -121,9 +121,21 @@ ftrace.[instance.INSTANCE.]event.synthetic.EVENT.field= s =3D FIELD[, FIELD2[...]] Defines new synthetic event with FIELDs. Each field should be "type varname". =20 -Note that kprobe and synthetic event definitions can be written under -instance node, but those are also visible from other instances. So please -take care for event name conflict. +ftrace.[instance.INSTANCE.]event.eprobes.EVENT.probes =3D PROBE[, PROBE2[.= ..]] + Defines new event probe based on PROBEs. This option is available only + for the event which group name is "eprobes". + +ftrace.[instance.INSTANCE.]event.fprobes.EVENT.probes =3D PROBE[, PROBE2[.= ..]] + Defines new fprobe event based on PROBEs. This option is available only + for the event which group name is "fprobes". + +ftrace.[instance.INSTANCE.]event.tracepoints.EVENT.probes =3D PROBE[, PROB= E2[...]] + Defines new tracepoint probe based on PROBEs. This option is available = only + for the event which group name is "tracepoints" or "tprobes". + +Note that dynamic event definitions can be written under instance node, but +those are also visible from other instances. So please take care for event +name conflict. =20 Ftrace Histogram Options ------------------------ diff --git a/kernel/trace/trace_boot.c b/kernel/trace/trace_boot.c index 2ca2541c8a58..5da0a8bbb110 100644 --- a/kernel/trace/trace_boot.c +++ b/kernel/trace/trace_boot.c @@ -18,6 +18,7 @@ #include =20 #include "trace.h" +#include "trace_dynevent.h" =20 #define MAX_BUF_LEN 256 =20 @@ -172,6 +173,93 @@ trace_boot_add_synth_event(struct xbc_node *node, cons= t char *event) } #endif =20 +#if defined(CONFIG_EPROBE_EVENTS) || defined(CONFIG_FPROBE_EVENTS) +static int __init +trace_boot_add_probe_event(struct xbc_node *node, const char *group, + const char *event, char type, const char *type_name) +{ + struct xbc_node *anode; + char buf[MAX_BUF_LEN]; + const char *val; + int ret =3D 0; + + xbc_node_for_each_array_value(node, "probes", anode, val) { + if (val[0] =3D=3D type && (val[1] =3D=3D ':' || isspace(val[1]))) { + ret =3D strscpy(buf, val, MAX_BUF_LEN); + if (ret < 0) { + pr_err("%s command is too long: %s\n", type_name, val); + break; + } + } else { + ret =3D snprintf(buf, MAX_BUF_LEN, "%c:%s/%s %s", type, group, event, v= al); + if (ret >=3D MAX_BUF_LEN || ret < 0) { + pr_err("%s command is too long: %c:%s/%s %s\n", + type_name, type, group, event, val); + ret =3D -E2BIG; + break; + } + } + + ret =3D dyn_event_create(buf, NULL); + if (ret) { + pr_err("Failed to add %s: %s\n", type_name, buf); + break; + } + } + + return ret; +} +#endif + +#ifdef CONFIG_EPROBE_EVENTS +static inline int __init +trace_boot_add_eprobe_event(struct xbc_node *node, const char *group, + const char *event) +{ + return trace_boot_add_probe_event(node, group, event, 'e', "eprobe"); +} +#else +static inline int __init +trace_boot_add_eprobe_event(struct xbc_node *node, const char *group, + const char *event) +{ + pr_err("Event probe is not supported.\n"); + return -EOPNOTSUPP; +} +#endif + +#ifdef CONFIG_FPROBE_EVENTS +static inline int __init +trace_boot_add_fprobe_event(struct xbc_node *node, const char *group, + const char *event) +{ + return trace_boot_add_probe_event(node, group, event, 'f', "fprobe"); +} + +static inline int __init +trace_boot_add_tprobe_event(struct xbc_node *node, const char *group, + const char *event) +{ + return trace_boot_add_probe_event(node, group, event, 't', "tprobe"); +} +#else +static inline int __init +trace_boot_add_fprobe_event(struct xbc_node *node, const char *group, + const char *event) +{ + pr_err("Fprobe event is not supported.\n"); + return -EOPNOTSUPP; +} + +static inline int __init +trace_boot_add_tprobe_event(struct xbc_node *node, const char *group, + const char *event) +{ + pr_err("Tracepoint probe is not supported.\n"); + return -EOPNOTSUPP; +} +#endif + #ifdef CONFIG_HIST_TRIGGERS static int __init __printf(3, 4) append_printf(char **bufp, char *end, const char *fmt, ...) @@ -477,6 +565,15 @@ trace_boot_init_one_event(struct trace_array *tr, stru= ct xbc_node *gnode, if (!strcmp(group, "synthetic")) if (trace_boot_add_synth_event(enode, event) < 0) return; + if (!strcmp(group, "eprobes")) + if (trace_boot_add_eprobe_event(enode, group, event) < 0) + return; + if (!strcmp(group, "fprobes")) + if (trace_boot_add_fprobe_event(enode, group, event) < 0) + return; + if (!strcmp(group, "tracepoints") || !strcmp(group, "tprobes")) + if (trace_boot_add_tprobe_event(enode, group, event) < 0) + return; =20 mutex_lock(&event_mutex); file =3D find_event_file(tr, group, event); diff --git a/kernel/trace/trace_dynevent.c b/kernel/trace/trace_dynevent.c index c4dfbc293bae..6f2e39b797e5 100644 --- a/kernel/trace/trace_dynevent.c +++ b/kernel/trace/trace_dynevent.c @@ -116,6 +116,8 @@ int dyn_event_release(const char *raw_command, struct d= yn_event_operations *type return ret; } =20 +static int create_dyn_event(const char *raw_command); + /* * Locked version of event creation. The event creation must be protected = by * dyn_event_ops_mutex because of protecting trace_probe_log. @@ -124,6 +126,9 @@ int dyn_event_create(const char *raw_command, struct dy= n_event_operations *type) { int ret; =20 + if (!type) + return create_dyn_event(raw_command); + mutex_lock(&dyn_event_ops_mutex); ret =3D type->create(raw_command); mutex_unlock(&dyn_event_ops_mutex); From nobody Tue Sep 29 13:18:43 2026 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-alma10-1.taild15c8.ts.net [100.103.45.18]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id D4AD1453A56; Fri, 7 Aug 2026 21:44:25 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=100.103.45.18 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786139069; cv=none; b=mravsi4dV9xMBKcY0FUrcCL44/F1ZRDqOpuIvASGLMHxTEPfseY9B+U5rYqe42EHVKs+OQh+madbsVnsJXDutct8VgjBc5Mzb+gMcRELyTqMUWLhDR00UjGZS9l/JpY26xRooa4LTw/KXxlztSD4CISt8bU5UoAodQMH+Ks3iDQ= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786139069; c=relaxed/simple; bh=Fwl2cl43VhTTbHjpZjTobt9SkcCXrPWQZMAMPFM4lwY=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=NVyRhgGot9HLuNDOxHpxIoXrgRacuCEAdZYrrIjosDNwgw7PyJCz1Ue3Q5B3Zz545iwA5WVRM3OThcYMjDEf99SeFBR/aukRivJpCUNOsTBV7Q2zOLvP2h1dmKokheN5O/AS0DytMkMqK2KjaWd2VPVMJK9JJO8SFnlFBQtv4Xg= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=JqlclPE8; arc=none smtp.client-ip=100.103.45.18 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="JqlclPE8" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 4AD331F000E9; Fri, 7 Aug 2026 21:44:23 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=kernel.org; s=k20260515; t=1786139065; bh=/QbNNc3FovT+401eADXcgfrBJ5rWqZwQdyxdN6L5CwI=; h=From:To:Cc:Subject:Date:In-Reply-To:References; b=JqlclPE8rb4olQy7OHifSmUAozKxSrBQZ27lAm3nCQWfgfKtD7jai+mwcdRxVyRwV k8f5vNLYVgp9tEQEzaGstxHx9lupHZVYmXZvt2ZpxpUfeD64tm4O1v/EkbcI6LtpJw cQqTF/bZBaBfUmN5rtWLw11OeB7izEaYQzuJ7gZh7RQiRoFVPa9lgNbw/6gJGXQsYx 0LLC03B/+QMDUFQIzF4BbyCaklenI/d/aMpea8mlv0DWuqtZpyY/1n7K88oMixrpU7 I6nu8Cjw2fGcTg2xTIQJVPnXHIKvq352gK1vLNn0uek92u+QqWLrMX9d+QML/nFIZj DLm+xBPiZI/aA== From: "Masami Hiramatsu (Google)" To: Steven Rostedt , Masami Hiramatsu , Jonathan Corbet , Shuah Khan Cc: Mathieu Desnoyers , linux-kernel@vger.kernel.org, linux-trace-kernel@vger.kernel.org, linux-doc@vger.kernel.org, linux-kselftest@vger.kernel.org Subject: [PATCH v3 2/2] selftests/ftrace: Add boot-time tracing test framework Date: Sat, 8 Aug 2026 06:44:21 +0900 Message-ID: <178613906103.259829.13367936927077263219.stgit@devnote2> X-Mailer: git-send-email 2.43.0 In-Reply-To: <178613904128.259829.16130019979800943264.stgit@devnote2> References: <178613904128.259829.16130019979800943264.stgit@devnote2> User-Agent: StGit/0.19 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable From: Masami Hiramatsu (Google) Add an automated test framework under tools/testing/selftests/ftrace/boottime/ to verify boot-time tracing configuration parsing. The test runner (run_boottime_test.sh) sources ktap_helpers.sh to generate output in TAP version 13 format. It builds a minimal initramfs with busybox, attaches bootconfig examples using tools/bootconfig/bootconfig, boots QEMU, and runs corresponding tracefs checker scripts. Assisted-by: Antigravity:gemini-3.6-flash Signed-off-by: Masami Hiramatsu (Google) Changes in v3: - Remove boottime/run_boottime_test.sh from TEST_PROGS_EXTENDED in Makefile to prevent lib.mk from flattening it into top-level ftrace/ on make inst= all. - Support executing run_boottime_test.sh both in-tree and in installed kselftest environment. - Add HUP, INT, and TERM signal handlers to tempdir cleanup trap. - Validate workdir creation and update run_single_test() to return 0 on te= st failures so set -e is not suspended by invocation in an AND-OR list. Changes in v2: - Copy shared library dependencies using ldd if busybox is dynamically linked. - Wrap QEMU execution with timeout command and add -T/--timeout CLI option. - Add pre-flight checks for busybox architecture compatibility and cpio tool in run_boottime_test.sh. - Fix POSIX syntax compatibility and allow bypassing HOST_ARCH skip when custom kernel/QEMU parameters are passed. - Add boottime/run_boottime_test.sh to TEST_PROGS_EXTENDED in selftests/ftrace/Makefile. --- tools/testing/selftests/ftrace/Makefile | 2=20 tools/testing/selftests/ftrace/boottime/Makefile | 10 + tools/testing/selftests/ftrace/boottime/README | 58 ++++ .../ftrace/boottime/bootconfigs/01-kprobe.bconf | 5=20 .../ftrace/boottime/bootconfigs/02-synth.bconf | 4=20 .../ftrace/boottime/bootconfigs/03-eprobe.bconf | 4=20 .../ftrace/boottime/bootconfigs/04-fprobe.bconf | 4=20 .../ftrace/boottime/bootconfigs/05-tprobe.bconf | 4=20 .../ftrace/boottime/bootconfigs/06-instance.bconf | 5=20 .../selftests/ftrace/boottime/run_boottime_test.sh | 271 ++++++++++++++++= ++++ .../selftests/ftrace/boottime/tests/01-kprobe.sh | 18 + .../selftests/ftrace/boottime/tests/02-synth.sh | 18 + .../selftests/ftrace/boottime/tests/03-eprobe.sh | 18 + .../selftests/ftrace/boottime/tests/04-fprobe.sh | 18 + .../selftests/ftrace/boottime/tests/05-tprobe.sh | 18 + .../selftests/ftrace/boottime/tests/06-instance.sh | 23 ++ tools/testing/selftests/ftrace/config | 4=20 17 files changed, 483 insertions(+), 1 deletion(-) create mode 100644 tools/testing/selftests/ftrace/boottime/Makefile create mode 100644 tools/testing/selftests/ftrace/boottime/README create mode 100644 tools/testing/selftests/ftrace/boottime/bootconfigs/01-= kprobe.bconf create mode 100644 tools/testing/selftests/ftrace/boottime/bootconfigs/02-= synth.bconf create mode 100644 tools/testing/selftests/ftrace/boottime/bootconfigs/03-= eprobe.bconf create mode 100644 tools/testing/selftests/ftrace/boottime/bootconfigs/04-= fprobe.bconf create mode 100644 tools/testing/selftests/ftrace/boottime/bootconfigs/05-= tprobe.bconf create mode 100644 tools/testing/selftests/ftrace/boottime/bootconfigs/06-= instance.bconf create mode 100755 tools/testing/selftests/ftrace/boottime/run_boottime_te= st.sh create mode 100755 tools/testing/selftests/ftrace/boottime/tests/01-kprobe= .sh create mode 100755 tools/testing/selftests/ftrace/boottime/tests/02-synth.= sh create mode 100755 tools/testing/selftests/ftrace/boottime/tests/03-eprobe= .sh create mode 100755 tools/testing/selftests/ftrace/boottime/tests/04-fprobe= .sh create mode 100755 tools/testing/selftests/ftrace/boottime/tests/05-tprobe= .sh create mode 100755 tools/testing/selftests/ftrace/boottime/tests/06-instan= ce.sh diff --git a/tools/testing/selftests/ftrace/Makefile b/tools/testing/selfte= sts/ftrace/Makefile index 7c12263f8260..8d8881744149 100644 --- a/tools/testing/selftests/ftrace/Makefile +++ b/tools/testing/selftests/ftrace/Makefile @@ -3,7 +3,7 @@ all: =20 TEST_PROGS_EXTENDED :=3D ftracetest TEST_PROGS :=3D ftracetest-ktap -TEST_FILES :=3D test.d settings +TEST_FILES :=3D test.d settings boottime EXTRA_CLEAN :=3D $(OUTPUT)/logs/* =20 TEST_GEN_FILES :=3D poll diff --git a/tools/testing/selftests/ftrace/boottime/Makefile b/tools/testi= ng/selftests/ftrace/boottime/Makefile new file mode 100644 index 000000000000..fd0975350f10 --- /dev/null +++ b/tools/testing/selftests/ftrace/boottime/Makefile @@ -0,0 +1,10 @@ +# SPDX-License-Identifier: GPL-2.0 + +all: + +run_tests: + @./run_boottime_test.sh + +clean: + +.PHONY: all run_tests clean diff --git a/tools/testing/selftests/ftrace/boottime/README b/tools/testing= /selftests/ftrace/boottime/README new file mode 100644 index 000000000000..a6f930a6e44c --- /dev/null +++ b/tools/testing/selftests/ftrace/boottime/README @@ -0,0 +1,58 @@ +Boot-Time Tracing Test Suite +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D + +This directory contains an automated test framework to verify kernel boot-= time +tracing configuration parsing and tracefs application during early boot. + +Overview +-------- +The test runner (`run_boottime_test.sh`) constructs a lightweight initramf= s with +busybox and a tracefs checker script from `tests/`, attaches a bootconfig = example +from `bootconfigs/` using the `bootconfig` tool, boots the target kernel i= mage under +QEMU, and reports results according to the TAP version 13 format. + +Required Tools +-------------- +- Host Architecture: x86 (x86_64/i686/i386/x86; tests skip on non-x86 host= s) +- `qemu-system-x86_64` (or custom QEMU executable) +- `busybox` (host binary at `/usr/bin/busybox` or custom path) +- `bootconfig` (compiled from `tools/bootconfig/bootconfig` or in PATH) +- `cpio` (standard archiver) + +Required Kernel Configurations +------------------------------ +The kernel binary under test must be compiled with: +- `CONFIG_BOOT_CONFIG=3Dy` +- `CONFIG_BOOTTIME_TRACING=3Dy` + +Additional feature-specific config options enable respective testcases: +- `CONFIG_KPROBE_EVENTS=3Dy` (for `01-kprobe`) +- `CONFIG_SYNTH_EVENTS=3Dy` (for `02-synth`) +- `CONFIG_EPROBE_EVENTS=3Dy` (for `03-eprobe`) +- `CONFIG_FPROBE_EVENTS=3Dy` (for `04-fprobe` and `05-tprobe`) +- `CONFIG_FUNCTION_TRACER=3Dy` (for tracer options in `06-instance`) + +Usage +----- +To run all test cases with a compiled kernel image: + + $ ./run_boottime_test.sh -k /path/to/bzImage + +To run a specific test case (e.g. `01-kprobe`): + + $ ./run_boottime_test.sh -k /path/to/bzImage -t 01-kprobe + +Customizing Tool Paths: + + $ ./run_boottime_test.sh -b /path/to/bootconfig \ + -k /path/to/bzImage \ + -q /path/to/qemu-system-x86_64 \ + -B /path/to/busybox + +Environment Variables +--------------------- +Tool locations and kernel paths can also be set via environment variables: +- `BOOTCONFIG`: Path to the `bootconfig` tool +- `KERNEL`: Path to the `bzImage` kernel binary +- `QEMU`: Path to the QEMU binary +- `BUSYBOX`: Path to the `busybox` binary diff --git a/tools/testing/selftests/ftrace/boottime/bootconfigs/01-kprobe.= bconf b/tools/testing/selftests/ftrace/boottime/bootconfigs/01-kprobe.bconf new file mode 100644 index 000000000000..f607840e3858 --- /dev/null +++ b/tools/testing/selftests/ftrace/boottime/bootconfigs/01-kprobe.bconf @@ -0,0 +1,5 @@ +ftrace.event.kprobes.vfs_read { + probes =3D "vfs_read $arg1 $arg2" + filter =3D "common_pid < 200" + enable +} diff --git a/tools/testing/selftests/ftrace/boottime/bootconfigs/02-synth.b= conf b/tools/testing/selftests/ftrace/boottime/bootconfigs/02-synth.bconf new file mode 100644 index 000000000000..b1f37713f33c --- /dev/null +++ b/tools/testing/selftests/ftrace/boottime/bootconfigs/02-synth.bconf @@ -0,0 +1,4 @@ +ftrace.event.synthetic.boot_lat { + fields =3D "unsigned long id", "u64 delta" + enable +} diff --git a/tools/testing/selftests/ftrace/boottime/bootconfigs/03-eprobe.= bconf b/tools/testing/selftests/ftrace/boottime/bootconfigs/03-eprobe.bconf new file mode 100644 index 000000000000..f954aa7fb8bd --- /dev/null +++ b/tools/testing/selftests/ftrace/boottime/bootconfigs/03-eprobe.bconf @@ -0,0 +1,4 @@ +ftrace.event.eprobes.ep_read { + probes =3D "syscalls/sys_enter_openat" + enable +} diff --git a/tools/testing/selftests/ftrace/boottime/bootconfigs/04-fprobe.= bconf b/tools/testing/selftests/ftrace/boottime/bootconfigs/04-fprobe.bconf new file mode 100644 index 000000000000..82ae2ac0629f --- /dev/null +++ b/tools/testing/selftests/ftrace/boottime/bootconfigs/04-fprobe.bconf @@ -0,0 +1,4 @@ +ftrace.event.fprobes.fp_read { + probes =3D "vfs_read" + enable +} diff --git a/tools/testing/selftests/ftrace/boottime/bootconfigs/05-tprobe.= bconf b/tools/testing/selftests/ftrace/boottime/bootconfigs/05-tprobe.bconf new file mode 100644 index 000000000000..02a2803c770a --- /dev/null +++ b/tools/testing/selftests/ftrace/boottime/bootconfigs/05-tprobe.bconf @@ -0,0 +1,4 @@ +ftrace.event.tracepoints.tp_sched { + probes =3D "sched_switch" + enable +} diff --git a/tools/testing/selftests/ftrace/boottime/bootconfigs/06-instanc= e.bconf b/tools/testing/selftests/ftrace/boottime/bootconfigs/06-instance.b= conf new file mode 100644 index 000000000000..31f81da570ea --- /dev/null +++ b/tools/testing/selftests/ftrace/boottime/bootconfigs/06-instance.bconf @@ -0,0 +1,5 @@ +ftrace.instance.foo { + event.sched.sched_switch.enable + buffer_size =3D 1MB + tracing_on =3D 1 +} diff --git a/tools/testing/selftests/ftrace/boottime/run_boottime_test.sh b= /tools/testing/selftests/ftrace/boottime/run_boottime_test.sh new file mode 100755 index 000000000000..7ba1afc91c35 --- /dev/null +++ b/tools/testing/selftests/ftrace/boottime/run_boottime_test.sh @@ -0,0 +1,271 @@ +#!/bin/bash +# SPDX-License-Identifier: GPL-2.0 +# +# Boot-time tracing test runner +# Builds a lightweight initramfs, attaches a bootconfig, boots QEMU, +# and verifies tracefs configuration using test scripts. + +set -e + +SCRIPT_DIR=3D"$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" +if [ -d "$SCRIPT_DIR/boottime" ]; then + SCRIPT_DIR=3D"$SCRIPT_DIR/boottime" +fi +KERNEL_SRC=3D"$(cd "$SCRIPT_DIR/../../../../.." && pwd)" + +# Source KTAP helpers +if [ -f "$SCRIPT_DIR/../../kselftest/ktap_helpers.sh" ]; then + KSELFTEST_DIR=3D"$(cd "$SCRIPT_DIR/../../kselftest" && pwd)" +elif [ -f "$SCRIPT_DIR/../kselftest/ktap_helpers.sh" ]; then + KSELFTEST_DIR=3D"$(cd "$SCRIPT_DIR/../kselftest" && pwd)" +else + echo "Error: ktap_helpers.sh not found relative to $SCRIPT_DIR" + exit 1 +fi +. "$KSELFTEST_DIR/ktap_helpers.sh" + +BOOTCONFIG=3D"${BOOTCONFIG:-"$KERNEL_SRC/tools/bootconfig/bootconfig"}" +KERNEL=3D"${KERNEL:-"$KERNEL_SRC/arch/x86/boot/bzImage"}" +QEMU=3D"${QEMU:-"qemu-system-x86_64"}" +BUSYBOX=3D"${BUSYBOX:-"$(which busybox 2>/dev/null || echo "/usr/bin/busyb= ox")"}" +TIMEOUT=3D"${TIMEOUT:-30s}" +TARGET_TEST=3D"all" + +usage() { + echo "Usage: $0 [options]" + echo "Options:" + echo " -b, --bootconfig PATH Path to bootconfig tool (default: $BOOTCO= NFIG)" + echo " -k, --kernel PATH Path to kernel image (default: $KERNEL)" + echo " -q, --qemu PATH Path to QEMU executable (default: $QEMU)" + echo " -B, --busybox PATH Path to busybox binary (default: $BUSYBOX= )" + echo " -T, --timeout DURATION QEMU execution timeout (default: $TIMEOUT= )" + echo " -t, --test NAME Run specific test (e.g. 01-kprobe) or 'al= l'" + echo " -h, --help Show this help message" + exit 1 +} + +while [ $# -gt 0 ]; do + case "$1" in + -b|--bootconfig) + BOOTCONFIG=3D"$2" + shift 2 + ;; + -k|--kernel) + KERNEL=3D"$2" + shift 2 + ;; + -q|--qemu) + QEMU=3D"$2" + shift 2 + ;; + -B|--busybox) + BUSYBOX=3D"$2" + shift 2 + ;; + -T|--timeout) + TIMEOUT=3D"$2" + shift 2 + ;; + -t|--test) + TARGET_TEST=3D"$2" + shift 2 + ;; + -h|--help) + usage + ;; + *) + echo "Unknown option: $1" + usage + ;; + esac +done + +# Check host architecture +HOST_ARCH=3D"$(uname -m)" +case "$HOST_ARCH" in + x86_64|i686|i386|x86) + ;; + *) + if [ "$KERNEL" =3D "$KERNEL_SRC/arch/x86/boot/bzImage" ]; then + ktap_print_header + ktap_skip_all \ + "Default boot-time tracing test is x86 only ($HOST_ARCH)" + exit 0 + fi + ;; +esac + +# Ensure bootconfig tool is built if Makefile exists +if [ ! -x "$BOOTCONFIG" ]; then + if [ -f "$KERNEL_SRC/tools/bootconfig/Makefile" ]; then + make -C "$KERNEL_SRC/tools/bootconfig" > /dev/null 2>&1 || true + fi + if [ ! -x "$BOOTCONFIG" ]; then + BOOTCONFIG=3D"$(which bootconfig 2>/dev/null || true)" + fi +fi + +if [ ! -x "$BOOTCONFIG" ]; then + ktap_print_header + ktap_skip_all "bootconfig tool not found at $BOOTCONFIG" + exit 0 +fi + +if [ ! -f "$KERNEL" ]; then + ktap_print_header + ktap_skip_all "Kernel image not found at $KERNEL" + exit 0 +fi + +if ! command -v "$QEMU" >/dev/null 2>&1; then + ktap_print_header + ktap_skip_all "QEMU binary not found: $QEMU" + exit 0 +fi + +if [ ! -x "$BUSYBOX" ]; then + ktap_print_header + ktap_skip_all "busybox binary not found at $BUSYBOX" + exit 0 +fi + +# Verify busybox architecture compatibility +if command -v file >/dev/null 2>&1; then + BUSYBOX_INFO=3D"$(file -b "$BUSYBOX" 2>/dev/null || true)" + case "$KERNEL" in + *x86*) + case "$BUSYBOX_INFO" in + *x86-64*|*x86_64*|*80386*|*i386*) + ;; + *) + ktap_print_header + ktap_skip_all "busybox binary architecture is incompatible with x86 k= ernel ($BUSYBOX_INFO)" + exit 0 + ;; + esac + ;; + esac +fi + +if ! command -v cpio >/dev/null 2>&1; then + ktap_print_header + ktap_skip_all "cpio tool not found" + exit 0 +fi + +run_single_test() { + local bconf_file=3D"$1" + local test_script=3D"$2" + local name=3D"$(basename "$bconf_file" .bconf)" + + local workdir=3D"$(mktemp -d)" + if [ -z "$workdir" ] || [ ! -d "$workdir" ]; then + ktap_test_fail "$name (failed to create temporary directory)" + return 0 + fi + trap 'rm -rf "$workdir"' EXIT HUP INT TERM + + local rootfs=3D"$workdir/rootfs" + mkdir -p "$rootfs"/{bin,sbin,etc,proc,sys,dev,tmp} + + cp "$BUSYBOX" "$rootfs/bin/busybox" + chmod +x "$rootfs/bin/busybox" + (cd "$rootfs/bin" && for applet in sh cat mount umount echo sync reboot \ + poweroff cpio grep; do ln -s busybox $applet; done) + + if command -v ldd >/dev/null 2>&1; then + for lib in $(ldd "$BUSYBOX" 2>/dev/null | grep -o '/[^ ]*'); do + if [ -f "$lib" ]; then + mkdir -p "$rootfs$(dirname "$lib")" + cp -L "$lib" "$rootfs$lib" 2>/dev/null || true + fi + done + fi + + cat << 'EOF' > "$rootfs/init" +#!/bin/sh +mount -t proc proc /proc 2>/dev/null +mount -t sysfs sys /sys 2>/dev/null +mount -t tracefs nodev /sys/kernel/tracing 2>/dev/null + +/bin/check_test.sh +RET=3D$? + +if [ $RET -eq 0 ]; then + echo "TEST RESULT: PASS" +else + echo "TEST RESULT: FAIL" +fi + +sync +echo o > /proc/sysrq-trigger 2>/dev/null || reboot -f 2>/dev/null || power= off -f 2>/dev/null +EOF + chmod +x "$rootfs/init" + + cp "$test_script" "$rootfs/bin/check_test.sh" + chmod +x "$rootfs/bin/check_test.sh" + + local initramfs=3D"$workdir/initramfs.cpio" + (cd "$rootfs" && find . | cpio -o -H newc --quiet) > "$initramfs" + + # Attach bootconfig + "$BOOTCONFIG" -a "$bconf_file" "$initramfs" > /dev/null + + # Run QEMU with timeout + local timeout_cmd=3D"" + if command -v timeout >/dev/null 2>&1; then + timeout_cmd=3D"timeout $TIMEOUT" + fi + + local logfile=3D"$workdir/qemu.log" + $timeout_cmd "$QEMU" -kernel "$KERNEL" \ + -initrd "$initramfs" \ + -append "bootconfig console=3DttyS0 quiet panic=3D-1" \ + -nographic \ + -no-reboot > "$logfile" 2>&1 || true + + if grep -q "TEST RESULT: PASS" "$logfile"; then + ktap_test_pass "$name" + else + ktap_test_fail "$name" + ktap_print_msg "QEMU Console Output for $name:" + while IFS=3D read -r line; do + ktap_print_msg "$line" + done < "$logfile" + fi + + rm -rf "$workdir" + trap - EXIT HUP INT TERM + return 0 +} + +TEST_FILES=3D("$SCRIPT_DIR/bootconfigs"/*.bconf) +TOTAL_TESTS=3D0 +for bconf in "${TEST_FILES[@]}"; do + name=3D"$(basename "$bconf" .bconf)" + if [ "$TARGET_TEST" !=3D "all" ] && [ "$TARGET_TEST" !=3D "$name" ]; then + continue + fi + TOTAL_TESTS=3D$((TOTAL_TESTS + 1)) +done + +ktap_print_header +ktap_set_plan "$TOTAL_TESTS" + +for bconf in "${TEST_FILES[@]}"; do + name=3D"$(basename "$bconf" .bconf)" + test_script=3D"$SCRIPT_DIR/tests/$name.sh" + + if [ "$TARGET_TEST" !=3D "all" ] && [ "$TARGET_TEST" !=3D "$name" ]; then + continue + fi + + if [ ! -f "$test_script" ]; then + ktap_test_skip "$name (test script missing)" + continue + fi + + run_single_test "$bconf" "$test_script" +done + +ktap_finished diff --git a/tools/testing/selftests/ftrace/boottime/tests/01-kprobe.sh b/t= ools/testing/selftests/ftrace/boottime/tests/01-kprobe.sh new file mode 100755 index 000000000000..a20e7e82d158 --- /dev/null +++ b/tools/testing/selftests/ftrace/boottime/tests/01-kprobe.sh @@ -0,0 +1,18 @@ +#!/bin/sh +# SPDX-License-Identifier: GPL-2.0 +# Check kprobe bootconfig settings on tracefs +TRACEDIR=3D"/sys/kernel/tracing" + +if [ ! -d "$TRACEDIR/events/kprobes/vfs_read" ]; then + echo "FAIL: kprobe event kprobes/vfs_read does not exist" + exit 1 +fi + +ENABLE=3D$(cat "$TRACEDIR/events/kprobes/vfs_read/enable") +if [ "$ENABLE" !=3D "1" ]; then + echo "FAIL: kprobe event kprobes/vfs_read is not enabled ($ENABLE)" + exit 1 +fi + +echo "PASS: 01-kprobe" +exit 0 diff --git a/tools/testing/selftests/ftrace/boottime/tests/02-synth.sh b/to= ols/testing/selftests/ftrace/boottime/tests/02-synth.sh new file mode 100755 index 000000000000..46d3b152cbea --- /dev/null +++ b/tools/testing/selftests/ftrace/boottime/tests/02-synth.sh @@ -0,0 +1,18 @@ +#!/bin/sh +# SPDX-License-Identifier: GPL-2.0 +# Check synthetic event bootconfig settings on tracefs +TRACEDIR=3D"/sys/kernel/tracing" + +if [ ! -d "$TRACEDIR/events/synthetic/boot_lat" ]; then + echo "FAIL: synthetic event synthetic/boot_lat does not exist" + exit 1 +fi + +ENABLE=3D$(cat "$TRACEDIR/events/synthetic/boot_lat/enable") +if [ "$ENABLE" !=3D "1" ]; then + echo "FAIL: synthetic event synthetic/boot_lat is not enabled ($ENABLE)" + exit 1 +fi + +echo "PASS: 02-synth" +exit 0 diff --git a/tools/testing/selftests/ftrace/boottime/tests/03-eprobe.sh b/t= ools/testing/selftests/ftrace/boottime/tests/03-eprobe.sh new file mode 100755 index 000000000000..108f9ba31c06 --- /dev/null +++ b/tools/testing/selftests/ftrace/boottime/tests/03-eprobe.sh @@ -0,0 +1,18 @@ +#!/bin/sh +# SPDX-License-Identifier: GPL-2.0 +# Check eprobe event bootconfig settings on tracefs +TRACEDIR=3D"/sys/kernel/tracing" + +if [ ! -d "$TRACEDIR/events/eprobes/ep_read" ]; then + echo "FAIL: eprobe event eprobes/ep_read does not exist" + exit 1 +fi + +ENABLE=3D$(cat "$TRACEDIR/events/eprobes/ep_read/enable") +if [ "$ENABLE" !=3D "1" ]; then + echo "FAIL: eprobe event eprobes/ep_read is not enabled ($ENABLE)" + exit 1 +fi + +echo "PASS: 03-eprobe" +exit 0 diff --git a/tools/testing/selftests/ftrace/boottime/tests/04-fprobe.sh b/t= ools/testing/selftests/ftrace/boottime/tests/04-fprobe.sh new file mode 100755 index 000000000000..c0a316bf7dde --- /dev/null +++ b/tools/testing/selftests/ftrace/boottime/tests/04-fprobe.sh @@ -0,0 +1,18 @@ +#!/bin/sh +# SPDX-License-Identifier: GPL-2.0 +# Check fprobe event bootconfig settings on tracefs +TRACEDIR=3D"/sys/kernel/tracing" + +if [ ! -d "$TRACEDIR/events/fprobes/fp_read" ]; then + echo "FAIL: fprobe event fprobes/fp_read does not exist" + exit 1 +fi + +ENABLE=3D$(cat "$TRACEDIR/events/fprobes/fp_read/enable") +if [ "$ENABLE" !=3D "1" ]; then + echo "FAIL: fprobe event fprobes/fp_read is not enabled ($ENABLE)" + exit 1 +fi + +echo "PASS: 04-fprobe" +exit 0 diff --git a/tools/testing/selftests/ftrace/boottime/tests/05-tprobe.sh b/t= ools/testing/selftests/ftrace/boottime/tests/05-tprobe.sh new file mode 100755 index 000000000000..b29119b81e07 --- /dev/null +++ b/tools/testing/selftests/ftrace/boottime/tests/05-tprobe.sh @@ -0,0 +1,18 @@ +#!/bin/sh +# SPDX-License-Identifier: GPL-2.0 +# Check tracepoint probe event bootconfig settings on tracefs +TRACEDIR=3D"/sys/kernel/tracing" + +if [ ! -d "$TRACEDIR/events/tracepoints/tp_sched" ]; then + echo "FAIL: tracepoint probe event tracepoints/tp_sched does not exist" + exit 1 +fi + +ENABLE=3D$(cat "$TRACEDIR/events/tracepoints/tp_sched/enable") +if [ "$ENABLE" !=3D "1" ]; then + echo "FAIL: tracepoint probe event tracepoints/tp_sched is not enabled ($= ENABLE)" + exit 1 +fi + +echo "PASS: 05-tprobe" +exit 0 diff --git a/tools/testing/selftests/ftrace/boottime/tests/06-instance.sh b= /tools/testing/selftests/ftrace/boottime/tests/06-instance.sh new file mode 100755 index 000000000000..a95fdddaa6a6 --- /dev/null +++ b/tools/testing/selftests/ftrace/boottime/tests/06-instance.sh @@ -0,0 +1,23 @@ +#!/bin/sh +# SPDX-License-Identifier: GPL-2.0 +# Check instance bootconfig settings on tracefs +TRACEDIR=3D"/sys/kernel/tracing" + +if [ ! -d "$TRACEDIR/instances/foo" ]; then + echo "FAIL: trace instance foo does not exist" + exit 1 +fi + +if [ ! -d "$TRACEDIR/instances/foo/events/sched/sched_switch" ]; then + echo "FAIL: event sched_switch does not exist in instance foo" + exit 1 +fi + +ENABLE=3D$(cat "$TRACEDIR/instances/foo/events/sched/sched_switch/enable") +if [ "$ENABLE" !=3D "1" ]; then + echo "FAIL: event sched_switch is not enabled in instance foo ($ENABLE)" + exit 1 +fi + +echo "PASS: 06-instance" +exit 0 diff --git a/tools/testing/selftests/ftrace/config b/tools/testing/selftest= s/ftrace/config index 544de0db5f58..fec41c6b290e 100644 --- a/tools/testing/selftests/ftrace/config +++ b/tools/testing/selftests/ftrace/config @@ -1,3 +1,5 @@ +CONFIG_BOOT_CONFIG=3Dy +CONFIG_BOOTTIME_TRACING=3Dy CONFIG_BPF_SYSCALL=3Dy CONFIG_DEBUG_INFO_BTF=3Dy CONFIG_DEBUG_INFO_DWARF4=3Dy @@ -8,6 +10,7 @@ CONFIG_FTRACE=3Dy CONFIG_FTRACE_SYSCALLS=3Dy CONFIG_FUNCTION_GRAPH_RETVAL=3Dy CONFIG_FUNCTION_PROFILER=3Dy +CONFIG_FUNCTION_TRACER=3Dy CONFIG_HIST_TRIGGERS=3Dy CONFIG_IRQSOFF_TRACER=3Dy CONFIG_KALLSYMS_ALL=3Dy @@ -24,6 +27,7 @@ CONFIG_SAMPLE_TRACE_EVENTS=3Dm CONFIG_SAMPLE_TRACE_PRINTK=3Dm CONFIG_SCHED_TRACER=3Dy CONFIG_STACK_TRACER=3Dy +CONFIG_SYNTH_EVENTS=3Dy CONFIG_TRACER_SNAPSHOT=3Dy CONFIG_UPROBES=3Dy CONFIG_UPROBE_EVENTS=3Dy