xpra icon
Bug tracker and wiki

Changes between Version 20 and Version 21 of NetworkProtocol


Ignore:
Timestamp:
03/29/14 04:04:10 (6 years ago)
Author:
Antoine Martin
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • NetworkProtocol

    v20 v21  
    2424||{{{connection-lost}}}|| ||sent by the network layer when the network connection has dropped||free any resources||
    2525||{{{gibberish}}}|| ||sent by the network layer when the network received unparseable data, data decompression failed or decryption failed||disconnect the connection and free any resources||
     26||{{{set_deflate}}}||new compression level||request a change in the connection's compression level||the server ''should'' honour it and echo the same packet back to the client|| ||
    2627
    2728[[BR]]
     
    8182||{{{speed}}}||new fixed speed value from -1 to 100||the client wants to use a fixed speed (0 to 100), or disable fixed speed (-1)||the server ''should'' honour the request, it ''may'' refresh all the windows with the new setting||{{{change-speed}}}||
    8283||{{{min-speed}}}||new minimum speed setting|| || ||{{{change-min-speed}}}||
    83 ||{{{info-request}}}||client UUID and list of window IDs||request the server to send detailed statistics including those for the windows given||the server ''should'' send an {{{info-response}}} packet back with the information||{{{info-request}}}}
     84||{{{info-request}}}||client UUID and list of window IDs||request the server to send detailed statistics including those for the windows given||the server ''should'' send an {{{info-response}}} packet back with the information||{{{info-request}}}||
     85||{{{suspend}}}||UI flag, list of window IDs||tell the server to stop sending window updates, and if the UI flag is set, also stop clipboard, sound, etc||the server ''should'' honour this request||{{{suspend-resume}}}||
     86||{{{resume}}}||UI flag, list of window IDs||tell the server to resume window updates suspended with {{{suspend}}}||the server ''should'' honour the request and ''should'' refresh all the windows||{{{suspend-resume}}}||
     87||{{{encoding}}}||new encoding, window IDs||tell the server to switch to a different encoding for the given windows||the server ''should'' honour the request and ''should'' refresh all the windows with the new encoding|| ||
     88||{{{buffer-refresh}}}||window ID (or -1 for all), unused value, quality and if the server supports {{{window_refresh_config}}}: refresh options and client properties||the client should refresh the window(s) specified and update its batching and client properties as specified|| ||
     89||{{{desktop_size}}}||width, height, screen(s) specification||the client's can tell the server that its screen resolution has changed||the server ''should'' ensure that its virtual screen is big enough to accommodate the new size, it ''should'' tell the client about the resolution it settled on using a {{{desktop_size}}} packet of its own, it ''may'' update other attributes ("workarea", etc)|| ||
    8490
    8591
    8692TODO: undocumented:
    87 ||{{{set_deflate}}}||
    88 ||{{{desktop_size}}}||
    89 ||{{{encoding}}}||
    90 ||{{{suspend}}}||
    91 ||{{{resume}}}||
    9293||{{{rpc}}}||
    9394||{{{sound-control}}}||
    9495||{{{shutdown-server}}}||
    9596||{{{exit-server}}}||
    96 ||{{{buffer-refresh}}}||
    9797||{{{screenshot}}}||
    9898||{{{disconnect}}}||
    9999
    100100Notes:
    101 * changing speed or quality is not applicable to all encodings, the server will expose the relevant encodings through the capabilities: {{{encodings.with_speed}}}, {{{encodings.with_quality}}} and {{{encodings.with_lossless_mode}}} (for quality=100%)
    102 * changing xsettings, clipboard  or bell settings may not be possible if those features are disabled by the server - in which case the server will simply ignore the request
     101* Changing speed or quality is not applicable to all encodings, the server will expose the relevant encodings through the capabilities: {{{encodings.with_speed}}}, {{{encodings.with_quality}}} and {{{encodings.with_lossless_mode}}} (for quality=100%)
     102* Changing xsettings, clipboard  or bell settings may not be possible if those features are disabled by the server - in which case the server will simply ignore the request
     103* The packets changing settings usually affect only the current client connection. To affect other connections (if there are more than one), use the "{{{xpra control}}}" interface.