Changeset 80452 in vbox

Timestamp:

Aug 27, 2019 7:06:45 PM (6 years ago)

Author:

vboxsync

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

132943

Message:

Shared Clipboard/URI: Added first protocol changelog.

File:

• trunk/include/VBox/HostServices/VBoxClipboardSvc.h (modified) (1 diff)

trunk/include/VBox/HostServices/VBoxClipboardSvc.h

@@ -22 +22 @@
  * You may elect to license modified versions of this file under the
  * terms and conditions of either the GPL or the CDDL or both.
+ */
+
+/**
+ * Protocol handling and notes:
+ *     All client/server components should be backwards compatible.
+ *
+ ******************************************************************************
+ *
+ * Protocol changelog:
+ *
+ *     Protocol v0 (VBox < 6.1, deprecated):
+ *         | First, initial implementation since feature was developed.
+ *           Has no protocol handshake / versioning support, the client's
+ *           waiting message also acted as retrieving the parameters from
+ *           the host (always and only *exactly* two parameters). Does
+ *           not have the ability to control / handle parallel transfers.
+ *
+ *     Protocol v1 (VBox >= 6.1):
+ *         + Introduces protocol versioning and context IDs for parallel,
+ *           asynchronous transfers.
+ *         | Keeps backwards-compatbility with protocol v0 clients.
  */