Revision 5fcb9de8

View differences:

src/sunstone/public/js/plugins/vms-tab.js
32 32
      <th>Memory</th>\
33 33
      <th>Hostname</th>\
34 34
      <th>Start Time</th>\
35
      <th>VNC Access</th>\
35 36
    </tr>\
36 37
  </thead>\
37 38
  <tbody id="tbodyvmachines">\
......
496 497

  
497 498
var vmachine_list_json = {};
498 499
var dataTable_vMachines;
500
var rfb;
499 501

  
500 502
var vm_actions = {
501 503
    "VM.create" : {
......
720 722
            var colored_log = '';
721 723
            for (line in log_lines){
722 724
                line = log_lines[line];
723
                if (line.match(/\[E\]/)){
724
                    line = '<span class="vm_log_error">'+line+'</span>'
725
                if (typeof line == "string") {
726
                    if (line.match(/\[E\]/)){
727
                        line = '<span class="vm_log_error">'+line+'</span>'
728
                    }
729
                    colored_log += line + "\n";
725 730
                }
726
                colored_log += line + "\n";
727 731
            }
728 732
            var log_tab = {
729 733
                title: "VM log",
......
902 906
    if (state == "ACTIVE") {
903 907
        state = OpenNebula.Helper.resource_state("vm_lcm",vm.LCM_STATE);
904 908
    }
909
    
910
   
905 911
	return [
906 912
			'<input type="checkbox" id="vm_'+vm.ID+'" name="selected_items" value="'+vm.ID+'"/>',
907 913
			vm.ID,
......
911 917
			vm.CPU,
912 918
			humanize_size(vm.MEMORY),
913 919
			vm.HISTORY ? vm.HISTORY.HOSTNAME : "--",
914
			str_start_time(vm)
920
			str_start_time(vm),
921
            vncIcon(vm)
915 922
		]
916 923
}
917 924

  
......
920 927
function vMachineInfoListener(){
921 928

  
922 929
	$('#tbodyvmachines tr').live("click", function(e){
923
		if ($(e.target).is('input')) {return true;}
930
		if ($(e.target).is('input') || $(e.target).is('a img')) {return true;}
924 931
        popDialogLoading();
925 932
		var aData = dataTable_vMachines.fnGetData(this);
926 933
		var id = $(aData[0]).val();
......
1019 1026
				<td class="key_td">Used CPU</td>\
1020 1027
				<td class="value_td">'+vm_info.CPU+'</td>\
1021 1028
			</tr>\
1029
            <tr>\
1030
				<td class="key_td">VNC Session</td>\
1031
				<td class="value_td">'+vncIcon(vm_info)+'</td>\
1032
			</tr>\
1022 1033
		</table>'
1023 1034
    }
1024 1035
    
......
1936 1947
	},INTERVAL+someTime()); //so that not all refreshing is done at the same time
1937 1948
}
1938 1949

  
1950
//setups VNC application
1951
function setupVNC(){
1952

  
1953
    var updateVNCState = function updateState(rfb, state, oldstate, msg) {
1954
            var s, sb, cad, klass;
1955
            s = $D('VNC_status');
1956
            sb = $D('VNC_status_bar');
1957
            cad = $D('sendCtrlAltDelButton');
1958
            switch (state) {
1959
                case 'failed':
1960
                case 'fatal':
1961
                    klass = "VNC_status_error";
1962
                    break;
1963
                case 'normal':
1964
                    klass = "VNC_status_normal";
1965
                    break;
1966
                case 'disconnected':
1967
                case 'loaded':
1968
                    klass = "VNC_status_normal";
1969
                    break;
1970
                case 'password':
1971
                    klass = "VNC_status_warn";
1972
                    break;
1973
                default:
1974
                    klass = "VNC_status_warn";
1975
            }
1976

  
1977
            if (state === "normal") { cad.disabled = false; }
1978
            else                    { cad.disabled = true; }
1979

  
1980
            if (typeof(msg) !== 'undefined') {
1981
                sb.setAttribute("class", klass);
1982
                s.innerHTML = msg;
1983
            }
1984
        }
1985

  
1986
    //Append to DOM
1987
    $('div#dialogs').append('<div id="vnc_dialog" title="VNC connection"></div>');
1988
    
1989
    $('#vnc_dialog').html('\
1990
      <div id="VNC_status_bar" class="VNC_status_bar" style="margin-top: 0px;">\
1991
                <table border=0 width="100%"><tr>\
1992
                    <td><div id="VNC_status">Loading</div></td>\
1993
                    <td width="1%"><div id="VNC_buttons">\
1994
                        <input type=button value="Send CtrlAltDel"\
1995
                            id="sendCtrlAltDelButton">\
1996
                            </div></td>\
1997
                </tr></table>\
1998
            </div>\
1999
            <canvas id="VNC_canvas" width="640px" height="20px">\
2000
                Canvas not supported.\
2001
            </canvas>\
2002
    ');
2003
    
2004
    $('#sendCtrlAltDelButton').click(function(){ 
2005
        rfb.sendCtrlAltDel();
2006
        return false;        
2007
    });
2008
    
2009
    $('#vnc_dialog').dialog({
2010
        autoOpen:false,
2011
        width:700,
2012
        modal:true,
2013
        height:500,
2014
        resizable:true,
2015
    });
2016
    
2017
    $('.vnc').live("click",function(){
2018
        rfb = new RFB({'target':       $D('VNC_canvas'),
2019
                        'encrypt':      false,
2020
                        'true_color':   true,
2021
                        'local_cursor': true,
2022
                        'shared':       true,
2023
                        'updateState':  updateVNCState});
2024
        //fetch things from clicked element host - port - password
2025
        var port=$(this).attr("vnc_port");
2026
        var pw=$(this).attr("vnc_pw");
2027
        rfb.connect(host, port, pw);
2028

  
2029
        $('#vnc_dialog').dialog('open');
2030
        
2031
        
2032
    });
2033

  
2034
}
2035

  
2036
function vncIcon(vm){
2037
    var graphics = vm.TEMPLATE.GRAPHICS;
2038
    var state = OpenNebula.Helper.resource_state("vm",vm.STATE);
2039
    var gr_icon, host, port, password;
2040
    if (graphics && graphics.TYPE == "vnc" && state == "ACTIVE" && vm.HISTORY.HOSTNAME){
2041
        host = vm.HISTORY.HOSTNAME;
2042
        port = graphics.PORT ? graphics.PORT : "";
2043
        password = graphics.PASSWD ? graphics.PASSWD : "";
2044
        gr_icon = '<a class="vnc" href="#" vnc_host="'+host+'" vnc_port="'+port+'" vnc_pw="'+password+'">';
2045
        gr_icon += '<img src="images/vnc_on.png" alt="Open VNC Session" /></a>';
2046
    }
2047
    else {
2048
        gr_icon = '<img src="images/vnc_off.png" alt="VNC Disabled" />';
2049
    }
2050
    return gr_icon;
2051
    
2052
}
2053

  
1939 2054
// At this point the DOM is ready and the sunstone.js ready() has been run.
1940 2055
$(document).ready(function(){
1941 2056
    
......
1947 2062
      "aoColumnDefs": [
1948 2063
                        { "bSortable": false, "aTargets": ["check"] },
1949 2064
                        { "sWidth": "60px", "aTargets": [0] },
1950
                        { "sWidth": "35px", "aTargets": [1] },
2065
                        { "sWidth": "35px", "aTargets": [1,9] },
1951 2066
                        { "sWidth": "100px", "aTargets": [2] }
1952 2067
                       ]
1953 2068
    });
......
1955 2070
    dataTable_vMachines.fnClearTable();
1956 2071
    addElement([
1957 2072
        spinner,
1958
        '','','','','','','',''],dataTable_vMachines);
2073
        '','','','','','','','',''],dataTable_vMachines);
1959 2074
	Sunstone.runAction("VM.list");
1960 2075
    
1961 2076
    setupCreateVMDialog();
1962 2077
    setupSaveasDialog();
1963 2078
    setVMAutorefresh();
2079
    setupVNC();
1964 2080
    
1965 2081
    initCheckAllBoxes(dataTable_vMachines);
1966 2082
    tableCheckboxesListener(dataTable_vMachines);
src/sunstone/public/vendor/noVNC/.gitignore
1
*.pyc
2
*.o
3
wsproxy
4
tests/data_*.js
5
utils/rebind.so
src/sunstone/public/vendor/noVNC/LICENSE.txt
1
noVNC is licensed under the LGPL version 3 (see docs/LICENSE.GPL-3 and
2
docs/LICENSE.LGPL-3) with the following exceptions:
3

  
4
    include/base64.js          : Dual GPL-2 or LGPL-2.1
5
   
6
    incluee/des.js             : Various BSD style licenses
7

  
8
    include/web-socket-js/     : New BSD license. Source code at
9
                                 http://github.com/gimite/web-socket-js
10

  
11
    images/                    : Creative Commons Attribution-ShareAlike
12
                                 http://creativecommons.org/licenses/by-sa/3.0/
13
                                 Uses of the work must be attributed
14
                                 to the noVNC project.
src/sunstone/public/vendor/noVNC/README.md
1
## noVNC: HTML5 VNC Client
2

  
3

  
4
### Description
5

  
6
noVNC is a VNC client implemented using HTML5 technologies,
7
specifically Canvas and WebSockets (supports 'wss://' encryption).
8
noVNC is licensed under the
9
[LGPLv3](http://www.gnu.org/licenses/lgpl.html).
10

  
11
Special thanks to [Sentry Data Systems](http://www.sentryds.com) for
12
sponsoring ongoing development of this project (and for employing me).
13

  
14
Notable commits, announcements and news are posted to
15
@<a href="http://www.twitter.com/noVNC">noVNC</a>
16

  
17

  
18
### Screenshots
19

  
20
Running in Chrome before and after connecting:
21

  
22
<img src="http://kanaka.github.com/noVNC/img/noVNC-1.jpg" width=400>&nbsp;<img src="http://kanaka.github.com/noVNC/img/noVNC-2.jpg" width=400>
23

  
24
See more screenshots <a href="http://kanaka.github.com/noVNC/screenshots.html">here</a>.
25

  
26

  
27
### Projects/Companies using noVNC
28

  
29
* [Sentry Data Systems](http://www.sentryds.com): uses noVNC in the
30
  [Datanex Cloud Computing Platform](http://www.sentryds.com/products/datanex/).
31

  
32
* [Ganeti Web Manager](http://code.osuosl.org/projects/ganeti-webmgr):
33
  Feature [#1935](http://code.osuosl.org/issues/1935).
34

  
35
* [Archipel](http://archipelproject.org):
36
  [Video demo](http://antoinemercadal.fr/archipelblog/wp-content/themes/ArchipelWPTemplate/video_youtube.php?title=VNC%20Demonstration&id=te_bzW574Zo)
37

  
38
* [openQRM](http://www.openqrm.com/): VNC plugin available
39
  by request. Probably included in [version
40
  4.8](http://www.openqrm.com/?q=node/15). [Video
41
    demo](http://www.openqrm-enterprise.com/news/details/article/remote-vm-console-plugin-available.html).
42

  
43
* [OpenNode](http://www.opennodecloud.com/): uses noVNC in
44
  [OpenNode Management Console](http://opennode.activesys.org/about/software-included-in-opennode/).
45
  [OMC Screencast](http://opennode.activesys.org/about/opennode-management-console-screencast/).
46

  
47
### Browser Requirements
48

  
49
* HTML5 Canvas: Except for Internet Explorer, most
50
  browsers have had Canvas support for quite some time. Internet
51
  Explorer 9 will have Canvas support (finally).
52

  
53
* HTML5 WebSockets: For browsers that do not have builtin
54
  WebSockets support, the project includes
55
  <a href="http://github.com/gimite/web-socket-js">web-socket-js</a>,
56
  a WebSockets emulator using Adobe Flash.
57

  
58
* Fast Javascript Engine: noVNC avoids using new Javascript
59
  functionality so it will run on older browsers, but decode and
60
  rendering happen in Javascript, so a slow Javascript engine will
61
  mean noVNC is painfully slow.
62

  
63
* I maintain a more detailed list of browser compatibility <a
64
  href="wiki/Browser-support">here</a>.
65

  
66

  
67
### Server Requirements
68

  
69
Unless you are using a VNC server with support for WebSockets
70
connections (only my [fork of libvncserver](http://github.com/kanaka/libvncserver)
71
currently), you need to use a WebSockets to TCP socket proxy. There is
72
a python proxy included ('websockify'). One advantage of using the
73
proxy is that it has builtin support for SSL/TLS encryption (i.e.
74
"wss://").
75

  
76
There a few reasons why a proxy is required:
77

  
78
  1. WebSockets is not a pure socket protocol. There is an initial HTTP
79
     like handshake to allow easy hand-off by web servers and allow
80
     some origin policy exchange. Also, each WebSockets frame begins
81
     with 0 ('\x00') and ends with 255 ('\xff').
82

  
83
  2. Javascript itself does not have the ability to handle pure byte
84
     arrays. The python proxy encodes the data as base64 so that the
85
     Javascript client can decode the data as an integer array.
86

  
87

  
88
### Quick Start
89

  
90
* Use the launch script to start a mini-webserver and the WebSockets
91
  proxy (websockify). The `--vnc` option is used to specify the location of
92
  a running VNC server:
93

  
94
    `./utils/launch.sh --vnc localhost:5901`
95

  
96
* Point your browser to the cut-and-paste URL that is output by the
97
  launch script. Enter a password if the VNC server has one
98
  configured. Hit the Connect button and enjoy!
99

  
100

  
101
### Other Pages
102

  
103
* [Advanced Usage](wiki/Advanced-usage). Generating an SSL
104
  certificate, starting a VNC server, advanced websockify usage, etc.
105

  
106
* [Integrating noVNC](wiki/Integration) into existing projects.
107

  
108
* [Troubleshooting noVNC](wiki/Troubleshooting) problems.
109

  
110

  
src/sunstone/public/vendor/noVNC/docs/LICENSE.GPL-3
1
                    GNU GENERAL PUBLIC LICENSE
2
                       Version 3, 29 June 2007
3

  
4
 Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
5
 Everyone is permitted to copy and distribute verbatim copies
6
 of this license document, but changing it is not allowed.
7

  
8
                            Preamble
9

  
10
  The GNU General Public License is a free, copyleft license for
11
software and other kinds of works.
12

  
13
  The licenses for most software and other practical works are designed
14
to take away your freedom to share and change the works.  By contrast,
15
the GNU General Public License is intended to guarantee your freedom to
16
share and change all versions of a program--to make sure it remains free
17
software for all its users.  We, the Free Software Foundation, use the
18
GNU General Public License for most of our software; it applies also to
19
any other work released this way by its authors.  You can apply it to
20
your programs, too.
21

  
22
  When we speak of free software, we are referring to freedom, not
23
price.  Our General Public Licenses are designed to make sure that you
24
have the freedom to distribute copies of free software (and charge for
25
them if you wish), that you receive source code or can get it if you
26
want it, that you can change the software or use pieces of it in new
27
free programs, and that you know you can do these things.
28

  
29
  To protect your rights, we need to prevent others from denying you
30
these rights or asking you to surrender the rights.  Therefore, you have
31
certain responsibilities if you distribute copies of the software, or if
32
you modify it: responsibilities to respect the freedom of others.
33

  
34
  For example, if you distribute copies of such a program, whether
35
gratis or for a fee, you must pass on to the recipients the same
36
freedoms that you received.  You must make sure that they, too, receive
37
or can get the source code.  And you must show them these terms so they
38
know their rights.
39

  
40
  Developers that use the GNU GPL protect your rights with two steps:
41
(1) assert copyright on the software, and (2) offer you this License
42
giving you legal permission to copy, distribute and/or modify it.
43

  
44
  For the developers' and authors' protection, the GPL clearly explains
45
that there is no warranty for this free software.  For both users' and
46
authors' sake, the GPL requires that modified versions be marked as
47
changed, so that their problems will not be attributed erroneously to
48
authors of previous versions.
49

  
50
  Some devices are designed to deny users access to install or run
51
modified versions of the software inside them, although the manufacturer
52
can do so.  This is fundamentally incompatible with the aim of
53
protecting users' freedom to change the software.  The systematic
54
pattern of such abuse occurs in the area of products for individuals to
55
use, which is precisely where it is most unacceptable.  Therefore, we
56
have designed this version of the GPL to prohibit the practice for those
57
products.  If such problems arise substantially in other domains, we
58
stand ready to extend this provision to those domains in future versions
59
of the GPL, as needed to protect the freedom of users.
60

  
61
  Finally, every program is threatened constantly by software patents.
62
States should not allow patents to restrict development and use of
63
software on general-purpose computers, but in those that do, we wish to
64
avoid the special danger that patents applied to a free program could
65
make it effectively proprietary.  To prevent this, the GPL assures that
66
patents cannot be used to render the program non-free.
67

  
68
  The precise terms and conditions for copying, distribution and
69
modification follow.
70

  
71
                       TERMS AND CONDITIONS
72

  
73
  0. Definitions.
74

  
75
  "This License" refers to version 3 of the GNU General Public License.
76

  
77
  "Copyright" also means copyright-like laws that apply to other kinds of
78
works, such as semiconductor masks.
79

  
80
  "The Program" refers to any copyrightable work licensed under this
81
License.  Each licensee is addressed as "you".  "Licensees" and
82
"recipients" may be individuals or organizations.
83

  
84
  To "modify" a work means to copy from or adapt all or part of the work
85
in a fashion requiring copyright permission, other than the making of an
86
exact copy.  The resulting work is called a "modified version" of the
87
earlier work or a work "based on" the earlier work.
88

  
89
  A "covered work" means either the unmodified Program or a work based
90
on the Program.
91

  
92
  To "propagate" a work means to do anything with it that, without
93
permission, would make you directly or secondarily liable for
94
infringement under applicable copyright law, except executing it on a
95
computer or modifying a private copy.  Propagation includes copying,
96
distribution (with or without modification), making available to the
97
public, and in some countries other activities as well.
98

  
99
  To "convey" a work means any kind of propagation that enables other
100
parties to make or receive copies.  Mere interaction with a user through
101
a computer network, with no transfer of a copy, is not conveying.
102

  
103
  An interactive user interface displays "Appropriate Legal Notices"
104
to the extent that it includes a convenient and prominently visible
105
feature that (1) displays an appropriate copyright notice, and (2)
106
tells the user that there is no warranty for the work (except to the
107
extent that warranties are provided), that licensees may convey the
108
work under this License, and how to view a copy of this License.  If
109
the interface presents a list of user commands or options, such as a
110
menu, a prominent item in the list meets this criterion.
111

  
112
  1. Source Code.
113

  
114
  The "source code" for a work means the preferred form of the work
115
for making modifications to it.  "Object code" means any non-source
116
form of a work.
117

  
118
  A "Standard Interface" means an interface that either is an official
119
standard defined by a recognized standards body, or, in the case of
120
interfaces specified for a particular programming language, one that
121
is widely used among developers working in that language.
122

  
123
  The "System Libraries" of an executable work include anything, other
124
than the work as a whole, that (a) is included in the normal form of
125
packaging a Major Component, but which is not part of that Major
126
Component, and (b) serves only to enable use of the work with that
127
Major Component, or to implement a Standard Interface for which an
128
implementation is available to the public in source code form.  A
129
"Major Component", in this context, means a major essential component
130
(kernel, window system, and so on) of the specific operating system
131
(if any) on which the executable work runs, or a compiler used to
132
produce the work, or an object code interpreter used to run it.
133

  
134
  The "Corresponding Source" for a work in object code form means all
135
the source code needed to generate, install, and (for an executable
136
work) run the object code and to modify the work, including scripts to
137
control those activities.  However, it does not include the work's
138
System Libraries, or general-purpose tools or generally available free
139
programs which are used unmodified in performing those activities but
140
which are not part of the work.  For example, Corresponding Source
141
includes interface definition files associated with source files for
142
the work, and the source code for shared libraries and dynamically
143
linked subprograms that the work is specifically designed to require,
144
such as by intimate data communication or control flow between those
145
subprograms and other parts of the work.
146

  
147
  The Corresponding Source need not include anything that users
148
can regenerate automatically from other parts of the Corresponding
149
Source.
150

  
151
  The Corresponding Source for a work in source code form is that
152
same work.
153

  
154
  2. Basic Permissions.
155

  
156
  All rights granted under this License are granted for the term of
157
copyright on the Program, and are irrevocable provided the stated
158
conditions are met.  This License explicitly affirms your unlimited
159
permission to run the unmodified Program.  The output from running a
160
covered work is covered by this License only if the output, given its
161
content, constitutes a covered work.  This License acknowledges your
162
rights of fair use or other equivalent, as provided by copyright law.
163

  
164
  You may make, run and propagate covered works that you do not
165
convey, without conditions so long as your license otherwise remains
166
in force.  You may convey covered works to others for the sole purpose
167
of having them make modifications exclusively for you, or provide you
168
with facilities for running those works, provided that you comply with
169
the terms of this License in conveying all material for which you do
170
not control copyright.  Those thus making or running the covered works
171
for you must do so exclusively on your behalf, under your direction
172
and control, on terms that prohibit them from making any copies of
173
your copyrighted material outside their relationship with you.
174

  
175
  Conveying under any other circumstances is permitted solely under
176
the conditions stated below.  Sublicensing is not allowed; section 10
177
makes it unnecessary.
178

  
179
  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
180

  
181
  No covered work shall be deemed part of an effective technological
182
measure under any applicable law fulfilling obligations under article
183
11 of the WIPO copyright treaty adopted on 20 December 1996, or
184
similar laws prohibiting or restricting circumvention of such
185
measures.
186

  
187
  When you convey a covered work, you waive any legal power to forbid
188
circumvention of technological measures to the extent such circumvention
189
is effected by exercising rights under this License with respect to
190
the covered work, and you disclaim any intention to limit operation or
191
modification of the work as a means of enforcing, against the work's
192
users, your or third parties' legal rights to forbid circumvention of
193
technological measures.
194

  
195
  4. Conveying Verbatim Copies.
196

  
197
  You may convey verbatim copies of the Program's source code as you
198
receive it, in any medium, provided that you conspicuously and
199
appropriately publish on each copy an appropriate copyright notice;
200
keep intact all notices stating that this License and any
201
non-permissive terms added in accord with section 7 apply to the code;
202
keep intact all notices of the absence of any warranty; and give all
203
recipients a copy of this License along with the Program.
204

  
205
  You may charge any price or no price for each copy that you convey,
206
and you may offer support or warranty protection for a fee.
207

  
208
  5. Conveying Modified Source Versions.
209

  
210
  You may convey a work based on the Program, or the modifications to
211
produce it from the Program, in the form of source code under the
212
terms of section 4, provided that you also meet all of these conditions:
213

  
214
    a) The work must carry prominent notices stating that you modified
215
    it, and giving a relevant date.
216

  
217
    b) The work must carry prominent notices stating that it is
218
    released under this License and any conditions added under section
219
    7.  This requirement modifies the requirement in section 4 to
220
    "keep intact all notices".
221

  
222
    c) You must license the entire work, as a whole, under this
223
    License to anyone who comes into possession of a copy.  This
224
    License will therefore apply, along with any applicable section 7
225
    additional terms, to the whole of the work, and all its parts,
226
    regardless of how they are packaged.  This License gives no
227
    permission to license the work in any other way, but it does not
228
    invalidate such permission if you have separately received it.
229

  
230
    d) If the work has interactive user interfaces, each must display
231
    Appropriate Legal Notices; however, if the Program has interactive
232
    interfaces that do not display Appropriate Legal Notices, your
233
    work need not make them do so.
234

  
235
  A compilation of a covered work with other separate and independent
236
works, which are not by their nature extensions of the covered work,
237
and which are not combined with it such as to form a larger program,
238
in or on a volume of a storage or distribution medium, is called an
239
"aggregate" if the compilation and its resulting copyright are not
240
used to limit the access or legal rights of the compilation's users
241
beyond what the individual works permit.  Inclusion of a covered work
242
in an aggregate does not cause this License to apply to the other
243
parts of the aggregate.
244

  
245
  6. Conveying Non-Source Forms.
246

  
247
  You may convey a covered work in object code form under the terms
248
of sections 4 and 5, provided that you also convey the
249
machine-readable Corresponding Source under the terms of this License,
250
in one of these ways:
251

  
252
    a) Convey the object code in, or embodied in, a physical product
253
    (including a physical distribution medium), accompanied by the
254
    Corresponding Source fixed on a durable physical medium
255
    customarily used for software interchange.
256

  
257
    b) Convey the object code in, or embodied in, a physical product
258
    (including a physical distribution medium), accompanied by a
259
    written offer, valid for at least three years and valid for as
260
    long as you offer spare parts or customer support for that product
261
    model, to give anyone who possesses the object code either (1) a
262
    copy of the Corresponding Source for all the software in the
263
    product that is covered by this License, on a durable physical
264
    medium customarily used for software interchange, for a price no
265
    more than your reasonable cost of physically performing this
266
    conveying of source, or (2) access to copy the
267
    Corresponding Source from a network server at no charge.
268

  
269
    c) Convey individual copies of the object code with a copy of the
270
    written offer to provide the Corresponding Source.  This
271
    alternative is allowed only occasionally and noncommercially, and
272
    only if you received the object code with such an offer, in accord
273
    with subsection 6b.
274

  
275
    d) Convey the object code by offering access from a designated
276
    place (gratis or for a charge), and offer equivalent access to the
277
    Corresponding Source in the same way through the same place at no
278
    further charge.  You need not require recipients to copy the
279
    Corresponding Source along with the object code.  If the place to
280
    copy the object code is a network server, the Corresponding Source
281
    may be on a different server (operated by you or a third party)
282
    that supports equivalent copying facilities, provided you maintain
283
    clear directions next to the object code saying where to find the
284
    Corresponding Source.  Regardless of what server hosts the
285
    Corresponding Source, you remain obligated to ensure that it is
286
    available for as long as needed to satisfy these requirements.
287

  
288
    e) Convey the object code using peer-to-peer transmission, provided
289
    you inform other peers where the object code and Corresponding
290
    Source of the work are being offered to the general public at no
291
    charge under subsection 6d.
292

  
293
  A separable portion of the object code, whose source code is excluded
294
from the Corresponding Source as a System Library, need not be
295
included in conveying the object code work.
296

  
297
  A "User Product" is either (1) a "consumer product", which means any
298
tangible personal property which is normally used for personal, family,
299
or household purposes, or (2) anything designed or sold for incorporation
300
into a dwelling.  In determining whether a product is a consumer product,
301
doubtful cases shall be resolved in favor of coverage.  For a particular
302
product received by a particular user, "normally used" refers to a
303
typical or common use of that class of product, regardless of the status
304
of the particular user or of the way in which the particular user
305
actually uses, or expects or is expected to use, the product.  A product
306
is a consumer product regardless of whether the product has substantial
307
commercial, industrial or non-consumer uses, unless such uses represent
308
the only significant mode of use of the product.
309

  
310
  "Installation Information" for a User Product means any methods,
311
procedures, authorization keys, or other information required to install
312
and execute modified versions of a covered work in that User Product from
313
a modified version of its Corresponding Source.  The information must
314
suffice to ensure that the continued functioning of the modified object
315
code is in no case prevented or interfered with solely because
316
modification has been made.
317

  
318
  If you convey an object code work under this section in, or with, or
319
specifically for use in, a User Product, and the conveying occurs as
320
part of a transaction in which the right of possession and use of the
321
User Product is transferred to the recipient in perpetuity or for a
322
fixed term (regardless of how the transaction is characterized), the
323
Corresponding Source conveyed under this section must be accompanied
324
by the Installation Information.  But this requirement does not apply
325
if neither you nor any third party retains the ability to install
326
modified object code on the User Product (for example, the work has
327
been installed in ROM).
328

  
329
  The requirement to provide Installation Information does not include a
330
requirement to continue to provide support service, warranty, or updates
331
for a work that has been modified or installed by the recipient, or for
332
the User Product in which it has been modified or installed.  Access to a
333
network may be denied when the modification itself materially and
334
adversely affects the operation of the network or violates the rules and
335
protocols for communication across the network.
336

  
337
  Corresponding Source conveyed, and Installation Information provided,
338
in accord with this section must be in a format that is publicly
339
documented (and with an implementation available to the public in
340
source code form), and must require no special password or key for
341
unpacking, reading or copying.
342

  
343
  7. Additional Terms.
344

  
345
  "Additional permissions" are terms that supplement the terms of this
346
License by making exceptions from one or more of its conditions.
347
Additional permissions that are applicable to the entire Program shall
348
be treated as though they were included in this License, to the extent
349
that they are valid under applicable law.  If additional permissions
350
apply only to part of the Program, that part may be used separately
351
under those permissions, but the entire Program remains governed by
352
this License without regard to the additional permissions.
353

  
354
  When you convey a copy of a covered work, you may at your option
355
remove any additional permissions from that copy, or from any part of
356
it.  (Additional permissions may be written to require their own
357
removal in certain cases when you modify the work.)  You may place
358
additional permissions on material, added by you to a covered work,
359
for which you have or can give appropriate copyright permission.
360

  
361
  Notwithstanding any other provision of this License, for material you
362
add to a covered work, you may (if authorized by the copyright holders of
363
that material) supplement the terms of this License with terms:
364

  
365
    a) Disclaiming warranty or limiting liability differently from the
366
    terms of sections 15 and 16 of this License; or
367

  
368
    b) Requiring preservation of specified reasonable legal notices or
369
    author attributions in that material or in the Appropriate Legal
370
    Notices displayed by works containing it; or
371

  
372
    c) Prohibiting misrepresentation of the origin of that material, or
373
    requiring that modified versions of such material be marked in
374
    reasonable ways as different from the original version; or
375

  
376
    d) Limiting the use for publicity purposes of names of licensors or
377
    authors of the material; or
378

  
379
    e) Declining to grant rights under trademark law for use of some
380
    trade names, trademarks, or service marks; or
381

  
382
    f) Requiring indemnification of licensors and authors of that
