From mboxrd@z Thu Jan  1 00:00:00 1970
From: David Vrabel <david.vrabel@citrix.com>
Subject: Re: [PATCH 2/3] public/io/netif.h: document control
 ring and toeplitz hashing
Date: Wed, 23 Dec 2015 13:27:36 +0000
Message-ID: <567AA148.4070207@citrix.com>
References: <1450865195-12883-1-git-send-email-paul.durrant@citrix.com>
	<1450865195-12883-3-git-send-email-paul.durrant@citrix.com>
Mime-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
Return-path: <xen-devel-bounces@lists.xen.org>
Received: from mail6.bemta14.messagelabs.com ([193.109.254.103])
	by lists.xen.org with esmtp (Exim 4.72)
	(envelope-from <prvs=792455dd0=david.vrabel@citrix.com>)
	id 1aBjSC-0006Tn-A3
	for xen-devel@lists.xenproject.org; Wed, 23 Dec 2015 13:27:44 +0000
In-Reply-To: <1450865195-12883-3-git-send-email-paul.durrant@citrix.com>
List-Unsubscribe: <http://lists.xen.org/cgi-bin/mailman/options/xen-devel>,
	<mailto:xen-devel-request@lists.xen.org?subject=unsubscribe>
List-Post: <mailto:xen-devel@lists.xen.org>
List-Help: <mailto:xen-devel-request@lists.xen.org?subject=help>
List-Subscribe: <http://lists.xen.org/cgi-bin/mailman/listinfo/xen-devel>,
	<mailto:xen-devel-request@lists.xen.org?subject=subscribe>
Sender: xen-devel-bounces@lists.xen.org
Errors-To: xen-devel-bounces@lists.xen.org
To: Paul Durrant <paul.durrant@citrix.com>, xen-devel@lists.xenproject.org
Cc: Ian Jackson <ian.jackson@eu.citrix.com>, Tim Deegan <tim@xen.org>, Keir Fraser <keir@xen.org>, Ian Campbell <ian.campbell@citrix.com>, Jan Beulich <jbeulich@suse.com>
List-Id: xen-devel@lists.xenproject.org

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