waitpid.c File Reference

Functions
pid_t	waitpid (pid_t pid, int *status, int options)
	Suspends the execution of the calling thread until a child specified by pid argument has changed state. More...
pid_t	wait (int *status)
	Suspends the execution of the calling thread until ANY child has changed state. More...

Detailed Description

Copyright

(c) 2014-2024 This file is distributed under the MIT License. See LICENSE.md for details.

Function Documentation

wait()

pid_t wait

(

int *

status

)

Suspends the execution of the calling thread until ANY child has changed state.

Parameters

status

Variable where the new status of the child is stored.

Returns

On error, -1 is returned, otherwise it returns the pid of the child that has unlocked the wait.

waitpid()

pid_t waitpid	(	pid_t	pid,
		int *	status,
		int	options
	)

Suspends the execution of the calling thread until a child specified by pid argument has changed state.

Parameters

pid	Se details below for more information.
status	Variable where the new status of the child is stored.
options	Waitpid options.

Returns

On error, -1 is returned, otherwise it returns the pid of the child that has unlocked the wait.

By default, waitpid() waits only for terminated children, but this behavior is modifiable via the options argument, as described below. The value of pid can be:

• 1 meaning wait for any child process. 0 meaning wait for any child process whose process group ID is equal to that of the calling process. > 0 meaning wait for the child whose process ID is equal to the value of pid.