Re: [PATCH 2/3] public/io/netif.h: document control ring and toeplitz hashing

[David Vrabel <david.vrabel@citrix.com>]

On 23/12/15 10:06, Paul Durrant wrote:
> This patch documents a new shared (variable message length) ring between
> frontend and backend that can be used to pass bulk out-of-band data, such
> as that required to implement toeplitz hashing in the backend that is
> configurable by the frontend.
> 
> The patch then goes on to document the messages passed over the control
[...]
> ring that can be used to configure toeplitz hashing.
> --- a/xen/include/public/io/netif.h
> +++ b/xen/include/public/io/netif.h
> @@ -151,6 +151,326 @@
>   */
>  
>  /*
> + * Control ring:
[...]
> + *
> + * The layout of the shared page is as follows:
> + *
> + *    0     1     2     3     4     5     6     7  octet
> + * +-----+-----+-----+-----+-----+-----+-----+-----+
> + * |        req_cons       |        req_prod       |
> + * +-----+-----+-----+-----+-----+-----+-----+-----+
> + * |        rsp_cons       |        rsp_prod       |
> + * +-----+-----+-----+-----+-----+-----+-----+-----+
> + * |                                               |
> + * +                                               +
> + * |                      req[1024]                |
> + *                         .
> + *                         .
> + * |                                               |
> + * +-----+-----+-----+-----+-----+-----+-----+-----+
> + * |                                               |
> + * +                                               +
> + * |                      rsp[1024]                |
> + *                         .
> + *                         .
> + * |                                               |
> + * +-----+-----+-----+-----+-----+-----+-----+-----+

You should use the standard ring format and infrastructure.

David