oom_adj/oom_score documentation
A message that is not in the archive (sent off-list or not yet received): OFF927B0C7.8C7E4394-ONC12571BC.003A43D2-C12571BC.003B49E8@no.ibm.com
A message that is not in the archive (sent off-list or not yet received): [email protected]
A message that is not in the archive (sent off-list or not yet received): [email protected]
A message that is not in the archive (sent off-list or not yet received): [email protected]
PATCH 1/1 oom_adj/oom_score documentation
I was looking for the a way around an OOM-problem, and found a couple of undocumented new features for tuning the OOM-score of individual processes. Here's a small documentation patch for /proc/<pid>/oom_adj and /proc/<pid>/oom_score.
---
Documentation/filesystems/proc.txt +17 -0
@@ -39,6 +39,8 @@ Table of Contents 2.9 Appletalk 2.10 IPX 2.11 /proc/sys/fs/mqueue - POSIX message queues filesystem + 2.12 /proc/<pid>/oom_adj - Adjust the oom-killer score + 2.13 /proc/<pid>/oom_score - Display current oom-killer score ------------------------------------------------------------------------------ Preface
@@ -1958,6 +1960,21 @@ a queue must be less or equal then msg_m maximum message size value (it is every message queue's attribute set during its creation). +2.12 /proc/<pid>/oom_adj - Adjust the oom-killer score +------------------------------------------------------ + +This file can be used to adjust the score used to select which processes shall +be killed in an out-of-memory situation. Giving it a high score, increase the +likelihood of this process being killed by the oom-killer. Valid values are in +the range [-16:15], plus the special value '-17', which defeat the oom-killer +altogether. + +2.13 /proc/<pid>/oom_score - Display current oom-killer score +------------------------------------------------------------- + +This file can be used to check what the current score used by the oom-killer +is for any given <pid>. Use it together with /proc/<pid>/oom_adj to tune which +process will be killed in an out-of-memory situation. ------------------------------------------------------------------------------ Summary
Got some spelling/language advice from Alan Cox (thanks!), so here's an updated patch. Hope it reads better now.
---
Documentation/filesystems/proc.txt +18 -0
@@ -39,6 +39,8 @@ Table of Contents 2.9 Appletalk 2.10 IPX 2.11 /proc/sys/fs/mqueue - POSIX message queues filesystem + 2.12 /proc/<pid>/oom_adj - Adjust the oom-killer score + 2.13 /proc/<pid>/oom_score - Display current oom-killer score ------------------------------------------------------------------------------ Preface
@@ -1958,6 +1960,22 @@ a queue must be less or equal then msg_m maximum message size value (it is every message queue's attribute set during its creation). +2.12 /proc/<pid>/oom_adj - Adjust the oom-killer score +------------------------------------------------------ + +This file can be used to adjust the score used to select which processes +should be killed in an out-of-memory situation. Giving it a high score will +increase the likelihood of this process being killed by the oom-killer. Valid +values are in the range -16 to +15, plus the special value -17, which disables +oom-killing altogether for this process. + +2.13 /proc/<pid>/oom_score - Display current oom-killer score +------------------------------------------------------------- + +------------------------------------------------------------------------------ +This file can be used to check the current score used by the oom-killer is for +any given <pid>. Use it together with /proc/<pid>/oom_adj to tune which +process should be killed in an out-of-memory situation. ------------------------------------------------------------------------------ Summary
Quoted 4 lines · On Tue, 1 Aug 2006 16:13:08 +0200 Jan-Frode Myklebust wrote:
I was looking for the a way around an OOM-problem, and found a couple of undocumented new features for tuning the OOM-score of individual processes. Here's a small documentation patch for /proc/<pid>/oom_adj and /proc/<pid>/oom_score.
Thanks, it's needed.
A few comments below.
Quoted 18 lines
Signed-off-by Jan-Frode Myklebust <[email protected]>---
Documentation/filesystems/proc.txt +2
-0@@ -39,6 +39,8 @@ Table of Contents 2.9 Appletalk 2.10 IPX 2.11 /proc/sys/fs/mqueue - POSIX message queues filesystem + 2.12 /proc/<pid>/oom_adj - Adjust the oom-killer score + 2.13 /proc/<pid>/oom_score - Display current oom-killer score ------------------------------------------------------------------------------ Preface
Documentation/filesystems/proc.txt a queue must be less or equal then msg_m · line 1967
Quoted 8 lines
Documentation/filesystems/proc.txt +5
-0@@ -1958,6 +1960,21 @@ a queue must be less or equal then msg_m maximum message size value (it is every message queue's attribute set during its creation). +2.12 /proc/<pid>/oom_adj - Adjust the oom-killer score +------------------------------------------------------ + +This file can be used to adjust the score used to select which processes shall +be killed in an out-of-memory situation. Giving it a high score, increase the
Drop the comma. "increases"
Documentation/filesystems/proc.txt a queue must be less or equal then msg_m · line 1969
Quoted 2 lines
Documentation/filesystems/proc.txt +2
-0+likelihood of this process being killed by the oom-killer. Valid values are in +the range [-16:15], plus the special value '-17', which defeat the oom-killer
"defeats"
Documentation/filesystems/proc.txt a queue must be less or equal then msg_m · line 1980
Quoted 11 lines
Documentation/filesystems/proc.txt +8
-0+altogether. + +2.13 /proc/<pid>/oom_score - Display current oom-killer score +------------------------------------------------------------- + +This file can be used to check what the current score used by the oom-killer +is for any given <pid>. Use it together with /proc/<pid>/oom_adj to tune which +process will be killed in an out-of-memory situation. ------------------------------------------------------------------------------ Summary
---
~Randy