[PATCH] ptrace.2: ffix and tfix

[PATCH] ptrace.2: ffix and tfix

[David Prévot]

---
 man2/ptrace.2 |   51 ++++++++++++++++++++++++++++++++-------------------
 1 files changed, 32 insertions(+), 19 deletions(-)

diff --git a/man2/ptrace.2 b/man2/ptrace.2
index 5a8b648..457c6ac 100644
--- a/man2/ptrace.2
+++ b/man2/ptrace.2
@@ -277,7 +277,7 @@ which are specified by the following flags:
 .BR PTRACE_O_TRACESYSGOOD " (since Linux 2.4.6)"
 When delivering system call traps, set bit 7 in the signal number
 (i.e., deliver
-.IR "SIGTRAP|0x80" ).
+.BR "SIGTRAP\ |\ 0x80" ).
 This makes it easy for the tracer to distinguish
 normal traps from those caused by a system call.
 .RB ( PTRACE_O_TRACESYSGOOD
@@ -468,7 +468,7 @@ The
 .I data
 argument is treated as for
 .BR PTRACE_CONT .
-.RI (addr
+.RI ( addr
 is ignored.)
 .TP
 .BR PTRACE_SYSEMU ", " PTRACE_SYSEMU_SINGLESTEP " (since Linux 2.6.14)"
@@ -539,7 +539,9 @@ but will not necessarily have stopped
 by the completion of this call; use
 .BR waitpid (2)
 to wait for the tracee to stop.
-See the "Attaching and detaching" subsection for additional information.
+See the 
+.B Attaching and detaching
+subsection for additional information.
 .RI ( addr
 and
 .I data
@@ -716,7 +718,9 @@ Example:
 .\"     describe how wait notifications queue (or not queue)
 .LP
 The following kinds of ptrace-stops exist: signal-delivery-stops,
-group-stop, PTRACE_EVENT stops, syscall-stops.
+group-stop,
+.B PTRACE_EVENT
+stops, syscall-stops.
 They all are reported by
 .BR waitpid (2)
 with
@@ -730,7 +734,7 @@ and if there is ambiguity in that value, by querying
 .I WSTOPSIG(status)
 macro can't be used to perform this examination,
 because it returns the value
-(\fIstatus\>>8)\ \fB&\ 0xff\fP\fP.)
+(\fIstatus\>>8\fP)\ \fB&\ 0xff\fP.)
 .SS Signal-delivery-stop
 When a (possibly multithreaded) process receives any signal except
 .BR SIGKILL ,
@@ -761,7 +765,11 @@ true, with the signal returned by
 If the signal is
 .BR SIGTRAP ,
 this may be a different kind of ptrace-stop;
-see the "Syscall-stops" and "execve" sections below for details.
+see the
+.B Syscall-stops
+and
+.B execve(2) under ptrace
+sections below for details.
 If
 .I WSTOPSIG(status)
 returns a stopping signal, this may be a group-stop; see below.
@@ -837,7 +845,7 @@ The
 signal has a side effect of waking up (all threads of)
 a group-stopped process.
 This side effect happens before signal-delivery-stop.
-The tracer can't suppress this side-effect (it can
+The tracer can't suppress this side effect (it can
 only suppress signal injection, which only causes the
 .BR SIGCONT
 handler to not be executed in the tracee, if such a handler is installed).
@@ -997,7 +1005,7 @@ with the exit signal set to
 .TP
 .B PTRACE_EVENT_CLONE
 Stop before return from
-.BR clone (2)
+.BR clone (2).
 .TP
 .B PTRACE_EVENT_VFORK_DONE
 Stop before return from
@@ -1039,12 +1047,13 @@ to finish exiting.
 on
 .B PTRACE_EVENT
 stops returns
-.B SIGTRAP in
+.B SIGTRAP
+in
 .IR si_signo ,
 with
 .I si_code
 set to
-.IR "(event<<8)\ |\ SIGTRAP" .
+(\fIevent<<8\fP)\ \fB|\ SIGTRAP\fP.
 .SS Syscall-stops
 If the tracee was restarted by
 .BR PTRACE_SYSCALL ,
@@ -1086,7 +1095,7 @@ If the
 option was set by the tracer, then
 .I WSTOPSIG(status)
 will give the value
-.IR "(SIGTRAP\ |\ 0x80)" .
+.RB ( "SIGTRAP\ |\ 0x80" ).
 .LP
 Syscall-stops can be distinguished from signal-delivery-stop with
 .B SIGTRAP
