waitpid(1)

waitpid1

Utility to wait for arbitrary processes

Usage

waitpid [-v] [{--timeout | -t seconds}] PID [:inode] ...

Overview

waitpid is a simple command to wait for arbitrary non-child processes.

It exits after all processes whose PIDs have been passed as arguments have exited.

Optionally, a process can be addressed with the format PID:inode. The inode identifies the unique process’s file descriptor. To retrieve a process’s inode number you can use the getino(1) utility.

Options

-v, --verbose

Be more verbose.

-t, --timeout seconds

Maximum wait time.

-e, --exited

Don’t error on already exited PIDs.

-c, --count count

Number of process exits to wait for.

-h, --help

Display help text and exit.

-V, --version

Display version and exit.

Exit status

waitpid has the following exit status values:

0

success

1

unspecified failure

2

system does not provide necessary functionality

3

timeout expired

Releases

2 releases since Debian 13 (Trixie); the text changed 1 time.

  1. 13
  2. Arch

Authors

Thomas Weißschuh <[email protected]>

Reporting bugs

For bug reports, use the issue tracker <https://github.com/util-linux/util-linux/issues>.

Availability

The waitpid command is part of the util-linux package which can be downloaded from Linux Kernel Archive <https://www.kernel.org/pub/linux/utils/util-linux/>.

From util-linux 2.42.4-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.