Changeset 102929 in vbox for trunk/include

Timestamp:

Jan 17, 2024 3:30:48 PM (13 months ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

161157

Message:

Shared Clipboard: Better documented for what headless mode is and why we need it; improved testing here and there a bit, so we have better coverage there.

File:

• trunk/include/VBox/GuestHost/SharedClipboard-x11.h (modified) (2 diffs)

trunk/include/VBox/GuestHost/SharedClipboard-x11.h

@@ -116 +116 @@
     /** Our callback table to use. */
     SHCLCALLBACKS    Callbacks;
-    /** Is an X server actually available?
-     *  Needed for non-interactive systems (i.e. servers) where X11 depedencies are installed,
-     *  but no X11 server is actually running. */
-    bool             fHaveX11;
+    /**
+     * Are we running in headless mode?
+     *
+     * This is a special situation for running on UNIX-y environments, where an
+     * X server could not be available when running on a server without any
+     * desktop environment available, for example.
+     */
+    bool             fHeadless;
     /** The X Toolkit application context structure. */
     XtAppContext     pAppContext;
@@ -262 +266 @@
  */
 int ShClX11Init(PSHCLX11CTX pCtx, PSHCLCALLBACKS pCallbacks, PSHCLCONTEXT pParent, bool fHeadless);
-void ShClX11Destroy(PSHCLX11CTX pCtx);
+int ShClX11Destroy(PSHCLX11CTX pCtx);
 int ShClX11ThreadStart(PSHCLX11CTX pCtx, bool grab);
 int ShClX11ThreadStartEx(PSHCLX11CTX pCtx, const char *pszName, bool fGrab);