1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
|
/** @file
* Manage XenBus device path and I/O handles
*
* Copyright (c) 2015, Linaro Ltd. All rights reserved.<BR>
*
* SPDX-License-Identifier: BSD-2-Clause-Patent
*
**/
#include <Library/BaseLib.h>
#include <Library/UefiBootServicesTableLib.h>
#include <Library/DebugLib.h>
#include <Library/UefiLib.h>
#include <Library/BaseMemoryLib.h>
#include <Library/MemoryAllocationLib.h>
#include <Library/DevicePathLib.h>
#include <Library/XenIoMmioLib.h>
#include <Protocol/XenIo.h>
#include <Guid/XenBusRootDevice.h>
#pragma pack (1)
typedef struct {
VENDOR_DEVICE_PATH Vendor;
EFI_PHYSICAL_ADDRESS GrantTableAddress;
EFI_DEVICE_PATH_PROTOCOL End;
} XENBUS_ROOT_DEVICE_PATH;
#pragma pack ()
STATIC CONST XENBUS_ROOT_DEVICE_PATH mXenBusRootDevicePathTemplate = {
{
{
HARDWARE_DEVICE_PATH,
HW_VENDOR_DP,
{ sizeof (VENDOR_DEVICE_PATH) + sizeof (EFI_PHYSICAL_ADDRESS), 0 }
},
XENBUS_ROOT_DEVICE_GUID,
},
0,
{
END_DEVICE_PATH_TYPE,
END_ENTIRE_DEVICE_PATH_SUBTYPE,
{ sizeof (EFI_DEVICE_PATH_PROTOCOL), 0 }
}
};
/**
Install the XENBUS_ROOT_DEVICE_PATH and XENIO_PROTOCOL protocols on
the handle pointed to by @Handle, or on a new handle if it points to
NULL
@param Handle Pointer to the handle to install the protocols
on, may point to a NULL handle.
@param GrantTableAddress The address of the Xen grant table
@retval EFI_SUCCESS Protocols were installed successfully
@retval EFI_OUT_OF_RESOURCES The function failed to allocate memory required
by the XenIo MMIO and device path protocols
@return Status code returned by the boot service
InstallMultipleProtocolInterfaces ()
**/
EFI_STATUS
XenIoMmioInstall (
IN OUT EFI_HANDLE *Handle,
IN EFI_PHYSICAL_ADDRESS GrantTableAddress
)
{
EFI_STATUS Status;
XENIO_PROTOCOL *XenIo;
XENBUS_ROOT_DEVICE_PATH *XenBusDevicePath;
EFI_HANDLE OutHandle;
ASSERT (Handle != NULL);
OutHandle = *Handle;
XenIo = AllocateZeroPool (sizeof *XenIo);
if (!XenIo) {
return EFI_OUT_OF_RESOURCES;
}
XenIo->GrantTableAddress = GrantTableAddress;
XenBusDevicePath = AllocateCopyPool (
sizeof *XenBusDevicePath,
&mXenBusRootDevicePathTemplate
);
if (!XenBusDevicePath) {
DEBUG ((DEBUG_ERROR, "%a: Out of memory\n", __FUNCTION__));
Status = EFI_OUT_OF_RESOURCES;
goto FreeXenIo;
}
XenBusDevicePath->GrantTableAddress = GrantTableAddress;
Status = gBS->InstallMultipleProtocolInterfaces (
&OutHandle,
&gEfiDevicePathProtocolGuid,
XenBusDevicePath,
&gXenIoProtocolGuid,
XenIo,
NULL
);
if (!EFI_ERROR (Status)) {
*Handle = OutHandle;
return EFI_SUCCESS;
}
DEBUG ((
DEBUG_ERROR,
"%a: Failed to install the EFI_DEVICE_PATH and "
"XENIO_PROTOCOL protocols on handle %p (Status == %r)\n",
__FUNCTION__,
OutHandle,
Status
));
FreePool (XenBusDevicePath);
FreeXenIo:
FreePool (XenIo);
return Status;
}
/**
Uninstall the XENBUS_ROOT_DEVICE_PATH and XENIO_PROTOCOL protocols
@param Handle Handle onto which the protocols have been installed
earlier by XenIoMmioInstall ()
@retval EFI_SUCCESS Protocols were uninstalled successfully
@return Status code returned by the boot service
UninstallMultipleProtocolInterfaces ()
**/
EFI_STATUS
XenIoMmioUninstall (
IN EFI_HANDLE Handle
)
{
EFI_STATUS Status;
VOID *XenIo;
VOID *XenBusDevicePath;
XenBusDevicePath = NULL;
gBS->OpenProtocol (
Handle,
&gEfiDevicePathProtocolGuid,
&XenBusDevicePath,
NULL,
NULL,
EFI_OPEN_PROTOCOL_GET_PROTOCOL
);
XenIo = NULL;
gBS->OpenProtocol (
Handle,
&gXenIoProtocolGuid,
&XenIo,
NULL,
NULL,
EFI_OPEN_PROTOCOL_GET_PROTOCOL
);
Status = gBS->UninstallMultipleProtocolInterfaces (
Handle,
&gEfiDevicePathProtocolGuid,
XenBusDevicePath,
&gXenIoProtocolGuid,
XenIo,
NULL
);
if (EFI_ERROR (Status)) {
return Status;
}
FreePool (XenBusDevicePath);
FreePool (XenIo);
return EFI_SUCCESS;
}
|
