Page MenuHomeFreeBSD
Differential D44372 Diff 141269 lib/libsys/wait.2

Changeset View

Standalone View

View Options

lib/libsys/wait.2

Show All 19 Lines
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE. .\" SUCH DAMAGE.
.\" .\"
.Dd June 24, 2022 .Dd June 18, 2024
.Dt WAIT 2 .Dt WAIT 2
.Os .Os
.Sh NAME .Sh NAME
.Nm wait , .Nm wait ,
.Nm waitid , .Nm waitid ,
.Nm waitpid , .Nm waitpid ,
.Nm wait3 , .Nm wait3 ,
.Nm wait4 , .Nm wait4 ,
▲ Show 20 Lines • Show All 561 Lines • ▼ Show 20 Lines
The The
.Fa si_signo .Fa si_signo
and and
.Fa si_pid .Fa si_pid
fields of fields of
.Fa infop .Fa infop
must be checked against zero to determine if a process reported status. must be checked against zero to determine if a process reported status.
.Pp .Pp
The The
.Fn wait .Fn wait
family of functions will not return a child process created with family of functions will only return a child process created with
.Xr pdfork 2 .Xr pdfork 2
unless specifically directed to do so by specifying its process ID. if the calling process is not in
.Xr capsicum 4
capability mode, and
.Nm
has been explicitly given the child's process ID.
rwatsonUnsubmitted
Not Done
Inline Actions

I find the double negative in this sentence very confusing. Can we find a way to reword this?

rwatson: I find the double negative in this sentence very confusing. Can we find a way to reword this?
traszAuthorUnsubmitted
Done
Inline Actions

How about something like:

By default, the wait family of functions will not return a child process created with pdfork.
They can be directed to do so by specifying its process ID; this is not allowed in Capsicum capability mode.

trasz: How about something like: By default, the wait family of functions will not return a child…
.Sh ERRORS .Sh ERRORS
brooksUnsubmitted
Not Done
Inline Actions
must be checked against zero to determine if a process reported status.
.Pp
- When running in
- .Xr capsicum 4
- capability mode, the
+ The
.Fn wait
- family of functions will never return a child process created with
- .Xr pdfork 2 .
- Otherwise it will only return it when specifically directed to do so
+ family of functions will not return a child process created with
+ .Xr pdfork 2
+ unless it is not in
+ .Xr capsicum 4
+ capability mode and specifically directed to do so
by specifying its process ID.
.Sh ERRORS

I found the edit hard to read, particularly the second sentence. Perhaps this option is better.

brooks: I found the edit hard to read, particularly the second sentence. Perhaps this option is better.
The The
.Fn wait .Fn wait
function function
will fail and return immediately if: will fail and return immediately if:
.Bl -tag -width Er .Bl -tag -width Er
.It Bq Er ECHILD .It Bq Er ECHILD
The calling process has no existing unwaited-for The calling process has no existing unwaited-for
child processes. child processes.
▲ Show 20 Lines • Show All 66 Lines • Show Last 20 Lines