android_system_core/lmkd
Suren Baghdasaryan 314a505710 lmkd: Introduce system property to get minfree and oom_adj levels
Introduce sys.lmk.minfree_levels system property to allow minfree level
reporting. The format for this property is:

<minfree 1>:<oom_adj 1>, <minfree 2>:<oom_adj 2>, ...

Max number of minfree levels is 6 and they are specified in the
increasing order. For example:

sys.lmk.minfree_levels=18432:0,23040:100,27648:200,32256:300,55296:900,80640:906

sys.lmk.minfree_levels updates are ratelimited to once per second in order
to prevent DoS attacks.

Bug: 111521182
Test: getprop sys.lmk.minfree_levels returns expected value
Change-Id: I80d75d6836650b12457d6a99ca88898535837a97
Signed-off-by: Suren Baghdasaryan <surenb@google.com>
2018-09-05 10:54:22 -07:00
..
include lmkd: Introduce liblmkd_utils for communicating with lmkd process 2018-03-09 11:18:53 -08:00
tests Merge "lmkd: test: access /sys/module/lowmemorykiller/ as u:r:shell:s0" am: b69cb7071d 2018-04-05 19:45:16 -07:00
Android.bp lmkd: Add meminfo logging after each kill for easy troubleshooting 2018-08-10 14:21:31 -07:00
event.logtags lmkd: Add meminfo logging after each kill for easy troubleshooting 2018-08-10 14:21:31 -07:00
liblmkd_utils.c lmkd: Introduce liblmkd_utils for communicating with lmkd process 2018-03-09 11:18:53 -08:00
lmkd.c lmkd: Introduce system property to get minfree and oom_adj levels 2018-09-05 10:54:22 -07:00
lmkd.rc lmkd: limit capability set to minimum 2018-04-16 14:51:56 -07:00
OWNERS Add lmkd/OWNERS. 2017-12-08 16:12:58 -08:00
README.md lmkd: Introduce support for legacy kill algorithm that uses minfree levels 2018-04-17 01:42:06 +00:00
statslog.c Fix the stats log in lmkd 2018-05-03 16:04:27 -07:00
statslog.h Fix the stats log in lmkd 2018-05-03 16:04:27 -07:00

Android Low Memory Killer Daemon

Introduction

Android Low Memory Killer Daemon (lmkd) is a process monitoring memory state of a running Android system and reacting to high memory pressure by killing the least essential process(es) to keep system performing at acceptable levels.

Background

Historically on Android systems memory monitoring and killing of non-essential processes was handled by a kernel lowmemorykiller driver. Since Linux Kernel 4.12 the lowmemorykiller driver has been removed and instead userspace lmkd daemon performs these tasks.

Android Properties

lmkd can be configured on a particular system using the following Android properties:

ro.config.low_ram: choose between low-memory vs high-performance device. Default = false.

ro.lmk.use_minfree_levels: use free memory and file cache thresholds for making decisions when to kill. This mode works the same way kernel lowmemorykiller driver used to work. Default = false

ro.lmk.low: min oom_adj score for processes eligible to be killed at low vmpressure level. Default = 1001 (disabled)

ro.lmk.medium: min oom_adj score for processes eligible to be killed at medium vmpressure level. Default = 800 (non-essential processes)

ro.lmk.critical: min oom_adj score for processes eligible to be killed at critical vmpressure level. Default = 0 (all processes)

ro.lmk.critical_upgrade: enables upgrade to critical level. Default = false

ro.lmk.upgrade_pressure: max mem_pressure at which level will be upgraded because system is swapping too much. Default = 100 (disabled)

ro.lmk.downgrade_pressure: min mem_pressure at which vmpressure event will be ignored because enough free memory is still available. Default = 100 (disabled)

ro.lmk.kill_heaviest_task: kill heaviest eligible task (best decision) vs. any eligible task (fast decision). Default = false

ro.lmk.kill_timeout_ms: duration in ms after a kill when no additional kill will be done, Default = 0 (disabled)

ro.lmk.debug: enable lmkd debug logs, Default = false