OvmfPkg/XenBusDxe: Add Event Channel into XenBus protocol.

This patch adds three event channel related functions:
- EventChannelAllocate: Allocate an event channel port that can be bind
  from a specified domain.
- EventChannelNotify: Send an event to the remote end of a channel.
- EventChannelClose: Close a local event channel port.

Change in V3:
- eventchannel, update protocol to return error code.
- expand patch description
- Add comments in the XenBus Protocol header.

Change in V2:
- coding style
- adding comment to functions
- Rename Xenbus to XenBus.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Anthony PERARD <anthony.perard@citrix.com>
Reviewed-by: Jordan Justen <jordan.l.justen@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@16271 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
Anthony PERARD 2014-10-29 06:51:26 +00:00 committed by jljusten
parent 86d968e05e
commit e86895d9e4
4 changed files with 163 additions and 0 deletions

View File

@ -63,6 +63,7 @@ typedef enum {
#include <IndustryStandard/Xen/grant_table.h>
#include <IndustryStandard/Xen/event_channel.h>
///
/// Function prototypes
@ -249,6 +250,54 @@ EFI_STATUS
IN grant_ref_t Ref
);
/**
Allocate a port that can be bind from domain DomainId.
@param This A pointer to the XENBUS_PROTOCOL.
@param DomainId The domain ID that can bind the newly allocated port.
@param Port A pointer to a evtchn_port_t that will contain the newly
allocated port.
@retval UINT32 The return value from the hypercall, 0 if success.
**/
typedef
UINT32
(EFIAPI *XENBUS_EVENT_CHANNEL_ALLOCATE) (
IN XENBUS_PROTOCOL *This,
IN domid_t DomainId,
OUT evtchn_port_t *Port
);
/**
Send an event to the remote end of the channel whose local endpoint is Port.
@param This A pointer to the XENBUS_PROTOCOL.
@param Port Local port to the the event from.
@retval UINT32 The return value from the hypercall, 0 if success.
**/
typedef
UINT32
(EFIAPI *XENBUS_EVENT_CHANNEL_NOTIFY) (
IN XENBUS_PROTOCOL *This,
IN evtchn_port_t Port
);
/**
Close a local event channel Port.
@param This A pointer to the XENBUS_PROTOCOL.
@param Port The event channel to close.
@retval UINT32 The return value from the hypercall, 0 if success.
**/
typedef
UINT32
(EFIAPI *XENBUS_EVENT_CHANNEL_CLOSE) (
IN XENBUS_PROTOCOL *This,
IN evtchn_port_t Port
);
/**
Register a XenStore watch.
@ -345,6 +394,10 @@ struct _XENBUS_PROTOCOL {
XENBUS_GRANT_ACCESS GrantAccess;
XENBUS_GRANT_END_ACCESS GrantEndAccess;
XENBUS_EVENT_CHANNEL_ALLOCATE EventChannelAllocate;
XENBUS_EVENT_CHANNEL_NOTIFY EventChannelNotify;
XENBUS_EVENT_CHANNEL_CLOSE EventChannelClose;
XENBUS_REGISTER_WATCH RegisterWatch;
XENBUS_REGISTER_WATCH_BACKEND RegisterWatchBackend;
XENBUS_UNREGISTER_WATCH UnregisterWatch;

View File

@ -31,3 +31,58 @@ XenEventChannelNotify (
ReturnCode = XenHypercallEventChannelOp (Dev, EVTCHNOP_send, &Send);
return ReturnCode;
}
UINT32
EFIAPI
XenBusEventChannelAllocate (
IN XENBUS_PROTOCOL *This,
IN domid_t DomainId,
OUT evtchn_port_t *Port
)
{
XENBUS_PRIVATE_DATA *Private;
evtchn_alloc_unbound_t Parameter;
UINT32 ReturnCode;
Private = XENBUS_PRIVATE_DATA_FROM_THIS (This);
Parameter.dom = DOMID_SELF;
Parameter.remote_dom = DomainId;
ReturnCode = XenHypercallEventChannelOp (Private->Dev,
EVTCHNOP_alloc_unbound,
&Parameter);
if (ReturnCode != 0) {
DEBUG ((EFI_D_ERROR, "ERROR: alloc_unbound failed with rc=%d", ReturnCode));
return ReturnCode;
}
*Port = Parameter.port;
return ReturnCode;
}
UINT32
EFIAPI
XenBusEventChannelNotify (
IN XENBUS_PROTOCOL *This,
IN evtchn_port_t Port
)
{
XENBUS_PRIVATE_DATA *Private;
Private = XENBUS_PRIVATE_DATA_FROM_THIS(This);
return XenEventChannelNotify (Private->Dev, Port);
}
UINT32
EFIAPI
XenBusEventChannelClose (
IN XENBUS_PROTOCOL *This,
IN evtchn_port_t Port
)
{
XENBUS_PRIVATE_DATA *Private;
evtchn_close_t Close;
Private = XENBUS_PRIVATE_DATA_FROM_THIS (This);
Close.port = Port;
return XenHypercallEventChannelOp (Private->Dev, EVTCHNOP_close, &Close);
}

View File

@ -33,4 +33,56 @@ XenEventChannelNotify (
IN evtchn_port_t Port
);
/*
* XenBus protocol
*/
/**
Allocate a port that can be bind from domain DomainId.
@param This A pointer to the XENBUS_PROTOCOL.
@param DomainId The domain ID that can bind the newly allocated port.
@param Port A pointer to a evtchn_port_t that will contain the newly
allocated port.
@retval UINT32 The return value from the hypercall, 0 if success.
**/
UINT32
EFIAPI
XenBusEventChannelAllocate (
IN XENBUS_PROTOCOL *This,
IN domid_t DomainId,
OUT evtchn_port_t *Port
);
/**
Send an event to the remote end of the channel whose local endpoint is Port.
@param This A pointer to the XENBUS_PROTOCOL.
@param Port Local port to the the event from.
@retval UINT32 The return value from the hypercall, 0 if success.
**/
UINT32
EFIAPI
XenBusEventChannelNotify (
IN XENBUS_PROTOCOL *This,
IN evtchn_port_t Port
);
/**
Close a local event channel Port.
@param This A pointer to the XENBUS_PROTOCOL.
@param Port The event channel to close.
@retval UINT32 The return value from the hypercall, 0 if success.
**/
UINT32
EFIAPI
XenBusEventChannelClose (
IN XENBUS_PROTOCOL *This,
IN evtchn_port_t Port
);
#endif

View File

@ -359,6 +359,9 @@ STATIC XENBUS_PRIVATE_DATA gXenBusPrivateData = {
.XenBusIo.SetState = XenBusSetState,
.XenBusIo.GrantAccess = XenBusGrantAccess,
.XenBusIo.GrantEndAccess = XenBusGrantEndAccess,
.XenBusIo.EventChannelAllocate = XenBusEventChannelAllocate,
.XenBusIo.EventChannelNotify = XenBusEventChannelNotify,
.XenBusIo.EventChannelClose = XenBusEventChannelClose,
.XenBusIo.RegisterWatch = XenBusRegisterWatch,
.XenBusIo.RegisterWatchBackend = XenBusRegisterWatchBackend,
.XenBusIo.UnregisterWatch = XenBusUnregisterWatch,