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: 13090913 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 D8697C4708D for ; Fri, 6 Jan 2023 03:49:21 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 3FE048E0002; Thu, 5 Jan 2023 22:49:21 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 3AE208E0001; Thu, 5 Jan 2023 22:49:21 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 2763F8E0002; Thu, 5 Jan 2023 22:49:21 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0016.hostedemail.com [216.40.44.16]) by kanga.kvack.org (Postfix) with ESMTP id 1AB5F8E0001 for ; Thu, 5 Jan 2023 22:49:21 -0500 (EST) Received: from smtpin27.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay05.hostedemail.com (Postfix) with ESMTP id E517840183 for ; Fri, 6 Jan 2023 03:49:20 +0000 (UTC) X-FDA: 80322994080.27.6081BFA Received: from mail-pj1-f42.google.com (mail-pj1-f42.google.com [209.85.216.42]) by imf25.hostedemail.com (Postfix) with ESMTP id 47711A0009 for ; Fri, 6 Jan 2023 03:49:18 +0000 (UTC) Authentication-Results: imf25.hostedemail.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=UiHZc4xP; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (imf25.hostedemail.com: domain of bagasdotme@gmail.com designates 209.85.216.42 as permitted sender) smtp.mailfrom=bagasdotme@gmail.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1672976958; 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:references:dkim-signature; bh=fekH72sui9GdebDgVNk2XaNYCf3hMj26CpPd65HWWNo=; b=kz8IJKu1m5B3T0k0uTPjSJWdRYinUuK3W6lTlGVcUA1Ic+8ny9MbrBIvUszKf1z3XyDJqu 31R06oFhqweW7c02Js2Jjr6HN12BdUi18ojMsokuh6ZfE4ldLnrXsaKozTvf0rsNPas47y HWbs1yT4b77g5rQCnNvwRYccQcl65bY= ARC-Authentication-Results: i=1; imf25.hostedemail.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=UiHZc4xP; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (imf25.hostedemail.com: domain of bagasdotme@gmail.com designates 209.85.216.42 as permitted sender) smtp.mailfrom=bagasdotme@gmail.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1672976958; a=rsa-sha256; cv=none; b=vDfJQkPIvkUyJKG24kBMH7nW42XA01X8PMvsS1UGDkxsq4hrKnPbunUugJle7a4Q+Y84Ro jDCJuvnV4cQ4jYVWG05F0Yqx7xC2kWSiXuuKKLG2CV5PrCykUkeEGyxABgxr+Chy+I7qwP 0xlDUPQwF4Ht/PDPcFItmqrBcmiI6Z8= Received: by mail-pj1-f42.google.com with SMTP id o7-20020a17090a0a0700b00226c9b82c3aso494697pjo.3 for ; Thu, 05 Jan 2023 19:49:18 -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=J/o2iOAPDZ1U7g8iMfMRbWsWyNDJd50BqECkX1ycDrTQO/+/vRqLDYF/RM3rnhOesW Obkw2NENFRb4wcoMKDOsTLKZVejrJsMb+H4I3oLReZQfASa0mQo0uoKe9hfB0hxBYDVS FY43OAIH3qjTqiC5Ob6kYZaNAixvgOZdL6KXtwCl7xz0Dx3CoEsy5kIEQQBsc9qPNz6t pIRa6To3cL41cQBOZC1JRjSMRRtfDer0d48KQjBzf6j6xUHf1zmIpRY+unjYyxKCva1p NO8GadYsPwwrkggrfPo1jAp4Qpz7stJbMlF5No+q672dYzrDShtpPakYlsH+5DSgJhEB KliQ== X-Gm-Message-State: AFqh2krQMihsBzKNuCUmGWmgie45buntO46/9i3nTt82vdGOcYI2QCfP Tw1xzUkRCsA+Wr3wfqY9DPc= X-Google-Smtp-Source: AMrXdXvyVCK1lhieVWDdWnx9fCexwUkj+hwmFDv22Gy18g2mIEKegCTvNB6j6O9x6ZyNW6FTQLfyhg== 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-Rspamd-Queue-Id: 47711A0009 X-Rspamd-Server: rspam09 X-Rspam-User: X-Stat-Signature: mjoxxu1cgrswfto7i1wyt5s4c8tkdaza X-HE-Tag: 1672976958-111049 X-HE-Meta: U2FsdGVkX1/o20Cohn2CnC7cBiakmBSa7csT9XswemCMfzntsBkiEfZwiIZsKqvRVtBiuK31hBkZ72IxadiIi0AM49lbviQIJiXOAr7WabXtAtkHuUr4WBpJwZyjKBABgP/EsIFhp0gSChKVNBJFUl00sWgIK1jxtMBqwt7Bc4oihy8pb5h8CiupvcJKdNWPw4C5PnQqggAs6GbnVSOvWb1eyBmomzN2cqGf/0WxjFoTe3tXjpXii40k5z0I5UsbBybYwAiMqVNB30APM7+3TN5sz/uUw2SolOeBNqQ+st7wDNNy+Po90ejADZEn4wBS/td2q0JmaC4MZykABQTuchk1G94EN8Z1wk85h/NFZvSmx+aR1ifGFXhaprngsVBqK69kqMbcat3e+JQqupi3s9VOlytl/OqmMsvwLCUJhplLh/j/98/MIGdGEIFq5BBTeylZcv0Kh22TWzrxiWEv+3Sq6uoizuaMFfEMYI+24L6SDlT6CyhqAcQpA56ZfTYrUlESMuAkD5T9FlRZnCWpuqyQEqXWv3Zrps3yR3ereXargFR54ueCfn05QSixGJUr4hLwtyc1O7HPZOHKKEudQ+Ef5lh9bcO2MhzPalc4cyI5Y3lreWBpq2u80eG5IjO5pwVvO9tdtm2lsZIHWhwY3y31arn0fn5wvb/eeyw8cX5bkxbJ62Fo/2sDtPGPeskhYCOC3L7SNvsvP1ZRyG1qR1V+67e7hm0Bdxp9h3hQuirL9QCC36Ke8ls/4ph6ghRLgz9wuG5QIRKEX1/II8RwnkSJ+vOfq8SH/dNaFIO6Wpqw99DjkKgtXkynzi9NqRViikU1YDJLVI4Lfdt0GJbok6xvumkH8ViDwYjvxCwHn2ecpciHxaVPJleOth04MXUhCCL2VdkxSB5g2t/eDl3AbIGqBYmMLWRmX3S4H/rI9iKrs8THLoQaCG/ojrxU/CqqjsMEs+s+MLqE88CmrH4 EO6bSpbV TEwnAjkmFVgvNpaJCYFd8bqqs1Dub8lc58QNvcuI/UsUjxixSWOToSINvjlIof2FUOop+9stjDN304Deah2jRlxDcwKtgz4wK3yT6lT/6r0gm10jkTR5xzIMnxlP8brpIlWn/ 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: 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.