Re: [PATCH] docs: core-api/printk-formats.rst: Clarify formatting {cpu,node}mask

From: Andy Shevchenko
Date: Wed Nov 11 2020 - 11:47:29 EST


On Wed, Nov 11, 2020 at 04:29:33PM +0100, Petr Mladek wrote:
> On Tue 2020-11-10 15:41:21, Geert Uytterhoeven wrote:
> > Clarify how to pass the field width for bitmaps, and mention the helper
> > macros that are available to ease printing cpumask and nodemask.

...

> %*pb 0779
> %*pbl 0,3-6,8-10
>
> For printing bitmap and its derivatives such as cpumask and nodemask.
>
> It takes two arguments, see '*'. The first argument defines the number
> of bits in the mask. The second argument points to the mask.
>
> %*pb outputs the bitmap as a hex number. If the size is bigger than 32-bit
> then 32-bit values are separated by a comma.
>
> %*pbl outputs the bitmap as a range list.
>
> The number of bits is passed by value. The mask is passed by reference.

It can be improved at least by replacing mask with bitmap here.

> Helper macros cpumask_pr_args() and nodemask_pr_args() are available to
> ease printing cpumask and nodemask.

--
With Best Regards,
Andy Shevchenko