383
    material by anyone who conveys the material (or modified versions of
384
    it) with contractual assumptions of liability to the recipient, for
385
    any liability that these contractual assumptions directly impose on
386
    those licensors and authors.
387

  
388
  All other non-permissive additional terms are considered "further
389
restrictions" within the meaning of section 10.  If the Program as you
390
received it, or any part of it, contains a notice stating that it is
391
governed by this License along with a term that is a further
392
restriction, you may remove that term.  If a license document contains
393
a further restriction but permits relicensing or conveying under this
394
License, you may add to a covered work material governed by the terms
395
of that license document, provided that the further restriction does
396
not survive such relicensing or conveying.
397

  
398
  If you add terms to a covered work in accord with this section, you
399
must place, in the relevant source files, a statement of the
400
additional terms that apply to those files, or a notice indicating
401
where to find the applicable terms.
402

  
403
  Additional terms, permissive or non-permissive, may be stated in the
404
form of a separately written license, or stated as exceptions;
405
the above requirements apply either way.
406

  
407
  8. Termination.
408

  
409
  You may not propagate or modify a covered work except as expressly
410
provided under this License.  Any attempt otherwise to propagate or
411
modify it is void, and will automatically terminate your rights under
412
this License (including any patent licenses granted under the third
413
paragraph of section 11).
414

  
415
  However, if you cease all violation of this License, then your