@@ -1173,7 +1182,7 @@ with
 set to
 .B SIGTRAP
 or
-.IR (SIGTRAP|0x80) .
+.RB ( "SIGTRAP\ |\ 0x80" ).
 .SS PTRACE_SINGLESTEP, PTRACE_SYSEMU, PTRACE_SYSEMU_SINGLESTEP stops
 [Details of these kinds of stops are yet to be documented.]
 .\"
@@ -1243,7 +1252,7 @@ is
 .BR PTRACE_SINGLESTEP ,
 .BR PTRACE_SYSEMU ,
 or
-.BR PTRACE_SYSEMU_SINGLESTEP.
+.BR PTRACE_SYSEMU_SINGLESTEP .
 If the tracee is in signal-delivery-stop,
 .I sig
 is the signal to be injected (if it is nonzero).
@@ -1252,7 +1261,7 @@ Otherwise,
 may be ignored.
 (When restarting a tracee from a ptrace-stop other than signal-delivery-stop,
 recommended practice is to always pass 0 in
-.I sig .)
+.IR sig .)
 .SS Attaching and detaching
 A thread can be attached to the tracer using the call
 
@@ -1285,9 +1294,11 @@ may be lost.
 Since attaching sends
 .B SIGSTOP
 and the tracer usually suppresses it, this may cause a stray
-.I EINTR
+.B EINTR
 return from the currently executing system call in the tracee,
-as described in the "signal injection and suppression" section.
+as described in the
+.B Signal injection and suppression
+section.
 .LP
 The request
 
@@ -1479,10 +1490,10 @@ Example: two threads call
 at the same time:
 .LP
 .nf
