From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id 33314CD6907 for ; Tue, 10 Oct 2023 08:32:11 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id C52358D00B2; Tue, 10 Oct 2023 04:32:10 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id C01698D006D; Tue, 10 Oct 2023 04:32:10 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id B17B08D00B2; Tue, 10 Oct 2023 04:32:10 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0011.hostedemail.com [216.40.44.11]) by kanga.kvack.org (Postfix) with ESMTP id A42848D006D for ; Tue, 10 Oct 2023 04:32:10 -0400 (EDT) Received: from smtpin14.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay05.hostedemail.com (Postfix) with ESMTP id 7A30A4023C for ; Tue, 10 Oct 2023 08:32:10 +0000 (UTC) X-FDA: 81328884420.14.6198043 Received: from outbound-smtp15.blacknight.com (outbound-smtp15.blacknight.com [46.22.139.232]) by imf17.hostedemail.com (Postfix) with ESMTP id 26C6140005 for ; Tue, 10 Oct 2023 08:32:06 +0000 (UTC) Authentication-Results: imf17.hostedemail.com; dkim=none; dmarc=none; spf=pass (imf17.hostedemail.com: domain of mgorman@techsingularity.net designates 46.22.139.232 as permitted sender) smtp.mailfrom=mgorman@techsingularity.net ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1696926727; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=HQytHMvkVfmtk+kL93AlzEx/EaNzT4qIVA3wITxCRzw=; b=774rmqYl8yivf0e41dFbkaUClFuQCs+/BURptcRuF0zrgB+EFKpkXdujiCKLhi0zf7f5Ir MRG4CmMY1qSu3aN7waDrCC9UMzyUjJv2894zOLWIAQPKtf/gvzbvTdO8DPiH3auOLtTzG8 Nh7pf417rAUs9ak2oL33K9YZpnTPwfE= ARC-Authentication-Results: i=1; imf17.hostedemail.com; dkim=none; dmarc=none; spf=pass (imf17.hostedemail.com: domain of mgorman@techsingularity.net designates 46.22.139.232 as permitted sender) smtp.mailfrom=mgorman@techsingularity.net ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1696926727; a=rsa-sha256; cv=none; b=uBRkbsoEASP5qNjKHNZncsT9iGkEDyixRmkDclddS2rm3e6sdnn3sYvrNNrFzsT4+8VHkg MI3LusSCXgZQqNJLYxcNUZgXk3Ob0VYfcvMgyRB7q2XTkLMsBwiDWJl9W+UncUAPXcJiw+ RZ9+0xeit3jBHQ9wEM/HmqLqdvzg7Sg= Received: from mail.blacknight.com (pemlinmail04.blacknight.ie [81.17.254.17]) by outbound-smtp15.blacknight.com (Postfix) with ESMTPS id 96A541C4FCD for ; Tue, 10 Oct 2023 09:32:05 +0100 (IST) Received: (qmail 7039 invoked from network); 10 Oct 2023 08:32:05 -0000 Received: from unknown (HELO morpheus.112glenside.lan) (mgorman@techsingularity.net@[84.203.197.19]) by 81.17.254.9 with ESMTPA; 10 Oct 2023 08:32:05 -0000 From: Mel Gorman To: Peter Zijlstra Cc: Raghavendra K T , K Prateek Nayak , Bharata B Rao , Ingo Molnar , LKML , Linux-MM , Mel Gorman Subject: [PATCH 1/6] sched/numa: Document vma_numab_state fields Date: Tue, 10 Oct 2023 09:31:38 +0100 Message-Id: <20231010083143.19593-2-mgorman@techsingularity.net> X-Mailer: git-send-email 2.35.3 In-Reply-To: <20231010083143.19593-1-mgorman@techsingularity.net> References: <20231010083143.19593-1-mgorman@techsingularity.net> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Rspamd-Server: rspam09 X-Rspamd-Queue-Id: 26C6140005 X-Stat-Signature: xuirottbanba8o8yn5o3pwfoomk96y59 X-Rspam-User: X-HE-Tag: 1696926726-704188 X-HE-Meta: U2FsdGVkX19R3M0DeSw4CaF1jdIC/ZcLDMeDiZXWqRVvGek9qPGLqbUf6kJOoqi5Um/KO7oK5cGqLarGXiASP1sX8awm2KyL93uEDkS0q4aEThqsnR0idMgxJBXJxQThiqumJ8iK9wx+Nd2cg+EGUjDahpIGUrOP/XAKGdGBBePw83+gd2r16YAN5hRSOS9ncrx+ryiKR7eiQWkuv67XFXqg282E5QJX6UNoxBQsV5kin4kg/JuXF1GLGy89aPc3MWd/b4NJEdCIuiq7zVxYjbZ7A4i8GlxYrYoewHe7czTRLjatx2OjpUc++HmYDyY3GnCVmnUWnVb6YPjxxspJWx8IRMpzPdvy8M840OpM0HVzeqxvCVWgIamtM9QpGWc5bxN79CDpF4xkaK417fqfXLUE2LKZlisE5k1Rv+mcC3a9Uoxxfrf1NzvgQlkF4ZzoIpSK6+8hEqNEuQ1emGcK+V/T0FX+Hi0m37c7WGfMDN29OjqqZspQbS3HbvBJsY+qYuUFOsfOvMB3AABvm5yF97cfBvjB3VhyIYgHyhJpFPHt+/NDoGc56HyMXnqQxRwkkRGUTFJqZydPVBMxwlcFJVyaD5vftFJkxoiYTRwE23Qgp3OXTXyhwuZvHqDu3dej7h9TpZOqzbnQn3MhmL8KeR4QOquyWSRuM9j6kwmqnj2O23rrT1pN6zKYDq8y6WQ4qCGNyS+kF0w4tVmnZFmwuD1r/+lE2OczsTGKJRzRPY2OlA00vMLAMBsdHsVhu7VrYtsteA8iW6v8YJShBvA3tzaEQ6aduiHeyp+bTUY9T/rvddnihuegk4Tad6PlIrHK95pAcl0i+9deHlZwVU40GJATH8tf1JzhlK4Mgybxiyl2Zt11M2hgC14biHKAsjWHt4wCa/EWjfR/Eh9izHu5pn5SGLhcTF4zHWftfw2swfgGkaD1awlbhpsJlCLiqaL171g3QfOEzlpjVOEQAqm V2T7gWAB mQKrhwSXEUXRikDeZNuRvO+rF04OYwRSwMNgoIwHUvra0M0kw7l3PH4MOiNma/ckJtlALVyu0b2/pxRQuAWQ+1BAVypPkzcjRpx8SsvaMYGTTvepV67ac6JrgA7BIH5MlMW3h9gQAlhEpu3UQG9nw0LKhyHk5sGbRxtCzkiH0YB2AhFjM1f1AsipvOcw0YPaVVPUh/acf5Uh7Am9DnOJMRhC95O0irDQ7Yki+D04NM3f9B/rX3ivxVFKK/zXgnpvN8tZOkXBgCd9r6ng= 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: Document the intended usage of the fields. Signed-off-by: Mel Gorman --- include/linux/mm_types.h | 30 +++++++++++++++++++++++++++--- 1 file changed, 27 insertions(+), 3 deletions(-) diff --git a/include/linux/mm_types.h b/include/linux/mm_types.h index 36c5b43999e6..0fe054afc4d6 100644 --- a/include/linux/mm_types.h +++ b/include/linux/mm_types.h @@ -551,9 +551,33 @@ struct vma_lock { }; struct vma_numab_state { - unsigned long next_scan; - unsigned long next_pid_reset; - unsigned long access_pids[2]; + unsigned long next_scan; /* Initialised as time in + * jiffies after which VMA + * should be scanned. Delays + * first scan of new VMA by at + * least + * sysctl_numa_balancing_scan_delay + */ + unsigned long next_pid_reset; /* Time in jiffies when + * access_pids is reset to + * detect phase change + * behaviour. + */ + unsigned long access_pids[2]; /* Approximate tracking of PIDS + * that trapped a NUMA hinting + * fault. May produce false + * positives due to hash + * collisions. + * + * [0] Previous PID tracking + * [1] Current PID tracking + * + * Window moves after + * next_pid_reset has expired + * approximately every + * VMA_PID_RESET_PERIOD + * jiffies. + */ }; /* -- 2.35.3