416
license from a particular copyright holder is reinstated (a)
417
provisionally, unless and until the copyright holder explicitly and
418
finally terminates your license, and (b) permanently, if the copyright
419
holder fails to notify you of the violation by some reasonable means
420
prior to 60 days after the cessation.
421

  
422
  Moreover, your license from a particular copyright holder is
423
reinstated permanently if the copyright holder notifies you of the
424
violation by some reasonable means, this is the first time you have
425
received notice of violation of this License (for any work) from that
426
copyright holder, and you cure the violation prior to 30 days after
427
your receipt of the notice.
428

  
429
  Termination of your rights under this section does not terminate the
430
licenses of parties who have received copies or rights from you under
431
this License.  If your rights have been terminated and not permanently
432
reinstated, you do not qualify to receive new licenses for the same
433
material under section 10.
434

  
435
  9. Acceptance Not Required for Having Copies.
436

  
437
  You are not required to accept this License in order to receive or
438
run a copy of the Program.  Ancillary propagation of a covered work
439
occurring solely as a consequence of using peer-to-peer transmission
440
to receive a copy likewise does not require acceptance.  However,
441
nothing other than this License grants you permission to propagate or
442
modify any covered work.  These actions infringe copyright if you do
443
not accept this License.  Therefore, by modifying or propagating a
444
covered work, you indicate your acceptance of this License to do so.
445

  
446
  10. Automatic Licensing of Downstream Recipients.
