author | kergoth <kergoth> | 2002-01-25 22:14:26 (UTC) |
---|---|---|
committer | kergoth <kergoth> | 2002-01-25 22:14:26 (UTC) |
commit | 15318cad33835e4e2dc620d033e43cd930676cdd (patch) (unidiff) | |
tree | c2fa0399a2c47fda8e2cd0092c73a809d17f68eb /noncore/comm/keypebble/README.html | |
download | opie-15318cad33835e4e2dc620d033e43cd930676cdd.zip opie-15318cad33835e4e2dc620d033e43cd930676cdd.tar.gz opie-15318cad33835e4e2dc620d033e43cd930676cdd.tar.bz2 |
Initial revision
Diffstat (limited to 'noncore/comm/keypebble/README.html') (more/less context) (ignore whitespace changes)
-rw-r--r-- | noncore/comm/keypebble/README.html | 206 |
1 files changed, 206 insertions, 0 deletions
diff --git a/noncore/comm/keypebble/README.html b/noncore/comm/keypebble/README.html new file mode 100644 index 0000000..def766b --- a/dev/null +++ b/noncore/comm/keypebble/README.html | |||
@@ -0,0 +1,206 @@ | |||
1 | <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN"> | ||
2 | <html> | ||
3 | <head> | ||
4 | <title>Keystone README</title> | ||
5 | </head> | ||
6 | |||
7 | <body> | ||
8 | <h1>Keystone README</h1> | ||
9 | <div align="justify"> <!-- #BeginEditable "Body" --> | ||
10 | <h3>Contents</h3> | ||
11 | <ul> | ||
12 | <li><a href="#whatisvnc">What is Keystone?</a></li> | ||
13 | <li><a href="#servers">Servers</a></li> | ||
14 | <li><a href="#status">Status</a></li> | ||
15 | <li><a href="#bugs">Bugs</a></li> | ||
16 | <li><a href="#download">Download</a></li> | ||
17 | <li><a href="#faq">FAQs</a></li> | ||
18 | <li><a href="#todo">Todo</a></li> | ||
19 | <li><a href="#credits">Credits</a></li> | ||
20 | <li><a href="#references">References</a></li> | ||
21 | </ul> | ||
22 | <h3><a name="whatiskvnc">What is Keystone?</a></h3> | ||
23 | <p>Keystone is a tool for <a href="http://www.kde.org/">KDE</a> that | ||
24 | allows you to remotely access the desktops of machines using the cross-platform | ||
25 | VNC system. Keystone can access machines running a variety of operating | ||
26 | systems (including most UNIX systems and Windows 95/98/NT/2000) providing | ||
27 | they are running a VNC server. Note that Keystone is only a client | ||
28 | program, you will need to download a server separately in order to | ||
29 | use it.</p> | ||
30 | <p>The protocol used by Keystone (called RFB) was developed, and released | ||
31 | as GPL by ORL (now the UK branch of AT&T research), they also | ||
32 | wrote and maintain GPL servers for several platforms. You can find | ||
33 | both information about the protocol and links to servers for a range | ||
34 | of platforms on their <a href="http://www.uk.research.att.com/vnc/">website</a>.</p> | ||
35 | <p>Keystone started life as a port of Markus Wuebben's kvncviewer program | ||
36 | to KDE 2, but in the course porting the code, I have rewritten and | ||
37 | redesigned most of the system. The new implementation builds on several | ||
38 | new facilities that were not available in KDE 1, such as KPixmapIO | ||
39 | and QSocket. There is so little of the original code left that I have | ||
40 | decided on a name change, and to put the version number back to 0.1.</p> | ||
41 | <p>You can see a few screenshots of <a href="http://www.ipso-facto.demon.co.uk/keystone/screenshots.html">Keystone | ||
42 | in action</a> on my screenshots page. The screenshots may or may not | ||
43 | reflect the look of the current version as I have some look and feel | ||
44 | improvements planned.</p> | ||
45 | <h3><a name="servers">Servers</a></h3> | ||
46 | <p>Most Linux distributions include the standard Xvnc server (usually | ||
47 | run via the <i>vncserver</i> script), you can also download this and | ||
48 | servers for other platforms such as MS Windows from the <a href="http://www.uk.research.att.com/vnc/">VNC | ||
49 | website</a>. If you have a problem with setting up a server then you | ||
50 | should read the <a href="http://www.uk.research.att.com/vnc/faq.html">VNC | ||
51 | FAQ</a>, and if that does not help join the VNC mailing list. Do not | ||
52 | mail me on this topic - I can't help and won't even reply.</p> | ||
53 | <p>I may in future write a server that operates in the same manner as | ||
54 | the Win32 server for KDE. The Win32 server differs from the X11 server | ||
55 | in that it does not virtualise the entire desktop. This has both advantages | ||
56 | and disadvatages, it means that you can make an existing session available | ||
57 | over the network, but only allows you to run a single server. I may | ||
58 | also put a GUI together that makes it easy to configure the ORL server.</p> | ||
59 | <h3><a name="status">Status</a></h3> | ||
60 | <p><font color="#000000">The current version is 0.4, and the following | ||
61 | are now working:</font></p> | ||
62 | <p> | ||
63 | <ul> | ||
64 | <li><b>0.1</b> | ||
65 | <ul> | ||
66 | <li>Non-blocking socket handling</li> | ||
67 | <li>Authentication and logon</li> | ||
68 | <li>KDE 2 user interface</li> | ||
69 | <li>Raw and CopyRect encodings</li> | ||
70 | <li>Full screen mode</li> | ||
71 | <li>Grab keyboard mode</li> | ||
72 | <li>Graphics</li> | ||
73 | <li>Taking screenshots of the remote desktop</li> | ||
74 | <li>Event dispatching</li> | ||
75 | <li>Konqueror helper application support (you can run Keystone | ||
76 | by entering a vnc: URL anywhere in KDE).</li> | ||
77 | <li>Options, login, password and about dialogs</li> | ||
78 | </ul> | ||
79 | </li> | ||
80 | <li><b>0.2</b> | ||
81 | <ul> | ||
82 | <li>XSHM support using KPixmapIO</li> | ||
83 | <li>Now uses KXMLGUI (thanks to Kurt)</li> | ||
84 | <li>Tru64 patch from Tom Leitner</li> | ||
85 | <li>Status reporting improvements</li> | ||
86 | <li>Config handling fixed</li> | ||
87 | <li>Recent connections list implemented</li> | ||
88 | <li>Update frequency respected</li> | ||
89 | </ul> | ||
90 | </li> | ||
91 | <li><b>0.3 [KDE 2.0]</b> | ||
92 | <ul> | ||
93 | <li>Portability fixes for FreeBSD (and maybe others)</li> | ||
94 | </ul> | ||
95 | </li> | ||
96 | <li><b>0.4</b> | ||
97 | <ul> | ||
98 | <li>Icons for the full screen mode now reflect the current state</li> | ||
99 | <li>Added a toolbar (optional of course)</li> | ||
100 | <li>Added support for the clipboard (you can cut and paste between the | ||
101 | local and remote machines)</li> | ||
102 | <li>Added some what's this help to the options dialog</li> | ||
103 | </ul> | ||
104 | </li> | ||
105 | </ul> | ||
106 | <h3><a name="bugs">Bugs</a></h3> | ||
107 | <p>Version 0.4 contains the following known bugs: | ||
108 | <ul> | ||
109 | <li><b>Custom about dialog is not shown</b><br> | ||
110 | I can't see a clean way to fix this without creating a complete custom | ||
111 | help menu. For now I've left the standard about dialog in place. | ||
112 | </li> | ||
113 | <li><b>Crash when you connect to a non-existant server</b><br> | ||
114 | I can reproduce this every time, but I can't figure out what's wrong | ||
115 | other developers have reported similar problems and they seem to be | ||
116 | down to QSocket. The only known fix so far is to use KSocket instead. | ||
117 | I'd prefer to fix the problem at the source, but I'm having no luck and | ||
118 | I suspect QSocket may also be causing some other weird network issues | ||
119 | I've seen, so if I can't track down the bug soon I'll give in and switch | ||
120 | to KSocket like everyone else. | ||
121 | </li> | ||
122 | </ul> | ||
123 | </p> | ||
124 | <h3><a name="download"></a>Download</h3> | ||
125 | <p>Keystone is available in the kdenetwork module of the | ||
126 | <a href="http://www.kde.org/anoncvs.html">KDE CVS</a>, and | ||
127 | is included in the KDE 2.0 release. The current version is 0.4. | ||
128 | Note that Keystone <b>requires KDE 2</b>, you cannot use KDE 1.x.</p> | ||
129 | <h3><a name="faq"></a>FAQs</h3> | ||
130 | <p> | ||
131 | <ul> | ||
132 | <li><b>Why don't the shortcut keys work in full screen mode?</b><br> | ||
133 | When you're in full screen mode Keystone grabs the keyboard to send | ||
134 | every key press to the remote screen. This means that you can send key | ||
135 | combinations that are used by Keystone or KDE to the remote screen. If | ||
136 | you really hate it, then you can add -nograb to the command line | ||
137 | arguments to disable all keyboard grabs. I will add an option to allow | ||
138 | this behaviour to be overridden in a future release. | ||
139 | </li> | ||
140 | <li><b>Why is Keystone so slow?</b><br> | ||
141 | Currently only the simplest of the RFB encodings are supported, this | ||
142 | means that Keystone is only useful on fairly fast networks. This is | ||
143 | a serious bug and is being addressed. | ||
144 | </ul> | ||
145 | </p> | ||
146 | <h3><a name="todo">Todo</a></h3> | ||
147 | These are the things I'm hoping to add to future versions of Keystone. | ||
148 | They're vaguely sorted in order of importance. | ||
149 | <p> | ||
150 | <ul> | ||
151 | <li>RRE encoding.<br> | ||
152 | I've started this, but the implementation has some | ||
153 | bugs so it did not make the cut for Keystone 0.3.</li> | ||
154 | <li>CoRRE and Hextile encodings</li> | ||
155 | <li>Session management</li> | ||
156 | <li>Support for Windows Terminal Server.<br> | ||
157 | There is now a GPL implementation | ||
158 | of the protocol, and the author is happy for me to use the code. If someone | ||
159 | can offer me an account to test it on then this is possible.</li> | ||
160 | <li>Zoom support.<br> | ||
161 | This will be handled using the same protocol extension | ||
162 | as is used in the Palm client, this will allow you to make use of | ||
163 | server side scaling to reduce the amount of network traffic. You | ||
164 | will also be able to do client side zooms, but in this case the | ||
165 | full screen needs to transmitted over the network.</li> | ||
166 | <li>Macros</li> | ||
167 | <li>Monitor mode (thumbnails of several machines)</li> | ||
168 | <li>ZLib extension support</li> | ||
169 | <li>Bookmarks</li> | ||
170 | <li>URL specific settings</li> | ||
171 | <li>Possibly a DnD extension using a mechanism based on mulitpart | ||
172 | MIME attachments.</li> | ||
173 | </ul> | ||
174 | <h3>Credits<a name="credits"></a></h3> | ||
175 | <p>Keystone owes a lot to Markus Wuebben's kvncviewer which some of | ||
176 | the code is derived from. Thanks are also due to Espen Sand the author | ||
177 | of khexedit from which I borrowed some code for the about dialog. | ||
178 | Alison Burch drew the bridge image used in the background of this | ||
179 | page (and in future versions of Keystone too of course). Finally thanks | ||
180 | go to ORL for making the RFB protocol and servers GPL.</p> | ||
181 | <h3><a name="references">References</a><br> | ||
182 | </h3> | ||
183 | <p> | ||
184 | <ul> | ||
185 | <li>The Keystone homepage<br> | ||
186 | <a href="http://www.ipso-facto.demon.co.uk/keystone/">http://www.ipso-facto.demon.co.uk/keystone/</a></li> | ||
187 | <li>The VNC Homepage<br> | ||
188 | <a href="http://www.uk.research.att.com/vnc/">http://www.uk.research.att.com/vnc/</a></li> | ||
189 | <li>The VNC FAQ<br> | ||
190 | <a href="http://www.uk.research.att.com/vnc/faq.html">http://www.uk.research.att.com/vnc/faq.html</a></li> | ||
191 | <li>The KDE Homepage<br> | ||
192 | <a href="http://www.kde.org/">http://www.kde.org/</a> </li> | ||
193 | </ul> | ||
194 | <p></p> | ||
195 | <!-- #EndEditable --> </div> | ||
196 | |||
197 | |||
198 | |||
199 | <hr> | ||
200 | <address><a href="mailto:rich@kde.org">Richard Moore</a></address> | ||
201 | <!-- Created: Tue Dec 5 01:35:56 GMT 2000 --> | ||
202 | <!-- hhmts start --> | ||
203 | Last modified: Tue Dec 5 01:37:17 GMT 2000 | ||
204 | <!-- hhmts end --> | ||
205 | </body> | ||
206 | </html> | ||