From patchwork Wed Apr 19 12:50:15 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peter Newman X-Patchwork-Id: 85398 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:b0ea:0:b0:3b6:4342:cba0 with SMTP id b10csp370657vqo; Wed, 19 Apr 2023 06:04:45 -0700 (PDT) X-Google-Smtp-Source: AKy350ZnGxB0x0fipIJWXui3Dgkk8RY6DikyWdVglAIN1/wJPgof0BX0Ahs4sFQxlr5x80Xb0u8x X-Received: by 2002:a05:6a00:2316:b0:63d:4756:6e9a with SMTP id h22-20020a056a00231600b0063d47566e9amr3798571pfh.27.1681909485177; Wed, 19 Apr 2023 06:04:45 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1681909485; cv=none; d=google.com; s=arc-20160816; b=LKciAxXkep03F0lnFgXDzNvbZBO721s/MDSGgsGl+3qmfNKb+5jpzwWeM/UpzXP/Xt 5Z1ch2duwfw/rWMh/+fXlC81dFKzHOzUiRvIb8TNwK2r8Z0e5s9B14ygJy4EqoJXjRIG tjIvU9YjajRuEKxh/e6ig01nOWVFdeZx64Dt+yzF6DeF2b/4TBlrHvl9AGTwaUhYlUft sUmKIUIrGv8d0EGhNe3ceanHwu1zW7QWiNiaYmc1CReexj285OnNs8TtTku1/sqYydwQ EsxVXMF+IIJduuIi7i/mE3tXe/os1Mkoxf0znR4tAfyePBSf9sHt55dzSk4IxPh2m/Lh mQQw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:cc:to:from:subject:message-id:references :mime-version:in-reply-to:date:dkim-signature; bh=qxACaIFQGSNpRzNrd0szUQtmVWzyEP8n7N2A/6ory1w=; b=Szeh4SkOXQW8t0uLdUXRTltFQ7kFf47bCF5zaWfdnrQ5GZDkEM+wx5ludM9ujkif4k 93B5BotsmwtwVB1ZFha75o4hQvULZvcdsT4QWFEX7GF6BdBdss7FmtZKP/JtxL5voN1B M0G7OxkTT3c7uix99941IJEvesWYTeZTpl+L+GiUIE836pOwk4qI2eUu8zgyScvX8QMb OF73y0OE5V8bvYGWE41kSoaU3pnx9eQPwRBCyXBdOSOjTDUAGk2mgKWwLhxvPAndEIfX T0SodcLPNx8nllPfJ6iChVaXX14DC0t67JI4eiZt9YK7wQ+jEsGOsjpwdudQgdUFGSMs FKSQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@google.com header.s=20221208 header.b=f8BJoFC7; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=google.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id w71-20020a63824a000000b0051f869d7089si1754494pgd.74.2023.04.19.06.04.32; Wed, 19 Apr 2023 06:04:45 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@google.com header.s=20221208 header.b=f8BJoFC7; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=google.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233285AbjDSMvH (ORCPT + 99 others); Wed, 19 Apr 2023 08:51:07 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:34506 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233181AbjDSMu7 (ORCPT ); Wed, 19 Apr 2023 08:50:59 -0400 Received: from mail-yw1-x114a.google.com (mail-yw1-x114a.google.com [IPv6:2607:f8b0:4864:20::114a]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 83CA1B76B for ; Wed, 19 Apr 2023 05:50:47 -0700 (PDT) Received: by mail-yw1-x114a.google.com with SMTP id 00721157ae682-54f8b46f399so196280237b3.10 for ; Wed, 19 Apr 2023 05:50:47 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20221208; t=1681908646; x=1684500646; h=cc:to:from:subject:message-id:references:mime-version:in-reply-to :date:from:to:cc:subject:date:message-id:reply-to; bh=qxACaIFQGSNpRzNrd0szUQtmVWzyEP8n7N2A/6ory1w=; b=f8BJoFC7tHMQtMMZnfHw8I7h0dvExKxzjkvC1CMzEqKyAmbkh0GKgpFLaAWbEVpRjA KwfORX59VwoQc9As8pK/qPW6dAwLa0GNz5YGckzd2SxjJAB+WusEdU5iE9hLk6K40ddH ewr//TybzLFRVfXLg43mMTSXfIThG52oMVeKsfCAnfnBfKGzuikbe8QyrRSsxmhsBMhm Tbuqw/GX+fnSmwH6+sk1ehjQgOV2M7TStxE5Cu6h1H1Xnn+tKVwb/Ft/TycpMOP5gvgD Lee6Gl6yu5sPMpAHI7kNDmwgdQYDFy1pHTXuYqKuSGsxnu1+HBkxrkyzN37oY0dSXHWK 9vOg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1681908646; x=1684500646; h=cc:to:from:subject:message-id:references:mime-version:in-reply-to :date:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=qxACaIFQGSNpRzNrd0szUQtmVWzyEP8n7N2A/6ory1w=; b=DVK7ovFmHkKEFkZpN6u/ZbehZQL9OlVhwSP9a7hCgvzk954WrkJaNRfENPS92V7NGn tAJr3LgM2QC9tMooxtWd2uLcCu4zi8TQxu03yjGdAX+ABbc9KD8ZjdGS2RBqY87jIpJV 6HcntZIY3OFvYqT9Gn4PqMMqd6He36kBtwj1hXWu71TSvm0USQyNTWceD2hsWlXPxjUW pKceL2DUzgZ3KZf/c8wnSsyJK2OTgqkkTXpPAT+aF22b1VkqV/c+2xH586Yx/zWnpECt Ea+bPb6kLZnXZpnZacytwxKr455LpRpo8jSpdDWYGba55wxctUw60rGfgZRLo30BXfla s/ZQ== X-Gm-Message-State: AAQBX9dn0WW74qmxiiQu/uztr3lt3JA5WL07KdC62SkclGi4t2izS4Qp syhTkOR/CHYf1/jdGG1gnCxhOfSstKy9ngdGJA== X-Received: from peternewman0.zrh.corp.google.com ([2a00:79e0:9d:6:b36e:a25e:826d:b66a]) (user=peternewman job=sendgmr) by 2002:a25:d256:0:b0:b95:6caa:a2cb with SMTP id j83-20020a25d256000000b00b956caaa2cbmr3621411ybg.10.1681908646729; Wed, 19 Apr 2023 05:50:46 -0700 (PDT) Date: Wed, 19 Apr 2023 14:50:15 +0200 In-Reply-To: <20230419125015.693566-1-peternewman@google.com> Mime-Version: 1.0 References: <20230419125015.693566-1-peternewman@google.com> X-Mailer: git-send-email 2.40.0.634.g4ca3ef3211-goog Message-ID: <20230419125015.693566-4-peternewman@google.com> Subject: [PATCH v6 3/3] Documentation/x86: Documentation for MON group move feature From: Peter Newman To: fenghua.yu@intel.com, reinette.chatre@intel.com Cc: Babu.Moger@amd.com, bp@alien8.de, dave.hansen@linux.intel.com, eranian@google.com, gupasani@google.com, hpa@zytor.com, james.morse@arm.com, linux-kernel@vger.kernel.org, mingo@redhat.com, skodak@google.com, tglx@linutronix.de, tony.luck@intel.com, x86@kernel.org, Peter Newman X-Spam-Status: No, score=-9.6 required=5.0 tests=BAYES_00,DKIMWL_WL_MED, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_NONE, SPF_HELO_NONE,SPF_PASS,T_SCC_BODY_TEXT_LINE,USER_IN_DEF_DKIM_WL autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1763609920205103995?= X-GMAIL-MSGID: =?utf-8?q?1763609920205103995?= Describe new support for moving MON groups to a new parent CTRL_MON group and its restrictions. Signed-off-by: Peter Newman Reviewed-by: Reinette Chatre --- Documentation/x86/resctrl.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/Documentation/x86/resctrl.rst b/Documentation/x86/resctrl.rst index 387ccbcb558f..cb05d90111b4 100644 --- a/Documentation/x86/resctrl.rst +++ b/Documentation/x86/resctrl.rst @@ -287,6 +287,13 @@ Removing a directory will move all tasks and cpus owned by the group it represents to the parent. Removing one of the created CTRL_MON groups will automatically remove all MON groups below it. +Moving MON group directories to a new parent CTRL_MON group is supported +for the purpose of changing the resource allocations of a MON group +without impacting its monitoring data or assigned tasks. This operation +is not allowed for MON groups which monitor CPUs. No other move +operation is currently allowed other than simply renaming a CTRL_MON or +MON group. + All groups contain the following files: "tasks":