zps
A small utility for listing and reaping zombie processes on GNU/Linux.
On Unix and Unix-like computer operating systems, a zombie process or defunct process is a process that has completed execution (via the exit system call) but still has an entry in the process table. This occurs for child processes, where the entry is still needed to allow the parent process to read its child's exit status: once the exit status is read via the wait system call, the zombie's entry is removed from the process table and it is said to be "reaped".
Unlike the normal processes, zombie processes cannot be removed from a system with the kill command since they are already dead. (This is where the term's metaphor [zombie - an undead person] comes from.) To reap a zombie process, SIGCHLD
signal can be sent to the parent process manually using the kill command. If the parent process refuses to reap the zombie, then terminating the parent process (mostly with SIGTERM
signal) can be an option. When a child process loses its parent, init process becomes its new parent and it will reap any zombies since it executes the wait system call periodically.
Zombie processes are not harmful since they are not affecting other processes or using any system resources. However, they do retain their process ID. This can lead to preventing new processes to launch if all the available PIDs were assigned to zombie processes. Considering Unix-like systems have a finite number of process IDs (/proc/sys/kernel/pid_max
), it's one of the problems that zombie processes can cause. Another danger of zombie processes is that they can cause resource leak if they stay as a zombie in the process table for a long time. Apart from these issues, having a few zombie processes won't be a big deal for the system although they might indicate a bug with their parent process.
zproc.c file can be compiled and run to see how zombie processes are created.
cd example/ && gcc -O3 -Wall zproc.c -o zproc && ./zproc
zps aims to list the running processes at a particular time with stats and indicate the zombie processes on this list. It can also reap these zombie processes automatically if --reap
argument is provided. There's also --lreap
argument for reaping zombie processes after listing. See usage for more information.
Technically, zps reads process stats from /proc filesystem and uses C POSIX library to handle listing, sending signals and other operations.
Installation
Arch Linux
pacman -S zps
Fedora Linux
dnf install zps
CMake
mkdir -p build && cd build
cmake ../ -DCMAKE_INSTALL_PREFIX=/usr
make
sudo make install
sudo ldconfig
Make
make
sudo make install
GCC
cd src/ && gcc -s -O3 -Wall -Wextra -pedantic zps.c -o zps
Docker
Building an image
docker build -f docker/Dockerfile -t zps .
Running the image in container
docker run zps
Usage
Usage:
zps [options]
Options:
-r, --reap reap zombie processes
-x, --lreap list and reap zombie processes
-l, --list list zombie processes only
-p, --prompt show prompt for selecting processes
-f, --fd <num> set maximum file descriptors (default: 15)
-s, --silent run in silent mode
-v, --version show version
-h, --help show help
zps -r
zps -x
zps -l
zps -p
TODO(s)
- Improve listing processes for long process names.
- Send
SIGCHLD
signal to the parent instead of terminating it.
License
GNU General Public License v3.0 only (GPL-3.0-only)
Copyright
Copyright ยฉ 2019-2023, Orhun Parmaksฤฑz