2022-05-02 07:28:28

by Krzysztof Kozlowski

[permalink] [raw]
Subject: [PATCH 1/2] mailbox: correct kerneldoc

Correct kerneldoc warnings like:

drivers/mailbox/arm_mhu_db.c:47:
warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
drivers/mailbox/qcom-ipcc.c:58:
warning: Function parameter or member 'num_chans' not described in 'qcom_ipcc'

Signed-off-by: Krzysztof Kozlowski <[email protected]>
---
drivers/mailbox/arm_mhu_db.c | 2 +-
drivers/mailbox/arm_mhuv2.c | 3 ++-
drivers/mailbox/qcom-ipcc.c | 3 ++-
3 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/drivers/mailbox/arm_mhu_db.c b/drivers/mailbox/arm_mhu_db.c
index 8674153cc893..aa0a4d83880f 100644
--- a/drivers/mailbox/arm_mhu_db.c
+++ b/drivers/mailbox/arm_mhu_db.c
@@ -44,7 +44,7 @@ struct arm_mhu {
};

/**
- * ARM MHU Mailbox allocated channel information
+ * struct mhu_db_channel - ARM MHU Mailbox allocated channel information
*
* @mhu: Pointer to parent mailbox device
* @pchan: Physical channel within which this doorbell resides in
diff --git a/drivers/mailbox/arm_mhuv2.c b/drivers/mailbox/arm_mhuv2.c
index d997f8ebfa98..a47aef8df52f 100644
--- a/drivers/mailbox/arm_mhuv2.c
+++ b/drivers/mailbox/arm_mhuv2.c
@@ -160,7 +160,8 @@ enum mhuv2_frame {
* struct mhuv2 - MHUv2 mailbox controller data
*
* @mbox: Mailbox controller belonging to the MHU frame.
- * @send/recv: Base address of the register mapping region.
+ * @send: Base address of the register mapping region.
+ * @recv: Base address of the register mapping region.
* @frame: Frame type: RECEIVER_FRAME or SENDER_FRAME.
* @irq: Interrupt.
* @windows: Channel windows implemented by the platform.
diff --git a/drivers/mailbox/qcom-ipcc.c b/drivers/mailbox/qcom-ipcc.c
index c5d963222014..881706da59c0 100644
--- a/drivers/mailbox/qcom-ipcc.c
+++ b/drivers/mailbox/qcom-ipcc.c
@@ -41,9 +41,10 @@ struct qcom_ipcc_chan_info {
* @dev: Device associated with this instance
* @base: Base address of the IPCC frame associated to APSS
* @irq_domain: The irq_domain associated with this instance
- * @chan: The mailbox channels array
+ * @chans: The mailbox channels array
* @mchan: The per-mailbox channel info array
* @mbox: The mailbox controller
+ * @num_chans: Number of @chans elements
* @irq: Summary irq
*/
struct qcom_ipcc {
--
2.32.0


2022-05-03 01:33:50

by Krzysztof Kozlowski

[permalink] [raw]
Subject: [PATCH 2/2] mailbox: imx: fix duplicated initializer

rxdb field is being initialized twice:

drivers/mailbox/imx-mailbox.c:889:19: error: initialized field overwritten [-Werror=override-init]
889 | .rxdb = imx_mu_generic_rxdb,

Fixes: 315d2e562418 ("mailbox: imx: introduce rxdb callback")
Signed-off-by: Krzysztof Kozlowski <[email protected]>
---
drivers/mailbox/imx-mailbox.c | 1 -
1 file changed, 1 deletion(-)

diff --git a/drivers/mailbox/imx-mailbox.c b/drivers/mailbox/imx-mailbox.c
index e88f544a1548..df8a785be324 100644
--- a/drivers/mailbox/imx-mailbox.c
+++ b/drivers/mailbox/imx-mailbox.c
@@ -886,7 +886,6 @@ static const struct imx_mu_dcfg imx_mu_cfg_imx8ulp = {
.rx = imx_mu_generic_rx,
.rxdb = imx_mu_generic_rxdb,
.init = imx_mu_init_generic,
- .rxdb = imx_mu_generic_rxdb,
.type = IMX_MU_V2,
.xTR = 0x200,
.xRR = 0x280,
--
2.32.0

2022-05-09 08:09:26

by Peng Fan

[permalink] [raw]
Subject: RE: [PATCH 2/2] mailbox: imx: fix duplicated initializer

> Subject: [PATCH 2/2] mailbox: imx: fix duplicated initializer
>
> rxdb field is being initialized twice:
>
> drivers/mailbox/imx-mailbox.c:889:19: error: initialized field overwritten [-
> Werror=override-init]
> 889 | .rxdb = imx_mu_generic_rxdb,
>
> Fixes: 315d2e562418 ("mailbox: imx: introduce rxdb callback")
> Signed-off-by: Krzysztof Kozlowski <[email protected]>

Reviewed-by: Peng Fan <[email protected]>

> ---
> drivers/mailbox/imx-mailbox.c | 1 -
> 1 file changed, 1 deletion(-)
>
> diff --git a/drivers/mailbox/imx-mailbox.c b/drivers/mailbox/imx-mailbox.c
> index e88f544a1548..df8a785be324 100644
> --- a/drivers/mailbox/imx-mailbox.c
> +++ b/drivers/mailbox/imx-mailbox.c
> @@ -886,7 +886,6 @@ static const struct imx_mu_dcfg imx_mu_cfg_imx8ulp =
> {
> .rx = imx_mu_generic_rx,
> .rxdb = imx_mu_generic_rxdb,
> .init = imx_mu_init_generic,
> - .rxdb = imx_mu_generic_rxdb,
> .type = IMX_MU_V2,
> .xTR = 0x200,
> .xRR = 0x280,
> --
> 2.32.0


2022-05-19 09:25:45

by Krzysztof Kozlowski

[permalink] [raw]
Subject: Re: [PATCH 1/2] mailbox: correct kerneldoc

On 01/05/2022 12:34, Krzysztof Kozlowski wrote:
> Correct kerneldoc warnings like:
>
> drivers/mailbox/arm_mhu_db.c:47:
> warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
> drivers/mailbox/qcom-ipcc.c:58:
> warning: Function parameter or member 'num_chans' not described in 'qcom_ipcc'
>
> Signed-off-by: Krzysztof Kozlowski <[email protected]>

Any comments on these patches? These fix warnings and they wait for
almost three weeks to be applied...

Can we get the warnings fixed?


Best regards,
Krzysztof

2022-05-19 18:52:57

by Sudeep Holla

[permalink] [raw]
Subject: Re: [PATCH 1/2] mailbox: correct kerneldoc

On Sun, May 01, 2022 at 12:34:27PM +0200, Krzysztof Kozlowski wrote:
> Correct kerneldoc warnings like:
>
> drivers/mailbox/arm_mhu_db.c:47:
> warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
> drivers/mailbox/qcom-ipcc.c:58:
> warning: Function parameter or member 'num_chans' not described in 'qcom_ipcc'
>
> Signed-off-by: Krzysztof Kozlowski <[email protected]>
> ---
> drivers/mailbox/arm_mhu_db.c | 2 +-

I thought I had copied it from arm_mhuc.c but apparently not. Anyways,

Acked-by: Sudeep Holla <[email protected]>

--
Regards,
Sudeep

2022-05-20 08:39:31

by Viresh Kumar

[permalink] [raw]
Subject: Re: [PATCH 1/2] mailbox: correct kerneldoc

On 01-05-22, 12:34, Krzysztof Kozlowski wrote:
> Correct kerneldoc warnings like:
>
> drivers/mailbox/arm_mhu_db.c:47:
> warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
> drivers/mailbox/qcom-ipcc.c:58:
> warning: Function parameter or member 'num_chans' not described in 'qcom_ipcc'
>
> Signed-off-by: Krzysztof Kozlowski <[email protected]>
> ---
> drivers/mailbox/arm_mhu_db.c | 2 +-
> drivers/mailbox/arm_mhuv2.c | 3 ++-

Acked-by: Viresh Kumar <[email protected]>

--
viresh

2022-05-20 09:44:40

by Sudeep Holla

[permalink] [raw]
Subject: Re: [PATCH 1/2] mailbox: correct kerneldoc

On Thu, May 19, 2022 at 05:14:33PM +0200, Krzysztof Kozlowski wrote:
> On 19/05/2022 17:13, Sudeep Holla wrote:
> > On Sun, May 01, 2022 at 12:34:27PM +0200, Krzysztof Kozlowski wrote:
> >> Correct kerneldoc warnings like:
> >>
> >> drivers/mailbox/arm_mhu_db.c:47:
> >> warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
> >> drivers/mailbox/qcom-ipcc.c:58:
> >> warning: Function parameter or member 'num_chans' not described in 'qcom_ipcc'
> >>
> >> Signed-off-by: Krzysztof Kozlowski <[email protected]>
> >> ---
> >> drivers/mailbox/arm_mhu_db.c | 2 +-
> >
> > I thought I had copied it from arm_mhuc.c but apparently not. Anyways,
> >
> > Acked-by: Sudeep Holla <[email protected]>
> >
>
>
> Thanks! Could someone pick these two patches?
>

They generally go via Jassi's tree.

Hi Jassi,

There is another PCC driver fix that I had acked few weeks back. Please
pick this as well as that when you start finalising patches for your PR
for v5.19.

--
Regards,
Sudeep

2022-05-20 09:46:26

by Krzysztof Kozlowski

[permalink] [raw]
Subject: Re: [PATCH 1/2] mailbox: correct kerneldoc

On 19/05/2022 17:13, Sudeep Holla wrote:
> On Sun, May 01, 2022 at 12:34:27PM +0200, Krzysztof Kozlowski wrote:
>> Correct kerneldoc warnings like:
>>
>> drivers/mailbox/arm_mhu_db.c:47:
>> warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
>> drivers/mailbox/qcom-ipcc.c:58:
>> warning: Function parameter or member 'num_chans' not described in 'qcom_ipcc'
>>
>> Signed-off-by: Krzysztof Kozlowski <[email protected]>
>> ---
>> drivers/mailbox/arm_mhu_db.c | 2 +-
>
> I thought I had copied it from arm_mhuc.c but apparently not. Anyways,
>
> Acked-by: Sudeep Holla <[email protected]>
>


Thanks! Could someone pick these two patches?

Best regards,
Krzysztof

2022-06-20 18:45:08

by Krzysztof Kozlowski

[permalink] [raw]
Subject: Re: [PATCH 2/2] mailbox: imx: fix duplicated initializer

On 07/05/2022 08:52, Peng Fan wrote:
>> Subject: [PATCH 2/2] mailbox: imx: fix duplicated initializer
>>
>> rxdb field is being initialized twice:
>>
>> drivers/mailbox/imx-mailbox.c:889:19: error: initialized field overwritten [-
>> Werror=override-init]
>> 889 | .rxdb = imx_mu_generic_rxdb,
>>
>> Fixes: 315d2e562418 ("mailbox: imx: introduce rxdb callback")
>> Signed-off-by: Krzysztof Kozlowski <[email protected]>
>
> Reviewed-by: Peng Fan <[email protected]>

Thanks for the review. This was a month ago... Anyone willing to pick it up?


Best regards,
Krzysztof

2022-06-20 20:49:25

by Jassi Brar

[permalink] [raw]
Subject: Re: [PATCH 2/2] mailbox: imx: fix duplicated initializer

On Mon, Jun 20, 2022 at 1:39 PM Krzysztof Kozlowski
<[email protected]> wrote:
>
> On 07/05/2022 08:52, Peng Fan wrote:
> >> Subject: [PATCH 2/2] mailbox: imx: fix duplicated initializer
> >>
> >> rxdb field is being initialized twice:
> >>
> >> drivers/mailbox/imx-mailbox.c:889:19: error: initialized field overwritten [-
> >> Werror=override-init]
> >> 889 | .rxdb = imx_mu_generic_rxdb,
> >>
> >> Fixes: 315d2e562418 ("mailbox: imx: introduce rxdb callback")
> >> Signed-off-by: Krzysztof Kozlowski <[email protected]>
> >
> > Reviewed-by: Peng Fan <[email protected]>
>
> Thanks for the review. This was a month ago... Anyone willing to pick it up?
>
There was a predated fix, which was picked.

https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/drivers/mailbox?id=262190a8ca2b1e1ec75b8a4f1c7f07e585facd6f

Thanks.