Bug 50421

Summary: proc.5: Information on oom_adj is outdated
Product: Documentation Reporter: Peter Wu (peter)
Component: man-pagesAssignee: Michael Kerrisk (mtk.manpages)
Status: RESOLVED CODE_FIX    
Severity: normal CC: mtk.manpages
Priority: P1    
Hardware: All   
OS: Linux   
Kernel Version: Subsystem:
Regression: No Bisected commit-id:

Description Peter Wu 2012-11-12 18:11:14 UTC 
oom_adj has been deprecated in Linux 2.6.35 (commit 51b1bd2ace1595b72956224deda349efa880b693) and removed in Linux 3.7 (01dc52ebdf472f77cca623ca693ca24cfc0f1bbe) because it was replaced with oom_score_adj.

The reasoning can be found on http://www.kernel.org/doc/Documentation/ABI/obsolete/proc-pid-oom_adj

Now, including this whole document is a bit too much for proc(5), but what should be included instead?

man-pages version: 3.44
Comment 1 Michael Kerrisk 2012-12-21 17:49:31 UTC 
But there is also 

        commit fa0cbbf145aabbf29c6f28f8a11935c0b0fd86fc
        Author: David Rientjes <rientjes@google.com>
        Date:   Mon Nov 12 17:53:04 2012 -0800

            mm, oom: reintroduce /proc/pid/oom_adj

So the story is not so simple.

I modify proc(5) to include oom_score_adj, taking pretty much all of the text from Documentation/filesystems/proc.txt.