Skip to contentSkip to conversation

staging: vt6656: change function from always returning 0 to void

PATCH In review John B. Wyatt IV 5 participants 12 messages Mar 24, 2020 – Mar 30, 2020 Staging

lore
Share & tools
lore
#0 lore raw

cover staging: vt6656: change function from always returning 0 to void

Change vnt_radio_power_on from always returning 0 to void.

The first patch in this series was originally submitted as a standalone patch. Greg Kroah-Hartman <[email protected]> suggested more changes to be made into a patchset.

John B. Wyatt IV (2):
staging: vt6656: remove unneeded variable: ret
staging: vt6656: change unused int return value to void

 drivers/staging/vt6656/card.c     | 9 ++-------
 drivers/staging/vt6656/card.h     | 2 +-
 drivers/staging/vt6656/main_usb.c | 4 +---
 3 files changed, 4 insertions(+), 11 deletions(-)
Signature · 1 line
2.25.1
#1 lore raw

PATCH 1/2 staging: vt6656: remove unneeded variable: ret

Remove unneeded variable ret; replace with 0 for the return value.

Update function documentation (comment) on the return status as suggested by Julia Lawall <[email protected]>.

Issue reported by coccinelle (coccicheck).

---
 drivers/staging/vt6656/card.c | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)
drivers/staging/vt6656/card.c +2 -4
index dc3ab10eb630..05b57a2489a0 100644
@@ -716,13 +716,11 @@ int vnt_radio_power_off(struct vnt_private *priv)
  *  Out:
  *      none
  *
- * Return Value: true if success; otherwise false
+ * Return Value: 0
  *
  */
 int vnt_radio_power_on(struct vnt_private *priv)
 {
-	int ret = 0;
-
 	vnt_exit_deep_sleep(priv);
 
 	vnt_mac_reg_bits_on(priv, MAC_REG_HOSTCR, HOSTCR_RXON);
@@ -741,7 +739,7 @@ int vnt_radio_power_on(struct vnt_private *priv)
 
 	vnt_mac_reg_bits_off(priv, MAC_REG_GPIOCTL1, GPIO3_INTMD);
 
-	return ret;
+	return 0;
 }
 
 void vnt_set_bss_mode(struct vnt_private *priv)
Signature · 1 line
2.25.1
#2 lore raw

Re: [PATCH 1/2] staging: vt6656: remove unneeded variable: ret

Quoted 1 line · John B. Wyatt IV

vnt_mac_reg_bits_off(priv, MAC_REG_GPIOCTL1, GPIO3_INTMD);

This function, and all the functions called in vnt_radio_power_on() returns a value, why don't you catch it and act accordingly (forward error code for example) instead of silencing it?

Thanks,
Quentin

author
#3 lore raw

Re: [PATCH 1/2] staging: vt6656: remove unneeded variable: ret

Quoted 7 lines · Quentin Deslandes
Quoted 1 line · John B. Wyatt IV

vnt_mac_reg_bits_off(priv, MAC_REG_GPIOCTL1, GPIO3_INTMD);

This function, and all the functions called in vnt_radio_power_on() returns
a value, why don't you catch it and act accordingly (forward error code

Hi Quentin,

I do not know what these functions do.

There is no function documentation for:
vnt_exit_deep_sleep
vnt_mac_reg_bits_on
vnt_mac_reg_bits_off

I am a new kernel developer intern with the Outreachy program. I am trying to fix a style issue reported by Coccinelle. I do not have that much experience with writing drivers yet.

I have CC'ed the developers listed by git blame + the outreachy mentors.

