Skip to contentSkip to conversation

bpftool: Exit from the stream wait signal handler with _exit()

PATCH In review Kumar Kartikeya Dwivedi 2 participants 2 messages Sep 26

Subsystems (2)
lore
Share & tools
lore

Kumar Kartikeya Dwivedi

author maintainer
#0 lore raw

PATCH 1/1 bpftool: Exit from the stream wait signal handler with _exit()

bpftool prog tracelog -w ends from its SIGINT, SIGHUP and SIGTERM handler, which calls exit(). exit() is not async-signal-safe: it runs atexit handlers and flushes stdio streams, and the signal may land while the read loop is inside fwrite() or fflush() on the stream being flushed. Whether that deadlocks or flushes a half-updated buffer depends on the C library.

Call _exit() instead. The loop flushes every chunk as soon as it is printed, so the stdio buffer is empty except while a chunk is being written, and skipping the exit-time flush loses nothing.

While here, note in the manual page that opening a stream as a file descriptor arrives in Linux 7.4, and restrict the -w/--wait description to the stdout/stderr form of the tracelog command, since the trace pipe form does not take the option.

---
 tools/bpf/bpftool/Documentation/bpftool-prog.rst | 8 +++++---
 tools/bpf/bpftool/prog.c                         | 2 +-
 2 files changed, 6 insertions(+), 4 deletions(-)
tools/bpf/bpftool/Documentation/bpftool-prog.rst +5 -3
index 17aa0d560e32..8dbd34ef3d8b 100644
@@ -190,7 +190,8 @@ bpftool prog tracelog { stdout | stderr } *PROG*
     By default, bpftool prints the output buffered so far and exits. With
     **-w** or **--wait**, it keeps printing new output as the program produces
     it, until the program is unloaded or <Ctrl+C> is hit. Waiting requires a
-    kernel that supports opening a stream as a file descriptor.
+    kernel that supports opening a stream as a file descriptor, introduced
+    upstream in Linux 7.4.
 
 bpftool prog run *PROG* data_in *FILE* [data_out *FILE* [data_size_out *L*]] [ctx_in *FILE* [ctx_out *FILE* [ctx_size_out *M*]]] [repeat *N*]
     Run BPF program *PROG* in the kernel testing infrastructure for BPF,
@@ -274,8 +275,9 @@ OPTIONS
     signing.
 
 -w, --wait
-    When dumping a program stream with **bpftool prog tracelog**, wait for new
-    output instead of exiting once the buffered output has been printed.
+    When dumping a program stream with **bpftool prog tracelog** { **stdout** |
+    **stderr** } *PROG*, wait for new output instead of exiting once the
+    buffered output has been printed.
 
 EXAMPLES
 ========
tools/bpf/bpftool/prog.c +1 -1
index 5e27b22444f2..a60414aaa494 100644
@@ -1121,7 +1121,7 @@ enum prog_tracelog_mode {
 
 static void exit_stream(int signo)
 {
-	exit(0);
+	_exit(0);
 }
 
 /* Consumes prog_fd. */

--
2.53.0

maintainer Acked-by on v1 1/1
#1 lore raw

2026-09-26 17:45 UTC+0200 ~ Kumar Kartikeya Dwivedi <[email protected]>

Quoted 10 lines

bpftool prog tracelog -w ends from its SIGINT, SIGHUP and SIGTERM handler, which calls exit(). exit() is not async-signal-safe: it runs atexit handlers and flushes stdio streams, and the signal may land while the read loop is inside fwrite() or fflush() on the stream being flushed. Whether that deadlocks or flushes a half-updated buffer depends on the C library.

Call _exit() instead. The loop flushes every chunk as soon as it is printed, so the stdio buffer is empty except while a chunk is being written, and skipping the exit-time flush loses nothing.

Quoted 7 lines

While here, note in the manual page that opening a stream as a file descriptor arrives in Linux 7.4, and restrict the -w/--wait description to the stdout/stderr form of the tracelog command, since the trace pipe form does not take the option.

Thanks for the follow-up!