-*** we get syscall-entry-stop in thread 1: **
+*** we get syscall-enter-stop in thread 1: **
 PID1 execve("/bin/foo", "foo" <unfinished ...>
 *** we issue PTRACE_SYSCALL for thread 1 **
-*** we get syscall-entry-stop in thread 2: **
+*** we get syscall-enter-stop in thread 2: **
 PID2 execve("/bin/bar", "bar" <unfinished ...>
 *** we issue PTRACE_SYSCALL for thread 2 **
 *** we get PTRACE_EVENT_EXEC for PID0, we issue PTRACE_SYSCALL **
@@ -1539,7 +1550,9 @@ several kinds of
 notifications when the child process is traced by some other process.
 .LP
 Many of these bugs have been fixed, but as of Linux 2.6.38 several still
-exist; see BUGS below.
+exist; see
+.B BUGS
+below.
 .LP
 As of Linux 2.6.38, the following is believed to work correctly:
 .IP * 3
-- 
1.7.9.1

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[PATCH 2/2] ptrace.2: more ffix and tfix

[David Prévot]

The previous ones were spotted during the translations, while those were
spotted during its review.

Regards

David
---
 man2/ptrace.2 |   14 ++++++++------
 1 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/man2/ptrace.2 b/man2/ptrace.2
index 457c6ac..62f4458 100644
--- a/man2/ptrace.2
+++ b/man2/ptrace.2
@@ -180,7 +180,8 @@ The word is returned as the result of the
 call.
 Typically, the offset must be word-aligned, though this might vary by
 architecture.
-See NOTES.
+See 
+.BR NOTES .
 .RI ( data
 is ignored.)
 .TP
@@ -264,7 +265,7 @@ itself.
 .RI ( addr
 is ignored.)
 .TP
-.BR PTRACE_SETOPTIONS " (since Linux 2.4.6; see BUGS for caveats)"
+.BR PTRACE_SETOPTIONS " (since Linux 2.4.6; see " BUGS " for caveats)"
 Set ptrace options from
 .IR data .
 .RI ( addr
@@ -718,7 +719,7 @@ Example:
 .\"     describe how wait notifications queue (or not queue)
 .LP
 The following kinds of ptrace-stops exist: signal-delivery-stops,
-group-stop,
+group-stops,
 .B PTRACE_EVENT
 stops, syscall-stops.
 They all are reported by
@@ -802,12 +803,12 @@ Note that a suppressed signal still causes system calls to return
 prematurely.
 In this case system calls will be restarted: the tracer will
 observe the tracee to reexecute the interrupted system call (or
-.BR restart_syscall(2)
+.BR restart_syscall (2)
 system call for a few syscalls which use a different mechanism
 for restarting) if the tracer uses
 .BR PTRACE_SYSCALL .
 Even system calls (such as
-.BR poll(2) )
+.BR poll (2))
 which are not restartable after signal are restarted after
 signal is suppressed;
 however, kernel bugs exist which cause some syscalls to fail with
@@ -1454,7 +1455,8 @@ The
 .B PTRACE_O_TRACEEXEC
 option is the recommended tool for dealing with this situation.
 First, it enables
-.BR PTRACE_EVENT_EXEC -stop,
+.B PTRACE_EVENT_EXEC
+stop,
 which occurs before
 .BR execve(2)
 returns.
-- 
1.7.9.1

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[PATCH 2/3] ptrace.2: more ffix and tfix

[David Prévot]

The previous ones were spotted during the translations, while those were
spotted during its review.

Regards

David
---
 man2/ptrace.2 |   14 ++++++++------
 1 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/man2/ptrace.2 b/man2/ptrace.2
index 457c6ac..62f4458 100644
--- a/man2/ptrace.2
+++ b/man2/ptrace.2
@@ -180,7 +180,8 @@ The word is returned as the result of the
 call.
 Typically, the offset must be word-aligned, though this might vary by
 architecture.
-See NOTES.
+See 
+.BR NOTES .
 .RI ( data
 is ignored.)
 .TP
@@ -264,7 +265,7 @@ itself.
 .RI ( addr
 is ignored.)
 .TP
-.BR PTRACE_SETOPTIONS " (since Linux 2.4.6; see BUGS for caveats)"
+.BR PTRACE_SETOPTIONS " (since Linux 2.4.6; see " BUGS " for caveats)"
 Set ptrace options from
 .IR data .
 .RI ( addr
@@ -718,7 +719,7 @@ Example:
 .\"     describe how wait notifications queue (or not queue)
 .LP
 The following kinds of ptrace-stops exist: signal-delivery-stops,
-group-stop,
+group-stops,
 .B PTRACE_EVENT
 stops, syscall-stops.
 They all are reported by
@@ -802,12 +803,12 @@ Note that a suppressed signal still causes system calls to return
 prematurely.
 In this case system calls will be restarted: the tracer will
 observe the tracee to reexecute the interrupted system call (or
-.BR restart_syscall(2)
+.BR restart_syscall (2)
 system call for a few syscalls which use a different mechanism
 for restarting) if the tracer uses
 .BR PTRACE_SYSCALL .
 Even system calls (such as
-.BR poll(2) )
+.BR poll (2))
 which are not restartable after signal are restarted after
 signal is suppressed;
 however, kernel bugs exist which cause some syscalls to fail with
@@ -1454,7 +1455,8 @@ The
 .B PTRACE_O_TRACEEXEC
 option is the recommended tool for dealing with this situation.
 First, it enables
-.BR PTRACE_EVENT_EXEC -stop,
+.B PTRACE_EVENT_EXEC
+stop,
 which occurs before
 .BR execve(2)
 returns.
-- 
1.7.9.1

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH 2/3] ptrace.2: more ffix and tfix

[David Prévot]

[-- Attachment #1: Type: text/plain, Size: 329 bytes --]

Le 23/03/2012 11:31, David Prévot a écrit :
> The previous ones were spotted during the translations, while those were
> spotted during its review.

Grr, I sent the wrong one here. Just sent back the actual late tiny
patch. Thanks Micheal for your explanations (about what you applied, and
why).

Regards

David



[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 836 bytes --]

Re: [PATCH 2/3] ptrace.2: more ffix and tfix

[Michael Kerrisk (man-pages)]

Hi David,

On Sat, Mar 24, 2012 at 12:34 PM, David Prévot <taffit-8fiUuRrzOP0dnm+yROfE0A@public.gmane.org> wrote:
> Le 23/03/2012 11:31, David Prévot a écrit :
>> The previous ones were spotted during the translations, while those were
>> spotted during its review.
>
> Grr, I sent the wrong one here. Just sent back the actual late tiny
> patch. Thanks Micheal for your explanations (about what you applied, and
> why).

No problem! Thanks for sending in all of these patches.

Cheers,

Michael

-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface"; http://man7.org/tlpi/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH 2/2] ptrace.2: more ffix and tfix

[Michael Kerrisk (man-pages)]

HI David,

On Fri, Mar 23, 2012 at 4:12 PM, David Prévot <taffit-8fiUuRrzOP0dnm+yROfE0A@public.gmane.org> wrote:
> The previous ones were spotted during the translations, while those were
> spotted during its review.
>
> Regards
>
> David
> ---
>  man2/ptrace.2 |   14 ++++++++------
>  1 files changed, 8 insertions(+), 6 deletions(-)
>
> diff --git a/man2/ptrace.2 b/man2/ptrace.2
> index 457c6ac..62f4458 100644
> --- a/man2/ptrace.2
> +++ b/man2/ptrace.2
> @@ -180,7 +180,8 @@ The word is returned as the result of the
>  call.
>  Typically, the offset must be word-aligned, though this might vary by
>  architecture.
> -See NOTES.
> +See
> +.BR NOTES .

Not applied (See previous mail)

>  .RI ( data
>  is ignored.)
>  .TP
> @@ -264,7 +265,7 @@ itself.
>  .RI ( addr
>  is ignored.)
>  .TP
> -.BR PTRACE_SETOPTIONS " (since Linux 2.4.6; see BUGS for caveats)"
> +.BR PTRACE_SETOPTIONS " (since Linux 2.4.6; see " BUGS " for caveats)"

Not applied (See previous mail)

>  Set ptrace options from
>  .IR data .
>  .RI ( addr
> @@ -718,7 +719,7 @@ Example:
>  .\"     describe how wait notifications queue (or not queue)
>  .LP
>  The following kinds of ptrace-stops exist: signal-delivery-stops,
> -group-stop,
> +group-stops,

I actually spotted this one myself while going though your previous
patch, and fixed it.

>  .B PTRACE_EVENT
>  stops, syscall-stops.
>  They all are reported by
> @@ -802,12 +803,12 @@ Note that a suppressed signal still causes system calls to return
>  prematurely.
>  In this case system calls will be restarted: the tracer will
>  observe the tracee to reexecute the interrupted system call (or
> -.BR restart_syscall(2)
> +.BR restart_syscall (2)

Applied.

>  system call for a few syscalls which use a different mechanism
>  for restarting) if the tracer uses
>  .BR PTRACE_SYSCALL .
>  Even system calls (such as
> -.BR poll(2) )
> +.BR poll (2))

Applied.

>  which are not restartable after signal are restarted after
>  signal is suppressed;
>  however, kernel bugs exist which cause some syscalls to fail with
> @@ -1454,7 +1455,8 @@ The
>  .B PTRACE_O_TRACEEXEC
>  option is the recommended tool for dealing with this situation.
>  First, it enables
> -.BR PTRACE_EVENT_EXEC -stop,
> +.B PTRACE_EVENT_EXEC
> +stop,

Applied.

>  which occurs before
>  .BR execve(2)
>  returns.
> --
> 1.7.9.1
>

Thanks, David!

Cheers,

Michael


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface"; http://man7.org/tlpi/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[PATCH 3/3] ptrace.2: another ffix

[David Prévot]

---
 man2/ptrace.2 |    2 +-
 1 files changed, 1 insertions(+), 1 deletions(-)

diff --git a/man2/ptrace.2 b/man2/ptrace.2
index 62f4458..0d6ec68 100644
--- a/man2/ptrace.2
+++ b/man2/ptrace.2
@@ -1458,7 +1458,7 @@ First, it enables
 .B PTRACE_EVENT_EXEC
 stop,
 which occurs before
-.BR execve(2)
+.BR execve (2)
 returns.
 In this stop, the tracer can use
 .B PTRACE_GETEVENTMSG
-- 
1.7.9.1

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH 3/3] ptrace.2: another ffix

[Michael Kerrisk (man-pages)]

Yup, I spotted that one two while I applied your previous patches ;-).

