staging: vt6656: change function from always returning 0 to void
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
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
@@ -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
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
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_sleepvnt_mac_reg_bits_onvnt_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.
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_sleepvnt_mac_reg_bits_onvnt_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
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_sleepvnt_mac_reg_bits_onvnt_mac_reg_bits_offI 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
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_sleepvnt_mac_reg_bits_onvnt_mac_reg_bits_offI 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
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_sleepvnt_mac_reg_bits_onvnt_mac_reg_bits_offI 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 forvnt_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.
Greg Kroah-Hartman
maintainerRe: [PATCH 1/2] staging: vt6656: remove unneeded variable: ret
In reply to John WyattQuoted 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_sleepvnt_mac_reg_bits_onvnt_mac_reg_bits_offI 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
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_sleepvnt_mac_reg_bits_onvnt_mac_reg_bits_offI 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. :)
PATCH 2/2 staging: vt6656: change unused int return value to void
In reply to John B. Wyatt IVChange 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
@@ -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
@@ -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
@@ -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
Fold these two patches together so its just one patch.
regards,
dan carpenter