[PATCH] network device: document VIRTIO_NET_F_CTRL_RX_EXTRA

VIRTIO-124  Signed-off-by: Michael S. Tsirkin <> ---  content.tex
31 ++++++++++++++++++++++++++++---  1 file changed, 28 insertions(+), 3 deletions(-)  diff --git a/content.tex b/content.tex index b287f5f..10d1320 100644 --- a/content.tex +++ b/content.tex @@ -3659,13 +3659,38 @@ packets could still arrive.  #define VIRTIO_NET_CTRL_RX
0
#define VIRTIO_NET_CTRL_RX_PROMISC
0
#define VIRTIO_NET_CTRL_RX_ALLMULTI
1 + #define VIRTIO_NET_CTRL_RX_ALLUNI
2 + #define VIRTIO_NET_CTRL_RX_NOMULTI
3 + #define VIRTIO_NET_CTRL_RX_NOUNI
4 + #define VIRTIO_NET_CTRL_RX_NOBCAST
5  end{lstlisting}
-The class VIRTIO_NET_CTRL_RX has two commands: -VIRTIO_NET_CTRL_RX_PROMISC turns promiscuous mode on and off, and -VIRTIO_NET_CTRL_RX_ALLMULTI turns all-multicast receive on and +The class VIRTIO_NET_CTRL_RX has the following commands: +egin{itemize} +item VIRTIO_NET_CTRL_RX_PROMISC turns promiscuous mode on and off +item VIRTIO_NET_CTRL_RX_ALLMULTI turns all-multicast receive on and +off. The command-specific-data is one byte containing 0 (off) or +1 (on). +item VIRTIO_NET_CTRL_RX_ALLUNI turns all-unicast receive on and  off. The command-specific-data is one byte containing 0 (off) or  1 (on). +item VIRTIO_NET_CTRL_RX_NOMULTI suppresses multicast receive. +The command-specific-data is one byte containing 0 (multicast +receive allowed) or 1 (multicast receive suppressed). +This takes effect even if VIRTIO_NET_CTRL_RX_ALLMULTI is on. +This filter does not apply to broadcast packets. +item VIRTIO_NET_CTRL_RX_NOUNI suppresses unicast receive. +The command-specific-data is one byte containing 0 (unicast +receive allowed) or 1 (unicast receive suppressed). +This takes effect even if VIRTIO_NET_CTRL_RX_UNI is on. +item VIRTIO_NET_CTRL_RX_NOBCAST suppresses broadcast receive. +The command-specific-data is one byte containing 0 (broadcast +receive allowed) or 1 (broadcast receive suppressed). +This takes effect even if VIRTIO_NET_CTRL_RX_ALLMULTI is on. +end{itemize} + +Commands 0 and 1 are supported with the VIRTIO_NET_F_CTRL_RX +feature.  Commands 2-5 are added with VIRTIO_NET_F_CTRL_RX_EXTRA.
paragraph{Setting MAC Address Filtering}label{sec:Device Types / Network Device / Device Operation / Control Virtqueue / Setting MAC Address Filtering}

--
MST