On Sat, Mar 24, 2012 at 12:32 PM, David Prévot <taffit-8fiUuRrzOP0dnm+yROfE0A@public.gmane.org> wrote:
> ---
>  man2/ptrace.2 |    2 +-
>  1 files changed, 1 insertions(+), 1 deletions(-)
>
> diff --git a/man2/ptrace.2 b/man2/ptrace.2
> index 62f4458..0d6ec68 100644
> --- a/man2/ptrace.2
> +++ b/man2/ptrace.2
> @@ -1458,7 +1458,7 @@ First, it enables
>  .B PTRACE_EVENT_EXEC
>  stop,
>  which occurs before
> -.BR execve(2)
> +.BR execve (2)
>  returns.
>  In this stop, the tracer can use
>  .B PTRACE_GETEVENTMSG
> --
> 1.7.9.1
>
> --
> To unsubscribe from this list: send the line "unsubscribe linux-man" in
> the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
> More majordomo info at  http://vger.kernel.org/majordomo-info.html



-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface"; http://man7.org/tlpi/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] ptrace.2: ffix and tfix

[Michael Kerrisk (man-pages)]

Hi David,

I applied pieces of this. See below.

On Fri, Mar 23, 2012 at 8:23 AM, David Prévot <taffit-8fiUuRrzOP0dnm+yROfE0A@public.gmane.org> wrote:
> ---
>  man2/ptrace.2 |   51 ++++++++++++++++++++++++++++++++-------------------
>  1 files changed, 32 insertions(+), 19 deletions(-)
>
> diff --git a/man2/ptrace.2 b/man2/ptrace.2
> index 5a8b648..457c6ac 100644
> --- a/man2/ptrace.2
> +++ b/man2/ptrace.2
> @@ -277,7 +277,7 @@ which are specified by the following flags:
>  .BR PTRACE_O_TRACESYSGOOD " (since Linux 2.4.6)"
>  When delivering system call traps, set bit 7 in the signal number
>  (i.e., deliver
> -.IR "SIGTRAP|0x80" ).
> +.BR "SIGTRAP\ |\ 0x80" ).

