I think that reads fine.
jmc

  Original Message  
From: Philip Guenther
Sent: Sunday, 11 October 2015 09:49
To: Tech-OpenBSD
Subject: Re: document that execve(2) reset an ignored SIGCHLD to default

On Sun, 11 Oct 2015, Jason McIntyre wrote:
> if you can easily combine it, it probably makes sense to do so. i find
> the last example you've given to be easiest to read. wording it that way
> puts the emphasis on SIGCHLD though - not sure if that's your aim. if
> not you could use example two, but maybe rework it a little:
> 
> Signals set to be ignored in the calling process, with the
> exception of SIGCHLD, are set to be...
> 
> but really they all read fine.

Oooh, I like that combo. How's this this look then, overall?

(Note: signals have only three disposition: caught, ignored, and default, 
so saying that signals not ignored are set to default would be the same as 
saying signals caught are set to default. It's the special handling of 
SIGCHLD which makes one wording simpler than the other...)


Philip

Index: sys/execve.2
===================================================================
RCS file: /cvs/src/lib/libc/sys/execve.2,v
retrieving revision 1.46
diff -u -p -r1.46 execve.2
--- sys/execve.2        10 Sep 2015 17:55:21 -0000      1.46
+++ sys/execve.2        11 Oct 2015 08:42:08 -0000
@@ -121,10 +121,13 @@ some system file like
The intent is to ensure these descriptors are not unallocated, since
many libraries make assumptions about the use of these 3 file descriptors.
.Pp
-Signals set to be ignored in the calling process are set to be ignored in
+Signals set to be ignored in the calling process,
+with the exception of
+.Dv SIGCHLD ,
+are set to be ignored in
the
new process.
-Signals which are set to be caught in the calling process image
+Other signals
are set to default action in the new process image.
Blocked signals remain blocked regardless of changes to the signal action.
The signal stack is reset to be undefined (see
@@ -323,3 +326,12 @@ to a non-superuser, but is executed when
is
.Dq root ,
then the process has some of the powers of a superuser as well.
+.Pp
+.St -p1003.1-2008
+permits
+.Nm
+to leave
+.Dv SIGCHLD
+as ignored in the new process; portable programs cannot rely on
+.Nm
+resetting it to the default disposition.


Reply via email to