OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

virtio-comment message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Re: RE: [PATCH v15] virtio-net: support device stats


On Thu, 24 Aug 2023 11:56:56 +0000, Parav Pandit <parav@nvidia.com> wrote:
>
> > From: Xuan Zhuo <xuanzhuo@linux.alibaba.com>
> > Sent: Monday, August 21, 2023 12:13 PM
> >
> > This patch allows the driver to obtain some statistics from the device.
> >
> > In the device implementation, we can count a lot of such information, which
> > can be used for debugging and judging the running status of the device. We
> > hope to directly display it to the user through ethtool.
> >
> > To get stats atomically, try to get stats for all/multiple queue pairs in one
> > command.
> >
> > Signed-off-by: Xuan Zhuo <xuanzhuo@linux.alibaba.com>
> > Suggested-by: Michael S. Tsirkin <mst@redhat.com>
> > ---
> >
> > v15:
> >    * query supported types via cvq @Parav
> >    * fix some problem @David
> >
> > v14:
> >    * introduce supported_stats to config space
> >    * add header(vq_index, size, type) to each reply stats
> >    * add ref to the tx GSO
> >
> >  device-types/net/description.tex        | 430 +++++++++++++++++++++++-
> >  device-types/net/device-conformance.tex |   1 +
> >  device-types/net/driver-conformance.tex |   1 +
> >  3 files changed, 429 insertions(+), 3 deletions(-)
> >
> > diff --git a/device-types/net/description.tex b/device-types/net/description.tex
> > index 76585b0..9f55c0d 100644
> > --- a/device-types/net/description.tex
> > +++ b/device-types/net/description.tex
> > @@ -88,6 +88,9 @@ \subsection{Feature bits}\label{sec:Device Types /
> > Network Device / Feature bits  \item[VIRTIO_NET_F_CTRL_MAC_ADDR(23)] Set
> > MAC address through control
> >      channel.
> >
> > +\item[VIRTIO_NET_F_DEVICE_STATS(50)] Device can provide device-level
> > statistics
> > +    to the driver through the control channel.
> Its over cvq, so lets do,
>
> s/channel/virtqueue
>
> so that user needs to learn one less term.
>
> > +
> >  \item[VIRTIO_NET_F_HASH_TUNNEL(51)] Device supports inner header hash
> > for encapsulated packets.
> >
> >  \item[VIRTIO_NET_F_VQ_NOTF_COAL(52)] Device supports virtqueue
> > notification coalescing.
> > @@ -1156,6 +1159,7 @@ \subsubsection{Control Virtqueue}\label{sec:Device
> > Types / Network Device / Devi
> >          u8 command;
> >          u8 command-specific-data[];
> >          u8 ack;
> > +        u8 command-specific-data-reply[];
> Please rename
> s/command-specific-data-reply/command_specific_result


I agree.

But it will be "command-specific-result" for alignment with 'command-specific-data'.

>
> This will align to what is done in aq and also shorter name. :)
>
> >  };
> >
> >  /* ack values */
> > @@ -1164,9 +1168,11 @@ \subsubsection{Control Virtqueue}\label{sec:Device
> > Types / Network Device / Devi  \end{lstlisting}
> >
> >  The \field{class}, \field{command} and command-specific-data are set by the -
> > driver, and the device sets the \field{ack} byte. There is little it can -do except
> > issue a diagnostic if \field{ack} is not -VIRTIO_NET_OK.
> > +driver, and the device sets the \field{ack} byte and optionally
> > +\field{command-specific-data-reply}.
>
> > There is little the driver can do
> > +except issue a diagnostic if \field{ack} is not VIRTIO_NET_OK.
> > +
> May be driver can retry the command, put to error state, issue diagnostics, ignore the error.
> So There is no need to mention what driver can/cannot do, so please just drop the last line.

This is not new. It turns out that there is this line.

I think, if you want to remove this, you should post a new patch.

>
> > +The command VIRTIO_NET_CTRL_STATS_GET contains \field{command-
> > specific-data-reply}.
> >
> >  \paragraph{Packet Receive Filtering}\label{sec:Device Types / Network Device
> > / Device Operation / Control Virtqueue / Packet Receive Filtering}
> > \label{sec:Device Types / Network Device / Device Operation / Control
> > Virtqueue / Setting Promiscuous Mode}%old label for latexdiff @@ -1805,6
> > +1811,424 @@ \subsubsection{Control Virtqueue}\label{sec:Device Types /
> > Network Device / Devi
> >
> >  Upon reset, a device MUST initialize all coalescing parameters to 0.
> >
> > +\paragraph{Device Statistic}\label{sec:Device Types / Network Device /
> > +Device Operation / Control Virtqueue / Device Statistic}
> > +
> > +If the VIRTIO_NET_F_DEVICE_STATS feature is negotiated, the driver can
> > +obtain device stats from the device by using the following command.
> > +
> s/device stats/device statistics at above and throughout many places below.
> in the spec wording, better to not shorten them.
>
> > +Different types of virtqueues have different stats. The stats of the
> > +receiveq are different from those of the transmitq.
> > +
> > +The stats of a certain type of virtqueue are also divided into multiple
> > +types because different types require different features. This enables
> > +the expansion of new stats.
> > +
> > +At one time, the driver can obtain the stats of one or multiple virtqueues.
> May be
> s/At one time/In one command
> This is to be more accurate, otherwise in one time we miss the notion of command.
>
> > +Additionally, the driver can obtain multiple type stats of each virtqueue.
> > +
> > +\begin{lstlisting}
> > +#define VIRTIO_NET_CTRL_STATS         7
> > +#define VIRTIO_NET_CTRL_STATS_QUERY   0
> > +#define VIRTIO_NET_CTRL_STATS_GET     1
> > +\end{lstlisting}
> > +
> > +To obtain device stats, use the VIRTIO_NET_CTRL_STATS_GET command with
> > +the \field{command-specific-data} containing the
> > +virtio_net_ctrl_queue_stats structure. The result is returned in the
> > \field{command-specific-data-reply}.
> > +
> We opted for slightly different wording for describing command specific data and results in aq.
> So lets align it here.
> Please reword above as,
> The \field{command-specific-data} is in the format of \field{ struct virtio_net_ctrl_queue_stats}.
>
> When the command completes successfully, \field{command_specific_result} is in the format of \field{struct virtio_net_stats_capabilites}.
>
> > +The following structure is used in \field{command-specific-data}:
> > +\begin{lstlisting}
> > +struct virtio_net_ctrl_queue_stats {
> > +       struct {
> > +           le16 vq_index;
> > +           le16 padding[3];
> > +           le64 types[1];
> > +       } stats[];
> > +};
> > +\end{lstlisting}
> > +
> > +The following structures are used in \field{command-specific-data-reply}:
> > +\begin{lstlisting}
> > +struct virtio_net_stats_capabilites {
> > +
> > +#define VIRTIO_NET_STATS_TYPE_CVQ       (1 << 0)
> > +#define VIRTIO_NET_STATS_TYPE_RX_BASIC  (1 << 1)
> > +#define VIRTIO_NET_STATS_TYPE_RX_CSUM   (1 << 2)
> > +#define VIRTIO_NET_STATS_TYPE_RX_GSO    (1 << 3)
> > +#define VIRTIO_NET_STATS_TYPE_TX_BASIC  (1 << 4)
> > +#define VIRTIO_NET_STATS_TYPE_TX_CSUM   (1 << 5)
> > +#define VIRTIO_NET_STATS_TYPE_TX_GSO    (1 << 6)
> > +    le64 supported_stats_types[1];
> > +}
> > +
> It would be best to split the command and description into two. One for the capabilities bit map.
> And second for the actual stats header.
> This avoids the mix up between the two.
>
> > +struct virtio_net_stats_reply_hdr {
> > +    le16 size;
> > +    le16 vq_index;
> > +
> > +#define VIRTIO_NET_STATS_TYPE_REPLY_CVQ       0
> > +#define VIRTIO_NET_STATS_TYPE_REPLY_RX_BASIC  1
> > +#define VIRTIO_NET_STATS_TYPE_REPLY_RX_CSUM   2
> > +#define VIRTIO_NET_STATS_TYPE_REPLY_RX_GSO    3
> > +#define VIRTIO_NET_STATS_TYPE_REPLY_TX_BASIC  4
> > +#define VIRTIO_NET_STATS_TYPE_REPLY_TX_CSUM   5
> > +#define VIRTIO_NET_STATS_TYPE_REPLY_TX_GSO    6
> > +    u8 type;
> If the query command input has it, we likely don't need it in the response.

YES.

But the driver may need to handle multiple reply stats. I think that will
be easy for the driver to handle so many stats with the vq_index and type.


> > +    u8 padding[3];
> > +}
> > +
> > +struct virtio_net_stats_cvq {
> > +    struct virtio_net_stats_reply_hdr hdr;
> > +
> > +    le64 command_num;
> > +    le64 ok_num;
> > +};
> > +
> > +struct virtio_net_stats_rx_basic {
> > +    struct virtio_net_stats_reply_hdr hdr;
> > +
> > +    le64 rx_packets;
> > +    le64 rx_bytes;
> > +
> > +    le64 rx_notification;
> > +    le64 rx_interrupt;
> > +
> > +    le64 rx_drop;
> > +    le64 rx_drop_overruns;
> > +    le64 rx_drop_busy;
> > +};
> > +
> > +struct virtio_net_stats_rx_csum {
> > +    struct virtio_net_stats_reply_hdr hdr;
> > +
> > +    le64 rx_csum_valid;
> > +    le64 rx_needs_csum;
> > +    le64 rx_csum_bad;
> > +    le64 rx_csum_none;
> > +};
> > +
> > +struct virtio_net_stats_rx_gso {
> > +    struct virtio_net_stats_reply_hdr hdr;
> > +
> > +    le64 rx_gso_packets;
> > +    le64 rx_gso_bytes;
> > +    le64 rx_gso_packets_coalesced;
> > +    le64 rx_gso_bytes_coalesced;
> > +    le64 rx_gso_segments;
> > +    le64 rx_gso_segments_bytes;
> > +};
> > +
> > +struct virtio_net_stats_tx_basic {
> > +    struct virtio_net_stats_reply_hdr hdr;
> > +
> > +    le64 tx_packets;
> > +    le64 tx_bytes;
> > +
> > +    le64 tx_notification;
> > +    le64 tx_interrupt;
> > +
> > +    le64 tx_drop;
> > +    le64 tx_drop_malformed;
> > +
> > +    le64 tx_drop_busy;
> > +};
> > +
> > +struct virtio_net_stats_tx_csum {
> > +    struct virtio_net_stats_reply_hdr hdr;
> > +
> > +    le64 tx_csum_none;
> > +    le64 tx_needs_csum;
> > +};
> > +
> > +struct virtio_net_stats_tx_gso {
> > +    struct virtio_net_stats_reply_hdr hdr;
> > +
> > +    le64 tx_gso_packets;
> > +    le64 tx_gso_bytes;
> > +    le64 tx_gso_packets_split;
> > +    le64 tx_gso_bytes_split;
> > +    le64 tx_gso_segments;
> > +    le64 tx_gso_segments_bytes;
> > +};
> > +
> > +\end{lstlisting}
> > +
> Since there are plenty of structures and more to grow, I am finding it hard to navigate between their names and below description.
> Thinking that below description to be next to the struct listing.
>
> > +The fields of the \field{struct virtio_net_ctrl_queue_stats}:
> > +\begin{description}
> > +    \item [vq_index]
> > +        The index of the virtqueue to obtain the stats.
> > +
> > +    \item [types]
> > +        This is a bitmask of the types of stats to be obtained. Therefore, a
> > +        \field{struct stats} inside virtio_net_ctrl_queue_stats may indicate
> > +        multiple stats replies for the virtqueue.
> > +\end{description}
> > +
> > +The fields of the \field{struct virtio_net_stats_reply_hdr}:
> > +\begin{description}
> > +    \item [vq_index]
> > +        The virtqueue index of the reply stats.
> > +
> > +    \item [size]
> > +        The size of bytes of the reply stats.
> > +
> I guess we only need bytes because rest are present in the request, so caller knows what to expect in response.\
> Its unlikely to transfer 64K, but it is worth to have the size as le32.
>
> > +    \item [type]
> > +        The type of the reply stats.
> > +
> > +\end{description}
> > +
> > +\subparagraph{Controlq Statistic}\label{sec:Device Types / Network
> > +Device / Device Operation / Control Virtqueue / Device Statistic /
> > +Controlq Statistic}
> > +
> > +The structure corresponding to the controlq stats is virtio_net_stats_cvq.
> > +The corresponding type is VIRTIO_NET_STATS_TYPE_CVQ. This is just for
> > +the controlq.
> > +
> > +\begin{description}
> > +    \item [command_num]
> > +        The number of commands including the current command.
> > +
> The number of commands received by the device including the current command.
>
> > +    \item [ok_num]
> > +        The number of commands (including the current command) where the
> > ack was VIRTIO_NET_OK.
> The number of commands completed successfully by the device including the current command.
> No need for braces as we didn't keep in the command_num.
>
> > +\end{description}
> > +
> > +
> > +\subparagraph{Receiveq Basic Statistic}\label{sec:Device Types /
> > +Network Device / Device Operation / Control Virtqueue / Device
> > +Statistic / Receiveq Basic Statistic}
> > +
> > +The structure corresponding to the receiveq basic stats is
> > virtio_net_stats_rx_basic.
> > +The corresponding type is VIRTIO_NET_STATS_TYPE_RX_BASIC. This is just
> > +for the receiveq.
> > +
> Please drop "just" from above.
>
> > +Receiveq basic stats does not require any feature. As long as the
> > +device supports VIRTIO_NET_F_DEVICE_STATS, the following are the receiveq
> > basic stats.
> > +
> > +The packets described below were all presented on the specified virtqueue.
> > +\begin{description}
> > +    \item [rx_packets]
> > +        This is the number of packets received by the device (not the packets
> > +        passed to the guest). The count includes the packets dropped by the
> > +        device.
> > +
> > +    \item [rx_bytes]
> > +        This is the bytes of packets received by the device (not the packets
> > +        passed to the guest). The count includes the packets dropped by the
> > +        device.
> > +
> > +    \item [rx_notification]
> s/rx_notification/rx_notifications
>
> > +        The number of driver notifications received by device for this receiveq.
> > +
> > +    \item [rx_interrupt]
> > +        The number of device interrupts for this receiveq.
> > +
> s/rx_interrupt/rx_interrupts
> The number of interrupts generated by the device for this receiveq.
>
> > +    \item [rx_drop]
> > +        This is the number of packets dropped by the device. The count includes
> > +        all types of packets dropped by the device.
> > +
> rx_drops
>
> > +    \item [rx_drop_overruns]
> > +        This is the number of packets dropped by the device when no more
> > +        descriptors were available.
> > +
> > +    \item [rx_drop_busy]
> > +        This is the number of packets dropped by the device when the device is
> > +        busy.
> > +
> I feel this is bit abstract counter and qualify the device as busy is tricky. Lets move it out of the basic counter.

I will rethink about this.


> Often pure receive side stats and host side stats are handled by different hw/sw engines.
> So better to collocate them.
> In other words,
> Please move rx_notifications at the start the struct so that rest of the receive side stats adjacent to each other.
> > +\end{description}
> > +
> > +\subparagraph{Transmitq Basic Statistic}\label{sec:Device Types /
> > +Network Device / Device Operation / Control Virtqueue / Device
> > +Statistic / Transmitq Basic Statistic}
> > +
> > +The structure corresponding to the transmitq basic stats is
> > virtio_net_stats_tx_basic.
> > +The corresponding type is VIRTIO_NET_STATS_TYPE_TX_BASIC. This is just
> > +for the transmitq.
> > +
> Please drop "just".
> Similar comments as tx.
> > +Transmitq basic stats does not require any feature. As long as the
> > +device supports VIRTIO_NET_F_DEVICE_STATS, the following are the transmitq
> > basic stats.
> > +
> > +The packets described below are all from a specific virtqueue.
> > +\begin{description}
> > +    \item [tx_packets]
> > +        This is the number of packets sent by the device (not the packets
> > +        got from the driver).
> > +
> > +    \item [tx_bytes]
> > +        This is the bytes of packets sent by the device (not the packets
> > +        got from the driver).
> > +
> > +    \item [tx_notification]
> > +        The number of driver notifications for this transmitq.
> > +
> > +    \item [tx_interrupt]
> > +        The number of device interrupts for this transmitq.
> > +
> > +    \item [tx_drop]
> > +        The number of packets dropped by the device. The count includes all
> > +        types of packets dropped by the device.
> > +
> > +    \item [tx_drop_malformed]
> > +        The number of packets dropped by the device, when the descriptor is in
> > +        an error state. For example, the buffer is too short.
> > +
> There descriptor do not have the state.
> So better to like the name, as the descriptors are malformed.
>
> > +    \item [tx_drop_busy]
> > +        The number of packets dropped by the device, when the device is busy.
> > +
> > +\end{description}
> > +
> > +\subparagraph{Receiveq CSUM Statistic}\label{sec:Device Types / Network
> > +Device / Device Operation / Control Virtqueue / Device Statistic /
> > +Receiveq CSUM Statistic}
> > +
> > +The structure corresponding to the receiveq csum stats is
> > virtio_net_stats_rx_csum.
> > +The corresponding type is VIRTIO_NET_STATS_TYPE_RX_CSUM. This is just
> > +for the receiveq.
> > +
> > +Only after the VIRTIO_NET_F_GUEST_CSUM is negotiated, the receiveq csum
> > +stats can be obtained.
> > +
> > +The packets described below are all steered to a specific virtqueue.
> > +\begin{description}
> > +    \item [rx_csum_valid]
> > +        The number of packets with VIRTIO_NET_HDR_F_DATA_VALID.
> > +
> > +    \item [rx_needs_csum]
> > +        The number of packets with VIRTIO_NET_HDR_F_NEEDS_CSUM.
> > +
> > +    \item [rx_csum_bad]
> > +        The number of packets with abnormal csum.
> > +
> This error counter to move after _none.
>
> > +    \item [rx_csum_none]
> > +        The number of packets without hardware csum. The packet here refers to
> > +        the non-TCP/UDP packet that the backend cannot recognize.
> > +
> > +\end{description}
> > +
> > +\subparagraph{Transmitq CSUM Statistic}\label{sec:Device Types /
> > +Network Device / Device Operation / Control Virtqueue / Device
> > +Statistic / Transmitq CSUM Statistic}
> > +
> > +The structure corresponding to the transmitq csum stats is
> > virtio_net_stats_tx_csum.
> > +The corresponding type is VIRTIO_NET_STATS_TYPE_TX_CSUM. This is just
> > +for the transmitq.
> > +
> Drop "just".
>
> > +Only after the VIRTIO_NET_F_CSUM is negotiated, the transmitq csum
> > +stats can be obtained.
> > +
> > +The following are the transmitq csum stats:
> > +
> > +The packets described below are all from a specific virtqueue.
> > +\begin{description}
> > +    \item [tx_csum_none]
> > +        The number of packets that didn't require hardware csum.
> > +
> s/that/which
>
> > +    \item [tx_needs_csum]
> > +        The number of packets that required hardware csum.
> > +
> > +\end{description}
> > +
> > +\subparagraph{Receiveq GSO Statistic}\label{sec:Device Types / Network
> > +Device / Device Operation / Control Virtqueue / Device Statistic /
> > +Receiveq GSO Statistic}
> > +
> > +The structure corresponding to the receivq GSO stats is
> > virtio_net_stats_rx_gso.
> > +The corresponding type is VIRTIO_NET_STATS_TYPE_RX_GSO. This is just
> > +for the receiveq.
> > +
> > +If one or more of the VIRTIO_NET_F_GUEST_TSO4,
> > VIRTIO_NET_F_GUEST_TSO6,
> > +or VIRTIO_NET_F_GUEST_UFO have been negotiated, the receiveq GSO stats
> > +can be obtained.
> > +
> > +GSO packets refer to packets passed by the device to the driver where
> > +\field{gso_type} is not VIRTIO_NET_HDR_GSO_NONE.
> > +
> > +The packets described below are all steered to a specific virtqueue.
> > +\begin{description}
> > +    \item [rx_gso_packets]
> > +        The number of the GSO packets received by device.
> > +
> > +    \item [rx_gso_bytes]
> > +        The bytes of the GSO packets received by device.
> > +
> > +    \item [rx_gso_packets_coalesced]
> > +        The number of the GSO packets coalesced by device.
> > +
> > +    \item [rx_gso_bytes_coalesced]
> > +        The bytes of the GSO packets coalesced by device.
> > +
> Please mention that the header size of the packet is accounted in GSO.
>
> > +    \item [rx_gso_segments]
> > +        The number of the segments that make up GSO packets.
> > +
> > +    \item [rx_gso_segments_bytes]
> > +        The bytes of the segments that make up GSO packets.
> > +
> > +\end{description}
> > +
> > +\subparagraph{Transmitq GSO Statistic}\label{sec:Device Types / Network
> > +Device / Device Operation / Control Virtqueue / Device Statistic /
> > +Transmitq GSO Statistic}
> > +
> > +The structure corresponding to the transmitq GSO stats is
> > virtio_net_stats_tx_gso.
> > +The corresponding type is VIRTIO_NET_STATS_TYPE_TX_GSO. This is just
> > +for the transmitq.
> > +
> > +If one or more of the VIRTIO_NET_F_HOST_TSO4, VIRTIO_NET_F_HOST_TSO6,
> > +VIRTIO_NET_F_HOST_USO or VIRTIO_NET_F_HOST_UFO options have been
> > +negotiated, the transmitq GSO stats can be obtained.
> > +
> > +GSO packets refer to packets passed by the driver to the device where
> > +\field{gso_type} is not VIRTIO_NET_HDR_GSO_NONE.
> > +See more \ref{sec:Device Types / Network Device / Device Operation /
> > +Packet Transmission}.
> > +
> > +The packets described below are all from a specific virtqueue.
> > +\begin{description}
> > +    \item [tx_gso_packets]
> > +        The number of the GSO packets sent by device that are not cut to small
> > +        packets.
> > +
> > +    \item [tx_gso_bytes]
> > +        The bytes of the GSO packets sent by device that are not cut to small
> > +        packets.
> > +
> > +    \item [tx_gso_packets_split]
> > +        The number of the GSO packets that been cut into small packets.
> > +
> > +    \item [tx_gso_bytes_split]
> > +        The bytes of the GSO packets that been cut into small packets.
> > +
> > +    \item [tx_gso_segments]
> > +        The number of segments separated from the GSO packets.
> > +
> > +    \item [tx_gso_segments_bytes]
> > +        The bytes of segments separated from the GSO packets.
> > +\end{description}
> > +
> > +\devicenormative{\subparagraph}{Device Statistic}{Device Types /
> > +Network Device / Device Operation / Control Virtqueue / Device
> > +Statistic} The device MUST replies to the command
> > +VIRTIO_NET_CTRL_STATS_QUERY with the struct virtio_net_stats_capabilites.
> > \field{supported_stats_types} includes all the stats types supported by the
> > device.
> > +
> I will take the second pass to review below normatives in a day.
>
> We need to add the capabilities and query them from the AQ too.
> If the reply header structure and actual stats are split properly, it will be easy to add the query by the owner device.

YES. I agree.

But I would to know is there some specific requirements?

I will post the next version today or tomorrow.

Thanks.


>
> > +If virtio_net_ctrl_queue_stats is incorrect (such as the following),
> > +the device MUST set \field{ack} to VIRTIO_NET_ERR. Even if there is
> > +only one error, the device MUST fail the entire command.
> > +\begin{itemize}
> > +    \item \field{vq_index} exceeds the queue range.
> > +    \item \field{types} contains unknown types.
> > +    \item One or more of the bits present in \field{types} is not valid for the
> > +        specified virtqueue.
> > +    \item The feature corresponding to the specified \field{types} was not
> > negotiated.
> > +    \item The size of the buffer allocated by the driver for \field{command-
> > specific-data-reply}
> > +        is less than the total size of the stats specialed by
> > +        \field{virtio_net_ctrl_queue_stats}.
> > +\end{itemize}
> > +
> > +The device MUST write the requested stats structures in
> > +\field{command-specific-data-reply} in the order specified by the
> > +structure virtio_net_ctrl_queue_stats. If the \field{types} indicates
> > +multiple stats, the replies order by the type value from small to large.
> > +
> > +The device MUST set the actual size of the space occupied by the reply
> > +to the \field{size} of the \field{hdr}. And the device MUST set the
> > +\field{type} and the \field{vq_index} of the stats header.
> > +
> > +\drivernormative{\subparagraph}{Device Statistic}{Device Types /
> > +Network Device / Device Operation / Control Virtqueue / Device
> > +Statistic}
> > +
> > +The types contained in the \field{types} MUST be queried from the
> > +device via command VIRTIO_NET_CTRL_STATS_QUERY.
> > +
> > +\field{types} in struct virtio_net_ctrl_queue_stats MUST be valid to
> > +the vq specified by \field{vq_index}.
> > +
> > +The \field{command-specific-data-reply} buffer allocated by the driver
> > +MUST be able to hold all the stats specified by virtio_net_ctrl_queue_stats.
> > +
> >  \subsubsection{Legacy Interface: Framing Requirements}\label{sec:Device
> > Types / Network Device / Legacy Interface: Framing Requirements}
> >
> > diff --git a/device-types/net/device-conformance.tex b/device-
> > types/net/device-conformance.tex
> > index f88f48b..8ce58fe 100644
> > --- a/device-types/net/device-conformance.tex
> > +++ b/device-types/net/device-conformance.tex
> > @@ -15,4 +15,5 @@
> >  \item \ref{devicenormative:Device Types / Network Device / Device Operation
> > / Control Virtqueue / Receive-side scaling (RSS) / RSS processing}  \item
> > \ref{devicenormative:Device Types / Network Device / Device Operation /
> > Control Virtqueue / Notifications Coalescing}  \item
> > \ref{devicenormative:Device Types / Network Device / Device Operation /
> > Control Virtqueue / Inner Header Hash}
> > +\item \ref{devicenormative:Device Types / Network Device / Device
> > +Operation / Control Virtqueue / Device Statistic}
> >  \end{itemize}
> > diff --git a/device-types/net/driver-conformance.tex b/device-types/net/driver-
> > conformance.tex
> > index 9d853d9..b6636a2 100644
> > --- a/device-types/net/driver-conformance.tex
> > +++ b/device-types/net/driver-conformance.tex
> > @@ -15,4 +15,5 @@
> >  \item \ref{drivernormative:Device Types / Network Device / Device Operation
> > / Control Virtqueue / Receive-side scaling (RSS) }  \item
> > \ref{drivernormative:Device Types / Network Device / Device Operation /
> > Control Virtqueue / Notifications Coalescing}  \item
> > \ref{drivernormative:Device Types / Network Device / Device Operation /
> > Control Virtqueue / Inner Header Hash}
> > +\item \ref{drivernormative:Device Types / Network Device / Device
> > +Operation / Control Virtqueue / Device Statistic}
> >  \end{itemize}
> > --
> > 2.32.0.3.g01195cf9f
>


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]