diff mbox series

[RESEND,net-next] net: tcp: replace the document for "lsndtime" in tcp_sock

Message ID 20241030113108.2277758-1-dongml2@chinatelecom.cn (mailing list archive)
State Superseded
Delegated to: Netdev Maintainers
Headers show
Series [RESEND,net-next] net: tcp: replace the document for "lsndtime" in tcp_sock | expand

Checks

Context Check Description
netdev/series_format success Single patches do not need cover letters
netdev/tree_selection success Clearly marked for net-next, async
netdev/ynl success Generated files up to date; no warnings/errors; no diff in generated;
netdev/fixes_present success Fixes tag not required for -next series
netdev/header_inline success No static functions without inline keyword in header files
netdev/build_32bit success Errors and warnings before: 16 this patch: 16
netdev/build_tools success Errors and warnings before: 0 (+0) this patch: 0 (+0)
netdev/cc_maintainers success CCed 6 of 6 maintainers
netdev/build_clang success Errors and warnings before: 27 this patch: 27
netdev/verify_signedoff success Signed-off-by tag matches author and committer
netdev/deprecated_api success None detected
netdev/check_selftest success No net selftest shell script
netdev/verify_fixes success Fixes tag looks correct
netdev/build_allmodconfig_warn success Errors and warnings before: 2066 this patch: 2066
netdev/checkpatch warning WARNING: From:/Signed-off-by: email address mismatch: 'From: Menglong Dong <menglong8.dong@gmail.com>' != 'Signed-off-by: Menglong Dong <dongml2@chinatelecom.cn>' WARNING: line length of 93 exceeds 80 columns
netdev/build_clang_rust success No Rust files in patch. Skipping build
netdev/kdoc success Errors and warnings before: 2 this patch: 2
netdev/source_inline success Was 0 now: 0
netdev/contest success net-next-2024-11-03--21-00 (tests: 781)

Commit Message

Menglong Dong Oct. 30, 2024, 11:31 a.m. UTC
The document for "lsndtime" in struct tcp_sock is placed in the wrong
place, so let's replace it in the proper place.

Fixes: d5fed5addb2b ("tcp: reorganize tcp_sock fast path variables")
Signed-off-by: Menglong Dong <dongml2@chinatelecom.cn>
---
 include/linux/tcp.h | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

Comments

Jakub Kicinski Nov. 3, 2024, 11:27 p.m. UTC | #1
On Wed, 30 Oct 2024 19:31:08 +0800 Menglong Dong wrote:
> Fixes: d5fed5addb2b ("tcp: reorganize tcp_sock fast path variables")

Fixes is for bug fixes. Please drop the fixes tag and add a normal text
reference like:

Commit d5fed5addb2b ("tcp: reorganize tcp_sock fast path variables")
moved the fields around and misplaced the documentation for "lsndtime".
Xuan Zhuo Nov. 4, 2024, 5:35 a.m. UTC | #2
On Wed, 30 Oct 2024 19:31:08 +0800, Menglong Dong <menglong8.dong@gmail.com> wrote:
> The document for "lsndtime" in struct tcp_sock is placed in the wrong
> place, so let's replace it in the proper place.
>
> Fixes: d5fed5addb2b ("tcp: reorganize tcp_sock fast path variables")
> Signed-off-by: Menglong Dong <dongml2@chinatelecom.cn>

Reviewed-by: Xuan Zhuo <xuanzhuo@linux.alibaba.com>


> ---
>  include/linux/tcp.h | 3 +--
>  1 file changed, 1 insertion(+), 2 deletions(-)
>
> diff --git a/include/linux/tcp.h b/include/linux/tcp.h
> index 6a5e08b937b3..f88daaa76d83 100644
> --- a/include/linux/tcp.h
> +++ b/include/linux/tcp.h
> @@ -200,7 +200,6 @@ struct tcp_sock {
>
>  	/* TX read-mostly hotpath cache lines */
>  	__cacheline_group_begin(tcp_sock_read_tx);
> -	/* timestamp of last sent data packet (for restart window) */
>  	u32	max_window;	/* Maximal window ever seen from peer	*/
>  	u32	rcv_ssthresh;	/* Current window clamp			*/
>  	u32	reordering;	/* Packet reordering metric.		*/
> @@ -263,7 +262,7 @@ struct tcp_sock {
>  	u32	chrono_stat[3];	/* Time in jiffies for chrono_stat stats */
>  	u32	write_seq;	/* Tail(+1) of data held in tcp send buffer */
>  	u32	pushed_seq;	/* Last pushed seq, required to talk to windows */
> -	u32	lsndtime;
> +	u32	lsndtime;	/* timestamp of last sent data packet (for restart window) */
>  	u32	mdev_us;	/* medium deviation			*/
>  	u32	rtt_seq;	/* sequence number to update rttvar	*/
>  	u64	tcp_wstamp_ns;	/* departure time for next sent data packet */
> --
> 2.39.5
>
>
Menglong Dong Nov. 4, 2024, 6:17 a.m. UTC | #3
On Mon, Nov 4, 2024 at 7:27 AM Jakub Kicinski <kuba@kernel.org> wrote:
>
> On Wed, 30 Oct 2024 19:31:08 +0800 Menglong Dong wrote:
> > Fixes: d5fed5addb2b ("tcp: reorganize tcp_sock fast path variables")
>
> Fixes is for bug fixes. Please drop the fixes tag and add a normal text
> reference like:

Yeah, I see now. The fix here is just like a typos fix, and no
Fixes tag is needed.

>
> Commit d5fed5addb2b ("tcp: reorganize tcp_sock fast path variables")
> moved the fields around and misplaced the documentation for "lsndtime".

I'll send a V2 with such a comment.

Thanks!
Menglong Dong

> --
> pw-bot: cr
diff mbox series

Patch

diff --git a/include/linux/tcp.h b/include/linux/tcp.h
index 6a5e08b937b3..f88daaa76d83 100644
--- a/include/linux/tcp.h
+++ b/include/linux/tcp.h
@@ -200,7 +200,6 @@  struct tcp_sock {
 
 	/* TX read-mostly hotpath cache lines */
 	__cacheline_group_begin(tcp_sock_read_tx);
-	/* timestamp of last sent data packet (for restart window) */
 	u32	max_window;	/* Maximal window ever seen from peer	*/
 	u32	rcv_ssthresh;	/* Current window clamp			*/
 	u32	reordering;	/* Packet reordering metric.		*/
@@ -263,7 +262,7 @@  struct tcp_sock {
 	u32	chrono_stat[3];	/* Time in jiffies for chrono_stat stats */
 	u32	write_seq;	/* Tail(+1) of data held in tcp send buffer */
 	u32	pushed_seq;	/* Last pushed seq, required to talk to windows */
-	u32	lsndtime;
+	u32	lsndtime;	/* timestamp of last sent data packet (for restart window) */
 	u32	mdev_us;	/* medium deviation			*/
 	u32	rtt_seq;	/* sequence number to update rttvar	*/
 	u64	tcp_wstamp_ns;	/* departure time for next sent data packet */