From patchwork Fri May 18 04:39:21 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: TSUKADA Koutaro X-Patchwork-Id: 10408195 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id B045F601F9 for ; Fri, 18 May 2018 04:39:42 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 9D56728802 for ; Fri, 18 May 2018 04:39:42 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 8E31628857; Fri, 18 May 2018 04:39:42 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-2.9 required=2.0 tests=BAYES_00, MAILING_LIST_MULTI, RCVD_IN_DNSWL_NONE autolearn=ham version=3.3.1 Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id F3D6228802 for ; Fri, 18 May 2018 04:39:41 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 316B26B0574; Fri, 18 May 2018 00:39:41 -0400 (EDT) Delivered-To: linux-mm-outgoing@kvack.org Received: by kanga.kvack.org (Postfix, from userid 40) id 2EB846B0575; Fri, 18 May 2018 00:39:41 -0400 (EDT) X-Original-To: int-list-linux-mm@kvack.org X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 18D506B0576; Fri, 18 May 2018 00:39:41 -0400 (EDT) X-Original-To: linux-mm@kvack.org X-Delivered-To: linux-mm@kvack.org Received: from mail-pf0-f198.google.com (mail-pf0-f198.google.com [209.85.192.198]) by kanga.kvack.org (Postfix) with ESMTP id C4D256B0574 for ; Fri, 18 May 2018 00:39:40 -0400 (EDT) Received: by mail-pf0-f198.google.com with SMTP id c187-v6so4023789pfa.20 for ; Thu, 17 May 2018 21:39:40 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-original-authentication-results:x-gm-message-state:subject:to:cc :references:from:message-id:date:user-agent:mime-version:in-reply-to :content-language:content-transfer-encoding; bh=hMtxMOsEDkEzcxjOgYx9sAyW39CDSNxvwukUCxc+Le4=; b=G4KPe1UHUTsxEzrJMPGBs7Dj6DYupJntGdL9kFgmYzqFnQVzXYzlml/naPY4vRAUhw Fjkj03iq6Fqt9Y11GoeIQwLjv9o9eqLCDNi9uqii4yXo3cXZQ1xXbe/1tFAx2w1ksii7 lWLW8cuUCqeKf3KTEC017wBAiUiIWK7KZMbLi5F8twRa+cVKzqTE0goCbkSHFrohijzi zxPljlHjNrW5UKTOe2ewroP47JSxd0bi/lJG5oQzQScjJxRSa4kDR4uFL3ZVR0ODL+V4 xB5h6eqeMaW8xVLoE1MqjnseEn4+H1d7H9gyvy5eHewEbh3ZMLWcjwSAyRkoxwFVvipf EC7w== X-Original-Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of tsukada@ascade.co.jp designates 218.224.228.194 as permitted sender) smtp.mailfrom=tsukada@ascade.co.jp X-Gm-Message-State: ALKqPwclFL15KM+CNXOKw1OiDIlBULwtrMGdL5PP6AYPHY+u3MB6nlXJ SVAvF4u2qxa0QU/b0e/mWWWVH4QhDPZX8ZeNcwe3chmxaRG+uAc/mAjnETetov7Sln/ELQnrQVH FFdEW8cMR5f6sdz4rzq1ECISmeb2iG/6OYznkRYyu+A2W5PN5eW0H7F4ySuUccTpmvA== X-Received: by 2002:a65:4586:: with SMTP id o6-v6mr6065495pgq.197.1526618380479; Thu, 17 May 2018 21:39:40 -0700 (PDT) X-Google-Smtp-Source: AB8JxZrJD2y3BxRG6osy8eDtoMm53GA2WmBaaV4w7ncUMsSM3tcj4Yb73X8XsmVOZlp5ur8MeyLM X-Received: by 2002:a65:4586:: with SMTP id o6-v6mr6065472pgq.197.1526618379832; Thu, 17 May 2018 21:39:39 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1526618379; cv=none; d=google.com; s=arc-20160816; b=UkXmbDtFcqqtNvmuTzVD9Xhvq5bJ+EhADVddjV6DTFqWXWgMb0DbST15L1na4qMzQv yLQeB8Szbr/GQWPgR9yWNHMkeFMOBreYRdlks0jfj7d9ogW2ll+CvyQU0E3JKuq98CEb p1Jvn4/+EqMMpxQlMLhx3j5TC+mUHQMLPtCaB7KliVtgcWLAjQWj4pPVLIhmmoZqgPRG LEoblF2HVxpS6KBTnRtm2JwBqLrhLHotUZ+Tw9fsXEiYT29fAwuO9ZYIpY1OpJ57xKv/ JE6XxI9+CsxBImmxteiAGpbde1oVTiG26SX5y/BYMJOzvsusPF2uedTwiTScxVQjxLUf e3dA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:content-language:in-reply-to:mime-version :user-agent:date:message-id:from:references:cc:to:subject :arc-authentication-results; bh=hMtxMOsEDkEzcxjOgYx9sAyW39CDSNxvwukUCxc+Le4=; b=0I5vYcK4++U+eo2Z/xHO9MwQKwfHJuk+AtT4mQlJa9X+b+V83mm15BXld48iMtjILm 2DcsQ7vG2u0QT3GdaA6D5CjmRf/oI0U+Qnnt2AM7LAQ223UsZ2cPGrK1Oz6pb+wfp2/b vjtehDU6+XtZpS7iSyRZ8Wzx5SvF9nPdmP4++hC0IPl/lOa+TaZ5yys7TMAMBIeRa4DT Q6S0RaUoar8lrCNlV+g9jSiThViT8LFXwvZxiFnNSbb8KVTNZ0MtQEvHbPXk7CocCZAe fzTXi2I0xnUPKoH9dAlWKQMvI9UBRFGijLt1pHC27oKBKa8ybKpFgdGVSsxS41nNphKr 0d5A== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of tsukada@ascade.co.jp designates 218.224.228.194 as permitted sender) smtp.mailfrom=tsukada@ascade.co.jp Received: from ns.ascade.co.jp (ext-host0001.ascade.co.jp. [218.224.228.194]) by mx.google.com with ESMTP id c10-v6si5234570pgn.231.2018.05.17.21.39.39 for ; Thu, 17 May 2018 21:39:39 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of tsukada@ascade.co.jp designates 218.224.228.194 as permitted sender) client-ip=218.224.228.194; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of tsukada@ascade.co.jp designates 218.224.228.194 as permitted sender) smtp.mailfrom=tsukada@ascade.co.jp Received: from server0001.ascade.co.jp (server0001.ascade.co.jp [10.1.1.63]) by ns.ascade.co.jp (Postfix) with ESMTP id E0319993BD; Fri, 18 May 2018 13:39:38 +0900 (JST) Received: from [IPv6:::1] (server0001.ascade.co.jp [10.1.1.63]) by server0001.ascade.co.jp (Postfix) with ESMTP id 9437810050E; Fri, 18 May 2018 13:39:32 +0900 (JST) Subject: [PATCH v2 6/7] Documentation, hugetlb: describe about charge_surplus_hugepages, To: Johannes Weiner , Michal Hocko , Vladimir Davydov , Jonathan Corbet , "Luis R. Rodriguez" , Kees Cook Cc: Andrew Morton , Roman Gushchin , David Rientjes , Mike Kravetz , "Aneesh Kumar K.V" , Naoya Horiguchi , Anshuman Khandual , Marc-Andre Lureau , Punit Agrawal , Dan Williams , Vlastimil Babka , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-fsdevel@vger.kernel.org, linux-mm@kvack.org, cgroups@vger.kernel.org, tsukada@ascade.co.jp References: From: TSUKADA Koutaro Message-ID: <07466cce-ca82-9024-a04a-c17291e64f84@ascade.co.jp> Date: Fri, 18 May 2018 13:39:21 +0900 User-Agent: Mozilla/5.0 (Windows NT 6.3; WOW64; rv:52.0) Gecko/20100101 Thunderbird/52.7.0 MIME-Version: 1.0 In-Reply-To: Content-Language: en-US X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: X-Virus-Scanned: ClamAV using ClamSMTP Add a description about charge_surplus_hugepages. Signed-off-by: TSUKADA Koutaro --- hugetlbpage.txt | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/Documentation/vm/hugetlbpage.txt b/Documentation/vm/hugetlbpage.txt index faf077d..af8d112 100644 --- a/Documentation/vm/hugetlbpage.txt +++ b/Documentation/vm/hugetlbpage.txt @@ -129,6 +129,11 @@ number of "surplus" huge pages from the kernel's normal page pool, when the persistent huge page pool is exhausted. As these surplus huge pages become unused, they are freed back to the kernel's normal page pool. +/proc/sys/vm/charge_surplus_hugepages indicates to charge "surplus" huge pages +obteined from the normal page pool to memory cgroup. If true, the amount to be +overcommitted is limited within memory usage allowed by the memory cgroup to +which the task belongs. The default value is false. + When increasing the huge page pool size via nr_hugepages, any existing surplus pages will first be promoted to persistent huge pages. Then, additional huge pages will be allocated, if necessary and if possible, to fulfill @@ -169,6 +174,7 @@ Inside each of these directories, the same set of files will exist: free_hugepages resv_hugepages surplus_hugepages + charge_surplus_hugepages which function as described above for the default huge page-sized case.