man/man2/ptrace.2: Add PTRACE_SET_SYSCALL_INFO, update struct ptrace_syscall_info

Add documentation for the new ptrace request PTRACE_SET_SYSCALL_INFO,
introduced in Linux 6.16.

Add 'reserved' and 'flags' fields of struct ptrace_syscall_info.

This description is based on kernel commit 26bb32768fe6552de044f782a58b3272073fbfc0
("ptrace: introduce PTRACE_SET_SYSCALL_INFO request") by Dmitry V. Levin.

Signed-off-by: Marco Cavenati <Marco.Cavenati@eurecom.fr>
Message-ID: <20260121155550.281916-1-Marco.Cavenati@eurecom.fr>
Reviewed-by: "Dmitry V. Levin" <ldv@strace.io>
Message-ID: <20260210205347.GA31604@strace.io>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

diff --git a/AUTHORS b/AUTHORS
index 675fc8ea54f2cbc63864d26d25ee7ca8e99bf706..74e685dbbed58eaabf13188bbf478bbfa1e649ee 100644 (file)
--- a/AUTHORS
+++ b/AUTHORS
@@ -508,6 +508,7 @@ Marc-André Lureau <marcandre.lureau@redhat.com>
 Marcela Maslanova <mmaslano@redhat.com>
 Marcin Ślusarz <marcin.slusarz@gmail.com>
 Marco Bonelli <marco@mebeim.net>
+Marco Cavenati <marco.cavenati@eurecom.fr>
 Marcus Folkesson <marcus.folkesson@gmail.com>
 Marcus Gelderie <redmnic@gmail.com>
 Marcus Huewe <suse-tux@gmx.de>

diff --git a/man/man2/ptrace.2 b/man/man2/ptrace.2
index dc2f83bee6f4961f90f958e39f9c44053e884f62..a15bad7d33085364859c5076b6f8d65ef57be51d 100644 (file)
--- a/man/man2/ptrace.2
+++ b/man/man2/ptrace.2
@@ -1045,6 +1045,8 @@ structure contains the following fields:
 .EX
 struct ptrace_syscall_info {
     __u8 op;        /* Type of system call stop */
+    __u8 reserved;  /* Reserved for future use, must be zero */
+    __u16 flags;    /* Reserved for future use, must be zero */
     __u32 arch;     /* AUDIT_ARCH_* value; see seccomp(2) */
     __u64 instruction_pointer; /* CPU instruction pointer */
     __u64 stack_pointer;    /* CPU stack pointer */
@@ -1124,6 +1126,25 @@ is limited to type
 unless
 .B PTRACE_O_TRACESYSGOOD
 option is set before the corresponding system call stop has occurred.
+.TP
+.BR PTRACE_SET_SYSCALL_INFO " (since Linux 6.16)"
+.\" commit 26bb32768fe6552de044f782a58b3272073fbfc0
+Modify information about the system call that caused the stop.
+The
+.I data
+argument is a pointer to
+.I struct ptrace_syscall_info
+that specifies the system call information to be set.
+The
+.I addr
+argument should be set to
+.IR "sizeof(struct ptrace_syscall_info)" .
+Only the
+.IR nr ,
+.IR args ,
+and
+.I rval
+fields can be modified.
 .\"
 .SS Death under ptrace
 When a (possibly multithreaded) process receives a killing signal