mirror_edk2/OvmfPkg/XenBusDxe/EventChannel.h
Michael D Kinney b26f0cf9ee OvmfPkg: Replace BSD License with BSD+Patent License
https://bugzilla.tianocore.org/show_bug.cgi?id=1373

Replace BSD 2-Clause License with BSD+Patent License.  This change is
based on the following emails:

  https://lists.01.org/pipermail/edk2-devel/2019-February/036260.html
  https://lists.01.org/pipermail/edk2-devel/2018-October/030385.html

RFCs with detailed process for the license change:

  V3: https://lists.01.org/pipermail/edk2-devel/2019-March/038116.html
  V2: https://lists.01.org/pipermail/edk2-devel/2019-March/037669.html
  V1: https://lists.01.org/pipermail/edk2-devel/2019-March/037500.html

Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com>
Reviewed-by: Laszlo Ersek <lersek@redhat.com>
2019-04-09 10:58:19 -07:00

83 lines
1.9 KiB
C

/** @file
Event Channel function declaration.
Copyright (C) 2014, Citrix Ltd.
SPDX-License-Identifier: BSD-2-Clause-Patent
**/
#ifndef __XENBUS_EVENT_CHANNEL_H
#define __XENBUS_EVENT_CHANNEL_H
#include "XenBusDxe.h"
#include <IndustryStandard/Xen/event_channel.h>
/**
Send an event to the remote end of the channel whose local endpoint is Port.
@param Dev A pointer to XENBUS_DEVICE.
@param Port The port to notify.
@return Return 0 on success, or return the errno code from the hypercall.
**/
UINT32
XenEventChannelNotify (
IN XENBUS_DEVICE *Dev,
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