1 | /** @file
|
---|
2 | *
|
---|
3 | * Shared Clipboard:
|
---|
4 | * Linux host, a stub version with no functionality for use on headless hosts.
|
---|
5 | */
|
---|
6 |
|
---|
7 | /*
|
---|
8 | * Copyright (C) 2006-2017 Oracle Corporation
|
---|
9 | *
|
---|
10 | * This file is part of VirtualBox Open Source Edition (OSE), as
|
---|
11 | * available from http://www.virtualbox.org. This file is free software;
|
---|
12 | * you can redistribute it and/or modify it under the terms of the GNU
|
---|
13 | * General Public License (GPL) as published by the Free Software
|
---|
14 | * Foundation, in version 2 as it comes in the "COPYING" file of the
|
---|
15 | * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
|
---|
16 | * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
|
---|
17 | */
|
---|
18 |
|
---|
19 | #include <VBox/HostServices/VBoxClipboardSvc.h>
|
---|
20 |
|
---|
21 | #include <iprt/alloc.h>
|
---|
22 | #include <iprt/asm.h> /* For atomic operations */
|
---|
23 | #include <iprt/assert.h>
|
---|
24 | #include <iprt/mem.h>
|
---|
25 | #include <iprt/string.h>
|
---|
26 | #include <iprt/thread.h>
|
---|
27 | #include <iprt/process.h>
|
---|
28 | #include <iprt/semaphore.h>
|
---|
29 | #include <string.h>
|
---|
30 | #include <stdio.h>
|
---|
31 | #include <stdint.h>
|
---|
32 |
|
---|
33 | #include "VBoxClipboard.h"
|
---|
34 |
|
---|
35 | /** Initialise the host side of the shared clipboard - called by the hgcm layer. */
|
---|
36 | int vboxClipboardInit (void)
|
---|
37 | {
|
---|
38 | LogFlowFunc(("called, returning VINF_SUCCESS.\n"));
|
---|
39 | return VINF_SUCCESS;
|
---|
40 | }
|
---|
41 |
|
---|
42 | /** Terminate the host side of the shared clipboard - called by the hgcm layer. */
|
---|
43 | void vboxClipboardDestroy (void)
|
---|
44 | {
|
---|
45 | LogFlowFunc(("called, returning.\n"));
|
---|
46 | }
|
---|
47 |
|
---|
48 | /**
|
---|
49 | * Enable the shared clipboard - called by the hgcm clipboard subsystem.
|
---|
50 | *
|
---|
51 | * @param pClient Structure containing context information about the guest system
|
---|
52 | * @param fHeadless Whether headless.
|
---|
53 | * @returns RT status code
|
---|
54 | */
|
---|
55 | int vboxClipboardConnect (VBOXCLIPBOARDCLIENTDATA *pClient,
|
---|
56 | bool fHeadless)
|
---|
57 | {
|
---|
58 | RT_NOREF(pClient, fHeadless);
|
---|
59 | LogFlowFunc(("called, returning VINF_SUCCESS.\n"));
|
---|
60 | return VINF_SUCCESS;
|
---|
61 | }
|
---|
62 |
|
---|
63 | /**
|
---|
64 | * Synchronise the contents of the host clipboard with the guest, called by the HGCM layer
|
---|
65 | * after a save and restore of the guest.
|
---|
66 | */
|
---|
67 | int vboxClipboardSync (VBOXCLIPBOARDCLIENTDATA * /* pClient */)
|
---|
68 | {
|
---|
69 | LogFlowFunc(("called, returning VINF_SUCCESS.\n"));
|
---|
70 | return VINF_SUCCESS;
|
---|
71 | }
|
---|
72 |
|
---|
73 | /**
|
---|
74 | * Shut down the shared clipboard subsystem and "disconnect" the guest.
|
---|
75 | *
|
---|
76 | * @param pClient Structure containing context information about the guest system
|
---|
77 | */
|
---|
78 | void vboxClipboardDisconnect (VBOXCLIPBOARDCLIENTDATA *pClient)
|
---|
79 | {
|
---|
80 | RT_NOREF(pClient);
|
---|
81 | LogFlowFunc(("called, returning.\n"));
|
---|
82 | }
|
---|
83 |
|
---|
84 | /**
|
---|
85 | * The guest is taking possession of the shared clipboard. Called by the HGCM clipboard
|
---|
86 | * subsystem.
|
---|
87 | *
|
---|
88 | * @param pClient Context data for the guest system
|
---|
89 | * @param u32Formats Clipboard formats the guest is offering
|
---|
90 | */
|
---|
91 | void vboxClipboardFormatAnnounce (VBOXCLIPBOARDCLIENTDATA *pClient,
|
---|
92 | uint32_t u32Formats)
|
---|
93 | {
|
---|
94 | RT_NOREF(pClient, u32Formats);
|
---|
95 | LogFlowFunc(("called, returning.\n"));
|
---|
96 | }
|
---|
97 |
|
---|
98 | /**
|
---|
99 | * Called by the HGCM clipboard subsystem when the guest wants to read the host clipboard.
|
---|
100 | *
|
---|
101 | * @param pClient Context information about the guest VM
|
---|
102 | * @param u32Format The format that the guest would like to receive the data in
|
---|
103 | * @param pv Where to write the data to
|
---|
104 | * @param cb The size of the buffer to write the data to
|
---|
105 | * @param pcbActual Where to write the actual size of the written data
|
---|
106 | */
|
---|
107 | int vboxClipboardReadData (VBOXCLIPBOARDCLIENTDATA *pClient, uint32_t u32Format,
|
---|
108 | void *pv, uint32_t cb, uint32_t *pcbActual)
|
---|
109 | {
|
---|
110 | RT_NOREF(pClient, u32Format, pv, cb);
|
---|
111 | LogFlowFunc(("called, returning VINF_SUCCESS.\n"));
|
---|
112 | /* No data available. */
|
---|
113 | *pcbActual = 0;
|
---|
114 | return VINF_SUCCESS;
|
---|
115 | }
|
---|
116 |
|
---|
117 | /**
|
---|
118 | * Called by the HGCM clipboard subsystem when we have requested data and that data arrives.
|
---|
119 | *
|
---|
120 | * @param pClient Context information about the guest VM
|
---|
121 | * @param pv Buffer to which the data was written
|
---|
122 | * @param cb The size of the data written
|
---|
123 | * @param u32Format The format of the data written
|
---|
124 | */
|
---|
125 | void vboxClipboardWriteData (VBOXCLIPBOARDCLIENTDATA *pClient, void *pv,
|
---|
126 | uint32_t cb, uint32_t u32Format)
|
---|
127 | {
|
---|
128 | RT_NOREF(pClient, pv, cb, u32Format);
|
---|
129 | LogFlowFunc(("called, returning.\n"));
|
---|
130 | }
|
---|