From patchwork Fri Jan 6 03:48:37 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bagas Sanjaya X-Patchwork-Id: 39932 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:4e01:0:0:0:0:0 with SMTP id p1csp625384wrt; Thu, 5 Jan 2023 19:59:58 -0800 (PST) X-Google-Smtp-Source: AMrXdXu+O0scqB9mpXEV0uGwX3rJrSs2sBu0opWP1GHBngftUZl4X6s7/gJFiIoL6pMC9hV4irEd X-Received: by 2002:a17:907:6746:b0:836:e7de:9792 with SMTP id qm6-20020a170907674600b00836e7de9792mr31971274ejc.32.1672977598667; Thu, 05 Jan 2023 19:59:58 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1672977598; cv=none; d=google.com; s=arc-20160816; b=Bd6rghaSxi0thO/8+ETCGZFo0T9xV3A0UhTSegBKpOLU8c9htm/L9ZMEgTJuzo5eY0 qR0l4XnWcPv/xC2twZjmmexWUfDCTMFaFXmLcmIuwBRNyDRYvQdQ4Q6rv4JEqCwEEXR1 8Qz8M5F8PGuZ1c0SKRsyNdtgMTiD3nD2wHGxPzfFn6jbzREdVKf+8yWOvO/ElOsgXok2 lh+CW0Si3rdj/3Lr8+jS9n4bKWnXqhb5aLrJ9LMJ1uFVKVoA2IIQAwJa2ymYEDg+Hj85 wrd0zMowh+YAKZNrR+YRUyj1UzeMVwtAFMUNi4semy6K6Oda1XjQ4d7qfn5pkfQKcap8 QMFA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from:dkim-signature; bh=fekH72sui9GdebDgVNk2XaNYCf3hMj26CpPd65HWWNo=; b=aJ6AEDk2hAVh34XZHdmYATgP+iOKD0j1FLx+dA9lMl9vB8AXbHZP/gIDgLwyF7KOpl CHc16aW3lGB2x1R1V3zE3j+U5D+DR3Frp9E825756PeRJcKeZY6e8kZ2OhH1PhEgnUdc oX9xCDf3uJqAysl5PsZh2SSwmen4n6ze000BTkheh/cZn9aDYVt5o7BJdhJbWXNDTrSn fjMBEFkq/tEiIYIaMn7j1VL7yjSUuKBlCaK0SQK5ax8NAYBRH3Von6s77IJINc8fklHq 3c/P2aEaNlnemia35BdwAKxreb2Uv6faGb3oHxW9lr1pnUSYZRRd+v1m2PsUJ7LVu3eu oE6g== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20210112 header.b=UiHZc4xP; 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=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id bb8-20020a1709070a0800b0077945c44b7fsi33729561ejc.856.2023.01.05.19.59.35; Thu, 05 Jan 2023 19:59:58 -0800 (PST) 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=@gmail.com header.s=20210112 header.b=UiHZc4xP; 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=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230074AbjAFDtV (ORCPT + 99 others); Thu, 5 Jan 2023 22:49:21 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:48030 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229509AbjAFDtS (ORCPT ); Thu, 5 Jan 2023 22:49:18 -0500 Received: from mail-pl1-x62e.google.com (mail-pl1-x62e.google.com [IPv6:2607:f8b0:4864:20::62e]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 9A979B4A8; Thu, 5 Jan 2023 19:49:17 -0800 (PST) Received: by mail-pl1-x62e.google.com with SMTP id d15so470043pls.6; Thu, 05 Jan 2023 19:49:17 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=fekH72sui9GdebDgVNk2XaNYCf3hMj26CpPd65HWWNo=; b=UiHZc4xPgz9riLMU7jZRFdpYBA/tSzUNwC2BWiIfW76JQV7qvDnZ5YFgaBwl9muFhb nAkOig3bzP5SUcRFGALvqIyPdhKwyNXxWrdL9D84b0uOtZaZPFbVrf5kQzVd/o7OBkXu z6f2FNtKYhJqWr/Xndmg2e/SuFt9Fy/yogCm8unBMDoDabAFe+n8z4lp47ALzRkkQCSZ oxmtpgTEH7TmsJjYV1pYx4dJ90trVyNrmkZGKcXoBVSNzk42OHhEXYxdFGiQEkojlIfy SzRBhKd/owMzJFmNo5AZZdxNmsCZtH2WIhpIGtVELwEteObfco0sQVwvAoyw3CcOcJba 2t0w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=fekH72sui9GdebDgVNk2XaNYCf3hMj26CpPd65HWWNo=; b=NMLSNz75dYFn0jr6RFwnhrRRGoKyxbcQAKJhHaP1Au3F6FcxqaH8huM9JIu8mepkku ZgKBs/VEPxCDsBN/6PocjLv/9EEqHyOOQ2xO5ryvPmc30fXrJOZ3uZlRK/fEpcEzXq7D oR49+XxCIiquQchygm6wawuVzSyreyvcZOaYTzdEeX1muLcA4OgigAC3PMS056ruuYec pirMV1nBgsVNHxiqnhr/wMKLil511p65Y625f4y1ax7Su3MyLivYVik1ZbDj8Ll4aL5O 0mpwuZKw1zIhAno5Pu64FVKtnzgGRCbTnDSMBct/LYaG0Ee7IiRmvOz4eF5AiREzh37Q x1Ag== X-Gm-Message-State: AFqh2kpbtCt7QCi3H20JhbFq7SXtLsCyNF7YlGY9FGHMUwnumx3IBz8L A/3Tf/yaq6xwOxj3+Kt0pBo= X-Received: by 2002:a17:902:edc3:b0:189:5ef4:6ae9 with SMTP id q3-20020a170902edc300b001895ef46ae9mr52366814plk.45.1672976955660; Thu, 05 Jan 2023 19:49:15 -0800 (PST) Received: from debian.me (subs32-116-206-28-2.three.co.id. [116.206.28.2]) by smtp.gmail.com with ESMTPSA id d22-20020a170902aa9600b00189c93ce5easm26648752plr.166.2023.01.05.19.49.15 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 05 Jan 2023 19:49:15 -0800 (PST) Received: by debian.me (Postfix, from userid 1000) id 5D52F104FE7; Fri, 6 Jan 2023 10:49:11 +0700 (WIB) From: Bagas Sanjaya To: Linux CGroups , Linux Documentation , LKML , Linux Memory Management List Cc: Tejun Heo , Zefan Li , Johannes Weiner , Jonathan Corbet , Michal Hocko , Andrew Morton , Hugh Dickins , Shakeel Butt , Bagas Sanjaya Subject: [PATCH] docs: cgroup-v1: wrap charge moving deprecation in warning block Date: Fri, 6 Jan 2023 10:48:37 +0700 Message-Id: <20230106034836.23708-1-bagasdotme@gmail.com> X-Mailer: git-send-email 2.39.0 MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1985; i=bagasdotme@gmail.com; h=from:subject; bh=KgCM3g5FsiytA4vmbQIOX+Rd86PUGBjozHPoOarnvsU=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDMnbZwnsfhJW03XnxmSRtsDcZWFZB88eW7hWrdvL9bXnM5+Z d5av7ShlYRDjYpAVU2SZlMjXdHqXkciF9rWOMHNYmUCGMHBxCsBENJ4y/He4lXBqP09p/boMlhvr/y 585c/It8Tzxvk+4yxNVfa3K8MZGb5oOmfr2SyO3zdhwoR9+hn7BQ8yvnZceueQmbWi7I2NxXwA X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D X-Spam-Status: No, score=-0.6 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM, RCVD_IN_DNSWL_NONE,RCVD_IN_SORBS_WEB,SPF_HELO_NONE,SPF_PASS autolearn=no 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?1754244158772965908?= X-GMAIL-MSGID: =?utf-8?q?1754244158772965908?= Commit 4ddb1a2aa1a3c4 ("docs: cgroup-v1: wrap remaining admonitions in admonition blocks") in cgroups tree states that it also wraps charge moving deprecation notice in admonition block (specifically warning). However, the notice isn't in cgroups tree when the v2 of formatting improv series [1] is submitted (and then applied), but rather in mm tree instead. Wrap the notice to fulfill the intention of referred commit. Link: https://lore.kernel.org/linux-doc/20230105131633.553574-1-bagasdotme@gmail.com/ # [1] Signed-off-by: Bagas Sanjaya --- Documentation/admin-guide/cgroup-v1/memory.rst | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) base-commit: dd5c3ba990ae67409bc058051efcd40c3689d01d diff --git a/Documentation/admin-guide/cgroup-v1/memory.rst b/Documentation/admin-guide/cgroup-v1/memory.rst index 258e45cc3b2db1..b73eb174735556 100644 --- a/Documentation/admin-guide/cgroup-v1/memory.rst +++ b/Documentation/admin-guide/cgroup-v1/memory.rst @@ -722,12 +722,14 @@ NOTE2: 8. Move charges at task migration (DEPRECATED!) =============================================== -THIS IS DEPRECATED! +.. warning:: -It's expensive and unreliable! It's better practice to launch workload -tasks directly from inside their target cgroup. Use dedicated workload -cgroups to allow fine-grained policy adjustments without having to -move physical pages between control domains. + THIS IS DEPRECATED! + + It's expensive and unreliable! It's better practice to launch workload + tasks directly from inside their target cgroup. Use dedicated workload + cgroups to allow fine-grained policy adjustments without having to + move physical pages between control domains. Users can move charges associated with a task along with task migration, that is, uncharge task's pages from the old cgroup and charge them to the new cgroup.