ivanfitenko / oom_ext Goto Github PK

OOM (out-of-memory) state is triggered under memory shortage conditions when kernel cannot free any additional memory pages to satisfy page request, and it is not likely that any pages will be reclaimed in the nearest time. Once in OOM state, a process is selected to be killed, alongside with a set of other processes sharing the same mm_struct. These processes will be sent TERM/KILL signals, while the other processes(threads) will be locked. Because of numerous drawbacks in the algorythm, it is a frequent situation that processes will never be able to exit, and machine would hang indefinitely until hard-rebooted.

When loaded, oom_ext reserves a portion of non-swappable memory as emergency buffer. Once OOM state is detected, the buffer is freed, effectively bringing the system out of OOM state an thus unlocking all the processes. The buffer doesn't need to be any huge, it just has to be large enough to win a few seconds of 'unlocked' operation for OOM-killer target processes to actually shut down.

Execute make inside code directory to build the module. After that, you will be able to try the module immediately with insmod oom_ext.ko. To install the module, execute make install. This will install the module under kernel modules directory, and it will be available for loading with modprobe oom_ext. Please note that installation will not set this module to autoload on boot: I prefer to leave autoloading (or not autoloading :) ) part to an end-user.

The module adds a few sysctl's with which it can be configured: