Add --hyperlink option

Introduce a new command-line option '--hyperlink' to add terminal
hyperlinks (using OSC 8 escape sequences) from system call names
in the trace output to their corresponding Linux manual pages on
man7.org. This improves the diagnostic and educational usability of
strace outputs in modern terminals supporting OSC 8.

* NEWS: Mention this change.
* doc/strace.1.in: Document --hyperlink option.
* src/color.h (hyperlink_is_enabled): Declare.
* src/print_fields.c (OSC8_BEGIN, OSC8_END, STRACE_PRINT_SYSCALL):
New macros.
(hyperlink_is_enabled): Define.
(tprints_arg_begin): Use STRACE_PRINT_SYSCALL.
* src/strace.c (usage): Document --hyperlink option.
(init) <GETOPT_HYPERLINK>: New enum constant.
<longopts>: Add "hyperlink" option.
Handle GETOPT_HYPERLINK.
* tests/Makefile.am (MISC_TESTS): Add strace--hyperlink.test.
* tests/strace--hyperlink.test: New test.

Assisted-by: Antigravity:gemini-3.5-flash (commit log)
Signed-off-by: Masatake YAMATO <yamato@redhat.com>

Author: masatake

NEWS

@@ -5,6 +5,8 @@ Noteworthy changes in release ?.? (????-??-??)
   * Implemented decoding of IFLA_BRPORT_NEIGH_FORWARD_GRAT attribute.
   * Updated lists of BPF_*, ETH_P_*, FS_*, IFLA_*, KVM_*, LANDLOCK_*, NL80211_*,
     O_*, RTEXT_*, V4L2_*, and XFRM_MSG_* constants.
+  * Added --hyperlink option that adds hyperlinks from system call names to
+    manual pages at man7.org.
 
 Noteworthy changes in release 7.1 (2026-06-15)
 ==============================================

doc/strace.1.in

@@ -1159,6 +1159,11 @@ Recognized color keys are:
 .BR retval ,
 .BR error .
 .TP
+.B \-\-hyperlink
+Add hyperlinks from system call names to manual pages at
+.UR https://man7.org/linux/man-pages/man2
+man7.org.
+.TP
 .B \-q
 .TQ
 .B \-\-quiet

src/color.h

@@ -35,6 +35,7 @@ enum color_kind_t {
 extern enum color_mode_t color_mode;
 extern const char *color_seq_table[COLOR_KIND_MAX];
 extern bool color_is_enabled;
+extern bool hyperlink_is_enabled;
 
 void color_init(int out_fd, bool output_separately);
 

src/print_fields.c

@@ -9,6 +9,18 @@
 #include "defs.h"
 #include "print_fields.h"
 
+#define OSC8_BEGIN "\033]8;;" "https://man7.org/linux/man-pages/man2/%s.2.html" "\033\\"
+#define OSC8_END   "\033]8;;\033\\"
+#define STRACE_PRINT_SYSCALL(name) do {					\
+		if (hyperlink_is_enabled)				\
+			STRACE_PRINTF(OSC8_BEGIN "%s" OSC8_END, name, name); \
+		else							\
+			STRACE_PRINTF("%s", name);			\
+	} \
+	while (0)
+
+bool hyperlink_is_enabled = false;
+
 void
 tprint_struct_begin(void)
 {
@@ -101,7 +113,7 @@ void
 tprints_arg_begin(const char *name)
 {
 	STRACE_PRINT_COLOR_SEQ(COLOR_SYSCALL);
-	STRACE_PRINTF("%s", name);
+	STRACE_PRINT_SYSCALL(name);
 	STRACE_PRINT_COLOR_SEQ(COLOR_PUNCT);
 	STRACE_PRINTS("(");
 	STRACE_PRINT_COLOR_SEQ(COLOR_ARGVAL);

src/strace.c

@@ -371,6 +371,8 @@ Output format:\n\
                  alignment COLUMN for printing syscall results (default %d)\n\
   --color[=WHEN]\n\
                  colorize output; WHEN is auto, always, or never (default auto)\n\
+  --hyperlink\n\
+                 add hyperlinks from system call names to manual pages at man7.org.\n\
   -e abbrev=SET, --abbrev=SET\n\
                  abbreviate output for the syscalls in SET\n\
   -e verbose=SET, --verbose=SET\n\
@@ -2450,6 +2452,7 @@ init(int argc, char *argv[])
 		GETOPT_STACK_TRACE_FRAME_LIMIT,
 		GETOPT_ALWAYS_SHOW_PID,
 		GETOPT_COLOR,
+		GETOPT_HYPERLINK,
 		GETOPT_QUAL_TRACE,
 		GETOPT_QUAL_TRACE_FD,
 		GETOPT_QUAL_ABBREV,
@@ -2518,6 +2521,7 @@ init(int argc, char *argv[])
 		{ "argv0",		required_argument, 0, GETOPT_ARGV0 },
 		{ "always-show-pid",	no_argument,	   0, GETOPT_ALWAYS_SHOW_PID },
 		{ "color",		required_argument, 0, GETOPT_COLOR },
+		{ "hyperlink",		no_argument,	   0, GETOPT_HYPERLINK },
 		{ "trace",	required_argument, 0, GETOPT_QUAL_TRACE },
 		{ "trace-fds",	required_argument, 0, GETOPT_QUAL_TRACE_FD },
 		{ "abbrev",	required_argument, 0, GETOPT_QUAL_ABBREV },
@@ -2827,6 +2831,9 @@ init(int argc, char *argv[])
 			color_mode = (enum color_mode_t) color_mode_raw;
 			break;
 		}
+		case GETOPT_HYPERLINK:
+			hyperlink_is_enabled = true;
+			break;
 		case GETOPT_QUAL_SECONTEXT:
 			qualify_secontext(optarg ? optarg : secontext_qual);
 			break;

tests/Makefile.am

@@ -716,6 +716,7 @@ MISC_TESTS = \
 	status-unfinished-threads.test \
 	strace--color-no-tty.test \
 	strace--color-tty.test \
+	strace--hyperlink.test \
 	strace--argv0.test \
 	strace--syscall-limit.test \
 	strace--syscall-limit--seccomp-bpf.test \

tests/strace--hyperlink.test

@@ -0,0 +1,28 @@
+#!/bin/sh -efu
+#
+# Check --hyperlink option
+#
+# Copyright (c) 2026 Masatake YAMATO <yamato@redhat.com>
+# Copyright (c) 2026 The strace developers.
+# All rights reserved.
+#
+# SPDX-License-Identifier: GPL-2.0-or-later
+
+. "${srcdir=.}/init.sh"
+
+unset STRACE_COLORS
+unset NO_COLOR
+
+TERM=linux
+export TERM
+
+run_prog ../getpid > /dev/null
+
+cmd="../getpid > /dev/null"
+
+csi_color="$(printf '\033\\[')"
+csi_link_begin="$(printf '\033]8;;%s\033\\\\' 'https://man7\.org/linux/man-pages/man2/getpid\.2\.html')"
+csi_link_end="$(printf '\033]8;;\033\\\\')"
+printf '%s\n' ".*${csi_color}33m${csi_link_begin}getpid${csi_link_end}.*${csi_color}0m.*" > "$EXP"
+run_strace --trace=getpid --hyperlink --color=always ../getpid > /dev/null
+match_grep "$LOG" "$EXP"