Received-SPF: pass (google.com: domain of linux-kernel+bounces-1571-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) client-ip=147.75.199.223;
From: Thomas Gleixner <tglx@linutronix.de>
To: wangxiaoming321 <xiaoming.wang@intel.com>, peterz@infradead.org,
 linux-kernel@vger.kernel.org
Cc: wangxiaoming321 <xiaoming.wang@intel.com>
Subject: Re: [PATCH] kernel/cpu: The number of CPUHP_AP_ONLINE_DYN (30) is
 too small that stops the new dynamic states hotplug.
In-Reply-To: <20231212025235.775986-1-xiaoming.wang@intel.com>
References: <20231212025235.775986-1-xiaoming.wang@intel.com>
Date: Fri, 15 Dec 2023 20:39:47 +0100
Message-ID: <87o7ermf0c.ffs@tglx>
Precedence: bulk
MIME-Version: 1.0
Content-Type: text/plain

On Tue, Dec 12 2023 at 10:52, wangxiaoming321 wrote:

The subject line has a two issues:

    1) the prefix is wrong. See
       https://www.kernel.org/doc/html/latest/process/maintainer-tip.html#patch-subject

       You find further information about changelogs there and in other
       parts of the documentation

    2) The sentence is too long and incomprehensible.

> 144: perf/x86/cstate:online
  ...
> 195: online

I have no idea what this number salad is trying to tell me. Changelogs
need to explain the problem they are trying to solve. This listing of
hotplug states is not an explanation and completely useless as it even
contains an entry which do not exist:

> 191: ia64/sep5:online

Even if it would exist a ia64 hotplug callback is hardly relevant on x86,
right?

Also the fixed entries e.g. workqueue and RCU/tree are irrelevant for
what you are trying to describe.

So what you really want to say is something like this:

   cpu/hotplug: Increase the number of dynamic states

   The dynamically allocatable hotplug state space can be exhausted by
   the existing drivers and infrastructure which install CPU hotplug
   states dynamically. That prevents new drivers and infrastructure from
   installing dynamically allocated states.

   Increase the size of the CPUHP_AP_ONLINE_DYN state by 10 to make
   room.

At least that's what I oracled out of your "changelog". Hmm?

Thanks,

        tglx