Fix mismatch in if_xdp.h between tools and kernel UAPI
Subsystems (3)
RFC 1/1 Fix mismatch in if_xdp.h between tools and kernel UAPI
Hello all,
While building libbpf, I encountered the following warning:
Warning: Kernel ABI header at 'tools/include/uapi/linux/if_xdp.h' differs from latest version at 'include/uapi/linux/if_xdp.h'
A brief diff shows discrepancies in the doc comments regarding union xsk_tx_metadata vs. struct xsk_tx_metadata references. Below is the relevant snippet:
$ diff tools/include/uapi/linux/if_xdp.h include/uapi/linux/if_xdp.h 120c120 < * field of union xsk_tx_metadata. ---
Quoted 1 line
* field of struct
xsk_tx_metadata.
125c125
< * are communicated via csum_start and csum_offset fields of union
---
Quoted 1 line
* are communicated via
csum_startandcsum_offsetfields of struct
This patch aligns the documentation in tools/include/uapi/linux/if_xdp.h with the kernel UAPI header in include/uapi/linux/if_xdp.h to remove the mismatch and associated warning.
Please consider applying this fix. Let me know if there are any questions or if additional changes are needed.
vishal.c
tools/include/uapi/linux/if_xdp.h +2 -2
@@ -117,12 +117,12 @@ struct xdp_options { ((1ULL <<XSK_UNALIGNED_BUF_OFFSET_SHIFT ) -1 )/* Request transmit timestamp. Upon completion, put it into tx_timestamp -* field of union xsk_tx_metadata. +* field of struct xsk_tx_metadata. */#define XDP_TXMD_FLAGS_TIMESTAMP (1 << 0)/* Request transmit checksum offload. Checksum start position and offset -* are communicated via csum_start and csum_offset fields of union +* are communicated via csum_start and csum_offset fields of struct * xsk_tx_metadata. */ #define XDP_TXMD_FLAGS_CHECKSUM (1 << 1)
Quoted 25 lines · Vishal Chourasia
Hello all,
While building libbpf, I encountered the following warning:
Warning: Kernel ABI header at '
tools/include/uapi/linux/if_xdp.h' differs from latest version at 'include/uapi/linux/if_xdp.h'A brief diff shows discrepancies in the doc comments regarding
union xsk_tx_metadatavs.struct xsk_tx_metadatareferences. Below is the relevant snippet:$ diff tools/include/uapi/linux/if_xdp.h include/uapi/linux/if_xdp.h 120c120 < * field of union xsk_tx_metadata. ---Quoted 1 line
* field of struct
xsk_tx_metadata.125c125
< * are communicated viacsum_startandcsum_offsetfields of union
---Quoted 1 line
* are communicated via
csum_startandcsum_offsetfields of structThis patch aligns the documentation in
tools/include/uapi/linux/if_xdp.hwith the kernel UAPI header ininclude/uapi/linux/if_xdp.hto remove the mismatch and associated warning.
Quoted 4 lines
Please consider applying this fix. Let me know if there are any questions or if additional changes are needed.
vishal.c
Hi Vishal. C,
Thank you for bringing this to our attention. The changes look good to me. Could you please confirm if you will be submitting this patch formally, or do you need assistance to submit it?
Thanks & Regards,
Siang
Quoted 20 lines
tools/include/uapi/linux/if_xdp.h +2
-2@@ -117,12 +117,12 @@ struct xdp_options { ((1ULL <<XSK_UNALIGNED_BUF_OFFSET_SHIFT ) -1 )/* Request transmit timestamp. Upon completion, put it into tx_timestamp -* field of union xsk_tx_metadata. +* field of struct xsk_tx_metadata. */#define XDP_TXMD_FLAGS_TIMESTAMP (1 << 0)/* Request transmit checksum offload. Checksum start position and offset -* are communicated via csum_start and csum_offset fields of union +* are communicated via csum_start and csum_offset fields of struct * xsk_tx_metadata. */ #define XDP_TXMD_FLAGS_CHECKSUM (1 << 1)
Quoted 31 lines · Yoong Siang
Quoted 25 lines · Vishal Chourasia
Hello all,
While building libbpf, I encountered the following warning:
Warning: Kernel ABI header at '
tools/include/uapi/linux/if_xdp.h' differs from latest version at 'include/uapi/linux/if_xdp.h'A brief diff shows discrepancies in the doc comments regarding
union xsk_tx_metadatavs.struct xsk_tx_metadatareferences. Below is the relevant snippet:$ diff tools/include/uapi/linux/if_xdp.h include/uapi/linux/if_xdp.h 120c120 < * field of union xsk_tx_metadata. ---Quoted 1 line
* field of struct
xsk_tx_metadata.125c125
< * are communicated viacsum_startandcsum_offsetfields of union
---Quoted 1 line
* are communicated via
csum_startandcsum_offsetfields of structThis patch aligns the documentation in
tools/include/uapi/linux/if_xdp.hwith the kernel UAPI header ininclude/uapi/linux/if_xdp.hto remove the mismatch and associated warning.Quoted 4 lines
Please consider applying this fix. Let me know if there are any questions or if additional changes are needed.
vishal.c
Quoted 8 lines
Hi Vishal. C,
Thank you for bringing this to our attention. The changes look good to me. Could you please confirm if you will be submitting this patch formally, or do you need assistance to submit it?
Thanks & Regards,
Siang
Hi Siang,
I need assistance as I am not well-versed in the code or the structures involved here. I was unsure about the appropriate commit message, so I submitted it as an RFC patch.
vishal.c
Quoted 22 lines
Quoted 21 lines
tools/include/uapi/linux/if_xdp.h +2
-2@@ -117,12 +117,12 @@ struct xdp_options { ((1ULL <<XSK_UNALIGNED_BUF_OFFSET_SHIFT ) -1 )/* Request transmit timestamp. Upon completion, put it into tx_timestamp -* field of union xsk_tx_metadata. +* field of struct xsk_tx_metadata. */#define XDP_TXMD_FLAGS_TIMESTAMP (1 << 0)/* Request transmit checksum offload. Checksum start position and offset -* are communicated via csum_start and csum_offset fields of union +* are communicated via csum_start and csum_offset fields of struct * xsk_tx_metadata. */ #define XDP_TXMD_FLAGS_CHECKSUM (1 << 1)