(Rithvik Patibandla's name shows up for one of the functions, but the email is not listed by get_maintainer.)

Please advise.

#4 lore raw

Re: [PATCH 1/2] staging: vt6656: remove unneeded variable: ret

Quoted 6 lines · John Wyatt

I do not know what these functions do.

There is no function documentation for:
vnt_exit_deep_sleep
vnt_mac_reg_bits_on
vnt_mac_reg_bits_off

I understand, however discarding the return value of functions that could fail is not the best thing to do. Whatever those 3 functions are doing, you should rely on their return code, and if one of those fail, vnt_radio_power_on() should fail too.

Quoted 3 lines

I am a new kernel developer intern with the Outreachy program. I am trying to fix a style issue reported by Coccinelle. I do not have that much experience with writing drivers yet.

Don't worry, I'm not that experienced either. If my request is out of scope for an Outreachy mentee, a more experienced contributor will pop in the discussion.

Thanks,
Quentin

author
#5 lore raw

Re: [PATCH 1/2] staging: vt6656: remove unneeded variable: ret

Quoted 20 lines · Quentin Deslandes
Quoted 6 lines · John Wyatt

I do not know what these functions do.

There is no function documentation for:
vnt_exit_deep_sleep
vnt_mac_reg_bits_on
vnt_mac_reg_bits_off

I understand, however discarding the return value of functions that could
fail is not the best thing to do. Whatever those 3 functions are doing,
you should rely on their return code, and if one of those fail, vnt_radio_power_on() should fail too.

Quoted 4 lines

I am a new kernel developer intern with the Outreachy program. I am trying to fix a style issue reported by Coccinelle. I do not have that
much experience with writing drivers yet.

Quoted 4 lines

Don't worry, I'm not that experienced either. If my request is out of scope for an Outreachy mentee, a more experienced contributor will pop
in the discussion.

To any of the Outreachy mentors please advise on what to do.

I was asked by Greg Kroah-Hartman to make this patch set, but Quentin Deslandes asked to return undocumented return codes for this patch to solve this coccinelle issue.

Thank you,
John

#6 lore raw

Re: [Outreachy kernel] Re: [PATCH 1/2] staging: vt6656: remove unneeded variable: ret

Hi John,

Quoted 26 lines · On Thu, 26 Mar 2020 16:26:13 -0700 John Wyatt <[email protected]> wrote:
Quoted 20 lines · Quentin Deslandes
Quoted 6 lines · John Wyatt

I do not know what these functions do.

There is no function documentation for:
vnt_exit_deep_sleep
vnt_mac_reg_bits_on
vnt_mac_reg_bits_off

I understand, however discarding the return value of functions that could
fail is not the best thing to do. Whatever those 3 functions are doing,
you should rely on their return code, and if one of those fail, vnt_radio_power_on() should fail too.

Quoted 4 lines

I am a new kernel developer intern with the Outreachy program. I am trying to fix a style issue reported by Coccinelle. I do not have that
much experience with writing drivers yet.

Quoted 4 lines

Don't worry, I'm not that experienced either. If my request is out of scope for an Outreachy mentee, a more experienced contributor will pop
in the discussion.

Quoted 5 lines

To any of the Outreachy mentors please advise on what to do.

I was asked by Greg Kroah-Hartman to make this patch set, but Quentin Deslandes asked to return undocumented return codes for this patch to solve this coccinelle issue.

Strictly speaking, those are documented: C code (especially in kernel) is supposed to be self-documenting, and if you follow the call path (example for vnt_mac_reg_bits_off()) you'll find out that, eventually, you might get -EINVAL (not going to actually happen), -ENOMEM, -EIO (the only likely one, on communication error).

If you forward those return codes as Quentin suggested, those are handled properly by the callers, so I would say that's the way to go.

Signature · 1 line
Stefano
author
#7 lore raw

Re: [Outreachy kernel] Re: [PATCH 1/2] staging: vt6656: remove unneeded variable: ret

Quoted 52 lines · Stefano Brivio

Hi John,

Quoted 31 lines · On Thu, 26 Mar 2020 16:26:13 -0700 John Wyatt <[email protected]> wrote:
Quoted 23 lines · Quentin Deslandes
Quoted 6 lines · John Wyatt

I do not know what these functions do.

There is no function documentation for:
vnt_exit_deep_sleep
vnt_mac_reg_bits_on
vnt_mac_reg_bits_off

I understand, however discarding the return value of functions that
could
fail is not the best thing to do. Whatever those 3 functions are doing,
you should rely on their return code, and if one of those fail, vnt_radio_power_on() should fail too.

Quoted 6 lines

I am a new kernel developer intern with the Outreachy program. I am
trying to fix a style issue reported by Coccinelle. I do not have
that
much experience with writing drivers yet.

Quoted 6 lines

Don't worry, I'm not that experienced either. If my request is out of
scope for an Outreachy mentee, a more experienced contributor will
pop
in the discussion.

Quoted 7 lines

To any of the Outreachy mentors please advise on what to do.

I was asked by Greg Kroah-Hartman to make this patch set, but Quentin
Deslandes asked to return undocumented return codes for this patch to
solve this coccinelle issue.

Strictly speaking, those are documented: C code (especially in kernel)
is supposed to be self-documenting, and if you follow the call path (example for vnt_mac_reg_bits_off()) you'll find out that, eventually,
you might get -EINVAL (not going to actually happen), -ENOMEM, -EIO (the only likely one, on communication error).

Quoted 3 lines

If you forward those return codes as Quentin suggested, those are handled properly by the callers, so I would say that's the way to go.

Understood, will do.

Thank you Stefano. :)

Edit: forgot to CC mailing list.

#8 lore raw

Re: [PATCH 1/2] staging: vt6656: remove unneeded variable: ret

In reply to John Wyatt
Quoted 26 lines · John Wyatt
Quoted 20 lines · Quentin Deslandes
Quoted 6 lines · John Wyatt

I do not know what these functions do.

There is no function documentation for:
vnt_exit_deep_sleep
vnt_mac_reg_bits_on
vnt_mac_reg_bits_off

I understand, however discarding the return value of functions that could
fail is not the best thing to do. Whatever those 3 functions are doing,
you should rely on their return code, and if one of those fail, vnt_radio_power_on() should fail too.

Quoted 4 lines

I am a new kernel developer intern with the Outreachy program. I am trying to fix a style issue reported by Coccinelle. I do not have that
much experience with writing drivers yet.

