NAME¶

oomstaller - suppress swap thrashing at build time

SYNOPSIS¶

oomstaller [<options>] command [arg] ...

DESCRIPTION¶

This tool monitors the memory usage of each process when performing a build, and suspends processes as necessary to prevent swap thrashing from occuring.

To perform a build using this tool, specify make or ninja as the argument of this tool and execute as follows.

$ oomstaller make -j `nproc`
    

OPTIONS¶

--max-parallel <number of processes, default=0>

Suspends processes so that the number of running build processes does not exceed the specified number. 0 means no limit. A process is counted as one process even if it has multiple threads.

--max-parallel-thrash <number of processes, default=1>

Specifies the maximum number of processes to run when thrashing is detected. 0 means no limit.

--period <seconds, default=1>

Specifies the interval at which memory usage of each process is checked and processes are controlled.

--show-stat

Displays statistics when finished.

TIPS¶

If you kill this tool with SIGKILL, a large number of build processes will remain suspended with SIGSTOP. To prevent this from happening, use SIGTERM or SIGINT to kill this tool.

You can send SIGCONT to all processes run by you with the following command.

$ killall -v -s CONT -u $USER -r '.*'
    

SEE ALSO¶

Home Page

https://github.com/shibatch/oomstaller

AUTHOR¶

Naoki Shibata (shibatch@users.sourceforge.net)