VirtualBox

source: vbox/trunk/src/VBox/HostServices/SharedClipboard/x11-stub.cpp@ 67954

Last change on this file since 67954 was 65123, checked in by vboxsync, 8 years ago

HostServices: doxygen fixes

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 4.1 KB
Line 
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-2016 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. */
36int 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. */
43void 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 */
55int vboxClipboardConnect (VBOXCLIPBOARDCLIENTDATA *pClient,
56 bool fHeadless)
57{
58 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 */
67int 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 */
78void vboxClipboardDisconnect (VBOXCLIPBOARDCLIENTDATA *pClient)
79{
80 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 */
91void vboxClipboardFormatAnnounce (VBOXCLIPBOARDCLIENTDATA *pClient,
92 uint32_t u32Formats)
93{
94 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 */
107int vboxClipboardReadData (VBOXCLIPBOARDCLIENTDATA *pClient, uint32_t u32Format,
108 void *pv, uint32_t cb, uint32_t *pcbActual)
109{
110 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 */
125void vboxClipboardWriteData (VBOXCLIPBOARDCLIENTDATA *pClient, void *pv,
126 uint32_t cb, uint32_t u32Format)
127{
128 NOREF(pClient, pv, cb, u32Format);
129 LogFlowFunc(("called, returning.\n"));
130}
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette