man5/proc_pid_oom_score.5

   1 .\" Copyright (C) 1994, 1995, Daniel Quinlan <quinlan@yggdrasil.com>
   2 .\" Copyright (C) 2002-2008, 2017, Michael Kerrisk <mtk.manpages@gmail.com>
   3 .\" Copyright (C) 2023, Alejandro Colomar <alx@kernel.org>
   4 .\"
   5 .\" SPDX-License-Identifier: GPL-3.0-or-later
   6 .\"
   7 .TH proc_pid_oom_score 5 (date) "Linux man-pages (unreleased)"
   8 .SH NAME
   9 /proc/pid/oom_score \- OOM-killer score
  10 .SH DESCRIPTION
  11 .TP
  12 .IR /proc/ pid /oom_score " (since Linux 2.6.11)"
  13 .\" See mm/oom_kill.c::badness() before Linux 2.6.36 sources
  14 .\" See mm/oom_kill.c::oom_badness() after Linux 2.6.36
  15 .\" commit a63d83f427fbce97a6cea0db2e64b0eb8435cd10
  16 This file displays the current score that the kernel gives to
  17 this process for the purpose of selecting a process
  18 for the OOM-killer.
  19 A higher score means that the process is more likely to be
  20 selected by the OOM-killer.
  21 The basis for this score is the amount of memory used by the process,
  22 with increases (+) or decreases (\-) for factors including:
  23 .\" See mm/oom_kill.c::badness() before Linux 2.6.36 sources
  24 .\" See mm/oom_kill.c::oom_badness() after Linux 2.6.36
  25 .\" commit a63d83f427fbce97a6cea0db2e64b0eb8435cd10
  26 .RS
  27 .IP \[bu] 3
  28 whether the process is privileged (\-).
  29 .\" More precisely, if it has CAP_SYS_ADMIN or (pre 2.6.36) CAP_SYS_RESOURCE
  30 .RE
  31 .IP
  32 Before Linux 2.6.36
  33 the following factors were also used in the calculation of oom_score:
  34 .RS
  35 .IP \[bu] 3
  36 whether the process creates a lot of children using
  37 .BR fork (2)
  38 (+);
  39 .IP \[bu]
  40 whether the process has been running a long time,
  41 or has used a lot of CPU time (\-);
  42 .IP \[bu]
  43 whether the process has a low nice value (i.e., > 0) (+); and
  44 .IP \[bu]
  45 whether the process is making direct hardware access (\-).
  46 .\" More precisely, if it has CAP_SYS_RAWIO
  47 .RE
  48 .IP
  49 The
  50 .I oom_score
  51 also reflects the adjustment specified by the
  52 .I oom_score_adj
  53 or
  54 .I oom_adj
  55 setting for the process.
  56 .SH SEE ALSO
  57 .BR proc (5),
  58 .BR proc_pid_oom_score_adj (5)