From patchwork Tue May 8 07:02:10 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mike Rapoport X-Patchwork-Id: 10385449 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 63AE660353 for ; Tue, 8 May 2018 07:02:34 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 52E5428CD3 for ; Tue, 8 May 2018 07:02:34 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 4700E28CD5; Tue, 8 May 2018 07:02:34 +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 94F5328CD4 for ; Tue, 8 May 2018 07:02:33 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id CF93B6B026B; Tue, 8 May 2018 03:02:30 -0400 (EDT) Delivered-To: linux-mm-outgoing@kvack.org Received: by kanga.kvack.org (Postfix, from userid 40) id CAB6A6B026C; Tue, 8 May 2018 03:02:30 -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 AD3C06B026D; Tue, 8 May 2018 03:02:30 -0400 (EDT) X-Original-To: linux-mm@kvack.org X-Delivered-To: linux-mm@kvack.org Received: from mail-wr0-f200.google.com (mail-wr0-f200.google.com [209.85.128.200]) by kanga.kvack.org (Postfix) with ESMTP id 5329C6B026B for ; Tue, 8 May 2018 03:02:30 -0400 (EDT) Received: by mail-wr0-f200.google.com with SMTP id y6-v6so20998768wrm.10 for ; Tue, 08 May 2018 00:02:30 -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:from:to:cc :subject:date:in-reply-to:references:message-id; bh=6HrXGKfNDL6Nhv9eSGdYPkNSZcN3s90P7isLE+AnsDo=; b=s7WUvGRp6vmudFV+ROJAYXb+/zAw2hsyFgFGfa0k+LuV8GvCIsYGWa7VRUjDzWi7dm eOwsRoYYeTL0qWU/h5c4qN7CL3elTWUtvyPozDdKT2Mt2WtBo1Bi9NzgOg1w6pFLAF1+ fXPwVwbcXuSiI7q3JORcu869OBbF9FIXfqdtddufypCWC9co178F+nR6Uyohw/fWATfB d4SPaI7QmleX1mDzjBHo8ONiQR+0SlTdZQnuN9VJJTf4dn7sYtNQBXAOOeUaepgQjK+1 N1c66PfLfqFIoTh3as1BsF6RdEBUSg5eVrtwSm4D/CTR/Cd7DsE5lzGO0SldczuS+u2c e4WA== X-Original-Authentication-Results: mx.google.com; spf=neutral (google.com: 148.163.158.5 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) smtp.mailfrom=rppt@linux.vnet.ibm.com; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com X-Gm-Message-State: ALQs6tAT0nV4e63R30Tg1vwCZrWO4D+yEoq6AWUbLdZY3IxJNh4OSD5x zSGgJgSjet6xep9vrENY44R9XoN3hSXH/5hw3EVPLzjQe5DapgpZFjLD6jP8B6/eSLklxw0F8T1 MVUxWa957S6IX0hNyrCeYjK2qa2M68DN3u9SXTRGNDRqk2yRxqfaYrfwa/t8J9Ws= X-Received: by 2002:a50:b6e2:: with SMTP id f31-v6mr53526305ede.23.1525762949882; Tue, 08 May 2018 00:02:29 -0700 (PDT) X-Google-Smtp-Source: AB8JxZrqgtwmwaqPlfANX1vBM9Jc0H3+beD+AMEKZ3BQG04UkJVLMS0I3JnbnR9U1eeWSwiNHbk8 X-Received: by 2002:a50:b6e2:: with SMTP id f31-v6mr53526252ede.23.1525762949005; Tue, 08 May 2018 00:02:29 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1525762948; cv=none; d=google.com; s=arc-20160816; b=e0lA8PebiAvGkGmvQv8wIsaS2o52IONpX6L1h/2MHTHcz1RSkHg2DeEV8Jn1F5nayP a0BUvRUpAzj1zN4vf300IM0r4sV9CLYfr2QCI9hU8frLmXQNx0XbOJvscq8vOGhclVtz EzmFSXgT+VBx0Uf1vgNKxIxU/kTSpcyf1yPQa5kFb/fxZylcKkfqfcvM0NAbIvggUyXk hcQ0c00jWDbxozW2Dd3GX27BSUS6Z9FLlR3q/KX5EiMjdy3maLdhGciJAPFV7uwf7Yy8 sRdM+Gdm48E3kbTrLHWp8c3Kvurq5osad3xSrnY3pfnloWkntJ7SCbINDNJAQWSVCe6i 45gg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=message-id:references:in-reply-to:date:subject:cc:to:from :arc-authentication-results; bh=6HrXGKfNDL6Nhv9eSGdYPkNSZcN3s90P7isLE+AnsDo=; b=WljbdE7B5yHu40XtCypAebDCFyzZ0E4ZlfAI2XjzrPzPdCVvYKpNvAjfwI+Hj8Tiiv ckJcQtvie3Qt4MzUr0LP7r6gqPt+UVBw65X5rjBQKpbFs1poDYa8Z+6K6U/wWTzg6mZX oEYxVCvHz0aW2kt481sY6AB/I15xTSAtyDd1W0gKdSSuC1Rbhk0J9SY1xwd8SQIXdx4B /CAvx4akW7Cy41iKlcaLLsw5k0Eobc2ZKZMRtSYQIyIsYQAI9dFrzBK4aI3Dflo00r24 Dg6x7CX139Au2nwJapU+TT+krURKGdoFU4UE5IYOWzg9z9n0EAHp5PZoWt8QbdLEml2o WFpA== ARC-Authentication-Results: i=1; mx.google.com; spf=neutral (google.com: 148.163.158.5 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) smtp.mailfrom=rppt@linux.vnet.ibm.com; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com. [148.163.158.5]) by mx.google.com with ESMTPS id s19-v6si1798724eda.85.2018.05.08.00.02.28 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 08 May 2018 00:02:28 -0700 (PDT) Received-SPF: neutral (google.com: 148.163.158.5 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) client-ip=148.163.158.5; Authentication-Results: mx.google.com; spf=neutral (google.com: 148.163.158.5 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) smtp.mailfrom=rppt@linux.vnet.ibm.com; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com Received: from pps.filterd (m0098414.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.22/8.16.0.22) with SMTP id w486xCJ0070594 for ; Tue, 8 May 2018 03:02:27 -0400 Received: from e06smtp13.uk.ibm.com (e06smtp13.uk.ibm.com [195.75.94.109]) by mx0b-001b2d01.pphosted.com with ESMTP id 2hu2bhagbt-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Tue, 08 May 2018 03:02:27 -0400 Received: from localhost by e06smtp13.uk.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Tue, 8 May 2018 08:02:25 +0100 Received: from b06cxnps4076.portsmouth.uk.ibm.com (9.149.109.198) by e06smtp13.uk.ibm.com (192.168.101.143) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Tue, 8 May 2018 08:02:22 +0100 Received: from d06av23.portsmouth.uk.ibm.com (d06av23.portsmouth.uk.ibm.com [9.149.105.59]) by b06cxnps4076.portsmouth.uk.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id w4872L4R3408356 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Tue, 8 May 2018 07:02:21 GMT Received: from d06av23.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id B8C18A404D; Tue, 8 May 2018 07:54:02 +0100 (BST) Received: from d06av23.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 4E7EEA4053; Tue, 8 May 2018 07:54:01 +0100 (BST) Received: from rapoport-lnx (unknown [9.148.8.166]) by d06av23.portsmouth.uk.ibm.com (Postfix) with ESMTPS; Tue, 8 May 2018 07:54:01 +0100 (BST) Received: by rapoport-lnx (sSMTP sendmail emulation); Tue, 08 May 2018 10:02:19 +0300 From: Mike Rapoport To: Jonathan Corbet Cc: Andrew Morton , linux-doc , linux-mm , lkml , Mike Rapoport Subject: [PATCH 3/3] docs/vm: move numa_memory_policy.rst to Documentation/admin-guide/mm Date: Tue, 8 May 2018 10:02:10 +0300 X-Mailer: git-send-email 2.7.4 In-Reply-To: <1525762930-28163-1-git-send-email-rppt@linux.vnet.ibm.com> References: <1525762930-28163-1-git-send-email-rppt@linux.vnet.ibm.com> X-TM-AS-GCONF: 00 x-cbid: 18050807-0012-0000-0000-000005D3DB21 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 18050807-0013-0000-0000-00001950E952 Message-Id: <1525762930-28163-4-git-send-email-rppt@linux.vnet.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2018-05-08_03:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 impostorscore=0 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1709140000 definitions=main-1805080069 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 The document describes userspace API and as such it belongs to Documentation/admin-guide/mm Signed-off-by: Mike Rapoport --- Documentation/admin-guide/mm/hugetlbpage.rst | 2 +- Documentation/admin-guide/mm/index.rst | 1 + Documentation/{vm => admin-guide/mm}/numa_memory_policy.rst | 0 Documentation/filesystems/proc.txt | 2 +- Documentation/filesystems/tmpfs.txt | 5 +++-- Documentation/vm/00-INDEX | 2 -- Documentation/vm/index.rst | 1 - Documentation/vm/numa.rst | 2 +- 8 files changed, 7 insertions(+), 8 deletions(-) rename Documentation/{vm => admin-guide/mm}/numa_memory_policy.rst (100%) diff --git a/Documentation/admin-guide/mm/hugetlbpage.rst b/Documentation/admin-guide/mm/hugetlbpage.rst index a8b0806..1cc0bc7 100644 --- a/Documentation/admin-guide/mm/hugetlbpage.rst +++ b/Documentation/admin-guide/mm/hugetlbpage.rst @@ -220,7 +220,7 @@ memory policy mode--bind, preferred, local or interleave--may be used. The resulting effect on persistent huge page allocation is as follows: #. Regardless of mempolicy mode [see - :ref:`Documentation/vm/numa_memory_policy.rst `], + :ref:`Documentation/admin-guide/mm/numa_memory_policy.rst `], persistent huge pages will be distributed across the node or nodes specified in the mempolicy as if "interleave" had been specified. However, if a node in the policy does not contain sufficient contiguous diff --git a/Documentation/admin-guide/mm/index.rst b/Documentation/admin-guide/mm/index.rst index ad28644..a69aa69 100644 --- a/Documentation/admin-guide/mm/index.rst +++ b/Documentation/admin-guide/mm/index.rst @@ -24,6 +24,7 @@ the Linux memory management. hugetlbpage idle_page_tracking ksm + numa_memory_policy pagemap soft-dirty userfaultfd diff --git a/Documentation/vm/numa_memory_policy.rst b/Documentation/admin-guide/mm/numa_memory_policy.rst similarity index 100% rename from Documentation/vm/numa_memory_policy.rst rename to Documentation/admin-guide/mm/numa_memory_policy.rst diff --git a/Documentation/filesystems/proc.txt b/Documentation/filesystems/proc.txt index ef53f80..520f6a8 100644 --- a/Documentation/filesystems/proc.txt +++ b/Documentation/filesystems/proc.txt @@ -566,7 +566,7 @@ address policy mapping details Where: "address" is the starting address for the mapping; -"policy" reports the NUMA memory policy set for the mapping (see vm/numa_memory_policy.txt); +"policy" reports the NUMA memory policy set for the mapping (see Documentation/admin-guide/mm/numa_memory_policy.rst); "mapping details" summarizes mapping data such as mapping type, page usage counters, node locality page counters (N0 == node0, N1 == node1, ...) and the kernel page size, in KB, that is backing the mapping up. diff --git a/Documentation/filesystems/tmpfs.txt b/Documentation/filesystems/tmpfs.txt index 627389a..d06e9a5 100644 --- a/Documentation/filesystems/tmpfs.txt +++ b/Documentation/filesystems/tmpfs.txt @@ -105,8 +105,9 @@ policy for the file will revert to "default" policy. NUMA memory allocation policies have optional flags that can be used in conjunction with their modes. These optional flags can be specified when tmpfs is mounted by appending them to the mode before the NodeList. -See Documentation/vm/numa_memory_policy.rst for a list of all available -memory allocation policy mode flags and their effect on memory policy. +See Documentation/admin-guide/mm/numa_memory_policy.rst for a list of +all available memory allocation policy mode flags and their effect on +memory policy. =static is equivalent to MPOL_F_STATIC_NODES =relative is equivalent to MPOL_F_RELATIVE_NODES diff --git a/Documentation/vm/00-INDEX b/Documentation/vm/00-INDEX index f8a96ca..f4a4f3e 100644 --- a/Documentation/vm/00-INDEX +++ b/Documentation/vm/00-INDEX @@ -22,8 +22,6 @@ mmu_notifier.rst - a note about clearing pte/pmd and mmu notifications numa.rst - information about NUMA specific code in the Linux vm. -numa_memory_policy.rst - - documentation of concepts and APIs of the 2.6 memory policy support. overcommit-accounting.rst - description of the Linux kernels overcommit handling modes. page_frags.rst diff --git a/Documentation/vm/index.rst b/Documentation/vm/index.rst index ed58cb9..8e1cc66 100644 --- a/Documentation/vm/index.rst +++ b/Documentation/vm/index.rst @@ -14,7 +14,6 @@ various features of the Linux memory management :maxdepth: 1 ksm - numa_memory_policy transhuge swap_numa zswap diff --git a/Documentation/vm/numa.rst b/Documentation/vm/numa.rst index aada84b..185d8a5 100644 --- a/Documentation/vm/numa.rst +++ b/Documentation/vm/numa.rst @@ -110,7 +110,7 @@ to improve NUMA locality using various CPU affinity command line interfaces, such as taskset(1) and numactl(1), and program interfaces such as sched_setaffinity(2). Further, one can modify the kernel's default local allocation behavior using Linux NUMA memory policy. -[see Documentation/vm/numa_memory_policy.rst.] +[see Documentation/admin-guide/mm/numa_memory_policy.rst.] System administrators can restrict the CPUs and nodes' memories that a non- privileged user can specify in the scheduling or NUMA commands and functions