Replace field name vqn to vq_index for recent virtqueue level commands.
Fixes: https://github.com/oasis-tcs/virtio-spec/issues/163
Signed-off-by: Parav Pandit <[email protected]>
---
changelog:
v12->v13:
- new patch
---
device-types/net/description.tex | 24 ++++++++++++------------
1 file changed, 12 insertions(+), 12 deletions(-)
diff --git a/device-types/net/description.tex b/device-types/net/description.tex
index 83bdaef..3030222 100644
--- a/device-types/net/description.tex
+++ b/device-types/net/description.tex
@@ -1560,7 +1560,7 @@ \subsubsection{Control Virtqueue}\label{sec:Device Types
/ Network Device / Devi
};
struct virtio_net_ctrl_coal_vq {
- le16 vqn;
+ le16 vq_index;
le16 reserved;
struct virtio_net_ctrl_coal coal;
};
@@ -1574,7 +1574,7 @@ \subsubsection{Control Virtqueue}\label{sec:Device Types
/ Network Device / Devi
Coalescing parameters:
\begin{itemize}
-\item \field{vqn}: The virtqueue number of an enabled transmit or receive
virtqueue.
+\item \field{vq_index}: The virtqueue index of an enabled transmit or receive
virtqueue.
\item \field{max_usecs} for RX: Maximum number of microseconds to delay a RX
notification.
\item \field{max_usecs} for TX: Maximum number of microseconds to delay a TX
notification.
\item \field{max_packets} for RX: Maximum number of packets to receive before
a RX notification.
@@ -1587,7 +1587,7 @@ \subsubsection{Control Virtqueue}\label{sec:Device Types
/ Network Device / Devi
\begin{itemize}
\item For commands VIRTIO_NET_CTRL_NOTF_COAL_TX_SET and
VIRTIO_NET_CTRL_NOTF_COAL_RX_SET, the structure virtio_net_ctrl_coal is
write-only for the driver.
\item For the command VIRTIO_NET_CTRL_NOTF_COAL_VQ_SET, the structure
virtio_net_ctrl_coal_vq is write-only for the driver.
-\item For the command VIRTIO_NET_CTRL_NOTF_COAL_VQ_GET, \field{vqn} and
\field{reserved} are write-only
+\item For the command VIRTIO_NET_CTRL_NOTF_COAL_VQ_GET, \field{vq_index} and
\field{reserved} are write-only
for the driver, and the structure virtio_net_ctrl_coal is read-only for
the driver.
\end{itemize}
@@ -1596,9 +1596,9 @@ \subsubsection{Control Virtqueue}\label{sec:Device Types
/ Network Device / Devi
\item VIRTIO_NET_CTRL_NOTF_COAL_TX_SET: use the structure virtio_net_ctrl_coal
to set the \field{max_usecs} and \field{max_packets} parameters for all
transmit virtqueues.
\item VIRTIO_NET_CTRL_NOTF_COAL_RX_SET: use the structure virtio_net_ctrl_coal
to set the \field{max_usecs} and \field{max_packets} parameters for all receive
virtqueues.
\item VIRTIO_NET_CTRL_NOTF_COAL_VQ_SET: use the structure
virtio_net_ctrl_coal_vq to set the \field{max_usecs} and \field{max_packets}
parameters
- for an enabled transmit/receive
virtqueue whose number is \field{vqn}.
+ for an enabled transmit/receive
virtqueue whose index is \field{vq_index}.
\item VIRTIO_NET_CTRL_NOTF_COAL_VQ_GET: use the structure
virtio_net_ctrl_coal_vq to get the \field{max_usecs} and \field{max_packets}
parameters
- for an enabled transmit/receive
virtqueue whose number is \field{vqn}.
+ for an enabled transmit/receive
virtqueue whose index is \field{vq_index}.
\end{enumerate}
The device may generate notifications more or less frequently than specified
by set commands of the VIRTIO_NET_CTRL_NOTF_COAL class.
@@ -1608,12 +1608,12 @@ \subsubsection{Control Virtqueue}\label{sec:Device
Types / Network Device / Devi
with two pairs of virtqueues as an example:
Each of the following commands sets \field{max_usecs} and \field{max_packets}
parameters for virtqueues.
\begin{itemize}
-\item Command1: VIRTIO_NET_CTRL_NOTF_COAL_RX_SET sets coalescing parameters
for virtqueues having vqn 0 and vqn 2. Virtqueues having vqn 1 and vqn 3 retain
their previous parameters.
-\item Command2: VIRTIO_NET_CTRL_NOTF_COAL_VQ_SET with \field{vqn} = 0 sets
coalescing parameters for virtqueue having vqn 0. Virtqueue having vqn 2
retains the parameters from command1.
-\item Command3: VIRTIO_NET_CTRL_NOTF_COAL_VQ_GET with \field{vqn} = 0, the
device responds with coalescing parameters of vqn 0 set by command2.
-\item Command4: VIRTIO_NET_CTRL_NOTF_COAL_VQ_SET with \field{vqn} = 1 sets
coalescing parameters for virtqueue having vqn 1. Virtqueue having vqn 3
retains its previous parameters.
-\item Command5: VIRTIO_NET_CTRL_NOTF_COAL_TX_SET sets coalescing parameters
for virtqueues having vqn 1 and vqn 3, and overrides the parameters set by
command4.
-\item Command6: VIRTIO_NET_CTRL_NOTF_COAL_VQ_GET with \field{vqn} = 1, the
device responds with coalescing parameters of vqn 1 set by command5.
+\item Command1: VIRTIO_NET_CTRL_NOTF_COAL_RX_SET sets coalescing parameters
for virtqueues having index 0 and index 2. Virtqueues having index 1 and index
3 retain their previous parameters.
+\item Command2: VIRTIO_NET_CTRL_NOTF_COAL_VQ_SET with \field{vq_index} = 0
sets coalescing parameters for virtqueue having index 0. Virtqueue having index
2 retains the parameters from command1.
+\item Command3: VIRTIO_NET_CTRL_NOTF_COAL_VQ_GET with \field{vq_index} = 0,
the device responds with coalescing parameters of vq_index 0 set by command2.
+\item Command4: VIRTIO_NET_CTRL_NOTF_COAL_VQ_SET with \field{vq_index} = 1
sets coalescing parameters for virtqueue having index 1. Virtqueue having index
3 retains its previous parameters.
+\item Command5: VIRTIO_NET_CTRL_NOTF_COAL_TX_SET sets coalescing parameters
for virtqueues having index 1 and index 3, and overrides the parameters set by
command4.
+\item Command6: VIRTIO_NET_CTRL_NOTF_COAL_VQ_GET with \field{vq_index} = 1,
the device responds with coalescing parameters of index 1 set by command5.
\end{itemize}
\subparagraph{Operation}\label{sec:Device Types / Network Device / Device
Operation / Control Virtqueue / Notifications Coalescing / Operation}
@@ -1663,7 +1663,7 @@ \subsubsection{Control Virtqueue}\label{sec:Device Types
/ Network Device / Devi
\drivernormative{\subparagraph}{Notifications Coalescing}{Device Types /
Network Device / Device Operation / Control Virtqueue / Notifications
Coalescing}
-The driver MUST set \field{vqn} to the virtqueue number of an enabled transmit
or receive virtqueue.
+The driver MUST set \field{vq_index} to the virtqueue index of an enabled
transmit or receive virtqueue.
The driver MUST have negotiated the VIRTIO_NET_F_NOTF_COAL feature when
issuing commands VIRTIO_NET_CTRL_NOTF_COAL_TX_SET and
VIRTIO_NET_CTRL_NOTF_COAL_RX_SET.
--
2.26.2
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