In general, I format expressions completely in italics, so I didn't
apply this part. (And I'm sure there's some inconsistency in man-pages
on this point.)

>  This makes it easy for the tracer to distinguish
>  normal traps from those caused by a system call.
>  .RB ( PTRACE_O_TRACESYSGOOD
> @@ -468,7 +468,7 @@ The
>  .I data
>  argument is treated as for
>  .BR PTRACE_CONT .
> -.RI (addr
> +.RI ( addr

Applied.

>  is ignored.)
>  .TP
>  .BR PTRACE_SYSEMU ", " PTRACE_SYSEMU_SINGLESTEP " (since Linux 2.6.14)"
> @@ -539,7 +539,9 @@ but will not necessarily have stopped
>  by the completion of this call; use
>  .BR waitpid (2)
>  to wait for the tracee to stop.
> -See the "Attaching and detaching" subsection for additional information.
> +See the
> +.B Attaching and detaching
> +subsection for additional information.

I don't tend to format headings in bold when used inline in text, so
I've skipped this piece. (And I wonder if there is some inconsistency
in man-pages on this point.)

>  .RI ( addr
>  and
>  .I data
> @@ -716,7 +718,9 @@ Example:
>  .\"     describe how wait notifications queue (or not queue)
>  .LP
>  The following kinds of ptrace-stops exist: signal-delivery-stops,
> -group-stop, PTRACE_EVENT stops, syscall-stops.
> +group-stop,
> +.B PTRACE_EVENT
> +stops, syscall-stops.

Applied.

>  They all are reported by
>  .BR waitpid (2)
>  with
> @@ -730,7 +734,7 @@ and if there is ambiguity in that value, by querying
>  .I WSTOPSIG(status)
>  macro can't be used to perform this examination,
>  because it returns the value
> -(\fIstatus\>>8)\ \fB&\ 0xff\fP\fP.)
> +(\fIstatus\>>8\fP)\ \fB&\ 0xff\fP.)

I agree the formatting was broken here, but I made it:

.IR "(status\>>8)\ &\ 0xff" .)

(See comments above about expressions.)

>  .SS Signal-delivery-stop
>  When a (possibly multithreaded) process receives any signal except
>  .BR SIGKILL ,
> @@ -761,7 +765,11 @@ true, with the signal returned by
>  If the signal is
>  .BR SIGTRAP ,
>  this may be a different kind of ptrace-stop;
> -see the "Syscall-stops" and "execve" sections below for details.
> +see the
> +.B Syscall-stops
> +and
> +.B execve(2) under ptrace
> +sections below for details.

Not applied. See comments above.

>  If
>  .I WSTOPSIG(status)
>  returns a stopping signal, this may be a group-stop; see below.
> @@ -837,7 +845,7 @@ The
>  signal has a side effect of waking up (all threads of)
>  a group-stopped process.
>  This side effect happens before signal-delivery-stop.
> -The tracer can't suppress this side-effect (it can
> +The tracer can't suppress this side effect (it can

Applied.