447

  
448
  Each time you convey a covered work, the recipient automatically
449
receives a license from the original licensors, to run, modify and
450
propagate that work, subject to this License.  You are not responsible
451
for enforcing compliance by third parties with this License.
452

  
453
  An "entity transaction" is a transaction transferring control of an
454
organization, or substantially all assets of one, or subdividing an
455
organization, or merging organizations.  If propagation of a covered
456
work results from an entity transaction, each party to that
457
transaction who receives a copy of the work also receives whatever
458
licenses to the work the party's predecessor in interest had or could
459
give under the previous paragraph, plus a right to possession of the
460
Corresponding Source of the work from the predecessor in interest, if
461
the predecessor has it or can get it with reasonable efforts.
462

  
463
  You may not impose any further restrictions on the exercise of the
464
rights granted or affirmed under this License.  For example, you may
465
not impose a license fee, royalty, or other charge for exercise of
466
rights granted under this License, and you may not initiate litigation
467
(including a cross-claim or counterclaim in a lawsuit) alleging that
468
any patent claim is infringed by making, using, selling, offering for
469
sale, or importing the Program or any portion of it.
470

  
471
  11. Patents.
472

  
473
  A "contributor" is a copyright holder who authorizes use under this
474
License of the Program or a work on which the Program is based.  The
475
work thus licensed is called the contributor's "contributor version".
476

  
477
  A contributor's "essential patent claims" are all patent claims
