From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751556AbdGZN2u (ORCPT ); Wed, 26 Jul 2017 09:28:50 -0400 Received: from mx0b-00082601.pphosted.com ([67.231.153.30]:59699 "EHLO mx0b-00082601.pphosted.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751070AbdGZN2P (ORCPT ); Wed, 26 Jul 2017 09:28:15 -0400 From: Roman Gushchin To: CC: Roman Gushchin , Michal Hocko , "Vladimir Davydov" , Johannes Weiner , Tetsuo Handa , David Rientjes , Tejun Heo , , , , Subject: [v4 4/4] mm, oom, docs: describe the cgroup-aware OOM killer Date: Wed, 26 Jul 2017 14:27:18 +0100 Message-ID: <20170726132718.14806-5-guro@fb.com> X-Mailer: git-send-email 2.13.3 In-Reply-To: <20170726132718.14806-1-guro@fb.com> References: <20170726132718.14806-1-guro@fb.com> MIME-Version: 1.0 Content-Type: text/plain X-Originating-IP: [2620:10d:c092:200::1:865f] X-ClientProxiedBy: AM5PR0102CA0018.eurprd01.prod.exchangelabs.com (10.167.167.31) To SN2PR15MB1088.namprd15.prod.outlook.com (10.169.192.138) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 5c70a345-e918-4f3a-55b7-08d4d42a2327 X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:(300000500095)(300135000095)(300000501095)(300135300095)(22001)(300000502095)(300135100095)(300000503095)(300135400095)(201703131423075)(201703031133081)(300000504095)(300135200095)(300000505095)(300135600095)(300000506095)(300135500095);SRVR:SN2PR15MB1088; X-Microsoft-Exchange-Diagnostics: 1;SN2PR15MB1088;3:4900em9q7koFiTTcXjzfrc133/CivtA0GsvrN52RzDovVwxLHRo3JTe1ExvBT5txmkblinFyRKmZMGrJEufo/R4nfqskW8ZRNaWAX/ppGZsBk1d5NgJU8fcmc0BXlZP6t8O+LRrOQm5lDu/ISg6O2pVDlbG38xQbfvpEuMf2EEbTme5VeIg2fsouQCbvqzXhZN9ESiTdC0dfGQc5ucrbnjvuTqoPMYmkHqAywoODcKZGXq7cM1g8DcZofZlHetWNal785y5Z7aySqRZZtOPeKA8r2VD/h0ZPWNvSqruxiiUY/W3agZ+LjO4cbLKxIRDMir+U7nAk7V4vzA0C+tBEYnCFAG/13M7P2dH1DfYkf2PYNa1xA9x6RL07giZXwO9mgxTIlWVZSH2nWzTcKa3xqMg1gPTcfYtLzwRg6IFM963MKVrBcIaOsBIwhgU5h8C0eqYbOOW6iHWMH+u1wLDb76tTDCfmD3g+5G/hg4uwbkKv8jYFJw/XQ1p/uGpNOJJynf6njZTyf5Fu/kH6QzwCmWdBjhVFHcTQeOKM+b5AQBcEzVyyzWFO59pyXiazNA/34Nn3cMATJwf0X2ZuT2DRw25iIuyTcdSKBE/ADoQuQOzMDvfirci+rfSY5xP4AFWWAJ2+pFxdnihKh+2NAByor4nX9Uh903qWAIuGacMSv969saQJCtKOQWmIDkxz1rvCEWqEG09apjjqah3m58zhUgzPjiuxhNWrYJn9cI6yWhg= X-MS-TrafficTypeDiagnostic: SN2PR15MB1088: X-Microsoft-Exchange-Diagnostics: 1;SN2PR15MB1088;25:v+JNu3dtTuGVs2Uu1RX6jRGkFEB88ZXhBEkmOYMqtzha515ME1+d5zpZ8rTT9yzo063ep1KvZDz+18xG8L9BsVSwCaIU3tlD8M0RlYhRmOCkOekpF4zcyQxSCGCeCRckedek9NgGBBPJLrkSrTQeYHgvGCyJdfL5OKhbUNg70n34DAcKSyKVaE5j8Jtv2Hlcwf4U5QXCOSOAVyZqqzoRTTiK2mtBy5MCfEmGWYaYAMiUgMKPiCmLb71Ae8SfuiP26BnnUQ/u80ODc31heFDs+p8Aoi2EHd26dn7iAWWtyuyrwbadzhcRj85AbmIfSD6FQcdGZmmybRAMHxM59Sd1bGT08/fIsIG1R+lNCJOn1NjtNvDzBAe27770YRaegVRNbU3Z/KyYVqcIsVW5x71aHLkAwweltFZUh70CszO7KExBblZ0lYi13R1uMsfS8ODlaVRvRFCIdqsv/+V0Zfvwhey38ASwfsszpFuXgfSelQOFpa9ATpAR51c/9UiInR+2UbPctOv9JvuH4gAvkik97ycQsV9Qr18KRnlF/jxA/kc1G4QawcCZYz71fGjTb+oS+HrJPYBncb/pC9LfNP/dldw1+EuUH74Qq1mMkjcXwvNEm7hXaGyjq6KRbV+puO+UqD+EUojVGikCh/0mlr/K91Ct7un/6mLjhN7XwpoNbVNqSFLSdE2KIgywPCb64BSuuPvZPsHc2ypCX400FGgSIOE9kep4ON7AaPTlkOv+RuIrm6xzsavZA3NA4VV2Iha20x/+eBl/jnoFn587+8B6oO6zaXWFARtlhHvhHiSQj5CiZFH/3BlN82qu5De/JJshGtfhLrCzBuvnU6x45a7cWleDR5ZZPl3Qt89Uk9W55XIgFHaqGvIrH+Cp2FPaC32v3czW6UMVkoV3zP/GXk0B5yvz4l2oETp8/fOOjKeGYo0= X-Microsoft-Exchange-Diagnostics: 1;SN2PR15MB1088;31:mDpeI8LzYfYuVTLMKOJyae5ZaE5n9l4LDmGoizC887W8J2KC7Q9yfY9wrjAcIjGxCJ0wCAD3fBKyWNiM14VWr0dcHwsT2OnGMR1qQVmCxRlj/SnOpOPSykqd2MDqdymy7K1XlOciRqq/T2i5RjG5haa+m/ZTM1dXGDyxn8gAd2cuwevpzUgZP69e27OLVC8apxfofr/CiKhxvRXUsxPmXmxOuFV3l3wTdjEDaaY8nwvGXpGBQpt7IGbP6Jx6VmDC4tmPjdD4MLAtqPCbCAJz6g5VLwU8mGt9YevYt5hOyEHOraa5WVpOY4jj+v9kGP1c6C7jVtepeS3EsMeIHKT/8keKEjkZqxJlnh9pXR4DzPO0osCe24C/0MFFiSFUJJO21D7p4ED3qgTOVQQ5chL8sI8mNl5X6ZONGiNXRMNY0GDboZz+kzXvfP8UP6TlWn0GdwS9JEiLGxVKE5NYqFMfYStfDHe7/vhEUda+LLnAcR+89+97RB+5Ryle4A/NwYTG18HbnqsikFnSYqQtAqJF6nEVwqakxpWoqSsfQDNKvQ9poMz65ANpXYi+8aoT1kXegwiG+Cdj4zH8P9XlQLK/2NTclXCvtXJZw8TKeog0kqlMm6hl4CTqz3n2DF5QpQYLu8x3Sd/mYv9vg7ZVl8exhN2ItP1ROXzI6QpNlU+h9cM= X-Microsoft-Exchange-Diagnostics: 1;SN2PR15MB1088;20:S9NnHQ7LWMprBHYnvxUaExMhzEfLWode4v/LxHYsKmgyCgBo09cfOOHSO/03v4ttGd8WYGUbSSEZf9r6/mRdiZCIi8JnOmhtkQoQRBLFeFGs5XHhh5Dtv6CG54XuiNKfH8jwLrrSiubw4/r3ot/CP/XQxY/aDmaWjUudW/fVxFVEK922wCusfbEeUgH77CZOfwvhm6N2IjVPPgZWtL38KKoiyYttgrHGIlN5VgHWU5SHywy//rgoSyS4UsZT7Zxf5I9v6CGrnTMcfE4KGlvKQmqJFLkK3mgS21sLp+xaAQkDQt8JW5zlZL+SLAx2CHRdc+CL52Bp9P13i2Au0yUAAUfIruQHSW1QPR2FPznrUk6B/eLj7YOQ7X8gl0Ydi6WN0UmxaJK1vTWauyEDhWsc8XuUbAST3DG//bJieyKJODzg/TziFbfAWKcIleNTPnj2jLsh+uho0BWsGeeGo6pGaL8sKLDyknaTVxniofRJb31BInE46+M30O/H6qi4rchA X-Exchange-Antispam-Report-Test: UriScan:(60795455431006)(9452136761055)(67672495146484)(211936372134217)(153496737603132); X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-CFA-Test: BCL:0;PCL:0;RULEID:(100000700101)(100105000095)(100000701101)(100105300095)(100000702101)(100105100095)(6040450)(601004)(2401047)(5005006)(8121501046)(10201501046)(3002001)(93006095)(93001095)(100000703101)(100105400095)(920507026)(6041248)(20161123562025)(20161123560025)(20161123555025)(20161123564025)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(20161123558100)(6072148)(100000704101)(100105200095)(100000705101)(100105500095);SRVR:SN2PR15MB1088;BCL:0;PCL:0;RULEID:(100000800101)(100110000095)(100000801101)(100110300095)(100000802101)(100110100095)(100000803101)(100110400095)(100000804101)(100110200095)(100000805101)(100110500095);SRVR:SN2PR15MB1088; X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1;SN2PR15MB1088;4:5MkKgTKsY6Rq4vojwBn7Eh3pVBundxCG4DspK9v42f?= =?us-ascii?Q?nX5vI6lyr/5kyRr40VFW5yj3soOXhnCO4KAT3gdEP+ckb7NC3Q020BO85QVq?= =?us-ascii?Q?Xua0JqydWrIIiFOOD1eVclw5ryQnVJEabO7qPTdKfxVLyMW9eiEYXG0BLZCy?= =?us-ascii?Q?syt7iW7022QfBaM9c9NPeandnydnTN3f/C4X9onxU3krelxD85P7axfVW71K?= =?us-ascii?Q?wVW/8wyS+mgqYc06j1FqT1GW2Ii7a8MnYr3x1pWGsuq52l2Zm/BeJEI7sIUC?= =?us-ascii?Q?Ge6Yx7bXOnqQT0nNCoOYQdP+JYqrfRgsP6U3o0ud/AA+5GM/OnRGN0+Haalt?= =?us-ascii?Q?iWM3NdBsP6mY9N14K4BE1Jw2yWThv66rq8MQwpL0BmRr+0zws/6FUU0WFlDr?= =?us-ascii?Q?UH6LFb39/Z+X6FWzsqaEU7gWE04meUAElR4qfK0zo7hwp8lS+xB8VQetMxEm?= =?us-ascii?Q?O4ORwsfQnDb7vIUrtQEnAGTc/+aO443cIsHf3G+5BFMGf1aFuzO+GZUhW38O?= =?us-ascii?Q?Ojtn4aJeBAbZCPC/XLeiwS2IhGH3KlMk4uct8gZnN5+JdrJ4wnzKRPydsa1i?= =?us-ascii?Q?30FWylbMeCSpbdhWThTTMMbYoQA8WNzJRkURMX7i1E2dbxy/wZLb08EOd5fy?= =?us-ascii?Q?YMtNzPj2De/nk4FR7GysoZIdTyyGK/+ufjd8tJizZUWhhP1jL1R5scW5Kzj2?= =?us-ascii?Q?w2nTmc7ukZjSNR5HcqF1WgCU2Y0fNeoejaGd+OGQsfbyONrV/Ilx4Q95RCZo?= =?us-ascii?Q?1O2dHCN/qJiqPRPihoV0z7aW3NhTOGDVhk6p4FGbypxb7p+b9HkPSHtIDpOZ?= =?us-ascii?Q?XvAs/FrmzXPqjAqNS6tx2PQyUEPTL553J3BB/x43jS+Z8poFWz326pwWAb+o?= =?us-ascii?Q?8tFqzluyvGPjLsMQt6JDyxx8WyuH0MHrsd4dbyQiNP9+qhQj++85sjM/qreN?= =?us-ascii?Q?q1lv+0N9MdBIHXL9X/T1UwEKtmstVOJu47xh1spEWJmPIxNUsOs2Pt1tgJlS?= =?us-ascii?Q?xDlnibz47njCpPpJHPWdY9laLthZyErDrMQozQUzUp64IP4pK6mkdvDlOB1U?= =?us-ascii?Q?tucwz1QXCIkRxZ2AEKg094TaSGa9zrBWnlgpo3lJOYnOyStbP2lEzdciv/P+?= =?us-ascii?Q?+J2G3lQIkrfoo1jaPJ3y+Z9zJUI/SSul6xi/C3HlUKf9dMFE0836h5jNJyJD?= =?us-ascii?Q?Va6emo4okp+hR6iCSrCwFyaKdp7vcYXSvaPJ8LJnxAvyOmEiD0J5Tb3wvVkH?= =?us-ascii?Q?A8NwNhCuT64wW3L6opL/p6Nzljq3xGeyJZ78wTkX4qHbfh84loj7/x94xwga?= =?us-ascii?Q?JsZSt7y5gFxvWnkj+DpZT0nteOqaHvHLQ4ckNKUznP08lBflmcU2LgQbUKy4?= =?us-ascii?Q?IXAA=3D=3D?= X-Forefront-PRVS: 038002787A X-Forefront-Antispam-Report: SFV:NSPM;SFS:(10019020)(4630300001)(7370300001)(6009001)(39450400003)(39840400002)(39400400002)(39850400002)(39410400002)(199003)(189002)(5660300001)(1076002)(48376002)(97736004)(6666003)(8676002)(38730400002)(110136004)(6116002)(69596002)(36756003)(6916009)(53416004)(478600001)(25786009)(4326008)(54906002)(86362001)(42186005)(2950100002)(50466002)(105586002)(7416002)(7736002)(106356001)(2361001)(305945005)(68736007)(34040400001)(6512007)(33646002)(50226002)(6486002)(101416001)(7350300001)(2906002)(6506006)(53936002)(81166006)(50986999)(2351001)(189998001)(81156014)(76176999)(47776003)(5003940100001)(42262002);DIR:OUT;SFP:1102;SCL:1;SRVR:SN2PR15MB1088;H:castle.thefacebook.com;FPR:;SPF:None;PTR:InfoNoRecords;A:1;MX:1;LANG:en; X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1;SN2PR15MB1088;23:CJQF8KfkJiK/PiEWb2QgZoyjWz3y1XOGNKD7vMpcr?= =?us-ascii?Q?cpwAxp3buONmge1lasNEK/XfqSZDFKJRH0oTOrQddQfsgjfu6FUAZff6R20M?= =?us-ascii?Q?s4kbaKDZ7gxfBlMWE6bYflrn4Lox2tF69F81DzCCEjuxSDAAQE1yxXCICaev?= =?us-ascii?Q?4/mRfox1NnP86hiimGAEOMvfUUE/wJq5bkptp0JdJxyl7Mc+NeGPY+nIT3pT?= =?us-ascii?Q?7t0suogXULst15buT+CaU5eYiejX8dIjHgJ6C6preZamzRopOjFv0In9O76i?= =?us-ascii?Q?kkF0xe9sVGndWquZ9M7tTZwFNdZ1mZQfzaSGVzKg4CwPQlNc162/kznRzKsa?= =?us-ascii?Q?HTd2eY5ZmZiPGje7lwSzeq/Aea/Slo/aGYlFAZiqgnNES1xpUpdMZBj2Je2L?= =?us-ascii?Q?1/xYcqGFVXb3XGS43D+9FxSg4fxQjPec36e4Ij1OzuIxO1gtkk932F3KgEgK?= =?us-ascii?Q?xK9WBP2o2ouj8nsWNrhZsB6JSE7sKKejunZnpA38LVYaNAexyd6ap/OBmSmW?= =?us-ascii?Q?HHgr8HRFmyrigtIycBen8b5fd+WJ+pvc+d3OxI9vQ2XvUDwRlCj47gI+HFKk?= =?us-ascii?Q?yihiksnCRKGV2ctXwi1FkRPjzk0WIpRtwzywEzFtAienGbiVW9tEacISdNcM?= =?us-ascii?Q?fpySm185TIW5iB62Hi7n3EE8o3AhZNYs7ZqdYZtQuImjiInbp1ZHDmiO5UDN?= =?us-ascii?Q?8gzC31ZGm1E33l/sN1NkO7aD9J0c2ER9d3BzJ70GrfBfJd/ALLG+jVMiK96C?= =?us-ascii?Q?fGgv/M3MfQ+zcD78X5zEAWDhBEysedBFJZd7n/QSUwsIlteYqecQqh3lkDgZ?= =?us-ascii?Q?Vo1YDk6A4X1PArPssss8WTLTWdCQROkO9w0vkBvZyDaUieXPFiJPntQq2lPL?= =?us-ascii?Q?7EzLWj5o1C2/hfU0S/a1aACsf8HkM8rFGTPFv1FZ1LglQc/hmdyQanKYIHcF?= =?us-ascii?Q?MoaCi7HPP5mtB2RoDU/FvgorQYpMVK/QVQMEE9th3iH0PerRicrjdE+x78dw?= =?us-ascii?Q?UmaqK79JhinnncQGimzjBgCZwgVXIdY/5b7/ychhC0u7hVzp58RQKo1Y8I/9?= =?us-ascii?Q?PNFP34qtBmrXXAPYjhbQ6AgQA3KWzy8Nj0XaAtQ1iX0Rnu4EXiF1LOxARwKT?= =?us-ascii?Q?YLFa/jnYf2oo/J5cm3SIWKZ/JbBkE/FREsP06ZuRyKOjq0klHu5iWhzthcok?= =?us-ascii?Q?DvvGsKyx9UuULR5LAZwPG71BQ57v85X/A4IqPa+KLKbSo8WUueF7eeXvj3qA?= =?us-ascii?Q?4nh9JSleTjsa3MVO2tfXvnL+zgOnOywGL0zMWqTV+ej7cbQ0yXtw4G53H5gS?= =?us-ascii?Q?rIE12Ray0vJx3F4hMh/d07nI3ludk23Vd40sAossvY819wmXUiW+C+FAxjCm?= =?us-ascii?Q?TDcomj+LdhJs6qiTG6u5LvQMlSGuMg8gRaaBVwfE3UWE0vz?= X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1;SN2PR15MB1088;6:GJsgdAH2f0bDvF5/52m41US6DW7hSklYikzXtBH9y+?= =?us-ascii?Q?MZSYGO/VKBXa0l5EV5Clg9w91vexoUFXk6jbavo/S4aE3mhXCua+MH2K9Hz6?= =?us-ascii?Q?2AjZVQVCVEzdcFiFNO9rxeedBywtOnHpGvlHib/+6AoPZuWNK7oxyHGjTnWI?= =?us-ascii?Q?QMb1Nrm48mtEs1wuGKAbpJ9Gl+la0cpOSMKIBjAG3A9GlwtoE+DTrNgoI5Sz?= =?us-ascii?Q?tXiTsMcXsE9GNLnlsClEKLT8CcSYj4NwQuqRplV6wijfjLl6qTL7o41QQpw0?= =?us-ascii?Q?uhoo11SPDD2JjiBkw7s8RFiW4vZcEvOnReBC6jjSyPo4PLTYZyu6HRlwftD4?= =?us-ascii?Q?PdTuqP2JM31CZF9q5QnAbffLCe9+PLlug99Ws5lOaiWK8coKLhjLy1F83kB1?= =?us-ascii?Q?MDBKLageR19xkTi327BmPc/znIPQ0DNCdrtFBlkasORJt3+0GOqZDQd9l0pT?= =?us-ascii?Q?YaHOUMR6JGsSXFuBy68MZCJyysNWiUjmhnFvNPmqZ7idDm8t/WR+H+Nuwj5d?= =?us-ascii?Q?dIFRTXSsTgVbckvpf6THg5sbW6iRyAP1cCEz+abaMJwOLVRMb7/7o+6JW6AO?= =?us-ascii?Q?GsI+jC0umDOro9VTl6nl6jfXc7yXW/kNKJgP3PdndY/vp+OXDHih+/M1zu0a?= =?us-ascii?Q?yot27Jf7O4EugjQ3LGNzSV4VgjlwX4a7uuLwqiBvxD2kDEd7hBr5hh4FhqIf?= =?us-ascii?Q?itdGHOOhb8avoIa6+/4lkGMAN21QrGvv0MXhDboUI9y8KG+L8hs3nOWCaOSA?= =?us-ascii?Q?H991yd7YsRUnd3b14mFCI30EWigbV+ZlY1lJIYawFxUSvzZg0GVqVYoLYmEu?= =?us-ascii?Q?LxGHnTUvF/aICcNF1MmXeqgwwCyn81Xlprvm4nnFygyY8/BoZbYpmuyEcfXD?= =?us-ascii?Q?9y7O2wWcoEknqBP072Y7K6xY3A17qp5Mpu39EBHBFxgwf/99oqOlViKxpuqx?= =?us-ascii?Q?R4IC1AtERjWibu2w1mBtaUZ1EJ4MouuOLf/VsGhSGUKlMcBKnHn6/vzddl+9?= =?us-ascii?Q?Q=3D?= X-Microsoft-Exchange-Diagnostics: 1;SN2PR15MB1088;5:KEvYLSj9fxkexREO4iymRCo8bzUJQrg0JbsLlQU4nJPEEUFWqumORObdtDs2t3DKJxmUxwgViMxSHkfXPFi9liQkkupckYyt6jbPhpAyKwm7JXJQTHVLER4IWtXRZbih3a6KQuidJMCyR7Gj9d7gPKp4GFNiaJaYBLGsOfPpGesZV2YGv8jBLE2RA3hmQxR2ttj2nD0+S36D8qsb3X3BnxuaDa0WqFb5EMkU2os1PRL9+OCoKlYU9BC9tRGYsOhP/A9mgbjme3GRPjlunh3cIymfVj7DW3L2Z9ldqw2Clnwlts9smE3VxdFQY3oeakAfvOtayoO2bLGk2HmIrgCW8EGwR3BGIn8csZj0dniglujTjzUDafK/rSrbIJ3FSqPYAjYSwyJJY3lrvqTYql/fSVotzVHeAOy+W7tBHWitU+Weo9pvqISK1omIqGbFCVw+M7x45Prla1FS03WKBwmbG64TgfIZI8WG8AIv02b0shQSyCWvgzopeSJSYjR4RQot;24:0XGaoXDvoM8SdniAT8P2Uarru1wVuykQM2xdKlclcXRIGeituNIL11wuDuCOceySt2NxB1kJC5ilT9Hf0zG8YU8Y81hmTmKZ070lZ2A7yss= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1;SN2PR15MB1088;7:9aJhcoDipZEcLkznhd5nPr+AyctRqzyOW/S6WtdYgIKsNH7KJLiZtathuzOLL8wsjs4lkKaBPtjJiyOrb626C3c9HUzTqKnCb64F/hs18RHm2sMOKX/tKfcDKs+25B7bm0DL5tg4euewiEszh9oGazK6LC1wUOPmDuXSvBfqpYeWxD5gi33lVV2r35HMbZh5YeHaXiMN7/+QkG8984JPfaw0eDg5n0qA+xZnDKVr0VdPzgBFMYNJYrs/tVw00Hhc9S8Rsld3g4GgrpVCKc3hgsXHetBbuA9k2/AhVD3htVry97fjJoK1Leh2fyaNql/inyoQbsoHta2RNZjGAxdUdco9DMaFCnwScdotdrMcyNcNThsQi1hblDP8blmu/j2iPV7bIM/rLnv5FqmnT9/ShXXbP7FHh2phjNJgBROUvrhzxnBev6sFScBe6N7zNBb3sTa3AyJyTDYLYkYAAWwilZEI932M6E8RNHacEJ5D3poftaFIujckLv44AH9mHTh/fs8lXM6naZxzE3HnhH+w+pIe5mMI4ywloT4RpZ5lw4W+Oti/ih24Nz5K0eD7HVd618OM1ZbaXQ7ehxA3X5V4Ud8GytOa+Xsp55EcyIlvGW8G2OKWvdM4JUADTVuXOwQHTtvOH/5QV7ODlxnqxquDcKNQEkxGVSeTpgwlvV2/8x2X/ee0AndpodnjFapMzuCIMO3aSI5OD9AxhfwyTK11Oq+l+TIJma/OuxjrwKTKFPd7lnuyru2lS8YRb2IiIuzTfchVRTzT/TK2PJOszknnViTFXrW/mgZxJkW/LSG6GCc= X-Microsoft-Exchange-Diagnostics: 1;SN2PR15MB1088;20:LwAn2fBBzGHb/jHySh339MypzVs4TfW6PxiWzAj375VPclaD36RfCEV0oCOimuS+5e301r7LedCeC5Bzkp2GOjizND8t7m6ynJyJ14fnelUdvc0pvbfBwngxGENY1norMqQj7KiISLYZdpD9XhTDW1QgKov6eHiTgWWIkScZS+U= X-MS-Exchange-CrossTenant-OriginalArrivalTime: 26 Jul 2017 13:27:58.5088 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: SN2PR15MB1088 X-OriginatorOrg: fb.com X-Proofpoint-Spam-Reason: safe X-FB-Internal: Safe X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10432:,, definitions=2017-07-26_06:,, signatures=0 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Update cgroups v2 docs. Signed-off-by: Roman Gushchin Cc: Michal Hocko Cc: Vladimir Davydov Cc: Johannes Weiner Cc: Tetsuo Handa Cc: David Rientjes Cc: Tejun Heo Cc: kernel-team@fb.com Cc: cgroups@vger.kernel.org Cc: linux-doc@vger.kernel.org Cc: linux-kernel@vger.kernel.org Cc: linux-mm@kvack.org --- Documentation/cgroup-v2.txt | 62 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 62 insertions(+) diff --git a/Documentation/cgroup-v2.txt b/Documentation/cgroup-v2.txt index cb9ea281ab72..bf106b6b6b52 100644 --- a/Documentation/cgroup-v2.txt +++ b/Documentation/cgroup-v2.txt @@ -48,6 +48,7 @@ v1 is available under Documentation/cgroup-v1/. 5-2-1. Memory Interface Files 5-2-2. Usage Guidelines 5-2-3. Memory Ownership + 5-2-4. Cgroup-aware OOM Killer 5-3. IO 5-3-1. IO Interface Files 5-3-2. Writeback @@ -1001,6 +1002,37 @@ PAGE_SIZE multiple when read back. high limit is used and monitored properly, this limit's utility is limited to providing the final safety net. + memory.oom_kill_all_tasks + + A read-write single value file which exits on non-root + cgroups. The default is "0". + + Defines whether the OOM killer should treat the cgroup + as a single entity during the victim selection. + + If set, OOM killer will kill all belonging tasks in + corresponding cgroup is selected as an OOM victim. + + Be default, OOM killer respect /proc/pid/oom_score_adj value + -1000, and will never kill the task, unless oom_kill_all_tasks + is set. + + memory.oom_priority + + A read-write single value file which exits on non-root + cgroups. The default is "0". + + An integer number within the [-10000, 10000] range, + which defines the order in which the OOM killer selects victim + memory cgroups. + + OOM killer prefers memory cgroups with larger priority if they + are populated with elegible tasks. + + The oom_priority value is compared within sibling cgroups. + + The root cgroup has the oom_priority 0, which cannot be changed. + memory.events A read-only flat-keyed file which exists on non-root cgroups. The following entries are defined. Unless specified @@ -1205,6 +1237,36 @@ POSIX_FADV_DONTNEED to relinquish the ownership of memory areas belonging to the affected files to ensure correct memory ownership. +Cgroup-aware OOM Killer +~~~~~~~~~~~~~~~~~~~~~~~ + +Cgroup v2 memory controller implements a cgroup-aware OOM killer. +It means that it treats memory cgroups as first class OOM entities. + +Under OOM conditions the memory controller tries to make the best +choise of a victim, hierarchically looking for the largest memory +consumer. By default, it will look for the biggest task in the +biggest leaf cgroup. + +Be default, all cgroups have oom_priority 0, and OOM killer will +chose the largest cgroup recursively on each level. For non-root +cgroups it's possible to change the oom_priority, and it will cause +the OOM killer to look athe the priority value first, and compare +sizes only of cgroups with equal priority. + +But a user can change this behavior by enabling the per-cgroup +oom_kill_all_tasks option. If set, it causes the OOM killer treat +the whole cgroup as an indivisible memory consumer. In case if it's +selected as on OOM victim, all belonging tasks will be killed. + +Tasks in the root cgroup are treated as independent memory consumers, +and are compared with other memory consumers (e.g. leaf cgroups). +The root cgroup doesn't support the oom_kill_all_tasks feature. + +This affects both system- and cgroup-wide OOMs. For a cgroup-wide OOM +the memory controller considers only cgroups belonging to the sub-tree +of the OOM'ing cgroup. + IO -- -- 2.13.3