xen: netif.h: document feature-split-event-channels
authorWei Liu <wei.liu2@citrix.com>
Wed, 22 May 2013 06:34:47 +0000 (06:34 +0000)
committerDavid S. Miller <davem@davemloft.net>
Fri, 24 May 2013 01:40:37 +0000 (18:40 -0700)
This patch synchronises documentation for feature-split-event-channels from
Xen canonical header file.

Signed-off-by: Wei Liu <wei.liu2@citrix.com>
Signed-off-by: David S. Miller <davem@davemloft.net>
include/xen/interface/io/netif.h

index 3ef3fe05ee99c55aa27d7c3eb5f828935b89ed59..eb262e3324d2fca44da8c88bf3127fd4da65b118 100644 (file)
  * that it cannot safely queue packets (as it may not be kicked to send them).
  */
 
+ /*
+ * "feature-split-event-channels" is introduced to separate guest TX
+ * and RX notificaion. Backend either doesn't support this feature or
+ * advertise it via xenstore as 0 (disabled) or 1 (enabled).
+ *
+ * To make use of this feature, frontend should allocate two event
+ * channels for TX and RX, advertise them to backend as
+ * "event-channel-tx" and "event-channel-rx" respectively. If frontend
+ * doesn't want to use this feature, it just writes "event-channel"
+ * node as before.
+ */
+
 /*
  * This is the 'wire' format for packets:
  *  Request 1: xen_netif_tx_request  -- XEN_NETTXF_* (any flags)