All of lore.kernel.org
 help / color / mirror / Atom feed
From: Simon Horman <horms@kernel.org>
To: Ethan Nelson-Moore <enelsonmoore@gmail.com>
Cc: netdev@vger.kernel.org, linux-usb@vger.kernel.org,
	Andrew Lunn <andrew+netdev@lunn.ch>,
	"David S. Miller" <davem@davemloft.net>,
	Eric Dumazet <edumazet@google.com>,
	Jakub Kicinski <kuba@kernel.org>, Paolo Abeni <pabeni@redhat.com>,
	Peter Korsgaard <peter@korsgaard.com>
Subject: Re: [PATCH net-next] net: usb: sr9700: fix byte numbering in comments
Date: Thu, 15 Jan 2026 17:36:59 +0000	[thread overview]
Message-ID: <aWklu0EwMbINC6T0@horms.kernel.org> (raw)
In-Reply-To: <20260113075327.85435-1-enelsonmoore@gmail.com>

On Mon, Jan 12, 2026 at 11:53:21PM -0800, Ethan Nelson-Moore wrote:
> The comments describing the RX/TX headers and status response use
> a combination of 0- and 1-based indexing, leading to confusion. Correct
> the numbering and make it consistent. Also fix a typo "pm" for "pn".
> 
> This issue also existed in dm9601 and was fixed in commit 61189c78bda8
> ("dm9601: trivial comment fixes").
> 
> Signed-off-by: Ethan Nelson-Moore <enelsonmoore@gmail.com>

Thanks,

I agree this is consistent with the cited commit.

Reviewed-by: Simon Horman <horms@kernel.org>

Context left below for the benefit of Peter who I've added to the CC list.

> ---
>  drivers/net/usb/sr9700.c | 42 ++++++++++++++++++++--------------------
>  1 file changed, 21 insertions(+), 21 deletions(-)
> 
> diff --git a/drivers/net/usb/sr9700.c b/drivers/net/usb/sr9700.c
> index 820c4c506979..bd90ac40acdd 100644
> --- a/drivers/net/usb/sr9700.c
> +++ b/drivers/net/usb/sr9700.c
> @@ -391,20 +391,20 @@ static int sr9700_rx_fixup(struct usbnet *dev, struct sk_buff *skb)
>  	int len;
>  
>  	/* skb content (packets) format :
> -	 *                    p0            p1            p2    ......    pm
> +	 *                    p1            p2            p3    ......    pn
>  	 *                 /      \
>  	 *            /                \
>  	 *        /                            \
>  	 *  /                                        \
> -	 * p0b0 p0b1 p0b2 p0b3 ...... p0b(n-4) p0b(n-3)...p0bn
> +	 * p1b1 p1b2 p1b3 p1b4 ...... p1b(n-4) p1b(n-3)...p1bn
>  	 *
> -	 * p0 : packet 0
> -	 * p0b0 : packet 0 byte 0
> +	 * p1 : packet 1
> +	 * p1b1 : packet 1 byte 1
>  	 *
> -	 * b0: rx status
> -	 * b1: packet length (incl crc) low
> -	 * b2: packet length (incl crc) high
> -	 * b3..n-4: packet data
> +	 * b1: rx status
> +	 * b2: packet length (incl crc) low
> +	 * b3: packet length (incl crc) high
> +	 * b4..n-4: packet data
>  	 * bn-3..bn: ethernet packet crc
>  	 */
>  	if (unlikely(skb->len < SR_RX_OVERHEAD)) {
> @@ -452,12 +452,12 @@ static struct sk_buff *sr9700_tx_fixup(struct usbnet *dev, struct sk_buff *skb,
>  
>  	/* SR9700 can only send out one ethernet packet at once.
>  	 *
> -	 * b0 b1 b2 b3 ...... b(n-4) b(n-3)...bn
> +	 * b1 b2 b3 b4 ...... b(n-4) b(n-3)...bn
>  	 *
> -	 * b0: rx status
> -	 * b1: packet length (incl crc) low
> -	 * b2: packet length (incl crc) high
> -	 * b3..n-4: packet data
> +	 * b1: rx status
> +	 * b2: packet length (incl crc) low
> +	 * b3: packet length (incl crc) high
> +	 * b4..n-4: packet data
>  	 * bn-3..bn: ethernet packet crc
>  	 */
>  
> @@ -488,14 +488,14 @@ static void sr9700_status(struct usbnet *dev, struct urb *urb)
>  	u8 *buf;
>  
>  	/* format:
> -	   b0: net status
> -	   b1: tx status 1
> -	   b2: tx status 2
> -	   b3: rx status
> -	   b4: rx overflow
> -	   b5: rx count
> -	   b6: tx count
> -	   b7: gpr
> +	   b1: net status
> +	   b2: tx status 1
> +	   b3: tx status 2
> +	   b4: rx status
> +	   b5: rx overflow
> +	   b6: rx count
> +	   b7: tx count
> +	   b8: gpr
>  	*/
>  
>  	if (urb->actual_length < 8)
> -- 
> 2.43.0
> 
> 

  reply	other threads:[~2026-01-15 17:37 UTC|newest]

Thread overview: 4+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-01-13  7:53 [PATCH net-next] net: usb: sr9700: fix byte numbering in comments Ethan Nelson-Moore
2026-01-15 17:36 ` Simon Horman [this message]
2026-01-15 20:22   ` Peter Korsgaard
2026-01-16  3:50 ` patchwork-bot+netdevbpf

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=aWklu0EwMbINC6T0@horms.kernel.org \
    --to=horms@kernel.org \
    --cc=andrew+netdev@lunn.ch \
    --cc=davem@davemloft.net \
    --cc=edumazet@google.com \
    --cc=enelsonmoore@gmail.com \
    --cc=kuba@kernel.org \
    --cc=linux-usb@vger.kernel.org \
    --cc=netdev@vger.kernel.org \
    --cc=pabeni@redhat.com \
    --cc=peter@korsgaard.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.