478
owned or controlled by the contributor, whether already acquired or
479
hereafter acquired, that would be infringed by some manner, permitted
480
by this License, of making, using, or selling its contributor version,
481
but do not include claims that would be infringed only as a
482
consequence of further modification of the contributor version.  For
483
purposes of this definition, "control" includes the right to grant
484
patent sublicenses in a manner consistent with the requirements of
485
this License.
486

  
487
  Each contributor grants you a non-exclusive, worldwide, royalty-free
488
patent license under the contributor's essential patent claims, to
489
make, use, sell, offer for sale, import and otherwise run, modify and
490
propagate the contents of its contributor version.
491

  
492
  In the following three paragraphs, a "patent license" is any express
493
agreement or commitment, however denominated, not to enforce a patent
494
(such as an express permission to practice a patent or covenant not to
495
sue for patent infringement).  To "grant" such a patent license to a
496
party means to make such an agreement or commitment not to enforce a
497
patent against the party.
498

  
499
  If you convey a covered work, knowingly relying on a patent license,
500
and the Corresponding Source of the work is not available for anyone
501
to copy, free of charge and under the terms of this License, through a
502
publicly available network server or other readily accessible means,
503
then you must either (1) cause the Corresponding Source to be so
504
available, or (2) arrange to deprive yourself of the benefit of the
505
patent license for this particular work, or (3) arrange, in a manner
506
consistent with the requirements of this License, to extend the patent
507
license to downstream recipients.  "Knowingly relying" means you have
508
actual knowledge that, but for the patent license, your conveying the
509
covered work in a country, or your recipient's use of the covered work
510
in a country, would infringe one or more identifiable patents in that
511
country that you have reason to believe are valid.
512

  
513
  If, pursuant to or in connection with a single transaction or