>  only suppress signal injection, which only causes the
>  .BR SIGCONT
>  handler to not be executed in the tracee, if such a handler is installed).
> @@ -997,7 +1005,7 @@ with the exit signal set to
>  .TP
>  .B PTRACE_EVENT_CLONE
>  Stop before return from
> -.BR clone (2)
> +.BR clone (2).

Applied.

>  .TP
>  .B PTRACE_EVENT_VFORK_DONE
>  Stop before return from
> @@ -1039,12 +1047,13 @@ to finish exiting.
>  on
>  .B PTRACE_EVENT
>  stops returns
> -.B SIGTRAP in
> +.B SIGTRAP
> +in

Already fixed by another patch (from Denys Vlasenko, I think).

>  .IR si_signo ,
>  with
>  .I si_code
>  set to
> -.IR "(event<<8)\ |\ SIGTRAP" .
> +(\fIevent<<8\fP)\ \fB|\ SIGTRAP\fP.

Not applied (see comments above).

>  .SS Syscall-stops
>  If the tracee was restarted by
>  .BR PTRACE_SYSCALL ,
> @@ -1086,7 +1095,7 @@ If the
>  option was set by the tracer, then
>  .I WSTOPSIG(status)
>  will give the value
> -.IR "(SIGTRAP\ |\ 0x80)" .
> +.RB ( "SIGTRAP\ |\ 0x80" ).

Not aplied.

>  .LP
>  Syscall-stops can be distinguished from signal-delivery-stop with
>  .B SIGTRAP
> @@ -1173,7 +1182,7 @@ with
>  set to
>  .B SIGTRAP
>  or
> -.IR (SIGTRAP|0x80) .
> +.RB ( "SIGTRAP\ |\ 0x80" ).

Not applied.

>  .SS PTRACE_SINGLESTEP, PTRACE_SYSEMU, PTRACE_SYSEMU_SINGLESTEP stops
>  [Details of these kinds of stops are yet to be documented.]
>  .\"
> @@ -1243,7 +1252,7 @@ is
>  .BR PTRACE_SINGLESTEP ,
>  .BR PTRACE_SYSEMU ,
>  or
> -.BR PTRACE_SYSEMU_SINGLESTEP.
> +.BR PTRACE_SYSEMU_SINGLESTEP .

Applied.

>  If the tracee is in signal-delivery-stop,
>  .I sig
>  is the signal to be injected (if it is nonzero).
> @@ -1252,7 +1261,7 @@ Otherwise,
>  may be ignored.
>  (When restarting a tracee from a ptrace-stop other than signal-delivery-stop,
>  recommended practice is to always pass 0 in
> -.I sig .)
> +.IR sig .)

Applied.

>  .SS Attaching and detaching
>  A thread can be attached to the tracer using the call
>
> @@ -1285,9 +1294,11 @@ may be lost.
>  Since attaching sends
>  .B SIGSTOP
>  and the tracer usually suppresses it, this may cause a stray
> -.I EINTR
> +.B EINTR

Applied.

>  return from the currently executing system call in the tracee,
> -as described in the "signal injection and suppression" section.
> +as described in the
> +.B Signal injection and suppression
> +section.

Not applied.

>  .LP
>  The request
>
> @@ -1479,10 +1490,10 @@ Example: two threads call
>  at the same time:
>  .LP
>  .nf
> -*** we get syscall-entry-stop in thread 1: **
> +*** we get syscall-enter-stop in thread 1: **
>  PID1 execve("/bin/foo", "foo" <unfinished ...>
>  *** we issue PTRACE_SYSCALL for thread 1 **
> -*** we get syscall-entry-stop in thread 2: **
> +*** we get syscall-enter-stop in thread 2: **
>  PID2 execve("/bin/bar", "bar" <unfinished ...>
>  *** we issue PTRACE_SYSCALL for thread 2 **
>  *** we get PTRACE_EVENT_EXEC for PID0, we issue PTRACE_SYSCALL **

Applied. (Nice catch!)

> @@ -1539,7 +1550,9 @@ several kinds of
>  notifications when the child process is traced by some other process.
>  .LP
>  Many of these bugs have been fixed, but as of Linux 2.6.38 several still
> -exist; see BUGS below.
> +exist; see
> +.B BUGS
> +below.

Not applied.

>  .LP
>  As of Linux 2.6.38, the following is believed to work correctly:
>  .IP * 3
> --
> 1.7.9.1
>

Thanks for this David!

Cheers,

Michael

-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface"; http://man7.org/tlpi/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html