[src/trunk]: src/lib/libc/sys Try to make posix_spawn(3) note in ptrace(2) le...

[kamil <kamil%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/0351deeba0c9
branches:  trunk
changeset: 457123:0351deeba0c9
user:      kamil <kamil%NetBSD.org@localhost>
date:      Wed Jun 12 12:30:42 2019 +0000

description:
Try to make posix_spawn(3) note in ptrace(2) less confusing

diffstat:

 lib/libc/sys/ptrace.2 |  17 ++++++-----------
 1 files changed, 6 insertions(+), 11 deletions(-)

diffs (35 lines):

diff -r 133d72aeedd2 -r 0351deeba0c9 lib/libc/sys/ptrace.2
--- a/lib/libc/sys/ptrace.2     Wed Jun 12 12:26:24 2019 +0000
+++ b/lib/libc/sys/ptrace.2     Wed Jun 12 12:30:42 2019 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: ptrace.2,v 1.72 2019/06/12 10:09:26 wiz Exp $
+.\"    $NetBSD: ptrace.2,v 1.73 2019/06/12 12:30:42 kamil Exp $
 .\"
 .\" This file is in the public domain.
 .Dd June 12, 2019
@@ -489,20 +489,15 @@
 .Dv PTRACE_VFORK_DONE
 event can be used to report unblocking of the parent.
 .Pp
-The
-.Xr posix_spawn 3
-operation implements
-.Xr vfork 2
-and
-.Xr exec 3
-as a single syscall in the kernel.
+.Fn posix_spawn
+on
+.Nx
+directly creates the child process without intermediant fork.
 The
 .Dv PTRACE_POSIX_SPAWN
 event semantics are the same as
 .Dv PTRACE_FORK ,
-but the child is reported with implied
-.Xr exec 3
-operation.
+but the child is reported with implied execution of a file.
 .Pp
 A pointer to this structure is passed in
 .Fa addr .