514
arrangement, you convey, or propagate by procuring conveyance of, a
515
covered work, and grant a patent license to some of the parties
516
receiving the covered work authorizing them to use, propagate, modify
517
or convey a specific copy of the covered work, then the patent license
518
you grant is automatically extended to all recipients of the covered
519
work and works based on it.
520

  
521
  A patent license is "discriminatory" if it does not include within
522
the scope of its coverage, prohibits the exercise of, or is
523
conditioned on the non-exercise of one or more of the rights that are
524
specifically granted under this License.  You may not convey a covered
525
work if you are a party to an arrangement with a third party that is
526
in the business of distributing software, under which you make payment
527
to the third party based on the extent of your activity of conveying
528
the work, and under which the third party grants, to any of the
529
parties who would receive the covered work from you, a discriminatory
530
patent license (a) in connection with copies of the covered work
531
conveyed by you (or copies made from those copies), or (b) primarily
532
for and in connection with specific products or compilations that
533
contain the covered work, unless you entered into that arrangement,
534
or that patent license was granted, prior to 28 March 2007.
535

  
536
  Nothing in this License shall be construed as excluding or limiting
537
any implied license or other defenses to infringement that may
538
otherwise be available to you under applicable patent law.
539

  
540
  12. No Surrender of Others' Freedom.
541

  
542
  If conditions are imposed on you (whether by court order, agreement or
543
otherwise) that contradict the conditions of this License, they do not
544
excuse you from the conditions of this License.  If you cannot convey a
545
covered work so as to satisfy simultaneously your obligations under this
546
License and any other pertinent obligations, then as a consequence you may
547
not convey it at all.  For example, if you agree to terms that obligate you
548
to collect a royalty for further conveying from those to whom you convey
549
the Program, the only way you could satisfy both those terms and this
550
License would be to refrain entirely from conveying the Program.
551

  
552
  13. Use with the GNU Affero General Public License.
553

  
554
  Notwithstanding any other provision of this License, you have
555
permission to link or combine any covered work with a work licensed
556
under version 3 of the GNU Affero General Public License into a single
557
combined work, and to convey the resulting work.  The terms of this
558
License will continue to apply to the part which is the covered work,
559
but the special requirements of the GNU Affero General Public License,
560
section 13, concerning interaction through a network will apply to the
561
combination as such.
562

  
563
  14. Revised Versions of this License.
564

  
565
  The Free Software Foundation may publish revised and/or new versions of
566
the GNU General Public License from time to time.  Such new versions will
567
be similar in spirit to the present version, but may differ in detail to
568
address new problems or concerns.
569

  
570
  Each version is given a distinguishing version number.  If the
571
Program specifies that a certain numbered version of the GNU General
572
Public License "or any later version" applies to it, you have the
573
option of following the terms and conditions either of that numbered
574
version or of any later version published by the Free Software
575
Foundation.  If the Program does not specify a version number of the
576
GNU General Public License, you may choose any version ever published
577
by the Free Software Foundation.
578

  
579
  If the Program specifies that a proxy can decide which future
580
versions of the GNU General Public License can be used, that proxy's
581
public statement of acceptance of a version permanently authorizes you
582
to choose that version for the Program.
583

  
584
  Later license versions may give you additional or different
585
permissions.  However, no additional obligations are imposed on any
586
author or copyright holder as a result of your choosing to follow a
587
later version.
588

  
589
  15. Disclaimer of Warranty.
590

  
591
  THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
592
APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
593
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
594
OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
595
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
596
PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
597
IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
598
ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
599

  
600
  16. Limitation of Liability.
601

  
602
  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
603
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
604
THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
605
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
606
USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
607
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
608
PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
609
EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
610
SUCH DAMAGES.
611

  
612
  17. Interpretation of Sections 15 and 16.
613

  
614
  If the disclaimer of warranty and limitation of liability provided
615
above cannot be given local legal effect according to their terms,
616
reviewing courts shall apply local law that most closely approximates
617
an absolute waiver of all civil liability in connection with the
618
Program, unless a warranty or assumption of liability accompanies a
619
copy of the Program in return for a fee.
620

  
621
                     END OF TERMS AND CONDITIONS
src/sunstone/public/vendor/noVNC/docs/LICENSE.LGPL-3
1
                   GNU LESSER GENERAL PUBLIC LICENSE
2
                       Version 3, 29 June 2007
3

  
4
 Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
5
 Everyone is permitted to copy and distribute verbatim copies
6
 of this license document, but changing it is not allowed.
7

  
8

  
9
  This version of the GNU Lesser General Public License incorporates
10
the terms and conditions of version 3 of the GNU General Public
11
License, supplemented by the additional permissions listed below.
12

  
13
  0. Additional Definitions.
14

  
15
  As used herein, "this License" refers to version 3 of the GNU Lesser
16
General Public License, and the "GNU GPL" refers to version 3 of the GNU
17
General Public License.
18

  
19
  "The Library" refers to a covered work governed by this License,
20
other than an Application or a Combined Work as defined below.
21

  
22
  An "Application" is any work that makes use of an interface provided
23
by the Library, but which is not otherwise based on the Library.
24
Defining a subclass of a class defined by the Library is deemed a mode
25
of using an interface provided by the Library.
26

  
27
  A "Combined Work" is a work produced by combining or linking an
28
Application with the Library.  The particular version of the Library
29
with which the Combined Work was made is also called the "Linked
30
Version".
31

  
32
  The "Minimal Corresponding Source" for a Combined Work means the
33
Corresponding Source for the Combined Work, excluding any source code
34
for portions of the Combined Work that, considered in isolation, are
35
based on the Application, and not on the Linked Version.
36

  
37
  The "Corresponding Application Code" for a Combined Work means the
38
object code and/or source code for the Application, including any data
39
and utility programs needed for reproducing the Combined Work from the
40
Application, but excluding the System Libraries of the Combined Work.
41

  
42
  1. Exception to Section 3 of the GNU GPL.
43

  
44
  You may convey a covered work under sections 3 and 4 of this License
45
without being bound by section 3 of the GNU GPL.
46

  
47
  2. Conveying Modified Versions.
48

  
49
  If you modify a copy of the Library, and, in your modifications, a
50
facility refers to a function or data to be supplied by an Application
51
that uses the facility (other than as an argument passed when the
52
facility is invoked), then you may convey a copy of the modified
53
version:
54

  
55
   a) under this License, provided that you make a good faith effort to
56
   ensure that, in the event an Application does not supply the
57
   function or data, the facility still operates, and performs
58
   whatever part of its purpose remains meaningful, or
59

  
60
   b) under the GNU GPL, with none of the additional permissions of
61
   this License applicable to that copy.
62

  
63
  3. Object Code Incorporating Material from Library Header Files.
64

  
65
  The object code form of an Application may incorporate material from
66
a header file that is part of the Library.  You may convey such object
67
code under terms of your choice, provided that, if the incorporated
68
material is not limited to numerical parameters, data structure
69
layouts and accessors, or small macros, inline functions and templates
70
(ten or fewer lines in length), you do both of the following:
71

  
72
   a) Give prominent notice with each copy of the object code that the
