oomstaller.1

.\" Manpage for oomstaller
.\" Contact shibatch@users.sourceforge.net to correct errors.
.TH oomstaller 1 "01 Jan 2025" "0.4.0" "oomstaller man page"
.SH NAME
oomstaller \- suppress swap thrashing at build time
.SH SYNOPSIS
oomstaller [<options>] command [arg] ...
.SH 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.
.sp
.TP
To perform a build using this tool, specify make or ninja as the argument of this tool and execute as follows.
.INDENT 4
.sp
.EX
$ oomstaller make -j `nproc`
.EE
.UNINDENT
.SH OPTIONS
.TP
.BR \-\-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.
.TP
.BR \-\-max\-parallel-thrash " " <number " " of " " processes, " " default=1>
Specifies the maximum number of processes to run when thrashing is detected. 0 means no limit.
.TP
.BR \-\-period " " <seconds, " " default=1>
Specifies the interval at which memory usage of each process is checked and processes are controlled.
.TP
.BR \-\-show\-stat
Displays statistics when finished.
.SH 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.
.sp
.TP
You can send SIGCONT to all processes run by you with the following command.
.INDENT 4
.sp
.EX
$ killall -v -s CONT -u $USER -r '.*'
.EE
.UNINDENT
.SH SEE ALSO
.TP
.B Home Page
\fI\%https://github.com/shibatch/oomstaller\fP
.SH AUTHOR
Naoki Shibata (shibatch@users.sourceforge.net)