[Overview][Constants][Types][Procedures and functions][Index] | Reference for unit 'BaseUnix' (#rtl)

# FpWaitPid

Wait for a process to terminate

## Declaration

Source position: bunxh.inc line 66

`function FpWaitpid(`
`pid: TPid;`
`stat_loc: pcint;`
`options: cint`
`):TPid; function FpWaitPid(`
`pid: TPid;`
`var Status: cint;`
`Options: cint`
`):TPid;`

## Description

fpWaitPid waits for a child process with process ID Pid to exit. The value of Pid can be one of the following:

Pid < -1
  Causes fpWaitPid to wait for any child process whose process group ID equals the absolute value of pid.
Pid = -1
  Causes fpWaitPid to wait for any child process.
Pid = 0
  Causes fpWaitPid to wait for any child process whose process group ID equals the one of the calling process.
Pid > 0
  Causes fpWaitPid to wait for the child whose process ID equals the value of Pid.

The Options parameter can be used to specify further how fpWaitPid behaves:

WNOHANG
  Causes fpWaitpid to return immediately if no child hasexited.
WUNTRACED
  Causes fpWaitPid to return also for children which are stopped, but whose status has not yet been reported.
__WCLONE
  Causes fpWaitPid also to wait for threads created by the #rtl.linux.Clone call.

The exit status of the process that caused fpWaitPID is reported in stat_loc or Status.

Upon return, it returns the process id of the process that exited, 0 if no process exited, or -1 in case of failure.

For an example, see fpFork.

## Errors

Extended error information can be retrieved using fpgetErrno.

## See also

fpFork |  | Create child process
fpExecve |  | Execute process using environment
fpWait |  | Wait for a child to exit.

Documentation generated on: May 14 2021