73
   Library is used in it and that the Library and its use are
74
   covered by this License.
75

  
76
   b) Accompany the object code with a copy of the GNU GPL and this license
77
   document.
78

  
79
  4. Combined Works.
80

  
81
  You may convey a Combined Work under terms of your choice that,
82
taken together, effectively do not restrict modification of the
83
portions of the Library contained in the Combined Work and reverse
84
engineering for debugging such modifications, if you also do each of
85
the following:
86

  
87
   a) Give prominent notice with each copy of the Combined Work that
88
   the Library is used in it and that the Library and its use are
89
   covered by this License.
90

  
91
   b) Accompany the Combined Work with a copy of the GNU GPL and this license
92
   document.
93

  
94
   c) For a Combined Work that displays copyright notices during
95
   execution, include the copyright notice for the Library among
96
   these notices, as well as a reference directing the user to the
97
   copies of the GNU GPL and this license document.
98

  
99
   d) Do one of the following:
100

  
101
       0) Convey the Minimal Corresponding Source under the terms of this
102
       License, and the Corresponding Application Code in a form
103
       suitable for, and under terms that permit, the user to
104
       recombine or relink the Application with a modified version of
105
       the Linked Version to produce a modified Combined Work, in the
106
       manner specified by section 6 of the GNU GPL for conveying
107
       Corresponding Source.
108

  
109
       1) Use a suitable shared library mechanism for linking with the
110
       Library.  A suitable mechanism is one that (a) uses at run time
111
       a copy of the Library already present on the user's computer
112
       system, and (b) will operate properly with a modified version
113
       of the Library that is interface-compatible with the Linked
114
       Version.
115

  
116
   e) Provide Installation Information, but only if you would otherwise
117
   be required to provide such information under section 6 of the
118
   GNU GPL, and only to the extent that such information is
119
   necessary to install and execute a modified version of the
120
   Combined Work produced by recombining or relinking the
121
   Application with a modified version of the Linked Version. (If
122
   you use option 4d0, the Installation Information must accompany
123
   the Minimal Corresponding Source and Corresponding Application
124
   Code. If you use option 4d1, you must provide the Installation
125
   Information in the manner specified by section 6 of the GNU GPL
126
   for conveying Corresponding Source.)
127

  
128
  5. Combined Libraries.
129

  
130
  You may place library facilities that are a work based on the
131
Library side by side in a single library together with other library
132
facilities that are not Applications and are not covered by this
133
License, and convey such a combined library under terms of your
134
choice, if you do both of the following:
135

  
136
   a) Accompany the combined library with a copy of the same work based
137
   on the Library, uncombined with any other library facilities,
138
   conveyed under the terms of this License.
139

  
140
   b) Give prominent notice with the combined library that part of it
141
   is a work based on the Library, and explaining where to find the
142
   accompanying uncombined form of the same work.
143

  
144
  6. Revised Versions of the GNU Lesser General Public License.
145

  
146
  The Free Software Foundation may publish revised and/or new versions
147
of the GNU Lesser General Public License from time to time. Such new
148
versions will be similar in spirit to the present version, but may
149
differ in detail to address new problems or concerns.
150

  
151
  Each version is given a distinguishing version number. If the
152
Library as you received it specifies that a certain numbered version
153
of the GNU Lesser General Public License "or any later version"
154
applies to it, you have the option of following the terms and
155
conditions either of that published version or of any later version
156
published by the Free Software Foundation. If the Library as you
157
received it does not specify a version number of the GNU Lesser
158
General Public License, you may choose any version of the GNU Lesser
159
General Public License ever published by the Free Software Foundation.
160

  
161
  If the Library as you received it specifies that a proxy can decide
162
whether future versions of the GNU Lesser General Public License shall
163
apply, that proxy's public statement of acceptance of any version is
164
permanent authorization for you to choose that version for the
165
Library.
src/sunstone/public/vendor/noVNC/docs/TODO
1
Short Term:
2

  
3
- Test normal arrays vs TypedArrays vs imageData arrays.
4
    - Blog post about it.
5

  
6
- VNC performance and regression playback suite.
7
    - WebSockets
8
        - expand latency test
9
        - add absolute timers (every 500 packets)
10
        - try 1 ms delay
11
        - stop at 4000 packets
12
        - small and large packets test
13

  
14
    - JavaScript
15
        - just base64 decode
16
        - everything except Canvas
17

  
18
    - Full test
19
        - Without WebSockets
20
        - With replay from python tester
21
        - add higher-resolution multi test
22

  
23
    - websockify test with echo and playback functionality
24
      - choosen by client test page on connect
25

  
26

  
27
- Keyboard layout/internationalization support
28
    - convert keyCode into proper charCode
29

  
30
- IE 9 improvements.
31
    - https://github.com/gimite/web-socket-js/issues#issue/41
32
    - try window.atob instead of decode for better performance
33

  
34
- Status bar menu/buttons:
35
    - Explanatory hover text over buttons
36

  
37
    - Configuration menu:
38
        - Tunable: speed vs. bandwidth selection
39
        - Tunable: CPU use versus latency.
40
        - Scaling
41

  
42
    - Keyboard menu:
43
        - Ctrl Lock, Alt Lock, SysRq Lock
44
        - Highlight menu icon when keys are locked
45

  
46
    - Clipboard button -> popup:
47
        - text, clear and send buttons
48

  
49
Medium Term:
50

  
51
- Viewport support
52

  
53
- Touchscreen testing/support.
src/sunstone/public/vendor/noVNC/docs/flash_policy.txt
1
Manual setup:
2

  
3
DATA="echo \'<cross-domain-policy><allow-access-from domain=\\\"*\\\" to-ports=\\\"*\\\" /></cross-domain-policy>\'"
4
/usr/bin/socat -T 1 TCP-L:843,reuseaddr,fork,crlf SYSTEM:"$DATA"
src/sunstone/public/vendor/noVNC/docs/links
1
New tight PNG protocol:
2
    http://wiki.qemu.org/VNC_Tight_PNG
3
    http://xf.iksaif.net/blog/index.php?post/2010/06/14/QEMU:-Tight-PNG-and-some-profiling
4

  
5
RFB protocol and extensions:
6
    http://tigervnc.org/cgi-bin/rfbproto
7

  
8
Canvas Browser Compatibility:
9
    http://philip.html5.org/tests/canvas/suite/tests/results.html
10

  
11
WebSockets API standard:
12
    http://www.whatwg.org/specs/web-apps/current-work/complete.html#websocket
13
    http://dev.w3.org/html5/websockets/
14
    http://www.ietf.org/id/draft-ietf-hybi-thewebsocketprotocol-00.txt
15

  
16
Browser Keyboard Events detailed:
17
    http://unixpapa.com/js/key.html
18

  
19
ActionScript (Flash) WebSocket implementation:
20
    http://github.com/gimite/web-socket-js
21

  
22
ActionScript (Flash) crypto/TLS library:
23
    http://code.google.com/p/as3crypto
24
    http://github.com/lyokato/as3crypto_patched
25

  
26
TLS Protocol:
27
    http://en.wikipedia.org/wiki/Transport_Layer_Security
28

  
29
Generate self-signed certificate:
30
    http://docs.python.org/dev/library/ssl.html#certificates
