[<prev] [next>] [day] [month] [year] [list]
Date: Mon, 3 Mar 2014 12:53:03 +0000
From: Paul Durrant <Paul.Durrant@...rix.com>
To: Andrew Bennieston <andrew.bennieston@...rix.com>,
"xen-devel@...ts.xenproject.org" <xen-devel@...ts.xenproject.org>
CC: Ian Campbell <Ian.Campbell@...rix.com>,
Wei Liu <wei.liu2@...rix.com>,
"netdev@...r.kernel.org" <netdev@...r.kernel.org>,
David Vrabel <david.vrabel@...rix.com>,
Andrew Bennieston <andrew.bennieston@...rix.com>
Subject: RE: [PATCH V6 net-next 5/5] xen-net{back,front}: Document
multi-queue feature in netif.h
> -----Original Message-----
> From: Andrew J. Bennieston [mailto:andrew.bennieston@...rix.com]
> Sent: 03 March 2014 11:48
> To: xen-devel@...ts.xenproject.org
> Cc: Ian Campbell; Wei Liu; Paul Durrant; netdev@...r.kernel.org; David
> Vrabel; Andrew Bennieston
> Subject: [PATCH V6 net-next 5/5] xen-net{back,front}: Document multi-
> queue feature in netif.h
>
> From: "Andrew J. Bennieston" <andrew.bennieston@...rix.com>
>
> Document the multi-queue feature in terms of XenStore keys to be written
> by the backend and by the frontend.
>
> Signed-off-by: Andrew J. Bennieston <andrew.bennieston@...rix.com>
Reviewed-by: Paul Durrant <paul.durrant@...rix.com>
> ---
> include/xen/interface/io/netif.h | 29 +++++++++++++++++++++++++++++
> 1 file changed, 29 insertions(+)
>
> diff --git a/include/xen/interface/io/netif.h
> b/include/xen/interface/io/netif.h
> index c50061d..a375a75 100644
> --- a/include/xen/interface/io/netif.h
> +++ b/include/xen/interface/io/netif.h
> @@ -51,6 +51,35 @@
> */
>
> /*
> + * Multiple transmit and receive queues:
> + * If supported, the backend will write "multi-queue-max-queues" and set
> its
> + * value to the maximum supported number of queues.
> + * Frontends that are aware of this feature and wish to use it can write the
> + * key "multi-queue-num-queues", set to the number they wish to use.
> + *
> + * Queues replicate the shared rings and event channels, and
> + * "feature-split-event-channels" may be used when using multiple queues.
> + * Each queue consists of one shared ring pair, i.e. there must be the same
> + * number of tx and rx rings.
> + *
> + * For frontends requesting just one queue, the usual event-channel and
> + * ring-ref keys are written as before, simplifying the backend processing
> + * to avoid distinguishing between a frontend that doesn't understand the
> + * multi-queue feature, and one that does, but requested only one queue.
> + *
> + * Frontends requesting two or more queues must not write the toplevel
> + * event-channel (or event-channel-{tx,rx}) and {tx,rx}-ring-ref keys,
> + * instead writing them under sub-keys having the name "queue-N" where
> + * N is the integer ID of the queue for which those keys belong. Queues
> + * are indexed from zero.
> + *
> + * Mapping of packets to queues is considered to be a function of the
> + * transmitting system (backend or frontend) and is not negotiated
> + * between the two. Guests are free to transmit packets on any queue
> + * they choose, provided it has been set up correctly.
> + */
> +
> +/*
> * "feature-no-csum-offload" should be used to turn IPv4 TCP/UDP
> checksum
> * offload off or on. If it is missing then the feature is assumed to be on.
> * "feature-ipv6-csum-offload" should be used to turn IPv6 TCP/UDP
> checksum
> --
> 1.7.10.4
--
To unsubscribe from this list: send the line "unsubscribe netdev" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
Powered by blists - more mailing lists