Re: [PATCH DOCDAY v2] netif.h: describe request/response structures in terms of binary layout

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

On 25/02/15 13:39, Ian Campbell wrote:
> 
> + * Guest transmit
> + * ==============
> + *
> + * Ring slot size is 12 octets, however not all request/response
> + * structs use the full size.
> + *
> + * tx request data (netif_tx_request_t)
> + * ------------------------------------
> + *
> + *    0     1     2     3     4     5     6     7  octet
> + * +-----+-----+-----+-----+-----+-----+-----+-----+
> + * | grant ref             | offset    | flags     |
> + * +-----+-----+-----+-----+-----+-----+-----+-----+
> + * | id        | size      |
> + * +-----+-----+-----+-----+
> + *
> + * grant ref: Reference to buffer page.
> + * offset: Offset within buffer page.
> + * flags: NETTXF_*.
> + * id: request identifier, echoed in response.
> + * size: packet size in bytes.

This size field should be described better since it's a bit weird when a
packet it split across multiple requests -- I have to look at the
implementations every time.

David