| Message ID | 20240502210038.11480-2-wsa+renesas@sang-engineering.com (mailing list archive) |
|---|---|
| State | New |
| Headers | show |
| Series | fpga: use 'time_left' instead of 'timeout' with wait_for_*() functions | expand |
On Thu, May 02, 2024 at 11:00:36PM +0200, Wolfram Sang wrote: Sorry for late reply. First of all, please limit your subject/shortlog/summary within 70 chars. > There is a confusing pattern in the kernel to use a variable named 'timeout' to Please make the changelog line wrapped at less than 75 chars. > store the result of wait_for_completion_interruptible_timeout() causing patterns like: > > timeout = wait_for_completion_interruptible_timeout(...) > if (!timeout) return -ETIMEDOUT; > > with all kinds of permutations. Use 'time_left' as a variable to make the code > self explaining. > > Fix to the proper variable type 'long' while here. > > Signed-off-by: Wolfram Sang <wsa+renesas@sang-engineering.com> > --- > drivers/fpga/socfpga.c | 7 ++++--- > 1 file changed, 4 insertions(+), 3 deletions(-) > > diff --git a/drivers/fpga/socfpga.c b/drivers/fpga/socfpga.c > index 723ea0ad3f09..b08b4bb8f650 100644 > --- a/drivers/fpga/socfpga.c > +++ b/drivers/fpga/socfpga.c > @@ -301,16 +301,17 @@ static irqreturn_t socfpga_fpga_isr(int irq, void *dev_id) > > static int socfpga_fpga_wait_for_config_done(struct socfpga_fpga_priv *priv) > { > - int timeout, ret = 0; > + int ret = 0; > + long time_left; Please use reverse xmas tree when it is easy to follow. The code change is good to me. Thanks, Yilun > > socfpga_fpga_disable_irqs(priv); > init_completion(&priv->status_complete); > socfpga_fpga_enable_irqs(priv, SOCFPGA_FPGMGR_MON_CONF_DONE); > > - timeout = wait_for_completion_interruptible_timeout( > + time_left = wait_for_completion_interruptible_timeout( > &priv->status_complete, > msecs_to_jiffies(10)); > - if (timeout == 0) > + if (time_left == 0) > ret = -ETIMEDOUT; > > socfpga_fpga_disable_irqs(priv); > -- > 2.43.0 > >
Hi Yilun, > Sorry for late reply. No worries, thank you for the review. > First of all, please limit your subject/shortlog/summary within 70 > chars. I'll try but it will be hard when it contains such a long function name. > > There is a confusing pattern in the kernel to use a variable named 'timeout' to > > Please make the changelog line wrapped at less than 75 chars. Good point. My scripts reformat generated paragraphs now accordingly. > > + int ret = 0; > > + long time_left; > > Please use reverse xmas tree when it is easy to follow. Will fix. All the best, Wolfram
On Thu, Jun 20, 2024 at 12:21:10PM +0200, Wolfram Sang wrote: > Hi Yilun, > > > Sorry for late reply. > > No worries, thank you for the review. > > > First of all, please limit your subject/shortlog/summary within 70 > > chars. > > I'll try but it will be hard when it contains such a long function name. You don't have to include the funtion name. The code change itself explains. Thanks, Yilun > > > > There is a confusing pattern in the kernel to use a variable named 'timeout' to > > > > Please make the changelog line wrapped at less than 75 chars. > > Good point. My scripts reformat generated paragraphs now accordingly. > > > > + int ret = 0; > > > + long time_left; > > > > Please use reverse xmas tree when it is easy to follow. > > Will fix. > > All the best, > > Wolfram >
diff --git a/drivers/fpga/socfpga.c b/drivers/fpga/socfpga.c index 723ea0ad3f09..b08b4bb8f650 100644 --- a/drivers/fpga/socfpga.c +++ b/drivers/fpga/socfpga.c @@ -301,16 +301,17 @@ static irqreturn_t socfpga_fpga_isr(int irq, void *dev_id) static int socfpga_fpga_wait_for_config_done(struct socfpga_fpga_priv *priv) { - int timeout, ret = 0; + int ret = 0; + long time_left; socfpga_fpga_disable_irqs(priv); init_completion(&priv->status_complete); socfpga_fpga_enable_irqs(priv, SOCFPGA_FPGMGR_MON_CONF_DONE); - timeout = wait_for_completion_interruptible_timeout( + time_left = wait_for_completion_interruptible_timeout( &priv->status_complete, msecs_to_jiffies(10)); - if (timeout == 0) + if (time_left == 0) ret = -ETIMEDOUT; socfpga_fpga_disable_irqs(priv);
There is a confusing pattern in the kernel to use a variable named 'timeout' to store the result of wait_for_completion_interruptible_timeout() causing patterns like: timeout = wait_for_completion_interruptible_timeout(...) if (!timeout) return -ETIMEDOUT; with all kinds of permutations. Use 'time_left' as a variable to make the code self explaining. Fix to the proper variable type 'long' while here. Signed-off-by: Wolfram Sang <wsa+renesas@sang-engineering.com> --- drivers/fpga/socfpga.c | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-)