[jira] [Created] (GUACAMOLE-2299) Documentation: document macOS VNC paste limitations.

["Bradley Bennett (Jira)" <ji...@apache.org>]

Bradley Bennett created GUACAMOLE-2299:
------------------------------------------

             Summary: Documentation: document macOS VNC paste limitations.
                 Key: GUACAMOLE-2299
                 URL: https://issues.apache.org/jira/browse/GUACAMOLE-2299
             Project: Guacamole
          Issue Type: Task
    Affects Versions: 1.6.0, 1.6.1 [staging]
         Environment: macOS VNC session.
            Reporter: Bradley Bennett


There are inherit *Paste *limitations to the macOS component (*screensharingd*) that handles 3rd party VNC client sessions. These limitations do not exist when using the native macOS screen sharing client (*ScreenSharingAgent*).

macOS evidently uses a proprietary RFB (Remote Frame Buffer) protocol, advertised as version 3.889 during negotiation; 3.8 is the latest. This extension implements a clipboard mechanism, supporting encrypting clipboard data as well as different clipboard data types. This protocol extension defining the APIs used between the Screen Sharing Client and Server processes (ScreenSharingAgent & screensharingd) is not publicly documented.

macOS apps have essentially 2 clipboard (pasteboard) mechanisms.

* NSPasteboard (Cocoa pasteboard APIs): Used by Cocoa apps, including all built-in macOS apps.
* Qt QClipboard: Used by Qt apps, e.g. Wireshark, SlickEdit.
    * Qt is cross-platform (macOS/Windows/X11) framework.

VNC pasting works for *Qt applications*; does not work for *NSPasteboard applications*.



--
This message was sent by Atlassian Jira
(v8.20.10#820010)