Linux Kernel  3.7.1
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
event_channel.h
Go to the documentation of this file.
1 /******************************************************************************
2  * event_channel.h
3  *
4  * Event channels between domains.
5  *
6  * Copyright (c) 2003-2004, K A Fraser.
7  */
8 
9 #ifndef __XEN_PUBLIC_EVENT_CHANNEL_H__
10 #define __XEN_PUBLIC_EVENT_CHANNEL_H__
11 
12 #include <xen/interface/xen.h>
13 
16 
17 /*
18  * EVTCHNOP_alloc_unbound: Allocate a port in domain <dom> and mark as
19  * accepting interdomain bindings from domain <remote_dom>. A fresh port
20  * is allocated in <dom> and returned as <port>.
21  * NOTES:
22  * 1. If the caller is unprivileged then <dom> must be DOMID_SELF.
23  * 2. <rdom> may be DOMID_SELF, allowing loopback connections.
24  */
25 #define EVTCHNOP_alloc_unbound 6
27  /* IN parameters */
29  /* OUT parameters */
31 };
32 
33 /*
34  * EVTCHNOP_bind_interdomain: Construct an interdomain event channel between
35  * the calling domain and <remote_dom>. <remote_dom,remote_port> must identify
36  * a port that is unbound and marked as accepting bindings from the calling
37  * domain. A fresh port is allocated in the calling domain and returned as
38  * <local_port>.
39  * NOTES:
40  * 2. <remote_dom> may be DOMID_SELF, allowing loopback connections.
41  */
42 #define EVTCHNOP_bind_interdomain 0
44  /* IN parameters. */
47  /* OUT parameters. */
49 };
50 
51 /*
52  * EVTCHNOP_bind_virq: Bind a local event channel to VIRQ <irq> on specified
53  * vcpu.
54  * NOTES:
55  * 1. A virtual IRQ may be bound to at most one event channel per vcpu.
56  * 2. The allocated event channel is bound to the specified vcpu. The binding
57  * may not be changed.
58  */
59 #define EVTCHNOP_bind_virq 1
61  /* IN parameters. */
64  /* OUT parameters. */
66 };
67 
68 /*
69  * EVTCHNOP_bind_pirq: Bind a local event channel to PIRQ <irq>.
70  * NOTES:
71  * 1. A physical IRQ may be bound to at most one event channel per domain.
72  * 2. Only a sufficiently-privileged domain may bind to a physical IRQ.
73  */
74 #define EVTCHNOP_bind_pirq 2
76  /* IN parameters. */
78 #define BIND_PIRQ__WILL_SHARE 1
79  uint32_t flags; /* BIND_PIRQ__* */
80  /* OUT parameters. */
82 };
83 
84 /*
85  * EVTCHNOP_bind_ipi: Bind a local event channel to receive events.
86  * NOTES:
87  * 1. The allocated event channel is bound to the specified vcpu. The binding
88  * may not be changed.
89  */
90 #define EVTCHNOP_bind_ipi 7
93  /* OUT parameters. */
95 };
96 
97 /*
98  * EVTCHNOP_close: Close a local event channel <port>. If the channel is
99  * interdomain then the remote end is placed in the unbound state
100  * (EVTCHNSTAT_unbound), awaiting a new connection.
101  */
102 #define EVTCHNOP_close 3
103 struct evtchn_close {
104  /* IN parameters. */
106 };
107 
108 /*
109  * EVTCHNOP_send: Send an event to the remote end of the channel whose local
110  * endpoint is <port>.
111  */
112 #define EVTCHNOP_send 4
113 struct evtchn_send {
114  /* IN parameters. */
116 };
117 
118 /*
119  * EVTCHNOP_status: Get the current status of the communication channel which
120  * has an endpoint at <dom, port>.
121  * NOTES:
122  * 1. <dom> may be specified as DOMID_SELF.
123  * 2. Only a sufficiently-privileged domain may obtain the status of an event
124  * channel for which <dom> is not DOMID_SELF.
125  */
126 #define EVTCHNOP_status 5
128  /* IN parameters */
131  /* OUT parameters */
132 #define EVTCHNSTAT_closed 0 /* Channel is not in use. */
133 #define EVTCHNSTAT_unbound 1 /* Channel is waiting interdom connection.*/
134 #define EVTCHNSTAT_interdomain 2 /* Channel is connected to remote domain. */
135 #define EVTCHNSTAT_pirq 3 /* Channel is bound to a phys IRQ line. */
136 #define EVTCHNSTAT_virq 4 /* Channel is bound to a virtual IRQ line */
137 #define EVTCHNSTAT_ipi 5 /* Channel is bound to a virtual IPI line */
139  uint32_t vcpu; /* VCPU to which this channel is bound. */
140  union {
141  struct {
142  domid_t dom;
143  } unbound; /* EVTCHNSTAT_unbound */
144  struct {
145  domid_t dom;
147  } interdomain; /* EVTCHNSTAT_interdomain */
148  uint32_t pirq; /* EVTCHNSTAT_pirq */
149  uint32_t virq; /* EVTCHNSTAT_virq */
150  } u;
151 };
152 
153 /*
154  * EVTCHNOP_bind_vcpu: Specify which vcpu a channel should notify when an
155  * event is pending.
156  * NOTES:
157  * 1. IPI- and VIRQ-bound channels always notify the vcpu that initialised
158  * the binding. This binding cannot be changed.
159  * 2. All other channels notify vcpu0 by default. This default is set when
160  * the channel is allocated (a port that is freed and subsequently reused
161  * has its binding reset to vcpu0).
162  */
163 #define EVTCHNOP_bind_vcpu 8
165  /* IN parameters. */
168 };
169 
170 /*
171  * EVTCHNOP_unmask: Unmask the specified local event-channel port and deliver
172  * a notification to the appropriate VCPU if an event is pending.
173  */
174 #define EVTCHNOP_unmask 9
176  /* IN parameters. */
178 };
179 
180 struct evtchn_op {
181  uint32_t cmd; /* EVTCHNOP_* */
182  union {
193  } u;
194 };
196 
197 #endif /* __XEN_PUBLIC_EVENT_CHANNEL_H__ */