31

  
32
Cursor appearance/style (for Cursor pseudo-encoding):
33
    http://en.wikipedia.org/wiki/ICO_(file_format)
34
    http://www.daubnet.com/en/file-format-cur
35
    https://developer.mozilla.org/en/Using_URL_values_for_the_cursor_property
36
    http://www.fileformat.info/format/bmp/egff.htm
37

  
38
Icon/Cursor file format:
39
    http://msdn.microsoft.com/en-us/library/ms997538
40
    http://msdn.microsoft.com/en-us/library/aa921550.aspx
41
    http://msdn.microsoft.com/en-us/library/aa930622.aspx
42

  
43

  
44
RDP Protocol specification:
45
    http://msdn.microsoft.com/en-us/library/cc240445(v=PROT.10).aspx
46

  
47

  
48
Related projects:
49
    
50
    guacamole: http://guacamole.sourceforge.net/
51

  
52
        - Web client, but Java servlet does pre-processing
53

  
54
    jsvnc: http://code.google.com/p/jsvnc/
55

  
56
        - No releases
57

  
58
    webvnc: http://code.google.com/p/webvnc/
59

  
60
        - Jetty web server gateway, no updates since April 2008.
61

  
62
    RealVNC Java applet: http://www.realvnc.com/support/javavncviewer.html
63

  
64
        - Java applet
65

  
66
    Flashlight-VNC: http://www.wizhelp.com/flashlight-vnc/
67

  
68
        - Adobe Flash implementation
69

  
70
    FVNC: http://osflash.org/fvnc
71

  
72
        - Adbove Flash implementation
73

  
74
    CanVNC: http://canvnc.sourceforge.net/
75

  
76
        - HTML client with REST to VNC python proxy. Mostly vapor.
src/sunstone/public/vendor/noVNC/docs/notes
1
Some implementation notes:
2

  
3
There is an included flash object (web-socket-js) that is used to
4
emulate websocket support on browsers without websocket support
5
(currently only Chrome has WebSocket support).
6

  
7
Javascript doesn't have a bytearray type, so what you get out of
8
a WebSocket object is just Javascript strings.  Javascript has UTF-16
9
unicode strings and anything sent through the WebSocket gets converted
10
to UTF-8 and vice-versa. So, one additional (and necessary) function
11
of wsproxy is base64 encoding/decoding what is sent to/from the
12
browser.
13

  
14
Building web-socket-js emulator:
15

  
16
cd include/web-socket-js/flash-src
17
mxmlc -static-link-runtime-shared-libraries WebSocketMain.as
src/sunstone/public/vendor/noVNC/docs/rfb_notes
1
5.1.1 ProtocolVersion: 12, 12 bytes
2

  
3
    - Sent by server, max supported
4
        12 ascii - "RFB 003.008\n"
5
    - Response by client, version to use
6
        12 ascii - "RFB 003.003\n"
7

  
8
5.1.2 Authentication: >=4, [16, 4] bytes
9

  
10
    - Sent by server
11
        CARD32 - authentication-scheme
12
                0 - connection failed
13
                    CARD32 - length
14
                    length - reason
15
                1 - no authentication
16

  
17
                2 - VNC authentication
18
                    16 CARD8 - challenge (random bytes)
19

  
20
    - Response by client (if VNC authentication)
21
        16 CARD8 - client encrypts the challenge with DES, using user
22
                   password as key, sends resulting 16 byte response
23

  
24
    - Response by server (if VNC authentication) 
25
        CARD32 - 0 - OK
26
                 1 - failed
27
                 2 - too-many
28

  
29
5.1.3 ClientInitialisation: 1 byte
30
    - Sent by client
31
        CARD8 - shared-flag, 0 exclusive, non-zero shared
32

  
33
5.1.4 ServerInitialisation: >=24 bytes
34
    - Sent by server
35
        CARD16 - framebuffer-width
36
        CARD16 - framebuffer-height
37
        16 byte PIXEL_FORMAT - server-pixel-format
38
            CARD8 - bits-per-pixel
39
            CARD8 - depth
40
            CARD8 - big-endian-flag, non-zero is big endian
41
            CARD8 - true-color-flag, non-zero then next 6 apply
42
            CARD16 - red-max
43
            CARD16 - green-max
44
            CARD16 - blue-max
45
            CARD8 - red-shift
46
            CARD8 - green-shift
47
            CARD8 - blue-shift
48
            3 bytes - padding
49
        CARD32 - name-length
50

  
51
        CARD8[length] - name-string
52

  
53

  
54

  
55
Client to Server Messages:
56

  
57
5.2.1 SetPixelFormat: 20 bytes
58
    CARD8: 0 - message-type
59
    ...
60

  
61
5.2.2 FixColourMapEntries: >=6 bytes
62
    CARD8: 1 - message-type
63
    ...
64

  
65
5.2.3 SetEncodings: >=8 bytes
66
    CARD8: 2 - message-type
67
    CARD8    - padding
68
    CARD16   - numer-of-encodings
69

  
70
    CARD32   - encoding-type in preference order
71
        0 - raw
72
        1 - copy-rectangle
73
        2 - RRE
74
        4 - CoRRE
75
        5 - hextile
76

  
77
5.2.4 FramebufferUpdateRequest (10 bytes)
78
    CARD8: 3 - message-type
79
    CARD8    - incremental (0 for full-update, non-zero for incremental)
80
    CARD16   - x-position
81
    CARD16   - y-position
82
    CARD16   - width
83
    CARD16   - height
84

  
85

  
86
5.2.5 KeyEvent: 8 bytes
87
    CARD8: 4 - message-type
88
    CARD8    - down-flag
89
    2 bytes  - padding
90
    CARD32   - key (X-Windows keysym values)
91

  
92
5.2.6 PointerEvent: 6 bytes
93
    CARD8: 5 - message-type
94
    CARD8    - button-mask
95
    CARD16   - x-position
96
    CARD16   - y-position
97

  
98
5.2.7 ClientCutText: >=9 bytes
99
    CARD8: 6 - message-type
100
    ...
101

  
102

  
103
Server to Client Messages:
104

  
105
5.3.1 FramebufferUpdate
106
    CARD8: 0 - message-type
107
    1 byte   - padding
108
    CARD16   - number-of-rectangles
109

  
110
    CARD16   - x-position
111
    CARD16   - y-position
112
    CARD16   - width
113
    CARD16   - height
114
    CARD16   - encoding-type:
115
        0 - raw
116
        1 - copy rectangle
117
        2 - RRE
118
        4 - CoRRE
119
        5 - hextile
120

  
121
        raw:
122
            - width x height pixel values
123

  
124
        copy rectangle: 
125
            CARD16 - src-x-position
126
            CARD16 - src-y-position
127

  
128
        RRE:
129
            CARD32  - N number-of-subrectangles
130
            Nxd bytes - background-pixel-value (d bits-per-pixel)
131

  
132
        ...
133

  
134
5.3.2 SetColourMapEntries (no support)
135
    CARD8: 1 - message-type
136
    ...
137

  
138
5.3.3 Bell
139
    CARD8: 2 - message-type
140

  
141
5.3.4 ServerCutText
142
    CARD8: 3 - message-type
143

  
144

  
145

  
146

  
147
    
... This diff was truncated because it exceeds the maximum size that can be displayed.

Also available in: Unified diff