From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752942AbdJaMKB (ORCPT ); Tue, 31 Oct 2017 08:10:01 -0400 Received: from terminus.zytor.com ([65.50.211.136]:36211 "EHLO terminus.zytor.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751050AbdJaMJ7 (ORCPT ); Tue, 31 Oct 2017 08:09:59 -0400 Date: Tue, 31 Oct 2017 05:05:06 -0700 From: tip-bot for Frederic Weisbecker Message-ID: Cc: cmetcalf@mellanox.com, kernellwp@gmail.com, hpa@zytor.com, torvalds@linux-foundation.org, riel@redhat.com, peterz@infradead.org, paulmck@linux.vnet.ibm.com, tglx@linutronix.de, cl@linux.com, efault@gmx.de, lcapitulino@redhat.com, frederic@kernel.org, linux-kernel@vger.kernel.org, mingo@kernel.org Reply-To: torvalds@linux-foundation.org, riel@redhat.com, tglx@linutronix.de, peterz@infradead.org, paulmck@linux.vnet.ibm.com, cmetcalf@mellanox.com, kernellwp@gmail.com, hpa@zytor.com, frederic@kernel.org, mingo@kernel.org, linux-kernel@vger.kernel.org, cl@linux.com, lcapitulino@redhat.com, efault@gmx.de In-Reply-To: <1509419914-16179-1-git-send-email-frederic@kernel.org> References: <1509419914-16179-1-git-send-email-frederic@kernel.org> To: linux-tip-commits@vger.kernel.org Subject: [tip:sched/core] sched/isolation: Document isolcpus= boot parameter flags, mark it deprecated Git-Commit-ID: b0d40d2b22fe48cfcbbfb137fd198be0a1cd8a85 X-Mailer: tip-git-log-daemon Robot-ID: Robot-Unsubscribe: Contact to get blacklisted from these emails MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain; charset=UTF-8 Content-Disposition: inline Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Commit-ID: b0d40d2b22fe48cfcbbfb137fd198be0a1cd8a85 Gitweb: https://git.kernel.org/tip/b0d40d2b22fe48cfcbbfb137fd198be0a1cd8a85 Author: Frederic Weisbecker AuthorDate: Tue, 31 Oct 2017 04:18:34 +0100 Committer: Ingo Molnar CommitDate: Tue, 31 Oct 2017 10:29:39 +0100 sched/isolation: Document isolcpus= boot parameter flags, mark it deprecated Document the latest updates on the isolcpus= boot option. While at it, let's also fix the details about the preferred way to isolate a set of CPUs from the scheduler general domains. Cpusets offer a much better interface to achieve that. Signed-off-by: Frederic Weisbecker Acked-by: Thomas Gleixner Acked-by: Peter Zijlstra Cc: Chris Metcalf Cc: Christoph Lameter Cc: Linus Torvalds Cc: Luiz Capitulino Cc: Mike Galbraith Cc: Paul E. McKenney Cc: Rik van Riel Cc: Wanpeng Li Link: http://lkml.kernel.org/r/1509419914-16179-1-git-send-email-frederic@kernel.org [ Clarified the text some more, marked the boot option deprecated. ] Signed-off-by: Ingo Molnar --- Documentation/admin-guide/kernel-parameters.txt | 39 ++++++++++++++++--------- 1 file changed, 26 insertions(+), 13 deletions(-) diff --git a/Documentation/admin-guide/kernel-parameters.txt b/Documentation/admin-guide/kernel-parameters.txt index 6b99c8b..17eb023 100644 --- a/Documentation/admin-guide/kernel-parameters.txt +++ b/Documentation/admin-guide/kernel-parameters.txt @@ -1727,20 +1727,33 @@ isapnp= [ISAPNP] Format: ,,, - isolcpus= [KNL,SMP] Isolate CPUs from the general scheduler. - The argument is a cpu list, as described above. + isolcpus= [KNL,SMP] Isolate a given set of CPUs from disturbance. + [Deprecated - use cpusets instead] + Format: [flag-list,] + + Specify one or more CPUs to isolate from disturbances + specified in the flag list (default: domain): + + nohz + Disable the tick when a single task runs. + domain + Isolate from the general SMP balancing and scheduling + algorithms. Note that performing domain isolation this way + is irreversible: it's not possible to bring back a CPU to + the domains once isolated through isolcpus. It's strongly + advised to use cpusets instead to disable scheduler load + balancing through the "cpuset.sched_load_balance" file. + It offers a much more flexible interface where CPUs can + move in and out of an isolated set anytime. + + You can move a process onto or off an "isolated" CPU via + the CPU affinity syscalls or cpuset. + begins at 0 and the maximum value is + "number of CPUs in system - 1". + + The format of is described above. + - This option can be used to specify one or more CPUs - to isolate from the general SMP balancing and scheduling - algorithms. You can move a process onto or off an - "isolated" CPU via the CPU affinity syscalls or cpuset. - begins at 0 and the maximum value is - "number of CPUs in system - 1". - - This option is the preferred way to isolate CPUs. The - alternative -- manually setting the CPU mask of all - tasks in the system -- can cause problems and - suboptimal load balancer performance. iucv= [HW,NET]