Quoted 4 lines

Don't worry, I'm not that experienced either. If my request is out of scope for an Outreachy mentee, a more experienced contributor will pop
in the discussion.

Quoted 5 lines

To any of the Outreachy mentors please advise on what to do.

I was asked by Greg Kroah-Hartman to make this patch set, but Quentin Deslandes asked to return undocumented return codes for this patch to solve this coccinelle issue.

What do you mean by "undocumented return codes"? Just pick an error value that you think matches what went wrong and try that. Worst thing is we review the patch and tell you to pick a different one :)

thanks,

greg k-h

author
#9 lore raw

Re: [PATCH 1/2] staging: vt6656: remove unneeded variable: ret

Quoted 34 lines · Greg Kroah-Hartman
Quoted 33 lines · John Wyatt
Quoted 23 lines · Quentin Deslandes
Quoted 6 lines · John Wyatt

I do not know what these functions do.

There is no function documentation for:
vnt_exit_deep_sleep
vnt_mac_reg_bits_on
vnt_mac_reg_bits_off

I understand, however discarding the return value of functions that
could
fail is not the best thing to do. Whatever those 3 functions are doing,
you should rely on their return code, and if one of those fail, vnt_radio_power_on() should fail too.

Quoted 6 lines

I am a new kernel developer intern with the Outreachy program. I am
trying to fix a style issue reported by Coccinelle. I do not have
that
much experience with writing drivers yet.

Quoted 6 lines

Don't worry, I'm not that experienced either. If my request is out of
scope for an Outreachy mentee, a more experienced contributor will
pop
in the discussion.

To any of the Outreachy mentors please advise on what to do.

Quoted 7 lines
Quoted 5 lines

I was asked by Greg Kroah-Hartman to make this patch set, but Quentin
Deslandes asked to return undocumented return codes for this patch to
solve this coccinelle issue.

What do you mean by "undocumented return codes"?

No function comments like the one that I originally changed in the first patch.

Quoted 2 lines

Just pick an error
value that you think matches what went wrong and try that.

I guess I thought it was more complicated than that. Stefano's explanation helped me understand it.

Quoted 3 lines

Worst thing
is we review the patch and tell you to pick a different one :)

Ideally I would like to minimize that. :)

#10 lore raw

PATCH 2/2 staging: vt6656: change unused int return value to void

In reply to John B. Wyatt IV

Change unused int function return value to void from previous patch.

Update function documentation to remove mention of return value.

Remove if statement check of the only usage of function in the kernel. Replace with calling the function.

---
 drivers/staging/vt6656/card.c     | 7 ++-----
 drivers/staging/vt6656/card.h     | 2 +-
 drivers/staging/vt6656/main_usb.c | 4 +---
 3 files changed, 4 insertions(+), 9 deletions(-)
drivers/staging/vt6656/card.c +2 -5
index 05b57a2489a0..4be7fca32796 100644
@@ -715,11 +715,8 @@ int vnt_radio_power_off(struct vnt_private *priv)
  *      priv         - The adapter to be turned on
  *  Out:
  *      none
- *
- * Return Value: 0
- *
  */
-int vnt_radio_power_on(struct vnt_private *priv)
+void vnt_radio_power_on(struct vnt_private *priv)
 {
 	vnt_exit_deep_sleep(priv);
 
@@ -739,7 +736,7 @@ int vnt_radio_power_on(struct vnt_private *priv)
 
 	vnt_mac_reg_bits_off(priv, MAC_REG_GPIOCTL1, GPIO3_INTMD);
 
-	return 0;
+	return;
 }
 
 void vnt_set_bss_mode(struct vnt_private *priv)
drivers/staging/vt6656/card.h +1 -1
index 75cd340c0cce..fcab6b086e71 100644
@@ -40,7 +40,7 @@ void vnt_update_next_tbtt(struct vnt_private *priv, u64 tsf,
 u64 vnt_get_next_tbtt(u64 tsf, u16 beacon_interval);
 u64 vnt_get_tsf_offset(u8 rx_rate, u64 tsf1, u64 tsf2);
 int vnt_radio_power_off(struct vnt_private *priv);
-int vnt_radio_power_on(struct vnt_private *priv);
+void vnt_radio_power_on(struct vnt_private *priv);
 u8 vnt_get_pkt_type(struct vnt_private *priv);
 void vnt_set_bss_mode(struct vnt_private *priv);
 
drivers/staging/vt6656/main_usb.c +1 -3
index 8e7269c87ea9..8214427f5ee3 100644
@@ -370,9 +370,7 @@ static int vnt_init_registers(struct vnt_private *priv)
 	if (ret)
 		goto end;
 
-	ret = vnt_radio_power_on(priv);
-	if (ret)
-		goto end;
+	vnt_radio_power_on(priv);
 
 	dev_dbg(&priv->usb->dev, "<----INIbInitAdapter Exit\n");
 
Signature · 1 line
2.25.1