ptrace.2: Document PTRACE_GET_SYSCALL_INFO

PTRACE_GET_SYSCALL_INFO request was introduced by Linux kernel
commit 201766a20e30f982ccfe36bebfad9602c3ff574a aka
v5.3-rc1~65^2~23.

Signed-off-by: Dmitry V. Levin <ldv@altlinux.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Dmitry V. Levin 2019-09-02 15:38:58 +03:00 committed by Michael Kerrisk
parent fec82988e7
commit fc91449cb5
1 changed files with 21 additions and 0 deletions

View File

@ -1005,6 +1005,27 @@ of the
.IR "struct user_desc"
is ignored; in other words,
this ptrace operation can't be used to allocate a free TLS entry.)
.TP
.BR PTRACE_GET_SYSCALL_INFO " (since Linux 5.3)"
.\" commit 201766a20e30f982ccfe36bebfad9602c3ff574a
Retrieve information about the syscall that caused the stop.
The information is placed into the buffer pointed by
.I data
argument, which should be a pointer to a buffer of type
.IR "struct ptrace_syscall_info" .
The
.I addr
argument contains the size of the buffer pointed to
by
.I data
argument (i.e.,
.IR "sizeof(struct ptrace_syscall_info)" ).
The return value contains the number of bytes available
to be written by the kernel.
If the size of data to be written by the kernel exceeds the size
specified by
.I addr
argument, the output is truncated.
.\"
.SS Death under ptrace
When a (possibly multithreaded) process receives a killing signal