virtio-net : Fix virtio_net_hdr struct size when VIRTIO_NET_F_HASH_REPORT feature is negociated.
PATCH 1/1 virtio-net : Fix virtio_net_hdr struct size when VIRTIO_NET_F_HASH_REPORT feature is negociated.
content.tex | 4 ++--
split-ring.tex | 6 +++---
2 files changed, 5 insertions(+), 5 deletions(-)
content.tex +0 -0
index e863709..263cb05 100644
--- a/content.tex
+++ b/content.tex
@@ -3620,8 +3620,8 @@ \subsubsection{Setting Up Receive Buffers}\label{sec:Device Types / Network Devi
features are used, the maximum incoming packet
will be to 65550 bytes long (the maximum size of a
TCP or UDP packet, plus the 14 byte ethernet header), otherwise
-1514 bytes. The 12-byte struct virtio_net_hdr is prepended to this,
-making for 65562 or 1526 bytes.
+1514 bytes. The 12-byte (or 16-byte if VIRTIO_NET_F_HASH_REPORT feature has been negotiated) struct virtio_net_hdr is prepended to this,
+making for 65562 or 1526 bytes (respectively 65566 and 1530 bytes if VIRTIO_NET_F_HASH_REPORT has been negotiated).
\drivernormative{\paragraph}{Setting Up Receive Buffers}{Device Types / Network Device / Device Operation / Setting Up Receive Buffers}
split-ring.tex +0 -0
index de94038..e6953d7 100644
--- a/split-ring.tex
+++ b/split-ring.tex
@@ -128,10 +128,10 @@ \subsection{Legacy Interfaces: A Note on Virtqueue Endianness}\label{sec:Basic F
\subsection{Message Framing}\label{sec:Basic Facilities of a Virtio Device / Virtqueues / Message Framing}
The framing of messages with descriptors is
independent of the contents of the buffers. For example, a network
-transmit buffer consists of a 12 byte header followed by the network
+transmit buffer consists of a 12 (or 16 if VIRTIO_NET_F_HASH_REPORT feature has been negociated) byte header followed by the network
packet. This could be most simply placed in the descriptor table as a
-12 byte output descriptor followed by a 1514 byte output descriptor,
-but it could also consist of a single 1526 byte output descriptor in
+12 (or 16) byte output descriptor followed by a 1514 byte output descriptor,
+but it could also consist of a single 1526 (or 1530) byte output descriptor in
the case where the header and packet are adjacent, or even three or
more descriptors (possibly with loss of efficiency in that case).
Hi,
The header size is 20 bytes if VIRTIO_NET_F_HASH_REPORT is negotiated.
struct virtio_net_hdr {
u8 flags;
u8 gso_type;
le16 hdr_len;
le16 gso_size;
le16 csum_start;
le16 csum_offset;
le16 num_buffers;
le32 hash_value; (Only if VIRTIO_NET_F_HASH_REPORT negotiated)
le16 hash_report; (Only if VIRTIO_NET_F_HASH_REPORT negotiated)
le16 padding_reserved; (Only if VIRTIO_NET_F_HASH_REPORT negotiated)
};This publicly archived list offers a means to provide input to the OASIS Virtual I/O Device (VIRTIO) TC.
In order to verify user consent to the Feedback License terms and to minimize spam in the list archive, subscription is required before posting.
Subscribe: [email protected]
Unsubscribe: [email protected]
List help: [email protected]
List archive: https://lists.oasis-open.org/archives/virtio-comment/
Feedback License: https://www.oasis-open.org/who/ipr/feedback_license.pdf
List Guidelines: https://www.oasis-open.org/policies-guidelines/mailing-lists
Committee: https://www.oasis-open.org/committees/virtio/
Join OASIS: https://www.oasis-open.org/join/
Hello
You are right indeed - my mistake.
It might even be better (at least less error-prone) to refer to the sifeof(virtio_net_hdr) in case new fields get added in the future.
In the meantime, here is updated proposal.
BR
Cyril
--- content.tex | 4 ++-- split-ring.tex | 6 +++--- 2 files changed, 5 insertions(+), 5 deletions(-)
content.tex +0 -0
@@ -3620,8 +3620,8 @@ \subsubsection{Setting Up Receive
Buffers}\label{sec:Device Types / Network Devi
features are used, the maximum incoming packet
will be to 65550 bytes long (the maximum size of a
TCP or UDP packet, plus the 14 byte ethernet header), otherwise
-1514 bytes. The 12-byte struct virtio_net_hdr is prepended to this, -making for 65562 or 1526 bytes.
+1514 bytes. The 12-byte (or 20-byte if VIRTIO_NET_F_HASH_REPORT feature has been negotiated) struct virtio_net_hdr is prepended to this, +making for 65562 or 1526 bytes (respectively 65570 and 1534 bytes if VIRTIO_NET_F_HASH_REPORT has been negotiated).
\drivernormative{\paragraph}{Setting Up Receive Buffers}{Device Types /
Network Device / Device Operation / Setting Up Receive Buffers}
split-ring.tex +0 -0
@@ -128,10 +128,10 @@ \subsection{Legacy Interfaces: A Note on Virtqueue
Endianness}\label{sec:Basic F
\subsection{Message Framing}\label{sec:Basic Facilities of a Virtio Device
/ Virtqueues / Message Framing}
The framing of messages with descriptors is
independent of the contents of the buffers. For example, a network
-transmit buffer consists of a 12 byte header followed by the network +transmit buffer consists of a 12 (or 20 if VIRTIO_NET_F_HASH_REPORT feature has been negociated) byte header followed by the network
packet. This could be most simply placed in the descriptor table as a
-12 byte output descriptor followed by a 1514 byte output descriptor, -but it could also consist of a single 1526 byte output descriptor in +12 (or 20) byte output descriptor followed by a 1514 byte output descriptor,
+but it could also consist of a single 1526 (or 1534) byte output descriptor in
the case where the header and packet are adjacent, or even three or more descriptors (possibly with loss of efficiency in that case).
--
-----Original Message-----
From: Alvaro Karsz <[email protected]>
Sent: Thursday, August 4, 2022 9:24 PM
To: Cyril Germond <[email protected]>
Cc: [email protected]
Subject: Re: [virtio-comment] [PATCH] virtio-net : Fix virtio_net_hdr struct size when VIRTIO_NET_F_HASH_REPORT feature is negociated.
Hi,
The header size is 20 bytes if VIRTIO_NET_F_HASH_REPORT is negotiated.
struct virtio_net_hdr {
u8 flags;
u8 gso_type;
le16 hdr_len;
le16 gso_size;
le16 csum_start;
le16 csum_offset;
le16 num_buffers;
le32 hash_value; (Only if VIRTIO_NET_F_HASH_REPORT negotiated)
le16 hash_report; (Only if VIRTIO_NET_F_HASH_REPORT
negotiated)
le16 padding_reserved; (Only if VIRTIO_NET_F_HASH_REPORT
negotiated) };
To declare a filtering error, please use the following link :
https://www.security-mail.net/reporter.php?mid=62c2.62ec1d06.258ee.0&r=cgermond%40kalray.eu&s=alvaro.karsz%40solid-run.com&o=Re%3A+%5Bvirtio-comment%5D+%5BPATCH%5D+virtio-net+%3A+Fix+virtio_net_hdr+struct+size+when+VIRTIO_NET_F_HASH_REPORT+feature+is+negociated.&verdict=C&c=ed2662797903b4423f528eab3fae6cc47b606e8b
This publicly archived list offers a means to provide input to the OASIS Virtual I/O Device (VIRTIO) TC.
In order to verify user consent to the Feedback License terms and to minimize spam in the list archive, subscription is required before posting.
Subscribe: [email protected]
Unsubscribe: [email protected]
List help: [email protected]
List archive: https://lists.oasis-open.org/archives/virtio-comment/
Feedback License: https://www.oasis-open.org/who/ipr/feedback_license.pdf
List Guidelines: https://www.oasis-open.org/policies-guidelines/mailing-lists
Committee: https://www.oasis-open.org/committees/virtio/
Join OASIS: https://www.oasis-open.org/join/
Quoted 20 lines · Cyril Germond
Hello
You are right indeed - my mistake.
It might even be better (at least less error-prone) to refer to thesifeof(virtio_net_hdr)in case new fields get added in the future.In the meantime, here is updated proposal.
BR
Cyril--- content.tex | 4 ++-- split-ring.tex | 6 +++--- 2 files changed, 5 insertions(+), 5 deletions(-)content.tex +0
-0@@ -3620,8 +3620,8 @@ \subsubsection{Setting Up ReceiveBuffers}\label{sec:Device Types / Network Devi
features are used, the maximum incoming packet
Quoted 8 lines
will be to 65550 bytes long (the maximum size of a
TCP or UDP packet, plus the 14 byte ethernet header), otherwise
-1514 bytes. The 12-byte structvirtio_net_hdris prepended to this, -making for 65562 or 1526 bytes.
+1514 bytes. The 12-byte (or 20-byte ifVIRTIO_NET_F_HASH_REPORTfeature has been negotiated) structvirtio_net_hdris prepended to this, +making for 65562 or 1526 bytes (respectively 65570 and 1534 bytes ifVIRTIO_NET_F_HASH_REPORThas been negotiated).
Your mail client seems to add line wraps, which means that the patch cannot be applied by git am (and it makes the change hard to read). Please consider using git send-email, as described in
https://github.com/oasis-tcs/virtio-spec#providing-feedback.
Quoted 18 lines
\drivernormative{\paragraph}{Setting Up Receive Buffers}{Device Types /
Network Device / Device Operation / Setting Up Receive Buffers}split-ring.tex +0
-0@@ -128,10 +128,10 @@ \subsection{Legacy Interfaces: A Note on VirtqueueEndianness}\label{sec:Basic F
\subsection{Message Framing}\label{sec:Basic Facilities of a Virtio Device
/ Virtqueues / Message Framing}
The framing of messages with descriptors is
independent of the contents of the buffers. For example, a networksplit-ring.tex +1
-1-transmit buffer consists of a 12 byte header followed by the network +transmit buffer consists of a 12 (or 20 if VIRTIO_NET_F_HASH_REPORT featurehas been negociated) byte header followed by the network
packet. This could be most simply placed in the descriptor table as a
Quoted 8 lines
-12 byte output descriptor followed by a 1514 byte output descriptor, -but it could also consist of a single 1526 byte output descriptor in +12 (or 20) byte output descriptor followed by a 1514 byte output descriptor,
+but it could also consist of a single 1526 (or 1534) byte output descriptor in
the case where the header and packet are adjacent, or even three or more descriptors (possibly with loss of efficiency in that case).
As this is only an example, maybe it is better to simply prefix it with
"For example, if VIRTIO_NET_F_HASH_REPORT has not been negotiated, a network transmit buffer consists of..."
so that you don't need to consider the separate cases, which make the example harder to read (and don't help to illustrate the process of deciding on a descriptor layout).
This publicly archived list offers a means to provide input to the OASIS Virtual I/O Device (VIRTIO) TC.
In order to verify user consent to the Feedback License terms and to minimize spam in the list archive, subscription is required before posting.
Subscribe: [email protected]
Unsubscribe: [email protected]
List help: [email protected]
List archive: https://lists.oasis-open.org/archives/virtio-comment/
Feedback License: https://www.oasis-open.org/who/ipr/feedback_license.pdf
List Guidelines: https://www.oasis-open.org/policies-guidelines/mailing-lists
Committee: https://www.oasis-open.org/committees/virtio/
Join OASIS: https://www.oasis-open.org/join/