Re: [PATCH] tty: serial: Introduce uart_tx_stoppped_or_empty()

From: Andrey Smirnov
Date: Tue Aug 06 2019 - 21:20:22 EST


On Mon, Aug 5, 2019 at 11:48 PM Andy Shevchenko
<andy.shevchenko@xxxxxxxxx> wrote:
>
> On Mon, Aug 5, 2019 at 10:36 PM Andrey Smirnov <andrew.smirnov@xxxxxxxxx> wrote:
> >
> > The vast majority of the serial drivers check for
> >
> > uart_tx_stopped(&p->port) || uart_circ_empty(xmit)
> >
> > condition one or more times. Create a dedicated helper function and
> > convert drivers to use it.
>
> Sometimes the arguments are swapped. It means that in case of first
> being false the second is aslo going to be checked.
> So, does ordering have any side effect?
>
> Please, elaborate this in the commit message.
>

Neither uart_tx_stopped() nor uart_circ_empty() should have any side
effects. I also didn't see any comments indicating that ordering is
important. Is that enough of a justification?

> > drivers/tty/serial/8250/8250_dma.c | 2 +-
> > drivers/tty/serial/8250/8250_omap.c | 7 +++----
> > drivers/tty/serial/sc16is7xx.c | 2 +-
>
> For the drivers I care about (see above) I prefer to see conversion on
> per driver basis. Of course, if Greg is okay with the current, I won't
> object.

I am more than happy to split this any way necessary.

>
> > - if (uart_tx_stopped(&up->port) ||
> > - uart_circ_empty(&up->port.state->xmit)) {
> > + if (uart_tx_stopped_or_empty(&up->port)) {
>
> Yes, it becomes one line, but...
>
> > - if (!(dmacr & UART011_TXDMAE) || uart_tx_stopped(&uap->port) ||
> > - uart_circ_empty(&uap->port.state->xmit)) {
> > + if (!(dmacr & UART011_TXDMAE) ||
> > + uart_tx_stopped_or_empty(&uap->port)) {
>
> ...wouldn't be the case here as well? And perhaps in other places?

Hmm, not sure I am reading this comment right. Are we talking purely
about formatting here? If we are, yeah, I probably can make this into
a single line. Not sure if there any other places like that,
sirfsoc_uart.c perhaps?

Thanks,
Andrey Smirnov