From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-ed1-f49.google.com (mail-ed1-f49.google.com [209.85.208.49]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id C24643F928E for ; Fri, 26 Jun 2026 16:24:44 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.208.49 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1782491086; cv=none; b=t7rURHU2SNMDM0ddHzmlLEw5BPK+MKiiTuOO1so064qgP91nQeWUYxknMyg8gWcldgvtg44m+kxJ/7B/5bApX7QEjSZYifcMDx0ZFIopGgo7I/louAd9zEdrwCYK+hA0kml+P8hzsWKy3q2tGFws83GT9imSn52wHc1yX1cMjjc= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1782491086; c=relaxed/simple; bh=ZDpTKXUJtSOCn0iOJVPzDGA8hH0ROrYolCqzrG/2UN4=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=n7qhdRIrjx+MLUXeawbt6Fg+GLeGVPHH+ECcwfC48mkox2PbPUZvcIETQj8lUMaCFfDdV/6cnxbV28/X4wIBpNPo0LXzr7/5hb4SB5A+Ow2GhVs0Ndt0X1Rc+LJ8vpKP5JYeeZLxdhITyI7TbJgjPe7o0Rekw+uwDqHJLCePjRs= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=suse.com; spf=pass smtp.mailfrom=suse.com; dkim=pass (2048-bit key) header.d=suse.com header.i=@suse.com header.b=fGPDYMfL; arc=none smtp.client-ip=209.85.208.49 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=suse.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=suse.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=suse.com header.i=@suse.com header.b="fGPDYMfL" Received: by mail-ed1-f49.google.com with SMTP id 4fb4d7f45d1cf-695f6438518so1661124a12.0 for ; Fri, 26 Jun 2026 09:24:44 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=google; t=1782491083; x=1783095883; darn=vger.kernel.org; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:from:to:cc:subject:date:message-id:reply-to; bh=tzLgbGGQbfhbvqh4cQgksDurGIAgQkr1YelLIUbVC08=; b=fGPDYMfL1bzfulPPFs02OXkeK34Wlo1+I1jEZUOk5RndOXBGGc+4vTo9H/6RPPs8PT sNANVZWHb8xK2S4+TAX2c1bnnRpf62IvNLXrXvpRcxEdpEgPvDvmVY61K7MaB/Do9+FN LKuFtGCgHu5/ckRSNaohDqElBmUyHv5rUXLctjE6EChd4rgY+NHHUnL2ApSmNP39pHlK MrL2t8B2kPS1PujnMjr8UIEr1wZ9z5LGtnkCIusItvsPZY8pylHM2w0RfGWQz+P+16Td f0X4kWPvrAPdmdNkQUzkukdphK4ByrpR/yftwMfPRICIzjl4y5WtFMsGPuYI3LJm9Ctb 3RaQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1782491083; x=1783095883; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:x-gm-gg:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=tzLgbGGQbfhbvqh4cQgksDurGIAgQkr1YelLIUbVC08=; b=ofhf86RncmD5rl8UPw22SEnto0tqMlFj+ibpwsBCxoUFW5wsMdylWn5OniBmztNewF QwQlfExH9qh3URRjOXX/GrpbCCGMUQUO+KcK6fwqjFr/rnJClh/bdtoAU/rVVgBb2PmC hOUj4mWBkUEOj4yNynD1f5FJLmmSEy/u/GIzESnzFSQiDzDyhaNwArl7F4cIZyYJLJd6 mEnDkNE6IdSJH1j/B6WzH084g1hUBfLJ+h0sZvlj4m2AdCwgsj2kR4cZE5tp5cpB3ija 9XuUdi8zTPMHYIVy0eSWFjgYgCOsz+T+4GC6h7fbC6qExG8QXvFjJGVo5R3M/yoNitpZ JwQg== X-Forwarded-Encrypted: i=1; AHgh+Rpy+SRUDqOwknu+ZUBKwDQuvwpY1FMjvqmvGoU3kIceI5lH2BTllDGwppzOJRLT5quMHF4KrTUaauY=@vger.kernel.org X-Gm-Message-State: AOJu0YyDDcvQUNheyFYrFIwrmGUa4jhPMt+RK+hcvmMhKjaZY9gRdcPe 2fOaThGXSqo3Tsnmdj7DuqP5KRjMk0Ad6Z4OxW9J4HkJVCxQn+uZyFnIJe44Jj4LUFM= X-Gm-Gg: AfdE7cmHSY3IUXBpQWFkX4l0a42tHpkZNfzyBWZL2IaTaqDhDo7hkVb4nNKQpszoBo5 IOyj3kOTt7/sV+gDYPzTUzRnx/RqyR/kfxXfh6FbvwOpxfZ1525OkCdSmy33BDfm8PVDwh9mFN8 KjKRaMsl03zzvp9gtFsqbFwybm+5X1WnKZpWiFM3nu4hjtYCWX+jdUEueSRoDwRTBouYQoiPPUK g7pkN+baR1hcBseW/H/3zd5DK+BkpijVFC5LHqRqU4va8PRQ2ailL6/7mpYeNMqWqYS3a1Q/udX Cun2xfE/I/rbc2R5RfONyHpRqCOduJwm75WQdY/l54jYV9IrxLYxSz586QkbPN7PvIFBC+BgmmY s1wDIarOOq7qJUOGuRtzLPNnxGNA2svP4AroR4tO7LyOV9X5e7izp3NxEDlF/r/NDp58mlagJFM 80GbohTGOqTtFcHWfiHg== X-Received: by 2002:a17:907:9308:b0:c08:713e:d8b2 with SMTP id a640c23a62f3a-c1205eb8b71mr494966966b.25.1782491083080; Fri, 26 Jun 2026 09:24:43 -0700 (PDT) Received: from localhost.localdomain ([62.77.90.70]) by smtp.gmail.com with ESMTPSA id a640c23a62f3a-c11fbbaa46asm365418766b.10.2026.06.26.09.24.42 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 26 Jun 2026 09:24:42 -0700 (PDT) Date: Fri, 26 Jun 2026 18:24:40 +0200 From: Michal =?utf-8?Q?Koutn=C3=BD?= To: Sun Shaojie Cc: cui.tao@linux.dev, Tejun Heo , Johannes Weiner , Jonathan Corbet , Shuah Khan , cgroups@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH v2] cgroup/cpu: document cpu.stat.local Message-ID: References: <20260626010914.1154495-1-sunshaojie@kylinos.cn> Precedence: bulk X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="opqipnw7zmxxqkyc" Content-Disposition: inline In-Reply-To: <20260626010914.1154495-1-sunshaojie@kylinos.cn> --opqipnw7zmxxqkyc Content-Type: text/plain; protected-headers=v1; charset=us-ascii Content-Disposition: inline Subject: Re: [PATCH v2] cgroup/cpu: document cpu.stat.local MIME-Version: 1.0 Hi. On Fri, Jun 26, 2026 at 09:09:14AM +0800, Sun Shaojie wrote: > + cpu.stat.local > + A read-only flat-keyed file. > + This file exists whether the controller is enabled or not. > + > + It reports the following stat when the controller is enabled: > + > + - throttled_usec > + > + Unlike the ``throttled_usec`` reported by ``cpu.stat`` which > + accounts for throttling caused by this cgroup's own CFS > + bandwidth limit, ``cpu.stat.local`` reports the actual > + throttling time incurred by this cgroup's own runqueues, > + which may include throttling inherited from ancestor > + cgroup bandwidth limits. > + > + When the controller is not enabled, this stat is not reported. I like that you contrast this to regular cpu.stat and implicitly explain that cpu.stat is not hierarchical. Here I think it's been such so long that it's not worth changing (also it's less useful than existing metrics for diagnostics). Hence would you also update the cpu.stat paragraph about the non-hierarchical values? Thanks, Michal --opqipnw7zmxxqkyc Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iJEEABYKADkWIQRCE24Fn/AcRjnLivR+PQLnlNv4CAUCaj6nwxsUgAAAAAAEAA5t YW51MiwyLjUrMS4xMiwyLDIACgkQfj0C55Tb+AhFgAD/XEcVugLyyou/TK3tUc5F ZkEPGtRFL0h0sCS/DI9icUkBAJ6LorKFQRUDq3uwRK3WH0mlxofp3zGNicQgdouy 18kK =iDl8 -----END PGP SIGNATURE----- --opqipnw7zmxxqkyc--