aboutsummaryrefslogtreecommitdiffstats
path: root/xen/include/public
diff options
context:
space:
mode:
authorWei Liu <wei.liu2@citrix.com>2013-05-22 16:44:45 +0200
committerJan Beulich <jbeulich@suse.com>2013-05-22 16:44:45 +0200
commit9204bc654562976c7cdebf21c6b5013f6e3057b3 (patch)
tree37255cbc33c29d28c1d6410ddc8444796c51687d /xen/include/public
parent6d243308e1d75f866679db226159c797d6c83aad (diff)
downloadxen-9204bc654562976c7cdebf21c6b5013f6e3057b3.tar.gz
xen-9204bc654562976c7cdebf21c6b5013f6e3057b3.tar.bz2
xen-9204bc654562976c7cdebf21c6b5013f6e3057b3.zip
netif: document feature-split-event-channel
This is a new feature to separate TX and RX notification. Document it in canonical header for future reference. For reference implementation, please see Xen network driver in Linux kernel. Signed-off-by: Wei Liu <wei.liu2@citrix.com>
Diffstat (limited to 'xen/include/public')
-rw-r--r--xen/include/public/io/netif.h12
1 files changed, 12 insertions, 0 deletions
diff --git a/xen/include/public/io/netif.h b/xen/include/public/io/netif.h
index 9664998f05..d477751d73 100644
--- a/xen/include/public/io/netif.h
+++ b/xen/include/public/io/netif.h
@@ -57,6 +57,18 @@
*/
/*
+ * "feature-split-event-channels" is introduced to separate guest TX
+ * and RX notification. Backend either doesn't support this feature or
+ * advertises 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: netif_tx_request -- NETTXF_* (any flags)
* [Request 2: netif_tx_extra] (only if request 1 has NETTXF_extra_info)