Hi Fotios, On 2/25/23 11:56, Fotios Valasiadis wrote: > Document the role of PTRACE_O_TRACESYSGOOD option in connection with PTRACE_GET_SYSCALL_INFO. > > Signed-off-by: Fotios Valasiadis <fvalasiad@xxxxxxxxx> > Cowritten-by: Dmitry V. Levin <ldv@xxxxxxxxx> > Complements: fc91449cb "ptrace.2: Document PTRACE_GET_SYSCALL_INFO" > --- > man2/ptrace.2 | 9 +++++++++ > 1 file changed, 9 insertions(+) > > diff --git a/man2/ptrace.2 b/man2/ptrace.2 > index 55d9fd36d..ad0543b0b 100644 > --- a/man2/ptrace.2 > +++ b/man2/ptrace.2 > @@ -1111,6 +1111,15 @@ stop. > .B PTRACE_SYSCALL_INFO_NONE > No component of the union contains relevant information. > .RE > +.IP > +Note that in case of "Note that" is usually redundant. See: <https://lore.kernel.org/linux-man/20210729223535.qvyomfqvvahzmu5w@localhost.localdomain/> <https://lore.kernel.org/linux-man/20230105225235.6cjtz6orjzxzvo6v@illithid/> > +syscall entry or exit stops, the data returned by Please use semantic newlines. See man-pages(7): Use semantic newlines In the source of a manual page, new sentences should be started on new lines, long sentences should be split into lines at clause breaks (com‐ mas, semicolons, colons, and so on), and long clauses should be split at phrase boundaries. This convention, sometimes known as "semantic newlines", makes it easier to see the effect of patches, which often operate at the level of individual sentences, clauses, or phrases. > +.B PTRACE_GET_SYSCALL_INFO > +is limited to type > +.B PTRACE_SYSCALL_INFO_NONE > +unless > +.B PTRACE_O_TRACESYSGOOD > +option is set before the corresponding ptrace stop has occurred. You should say .BR ptrace () right? Or is unformatted ptrace common in this page? Cheers, Alex > .\" > .SS Death under ptrace > When a (possibly multithreaded) process receives a killing signal -- <http://www.alejandro-colomar.es/> GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5
Attachment:
OpenPGP_signature
Description: OpenPGP digital signature