1 | /** @file
|
---|
2 | *
|
---|
3 | * VirtualBox Driver Interface to VMM device
|
---|
4 | */
|
---|
5 |
|
---|
6 | /*
|
---|
7 | * Copyright (C) 2006-2007 innotek GmbH
|
---|
8 | *
|
---|
9 | * This file is part of VirtualBox Open Source Edition (OSE), as
|
---|
10 | * available from http://www.virtualbox.org. This file is free software;
|
---|
11 | * you can redistribute it and/or modify it under the terms of the GNU
|
---|
12 | * General Public License (GPL) as published by the Free Software
|
---|
13 | * Foundation, in version 2 as it comes in the "COPYING" file of the
|
---|
14 | * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
|
---|
15 | * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
|
---|
16 | */
|
---|
17 |
|
---|
18 | #include "VMMDev.h"
|
---|
19 | #include "ConsoleImpl.h"
|
---|
20 | #include "DisplayImpl.h"
|
---|
21 | #include "GuestImpl.h"
|
---|
22 |
|
---|
23 | #include "Logging.h"
|
---|
24 |
|
---|
25 | #include <VBox/pdmdrv.h>
|
---|
26 | #include <VBox/VBoxDev.h>
|
---|
27 | #include <VBox/VBoxGuest.h>
|
---|
28 | #include <VBox/shflsvc.h>
|
---|
29 | #include <iprt/asm.h>
|
---|
30 |
|
---|
31 | #ifdef VBOX_HGCM
|
---|
32 | #include "hgcm/HGCM.h"
|
---|
33 | #include "hgcm/HGCMObjects.h"
|
---|
34 | #endif
|
---|
35 |
|
---|
36 | //
|
---|
37 | // defines
|
---|
38 | //
|
---|
39 |
|
---|
40 | #ifdef RT_OS_OS2
|
---|
41 | # define VBOXSHAREDFOLDERS_DLL "VBoxSFld"
|
---|
42 | #else
|
---|
43 | # define VBOXSHAREDFOLDERS_DLL "VBoxSharedFolders"
|
---|
44 | #endif
|
---|
45 |
|
---|
46 | //
|
---|
47 | // globals
|
---|
48 | //
|
---|
49 |
|
---|
50 |
|
---|
51 | /**
|
---|
52 | * VMMDev driver instance data.
|
---|
53 | */
|
---|
54 | typedef struct DRVMAINVMMDEV
|
---|
55 | {
|
---|
56 | /** Pointer to the VMMDev object. */
|
---|
57 | VMMDev *pVMMDev;
|
---|
58 | /** Pointer to the driver instance structure. */
|
---|
59 | PPDMDRVINS pDrvIns;
|
---|
60 | /** Pointer to the VMMDev port interface of the driver/device above us. */
|
---|
61 | PPDMIVMMDEVPORT pUpPort;
|
---|
62 | /** Our VMM device connector interface. */
|
---|
63 | PDMIVMMDEVCONNECTOR Connector;
|
---|
64 |
|
---|
65 | #ifdef VBOX_HGCM
|
---|
66 | /** Pointer to the HGCM port interface of the driver/device above us. */
|
---|
67 | PPDMIHGCMPORT pHGCMPort;
|
---|
68 | /** Our HGCM connector interface. */
|
---|
69 | PDMIHGCMCONNECTOR HGCMConnector;
|
---|
70 | #endif
|
---|
71 | } DRVMAINVMMDEV, *PDRVMAINVMMDEV;
|
---|
72 |
|
---|
73 | /** Converts PDMIVMMDEVCONNECTOR pointer to a DRVMAINVMMDEV pointer. */
|
---|
74 | #define PDMIVMMDEVCONNECTOR_2_MAINVMMDEV(pInterface) ( (PDRVMAINVMMDEV) ((uintptr_t)pInterface - RT_OFFSETOF(DRVMAINVMMDEV, Connector)) )
|
---|
75 |
|
---|
76 | #ifdef VBOX_HGCM
|
---|
77 | /** Converts PDMIHGCMCONNECTOR pointer to a DRVMAINVMMDEV pointer. */
|
---|
78 | #define PDMIHGCMCONNECTOR_2_MAINVMMDEV(pInterface) ( (PDRVMAINVMMDEV) ((uintptr_t)pInterface - RT_OFFSETOF(DRVMAINVMMDEV, HGCMConnector)) )
|
---|
79 | #endif
|
---|
80 |
|
---|
81 | //
|
---|
82 | // constructor / destructor
|
---|
83 | //
|
---|
84 | VMMDev::VMMDev(Console *console) : mpDrv(NULL)
|
---|
85 | {
|
---|
86 | mParent = console;
|
---|
87 | int rc = RTSemEventCreate(&mCredentialsEvent);
|
---|
88 | AssertRC(rc);
|
---|
89 | #ifdef VBOX_HGCM
|
---|
90 | rc = HGCMHostInit ();
|
---|
91 | AssertRC(rc);
|
---|
92 | #endif /* VBOX_HGCM */
|
---|
93 | mu32CredentialsFlags = 0;
|
---|
94 | }
|
---|
95 |
|
---|
96 | VMMDev::~VMMDev()
|
---|
97 | {
|
---|
98 | RTSemEventDestroy (mCredentialsEvent);
|
---|
99 | if (mpDrv)
|
---|
100 | mpDrv->pVMMDev = NULL;
|
---|
101 | mpDrv = NULL;
|
---|
102 | }
|
---|
103 |
|
---|
104 | PPDMIVMMDEVPORT VMMDev::getVMMDevPort()
|
---|
105 | {
|
---|
106 | Assert(mpDrv);
|
---|
107 | return mpDrv->pUpPort;
|
---|
108 | }
|
---|
109 |
|
---|
110 |
|
---|
111 |
|
---|
112 | //
|
---|
113 | // public methods
|
---|
114 | //
|
---|
115 |
|
---|
116 | /**
|
---|
117 | * Wait on event semaphore for guest credential judgement result.
|
---|
118 | */
|
---|
119 | int VMMDev::WaitCredentialsJudgement (uint32_t u32Timeout, uint32_t *pu32CredentialsFlags)
|
---|
120 | {
|
---|
121 | if (u32Timeout == 0)
|
---|
122 | {
|
---|
123 | u32Timeout = 5000;
|
---|
124 | }
|
---|
125 |
|
---|
126 | int rc = RTSemEventWait (mCredentialsEvent, u32Timeout);
|
---|
127 |
|
---|
128 | if (VBOX_SUCCESS (rc))
|
---|
129 | {
|
---|
130 | *pu32CredentialsFlags = mu32CredentialsFlags;
|
---|
131 | }
|
---|
132 |
|
---|
133 | return rc;
|
---|
134 | }
|
---|
135 |
|
---|
136 | int VMMDev::SetCredentialsJudgementResult (uint32_t u32Flags)
|
---|
137 | {
|
---|
138 | mu32CredentialsFlags = u32Flags;
|
---|
139 |
|
---|
140 | int rc = RTSemEventSignal (mCredentialsEvent);
|
---|
141 | AssertRC(rc);
|
---|
142 |
|
---|
143 | return rc;
|
---|
144 | }
|
---|
145 |
|
---|
146 |
|
---|
147 | /**
|
---|
148 | * Report guest OS version.
|
---|
149 | * Called whenever the Additions issue a guest version report request.
|
---|
150 | *
|
---|
151 | * @param pInterface Pointer to this interface.
|
---|
152 | * @param guestInfo Pointer to guest information structure
|
---|
153 | * @thread The emulation thread.
|
---|
154 | */
|
---|
155 | DECLCALLBACK(void) vmmdevUpdateGuestVersion(PPDMIVMMDEVCONNECTOR pInterface, VBoxGuestInfo *guestInfo)
|
---|
156 | {
|
---|
157 | PDRVMAINVMMDEV pDrv = PDMIVMMDEVCONNECTOR_2_MAINVMMDEV(pInterface);
|
---|
158 |
|
---|
159 | Assert(guestInfo);
|
---|
160 | if (!guestInfo)
|
---|
161 | return;
|
---|
162 |
|
---|
163 | /* store that information in IGuest */
|
---|
164 | Guest* guest = pDrv->pVMMDev->getParent()->getGuest();
|
---|
165 | Assert(guest);
|
---|
166 | if (!guest)
|
---|
167 | return;
|
---|
168 |
|
---|
169 | char version[20];
|
---|
170 | RTStrPrintf(version, sizeof(version), "%d", guestInfo->additionsVersion);
|
---|
171 | guest->setAdditionsVersion(Bstr(version));
|
---|
172 |
|
---|
173 | /*
|
---|
174 | * Tell the console interface about the event
|
---|
175 | * so that it can notify its consumers.
|
---|
176 | */
|
---|
177 | pDrv->pVMMDev->getParent()->onAdditionsStateChange();
|
---|
178 |
|
---|
179 | if (guestInfo->additionsVersion < VMMDEV_VERSION)
|
---|
180 | {
|
---|
181 | pDrv->pVMMDev->getParent()->onAdditionsOutdated();
|
---|
182 | }
|
---|
183 | }
|
---|
184 |
|
---|
185 | /**
|
---|
186 | * Update the guest additions capabilities.
|
---|
187 | * This is called when the guest additions capabilities change. The new capabilities
|
---|
188 | * are given and the connector should update its internal state.
|
---|
189 | *
|
---|
190 | * @param pInterface Pointer to this interface.
|
---|
191 | * @param newCapabilities New capabilities.
|
---|
192 | * @thread The emulation thread.
|
---|
193 | */
|
---|
194 | DECLCALLBACK(void) vmmdevUpdateGuestCapabilities(PPDMIVMMDEVCONNECTOR pInterface, uint32_t newCapabilities)
|
---|
195 | {
|
---|
196 | PDRVMAINVMMDEV pDrv = PDMIVMMDEVCONNECTOR_2_MAINVMMDEV(pInterface);
|
---|
197 |
|
---|
198 | /* store that information in IGuest */
|
---|
199 | Guest* guest = pDrv->pVMMDev->getParent()->getGuest();
|
---|
200 | Assert(guest);
|
---|
201 | if (!guest)
|
---|
202 | return;
|
---|
203 |
|
---|
204 | Assert(!(newCapabilities & ~VMMDEV_GUEST_SUPPORTS_SEAMLESS));
|
---|
205 |
|
---|
206 | guest->setSupportsSeamless(BOOL (newCapabilities & VMMDEV_GUEST_SUPPORTS_SEAMLESS));
|
---|
207 |
|
---|
208 | /*
|
---|
209 | * Tell the console interface about the event
|
---|
210 | * so that it can notify its consumers.
|
---|
211 | */
|
---|
212 | pDrv->pVMMDev->getParent()->onAdditionsStateChange();
|
---|
213 |
|
---|
214 | }
|
---|
215 |
|
---|
216 | /**
|
---|
217 | * Update the mouse capabilities.
|
---|
218 | * This is called when the mouse capabilities change. The new capabilities
|
---|
219 | * are given and the connector should update its internal state.
|
---|
220 | *
|
---|
221 | * @param pInterface Pointer to this interface.
|
---|
222 | * @param newCapabilities New capabilities.
|
---|
223 | * @thread The emulation thread.
|
---|
224 | */
|
---|
225 | DECLCALLBACK(void) vmmdevUpdateMouseCapabilities(PPDMIVMMDEVCONNECTOR pInterface, uint32_t newCapabilities)
|
---|
226 | {
|
---|
227 | PDRVMAINVMMDEV pDrv = PDMIVMMDEVCONNECTOR_2_MAINVMMDEV(pInterface);
|
---|
228 | /*
|
---|
229 | * Tell the console interface about the event
|
---|
230 | * so that it can notify its consumers.
|
---|
231 | */
|
---|
232 | pDrv->pVMMDev->getParent()->onMouseCapabilityChange(BOOL (newCapabilities & VMMDEV_MOUSEGUESTWANTSABS),
|
---|
233 | BOOL (newCapabilities & VMMDEV_MOUSEGUESTNEEDSHOSTCUR));
|
---|
234 | }
|
---|
235 |
|
---|
236 |
|
---|
237 | /**
|
---|
238 | * Update the pointer shape or visibility.
|
---|
239 | *
|
---|
240 | * This is called when the mouse pointer shape changes or pointer is hidden/displaying.
|
---|
241 | * The new shape is passed as a caller allocated buffer that will be freed after returning.
|
---|
242 | *
|
---|
243 | * @param pInterface Pointer to this interface.
|
---|
244 | * @param fVisible Whether the pointer is visible or not.
|
---|
245 | * @param fAlpha Alpha channel information is present.
|
---|
246 | * @param xHot Horizontal coordinate of the pointer hot spot.
|
---|
247 | * @param yHot Vertical coordinate of the pointer hot spot.
|
---|
248 | * @param width Pointer width in pixels.
|
---|
249 | * @param height Pointer height in pixels.
|
---|
250 | * @param pShape The shape buffer. If NULL, then only pointer visibility is being changed.
|
---|
251 | * @thread The emulation thread.
|
---|
252 | */
|
---|
253 | DECLCALLBACK(void) vmmdevUpdatePointerShape(PPDMIVMMDEVCONNECTOR pInterface, bool fVisible, bool fAlpha,
|
---|
254 | uint32_t xHot, uint32_t yHot,
|
---|
255 | uint32_t width, uint32_t height,
|
---|
256 | void *pShape)
|
---|
257 | {
|
---|
258 | PDRVMAINVMMDEV pDrv = PDMIVMMDEVCONNECTOR_2_MAINVMMDEV(pInterface);
|
---|
259 |
|
---|
260 | /* tell the console about it */
|
---|
261 | pDrv->pVMMDev->getParent()->onMousePointerShapeChange(fVisible, fAlpha,
|
---|
262 | xHot, yHot, width, height, pShape);
|
---|
263 | }
|
---|
264 |
|
---|
265 | DECLCALLBACK(int) iface_VideoAccelEnable(PPDMIVMMDEVCONNECTOR pInterface, bool fEnable, VBVAMEMORY *pVbvaMemory)
|
---|
266 | {
|
---|
267 | PDRVMAINVMMDEV pDrv = PDMIVMMDEVCONNECTOR_2_MAINVMMDEV(pInterface);
|
---|
268 |
|
---|
269 | Display *display = pDrv->pVMMDev->getParent()->getDisplay();
|
---|
270 |
|
---|
271 | if (display)
|
---|
272 | {
|
---|
273 | LogSunlover(("MAIN::VMMDevInterface::iface_VideoAccelEnable: %d, %p\n", fEnable, pVbvaMemory));
|
---|
274 | return display->VideoAccelEnable (fEnable, pVbvaMemory);
|
---|
275 | }
|
---|
276 |
|
---|
277 | return VERR_NOT_SUPPORTED;
|
---|
278 | }
|
---|
279 | DECLCALLBACK(void) iface_VideoAccelFlush(PPDMIVMMDEVCONNECTOR pInterface)
|
---|
280 | {
|
---|
281 | PDRVMAINVMMDEV pDrv = PDMIVMMDEVCONNECTOR_2_MAINVMMDEV(pInterface);
|
---|
282 |
|
---|
283 | Display *display = pDrv->pVMMDev->getParent()->getDisplay();
|
---|
284 |
|
---|
285 | if (display)
|
---|
286 | {
|
---|
287 | LogSunlover(("MAIN::VMMDevInterface::iface_VideoAccelFlush\n"));
|
---|
288 | display->VideoAccelFlush ();
|
---|
289 | }
|
---|
290 | }
|
---|
291 |
|
---|
292 | DECLCALLBACK(int) vmmdevVideoModeSupported(PPDMIVMMDEVCONNECTOR pInterface, uint32_t width, uint32_t height,
|
---|
293 | uint32_t bpp, bool *fSupported)
|
---|
294 | {
|
---|
295 | PDRVMAINVMMDEV pDrv = PDMIVMMDEVCONNECTOR_2_MAINVMMDEV(pInterface);
|
---|
296 |
|
---|
297 | if (!fSupported)
|
---|
298 | return VERR_INVALID_PARAMETER;
|
---|
299 | IFramebuffer *framebuffer = pDrv->pVMMDev->getParent()->getDisplay()->getFramebuffer();
|
---|
300 | if (framebuffer)
|
---|
301 | framebuffer->VideoModeSupported(width, height, bpp, (BOOL*)fSupported);
|
---|
302 | else
|
---|
303 | *fSupported = true;
|
---|
304 | return VINF_SUCCESS;
|
---|
305 | }
|
---|
306 |
|
---|
307 | DECLCALLBACK(int) vmmdevGetHeightReduction(PPDMIVMMDEVCONNECTOR pInterface, uint32_t *heightReduction)
|
---|
308 | {
|
---|
309 | PDRVMAINVMMDEV pDrv = PDMIVMMDEVCONNECTOR_2_MAINVMMDEV(pInterface);
|
---|
310 |
|
---|
311 | if (!heightReduction)
|
---|
312 | return VERR_INVALID_PARAMETER;
|
---|
313 | IFramebuffer *framebuffer = pDrv->pVMMDev->getParent()->getDisplay()->getFramebuffer();
|
---|
314 | if (framebuffer)
|
---|
315 | framebuffer->COMGETTER(HeightReduction)((ULONG*)heightReduction);
|
---|
316 | else
|
---|
317 | *heightReduction = 0;
|
---|
318 | return VINF_SUCCESS;
|
---|
319 | }
|
---|
320 |
|
---|
321 | DECLCALLBACK(int) vmmdevSetCredentialsJudgementResult(PPDMIVMMDEVCONNECTOR pInterface, uint32_t u32Flags)
|
---|
322 | {
|
---|
323 | PDRVMAINVMMDEV pDrv = PDMIVMMDEVCONNECTOR_2_MAINVMMDEV(pInterface);
|
---|
324 |
|
---|
325 | int rc = pDrv->pVMMDev->SetCredentialsJudgementResult (u32Flags);
|
---|
326 |
|
---|
327 | return rc;
|
---|
328 | }
|
---|
329 |
|
---|
330 | DECLCALLBACK(int) vmmdevSetVisibleRegion(PPDMIVMMDEVCONNECTOR pInterface, uint32_t cRect, PRTRECT pRect)
|
---|
331 | {
|
---|
332 | PDRVMAINVMMDEV pDrv = PDMIVMMDEVCONNECTOR_2_MAINVMMDEV(pInterface);
|
---|
333 |
|
---|
334 | if (!cRect)
|
---|
335 | return VERR_INVALID_PARAMETER;
|
---|
336 | IFramebuffer *framebuffer = pDrv->pVMMDev->getParent()->getDisplay()->getFramebuffer();
|
---|
337 | if (framebuffer)
|
---|
338 | framebuffer->SetVisibleRegion((BYTE *)pRect, cRect);
|
---|
339 |
|
---|
340 | return VINF_SUCCESS;
|
---|
341 | }
|
---|
342 |
|
---|
343 | DECLCALLBACK(int) vmmdevQueryVisibleRegion(PPDMIVMMDEVCONNECTOR pInterface, uint32_t *pcRect, PRTRECT pRect)
|
---|
344 | {
|
---|
345 | PDRVMAINVMMDEV pDrv = PDMIVMMDEVCONNECTOR_2_MAINVMMDEV(pInterface);
|
---|
346 |
|
---|
347 | IFramebuffer *framebuffer = pDrv->pVMMDev->getParent()->getDisplay()->getFramebuffer();
|
---|
348 | if (framebuffer)
|
---|
349 | {
|
---|
350 | ULONG cRect = 0;
|
---|
351 | framebuffer->GetVisibleRegion((BYTE *)pRect, cRect, &cRect);
|
---|
352 |
|
---|
353 | *pcRect = cRect;
|
---|
354 | }
|
---|
355 |
|
---|
356 | return VINF_SUCCESS;
|
---|
357 | }
|
---|
358 |
|
---|
359 | /**
|
---|
360 | * Request the statistics interval
|
---|
361 | *
|
---|
362 | * @returns VBox status code.
|
---|
363 | * @param pInterface Pointer to this interface.
|
---|
364 | * @param pulInterval Pointer to interval in seconds
|
---|
365 | * @thread The emulation thread.
|
---|
366 | */
|
---|
367 | DECLCALLBACK(int) vmmdevQueryStatisticsInterval(PPDMIVMMDEVCONNECTOR pInterface, uint32_t *pulInterval)
|
---|
368 | {
|
---|
369 | PDRVMAINVMMDEV pDrv = PDMIVMMDEVCONNECTOR_2_MAINVMMDEV(pInterface);
|
---|
370 | ULONG val = 0;
|
---|
371 |
|
---|
372 | if (!pulInterval)
|
---|
373 | return VERR_INVALID_POINTER;
|
---|
374 |
|
---|
375 | /* store that information in IGuest */
|
---|
376 | Guest* guest = pDrv->pVMMDev->getParent()->getGuest();
|
---|
377 | Assert(guest);
|
---|
378 | if (!guest)
|
---|
379 | return VERR_INVALID_PARAMETER; /** @todo wrong error */
|
---|
380 |
|
---|
381 | guest->COMGETTER(StatisticsUpdateInterval)(&val);
|
---|
382 | *pulInterval = val;
|
---|
383 | return VINF_SUCCESS;
|
---|
384 | }
|
---|
385 |
|
---|
386 | /**
|
---|
387 | * Report new guest statistics
|
---|
388 | *
|
---|
389 | * @returns VBox status code.
|
---|
390 | * @param pInterface Pointer to this interface.
|
---|
391 | * @param pGuestStats Guest statistics
|
---|
392 | * @thread The emulation thread.
|
---|
393 | */
|
---|
394 | DECLCALLBACK(int) vmmdevReportStatistics(PPDMIVMMDEVCONNECTOR pInterface, VBoxGuestStatistics *pGuestStats)
|
---|
395 | {
|
---|
396 | PDRVMAINVMMDEV pDrv = PDMIVMMDEVCONNECTOR_2_MAINVMMDEV(pInterface);
|
---|
397 |
|
---|
398 | Assert(pGuestStats);
|
---|
399 | if (!pGuestStats)
|
---|
400 | return VERR_INVALID_POINTER;
|
---|
401 |
|
---|
402 | /* store that information in IGuest */
|
---|
403 | Guest* guest = pDrv->pVMMDev->getParent()->getGuest();
|
---|
404 | Assert(guest);
|
---|
405 | if (!guest)
|
---|
406 | return VERR_INVALID_PARAMETER; /** @todo wrong error */
|
---|
407 |
|
---|
408 | if (pGuestStats->u32StatCaps & VBOX_GUEST_STAT_CPU_LOAD_IDLE)
|
---|
409 | guest->SetStatistic(pGuestStats->u32CpuId, GuestStatisticType_CPULoad_Idle, pGuestStats->u32CpuLoad_Idle);
|
---|
410 |
|
---|
411 | if (pGuestStats->u32StatCaps & VBOX_GUEST_STAT_CPU_LOAD_KERNEL)
|
---|
412 | guest->SetStatistic(pGuestStats->u32CpuId, GuestStatisticType_CPULoad_Kernel, pGuestStats->u32CpuLoad_Kernel);
|
---|
413 |
|
---|
414 | if (pGuestStats->u32StatCaps & VBOX_GUEST_STAT_CPU_LOAD_USER)
|
---|
415 | guest->SetStatistic(pGuestStats->u32CpuId, GuestStatisticType_CPULoad_User, pGuestStats->u32CpuLoad_User);
|
---|
416 |
|
---|
417 | if (pGuestStats->u32StatCaps & VBOX_GUEST_STAT_THREADS)
|
---|
418 | guest->SetStatistic(pGuestStats->u32CpuId, GuestStatisticType_Threads, pGuestStats->u32Threads);
|
---|
419 |
|
---|
420 | if (pGuestStats->u32StatCaps & VBOX_GUEST_STAT_PROCESSES)
|
---|
421 | guest->SetStatistic(pGuestStats->u32CpuId, GuestStatisticType_Processes, pGuestStats->u32Processes);
|
---|
422 |
|
---|
423 | if (pGuestStats->u32StatCaps & VBOX_GUEST_STAT_HANDLES)
|
---|
424 | guest->SetStatistic(pGuestStats->u32CpuId, GuestStatisticType_Handles, pGuestStats->u32Handles);
|
---|
425 |
|
---|
426 | if (pGuestStats->u32StatCaps & VBOX_GUEST_STAT_MEMORY_LOAD)
|
---|
427 | guest->SetStatistic(pGuestStats->u32CpuId, GuestStatisticType_MemoryLoad, pGuestStats->u32MemoryLoad);
|
---|
428 |
|
---|
429 | /* Note that reported values are in pages; upper layers expect them in megabytes */
|
---|
430 | Assert(pGuestStats->u32PageSize == 4096);
|
---|
431 | if (pGuestStats->u32PageSize != 4096)
|
---|
432 | pGuestStats->u32PageSize = 4096;
|
---|
433 |
|
---|
434 | if (pGuestStats->u32StatCaps & VBOX_GUEST_STAT_PHYS_MEM_TOTAL)
|
---|
435 | guest->SetStatistic(pGuestStats->u32CpuId, GuestStatisticType_PhysMemTotal, (pGuestStats->u32PhysMemTotal + (_1M/pGuestStats->u32PageSize)-1) / (_1M/pGuestStats->u32PageSize));
|
---|
436 |
|
---|
437 | if (pGuestStats->u32StatCaps & VBOX_GUEST_STAT_PHYS_MEM_AVAIL)
|
---|
438 | guest->SetStatistic(pGuestStats->u32CpuId, GuestStatisticType_PhysMemAvailable, pGuestStats->u32PhysMemAvail / (_1M/pGuestStats->u32PageSize));
|
---|
439 |
|
---|
440 | if (pGuestStats->u32StatCaps & VBOX_GUEST_STAT_PHYS_MEM_BALLOON)
|
---|
441 | guest->SetStatistic(pGuestStats->u32CpuId, GuestStatisticType_PhysMemBalloon, pGuestStats->u32PhysMemBalloon / (_1M/pGuestStats->u32PageSize));
|
---|
442 |
|
---|
443 | if (pGuestStats->u32StatCaps & VBOX_GUEST_STAT_MEM_COMMIT_TOTAL)
|
---|
444 | guest->SetStatistic(pGuestStats->u32CpuId, GuestStatisticType_MemCommitTotal, pGuestStats->u32MemCommitTotal / (_1M/pGuestStats->u32PageSize));
|
---|
445 |
|
---|
446 | if (pGuestStats->u32StatCaps & VBOX_GUEST_STAT_MEM_KERNEL_TOTAL)
|
---|
447 | guest->SetStatistic(pGuestStats->u32CpuId, GuestStatisticType_MemKernelTotal, pGuestStats->u32MemKernelTotal / (_1M/pGuestStats->u32PageSize));
|
---|
448 |
|
---|
449 | if (pGuestStats->u32StatCaps & VBOX_GUEST_STAT_MEM_KERNEL_PAGED)
|
---|
450 | guest->SetStatistic(pGuestStats->u32CpuId, GuestStatisticType_MemKernelPaged, pGuestStats->u32MemKernelPaged / (_1M/pGuestStats->u32PageSize));
|
---|
451 |
|
---|
452 | if (pGuestStats->u32StatCaps & VBOX_GUEST_STAT_MEM_KERNEL_NONPAGED)
|
---|
453 | guest->SetStatistic(pGuestStats->u32CpuId, GuestStatisticType_MemKernelNonpaged, pGuestStats->u32MemKernelNonPaged / (_1M/pGuestStats->u32PageSize));
|
---|
454 |
|
---|
455 | if (pGuestStats->u32StatCaps & VBOX_GUEST_STAT_MEM_SYSTEM_CACHE)
|
---|
456 | guest->SetStatistic(pGuestStats->u32CpuId, GuestStatisticType_MemSystemCache, pGuestStats->u32MemSystemCache / (_1M/pGuestStats->u32PageSize));
|
---|
457 |
|
---|
458 | if (pGuestStats->u32StatCaps & VBOX_GUEST_STAT_PAGE_FILE_SIZE)
|
---|
459 | guest->SetStatistic(pGuestStats->u32CpuId, GuestStatisticType_PageFileSize, pGuestStats->u32PageFileSize / (_1M/pGuestStats->u32PageSize));
|
---|
460 |
|
---|
461 | /* increase sample number */
|
---|
462 | ULONG sample;
|
---|
463 |
|
---|
464 | int rc = guest->GetStatistic(0, GuestStatisticType_SampleNumber, &sample);
|
---|
465 | if (SUCCEEDED(rc))
|
---|
466 | guest->SetStatistic(pGuestStats->u32CpuId, GuestStatisticType_SampleNumber, sample+1);
|
---|
467 |
|
---|
468 | return VINF_SUCCESS;
|
---|
469 | }
|
---|
470 |
|
---|
471 | /**
|
---|
472 | * Inflate or deflate the memory balloon
|
---|
473 | *
|
---|
474 | * @returns VBox status code.
|
---|
475 | * @param pInterface Pointer to this interface.
|
---|
476 | * @param fInflate Inflate or deflate
|
---|
477 | * @param cPages Number of physical pages (must be 256 as we allocate in 1 MB chunks)
|
---|
478 | * @param aPhysPage Array of physical page addresses
|
---|
479 | * @thread The emulation thread.
|
---|
480 | */
|
---|
481 | DECLCALLBACK(int) vmmdevChangeMemoryBalloon(PPDMIVMMDEVCONNECTOR pInterface, bool fInflate, uint32_t cPages, RTGCPHYS *aPhysPage)
|
---|
482 | {
|
---|
483 | if ( cPages != VMMDEV_MEMORY_BALLOON_CHUNK_PAGES
|
---|
484 | || !aPhysPage)
|
---|
485 | return VERR_INVALID_PARAMETER;
|
---|
486 |
|
---|
487 | Log(("vmmdevChangeMemoryBalloon @todo\n"));
|
---|
488 | return VINF_SUCCESS;
|
---|
489 | }
|
---|
490 |
|
---|
491 | #ifdef VBOX_HGCM
|
---|
492 |
|
---|
493 | /* HGCM connector interface */
|
---|
494 |
|
---|
495 | static DECLCALLBACK(int) iface_hgcmConnect (PPDMIHGCMCONNECTOR pInterface, PVBOXHGCMCMD pCmd, PHGCMSERVICELOCATION pServiceLocation, uint32_t *pu32ClientID)
|
---|
496 | {
|
---|
497 | LogSunlover(("Enter\n"));
|
---|
498 |
|
---|
499 | PDRVMAINVMMDEV pDrv = PDMIHGCMCONNECTOR_2_MAINVMMDEV(pInterface);
|
---|
500 |
|
---|
501 | if ( !pServiceLocation
|
---|
502 | || ( pServiceLocation->type != VMMDevHGCMLoc_LocalHost
|
---|
503 | && pServiceLocation->type != VMMDevHGCMLoc_LocalHost_Existing))
|
---|
504 | {
|
---|
505 | return VERR_INVALID_PARAMETER;
|
---|
506 | }
|
---|
507 |
|
---|
508 | return HGCMGuestConnect (pDrv->pHGCMPort, pCmd, pServiceLocation->u.host.achName, pu32ClientID);
|
---|
509 | }
|
---|
510 |
|
---|
511 | static DECLCALLBACK(int) iface_hgcmDisconnect (PPDMIHGCMCONNECTOR pInterface, PVBOXHGCMCMD pCmd, uint32_t u32ClientID)
|
---|
512 | {
|
---|
513 | LogSunlover(("Enter\n"));
|
---|
514 |
|
---|
515 | PDRVMAINVMMDEV pDrv = PDMIHGCMCONNECTOR_2_MAINVMMDEV(pInterface);
|
---|
516 |
|
---|
517 | return HGCMGuestDisconnect (pDrv->pHGCMPort, pCmd, u32ClientID);
|
---|
518 | }
|
---|
519 |
|
---|
520 | static DECLCALLBACK(int) iface_hgcmCall (PPDMIHGCMCONNECTOR pInterface, PVBOXHGCMCMD pCmd, uint32_t u32ClientID, uint32_t u32Function,
|
---|
521 | uint32_t cParms, PVBOXHGCMSVCPARM paParms)
|
---|
522 | {
|
---|
523 | LogSunlover(("Enter\n"));
|
---|
524 |
|
---|
525 | PDRVMAINVMMDEV pDrv = PDMIHGCMCONNECTOR_2_MAINVMMDEV(pInterface);
|
---|
526 |
|
---|
527 | return HGCMGuestCall (pDrv->pHGCMPort, pCmd, u32ClientID, u32Function, cParms, paParms);
|
---|
528 | }
|
---|
529 |
|
---|
530 | /**
|
---|
531 | * Execute state save operation.
|
---|
532 | *
|
---|
533 | * @returns VBox status code.
|
---|
534 | * @param pDrvIns Driver instance of the driver which registered the data unit.
|
---|
535 | * @param pSSM SSM operation handle.
|
---|
536 | */
|
---|
537 | static DECLCALLBACK(int) iface_hgcmSave(PPDMDRVINS pDrvIns, PSSMHANDLE pSSM)
|
---|
538 | {
|
---|
539 | LogSunlover(("Enter\n"));
|
---|
540 | return HGCMHostSaveState (pSSM);
|
---|
541 | }
|
---|
542 |
|
---|
543 |
|
---|
544 | /**
|
---|
545 | * Execute state load operation.
|
---|
546 | *
|
---|
547 | * @returns VBox status code.
|
---|
548 | * @param pDrvIns Driver instance of the driver which registered the data unit.
|
---|
549 | * @param pSSM SSM operation handle.
|
---|
550 | * @param u32Version Data layout version.
|
---|
551 | */
|
---|
552 | static DECLCALLBACK(int) iface_hgcmLoad(PPDMDRVINS pDrvIns, PSSMHANDLE pSSM, uint32_t u32Version)
|
---|
553 | {
|
---|
554 | LogFlowFunc(("Enter\n"));
|
---|
555 |
|
---|
556 | if (u32Version != HGCM_SSM_VERSION)
|
---|
557 | return VERR_SSM_UNSUPPORTED_DATA_UNIT_VERSION;
|
---|
558 |
|
---|
559 | return HGCMHostLoadState (pSSM);
|
---|
560 | }
|
---|
561 |
|
---|
562 | int VMMDev::hgcmLoadService (const char *pszServiceLibrary, const char *pszServiceName)
|
---|
563 | {
|
---|
564 | return HGCMHostLoad (pszServiceLibrary, pszServiceName);
|
---|
565 | }
|
---|
566 |
|
---|
567 | int VMMDev::hgcmHostCall (const char *pszServiceName, uint32_t u32Function,
|
---|
568 | uint32_t cParms, PVBOXHGCMSVCPARM paParms)
|
---|
569 | {
|
---|
570 | return HGCMHostCall (pszServiceName, u32Function, cParms, paParms);
|
---|
571 | }
|
---|
572 |
|
---|
573 | void VMMDev::hgcmShutdown (void)
|
---|
574 | {
|
---|
575 | HGCMHostShutdown ();
|
---|
576 | }
|
---|
577 |
|
---|
578 | #endif /* HGCM */
|
---|
579 |
|
---|
580 |
|
---|
581 | /**
|
---|
582 | * Queries an interface to the driver.
|
---|
583 | *
|
---|
584 | * @returns Pointer to interface.
|
---|
585 | * @returns NULL if the interface was not supported by the driver.
|
---|
586 | * @param pInterface Pointer to this interface structure.
|
---|
587 | * @param enmInterface The requested interface identification.
|
---|
588 | */
|
---|
589 | DECLCALLBACK(void *) VMMDev::drvQueryInterface(PPDMIBASE pInterface, PDMINTERFACE enmInterface)
|
---|
590 | {
|
---|
591 | PPDMDRVINS pDrvIns = PDMIBASE_2_PDMDRV(pInterface);
|
---|
592 | PDRVMAINVMMDEV pDrv = PDMINS2DATA(pDrvIns, PDRVMAINVMMDEV);
|
---|
593 | switch (enmInterface)
|
---|
594 | {
|
---|
595 | case PDMINTERFACE_BASE:
|
---|
596 | return &pDrvIns->IBase;
|
---|
597 | case PDMINTERFACE_VMMDEV_CONNECTOR:
|
---|
598 | return &pDrv->Connector;
|
---|
599 | #ifdef VBOX_HGCM
|
---|
600 | case PDMINTERFACE_HGCM_CONNECTOR:
|
---|
601 | return &pDrv->HGCMConnector;
|
---|
602 | #endif
|
---|
603 | default:
|
---|
604 | return NULL;
|
---|
605 | }
|
---|
606 | }
|
---|
607 |
|
---|
608 | /**
|
---|
609 | * Destruct a VMMDev driver instance.
|
---|
610 | *
|
---|
611 | * @returns VBox status.
|
---|
612 | * @param pDrvIns The driver instance data.
|
---|
613 | */
|
---|
614 | DECLCALLBACK(void) VMMDev::drvDestruct(PPDMDRVINS pDrvIns)
|
---|
615 | {
|
---|
616 | PDRVMAINVMMDEV pData = PDMINS2DATA(pDrvIns, PDRVMAINVMMDEV);
|
---|
617 | LogFlow(("VMMDev::drvDestruct: iInstance=%d\n", pDrvIns->iInstance));
|
---|
618 | #ifdef VBOX_HGCM
|
---|
619 | /* HGCM is shut down on the VMMDev destructor. */
|
---|
620 | #endif /* VBOX_HGCM */
|
---|
621 | if (pData->pVMMDev)
|
---|
622 | {
|
---|
623 | pData->pVMMDev->mpDrv = NULL;
|
---|
624 | }
|
---|
625 | }
|
---|
626 |
|
---|
627 | /**
|
---|
628 | * Reset notification.
|
---|
629 | *
|
---|
630 | * @returns VBox status.
|
---|
631 | * @param pDrvIns The driver instance data.
|
---|
632 | */
|
---|
633 | DECLCALLBACK(void) VMMDev::drvReset(PPDMDRVINS pDrvIns)
|
---|
634 | {
|
---|
635 | LogFlow(("VMMDev::drvReset: iInstance=%d\n", pDrvIns->iInstance));
|
---|
636 | #ifdef VBOX_HGCM
|
---|
637 | HGCMHostReset ();
|
---|
638 | #endif /* VBOX_HGCM */
|
---|
639 | }
|
---|
640 |
|
---|
641 | /**
|
---|
642 | * Construct a VMMDev driver instance.
|
---|
643 | *
|
---|
644 | * @returns VBox status.
|
---|
645 | * @param pDrvIns The driver instance data.
|
---|
646 | * If the registration structure is needed, pDrvIns->pDrvReg points to it.
|
---|
647 | * @param pCfgHandle Configuration node handle for the driver. Use this to obtain the configuration
|
---|
648 | * of the driver instance. It's also found in pDrvIns->pCfgHandle, but like
|
---|
649 | * iInstance it's expected to be used a bit in this function.
|
---|
650 | */
|
---|
651 | DECLCALLBACK(int) VMMDev::drvConstruct(PPDMDRVINS pDrvIns, PCFGMNODE pCfgHandle)
|
---|
652 | {
|
---|
653 | PDRVMAINVMMDEV pData = PDMINS2DATA(pDrvIns, PDRVMAINVMMDEV);
|
---|
654 | LogFlow(("Keyboard::drvConstruct: iInstance=%d\n", pDrvIns->iInstance));
|
---|
655 |
|
---|
656 | /*
|
---|
657 | * Validate configuration.
|
---|
658 | */
|
---|
659 | if (!CFGMR3AreValuesValid(pCfgHandle, "Object\0OpenGLEnabled\0"))
|
---|
660 | return VERR_PDM_DRVINS_UNKNOWN_CFG_VALUES;
|
---|
661 | PPDMIBASE pBaseIgnore;
|
---|
662 | int rc = pDrvIns->pDrvHlp->pfnAttach(pDrvIns, &pBaseIgnore);
|
---|
663 | if (rc != VERR_PDM_NO_ATTACHED_DRIVER)
|
---|
664 | {
|
---|
665 | AssertMsgFailed(("Configuration error: Not possible to attach anything to this driver!\n"));
|
---|
666 | return VERR_PDM_DRVINS_NO_ATTACH;
|
---|
667 | }
|
---|
668 |
|
---|
669 | /*
|
---|
670 | * IBase.
|
---|
671 | */
|
---|
672 | pDrvIns->IBase.pfnQueryInterface = VMMDev::drvQueryInterface;
|
---|
673 |
|
---|
674 | pData->Connector.pfnUpdateGuestVersion = vmmdevUpdateGuestVersion;
|
---|
675 | pData->Connector.pfnUpdateGuestCapabilities = vmmdevUpdateGuestCapabilities;
|
---|
676 | pData->Connector.pfnUpdateMouseCapabilities = vmmdevUpdateMouseCapabilities;
|
---|
677 | pData->Connector.pfnUpdatePointerShape = vmmdevUpdatePointerShape;
|
---|
678 | pData->Connector.pfnVideoAccelEnable = iface_VideoAccelEnable;
|
---|
679 | pData->Connector.pfnVideoAccelFlush = iface_VideoAccelFlush;
|
---|
680 | pData->Connector.pfnVideoModeSupported = vmmdevVideoModeSupported;
|
---|
681 | pData->Connector.pfnGetHeightReduction = vmmdevGetHeightReduction;
|
---|
682 | pData->Connector.pfnSetCredentialsJudgementResult = vmmdevSetCredentialsJudgementResult;
|
---|
683 | pData->Connector.pfnSetVisibleRegion = vmmdevSetVisibleRegion;
|
---|
684 | pData->Connector.pfnQueryVisibleRegion = vmmdevQueryVisibleRegion;
|
---|
685 | pData->Connector.pfnReportStatistics = vmmdevReportStatistics;
|
---|
686 | pData->Connector.pfnQueryStatisticsInterval = vmmdevQueryStatisticsInterval;
|
---|
687 | pData->Connector.pfnChangeMemoryBalloon = vmmdevChangeMemoryBalloon;
|
---|
688 |
|
---|
689 | #ifdef VBOX_HGCM
|
---|
690 | pData->HGCMConnector.pfnConnect = iface_hgcmConnect;
|
---|
691 | pData->HGCMConnector.pfnDisconnect = iface_hgcmDisconnect;
|
---|
692 | pData->HGCMConnector.pfnCall = iface_hgcmCall;
|
---|
693 | #endif
|
---|
694 |
|
---|
695 | /*
|
---|
696 | * Get the IVMMDevPort interface of the above driver/device.
|
---|
697 | */
|
---|
698 | pData->pUpPort = (PPDMIVMMDEVPORT)pDrvIns->pUpBase->pfnQueryInterface(pDrvIns->pUpBase, PDMINTERFACE_VMMDEV_PORT);
|
---|
699 | if (!pData->pUpPort)
|
---|
700 | {
|
---|
701 | AssertMsgFailed(("Configuration error: No VMMDev port interface above!\n"));
|
---|
702 | return VERR_PDM_MISSING_INTERFACE_ABOVE;
|
---|
703 | }
|
---|
704 |
|
---|
705 | #ifdef VBOX_HGCM
|
---|
706 | pData->pHGCMPort = (PPDMIHGCMPORT)pDrvIns->pUpBase->pfnQueryInterface(pDrvIns->pUpBase, PDMINTERFACE_HGCM_PORT);
|
---|
707 | if (!pData->pHGCMPort)
|
---|
708 | {
|
---|
709 | AssertMsgFailed(("Configuration error: No HGCM port interface above!\n"));
|
---|
710 | return VERR_PDM_MISSING_INTERFACE_ABOVE;
|
---|
711 | }
|
---|
712 | #endif
|
---|
713 |
|
---|
714 | /*
|
---|
715 | * Get the Console object pointer and update the mpDrv member.
|
---|
716 | */
|
---|
717 | void *pv;
|
---|
718 | rc = CFGMR3QueryPtr(pCfgHandle, "Object", &pv);
|
---|
719 | if (VBOX_FAILURE(rc))
|
---|
720 | {
|
---|
721 | AssertMsgFailed(("Configuration error: No/bad \"Object\" value! rc=%Vrc\n", rc));
|
---|
722 | return rc;
|
---|
723 | }
|
---|
724 |
|
---|
725 | pData->pVMMDev = (VMMDev*)pv; /** @todo Check this cast! */
|
---|
726 | pData->pVMMDev->mpDrv = pData;
|
---|
727 |
|
---|
728 | #ifdef VBOX_HGCM
|
---|
729 | rc = pData->pVMMDev->hgcmLoadService (VBOXSHAREDFOLDERS_DLL,
|
---|
730 | "VBoxSharedFolders");
|
---|
731 | pData->pVMMDev->fSharedFolderActive = VBOX_SUCCESS(rc);
|
---|
732 | if (VBOX_SUCCESS(rc))
|
---|
733 | {
|
---|
734 | PPDMLED pLed;
|
---|
735 | PPDMILEDPORTS pLedPort;
|
---|
736 |
|
---|
737 | LogRel(("Shared Folders service loaded.\n"));
|
---|
738 | pLedPort = (PPDMILEDPORTS)pDrvIns->pUpBase->pfnQueryInterface(pDrvIns->pUpBase, PDMINTERFACE_LED_PORTS);
|
---|
739 | if (!pLedPort)
|
---|
740 | {
|
---|
741 | AssertMsgFailed(("Configuration error: No LED port interface above!\n"));
|
---|
742 | return VERR_PDM_MISSING_INTERFACE_ABOVE;
|
---|
743 | }
|
---|
744 | rc = pLedPort->pfnQueryStatusLed(pLedPort, 0, &pLed);
|
---|
745 | if (VBOX_SUCCESS(rc) && pLed)
|
---|
746 | {
|
---|
747 | VBOXHGCMSVCPARM parm;
|
---|
748 |
|
---|
749 | parm.type = VBOX_HGCM_SVC_PARM_PTR;
|
---|
750 | parm.u.pointer.addr = pLed;
|
---|
751 | parm.u.pointer.size = sizeof(*pLed);
|
---|
752 |
|
---|
753 | rc = HGCMHostCall("VBoxSharedFolders", SHFL_FN_SET_STATUS_LED, 1, &parm);
|
---|
754 | }
|
---|
755 | else
|
---|
756 | AssertMsgFailed(("pfnQueryStatusLed failed with %Vrc (pLed=%x)\n", rc, pLed));
|
---|
757 | }
|
---|
758 | else
|
---|
759 | {
|
---|
760 | LogRel(("Failed to load Shared Folders service %Vrc\n", rc));
|
---|
761 | }
|
---|
762 |
|
---|
763 | bool fEnabled;
|
---|
764 |
|
---|
765 | /* Check CFGM option. */
|
---|
766 | rc = CFGMR3QueryBool(pCfgHandle, "OpenGLEnabled", &fEnabled);
|
---|
767 | if ( VBOX_SUCCESS(rc)
|
---|
768 | && fEnabled)
|
---|
769 | {
|
---|
770 | rc = pData->pVMMDev->hgcmLoadService ("VBoxSharedOpenGL", "VBoxSharedOpenGL");
|
---|
771 | if (VBOX_SUCCESS(rc))
|
---|
772 | {
|
---|
773 | LogRel(("Shared OpenGL service loaded.\n"));
|
---|
774 | }
|
---|
775 | else
|
---|
776 | {
|
---|
777 | LogRel(("Failed to load Shared OpenGL service %Vrc\n", rc));
|
---|
778 | }
|
---|
779 | }
|
---|
780 |
|
---|
781 | pDrvIns->pDrvHlp->pfnSSMRegister(pDrvIns, "HGCM", 0, HGCM_SSM_VERSION, 4096/* bad guess */, NULL, iface_hgcmSave, NULL, NULL, iface_hgcmLoad, NULL);
|
---|
782 | #endif /* VBOX_HGCM */
|
---|
783 |
|
---|
784 | return VINF_SUCCESS;
|
---|
785 | }
|
---|
786 |
|
---|
787 |
|
---|
788 | /**
|
---|
789 | * VMMDevice driver registration record.
|
---|
790 | */
|
---|
791 | const PDMDRVREG VMMDev::DrvReg =
|
---|
792 | {
|
---|
793 | /* u32Version */
|
---|
794 | PDM_DRVREG_VERSION,
|
---|
795 | /* szDriverName */
|
---|
796 | "MainVMMDev",
|
---|
797 | /* pszDescription */
|
---|
798 | "Main VMMDev driver (Main as in the API).",
|
---|
799 | /* fFlags */
|
---|
800 | PDM_DRVREG_FLAGS_HOST_BITS_DEFAULT,
|
---|
801 | /* fClass. */
|
---|
802 | PDM_DRVREG_CLASS_VMMDEV,
|
---|
803 | /* cMaxInstances */
|
---|
804 | ~0,
|
---|
805 | /* cbInstance */
|
---|
806 | sizeof(DRVMAINVMMDEV),
|
---|
807 | /* pfnConstruct */
|
---|
808 | VMMDev::drvConstruct,
|
---|
809 | /* pfnDestruct */
|
---|
810 | VMMDev::drvDestruct,
|
---|
811 | /* pfnIOCtl */
|
---|
812 | NULL,
|
---|
813 | /* pfnPowerOn */
|
---|
814 | NULL,
|
---|
815 | /* pfnReset */
|
---|
816 | VMMDev::drvReset,
|
---|
817 | /* pfnSuspend */
|
---|
818 | NULL,
|
---|
819 | /* pfnResume */
|
---|
820 | NULL,
|
---|
821 | /* pfnDetach */
|
---|
822 | NULL
|
---|
823 | };
|
---|