Linux build instructions for Secure Mobile Computing VNC software v0.1
----------------------------------------------------------------------
James Scott

These instructions are for some software I wrote while I was working at Intel Research in Cambridge, UK.
For more information, see the paper at:
http://www.tokenstar.com/james/pubfiles/pervasive2006-securemobilecomputing.pdf

VNC viewer (and other utils e.g. vncpasswd)
-------------------------------------------

1. Get VNC 4.1.1 code (or a different version at your own risk)
2. Extract it "tar -zxvf vnc-4_1_1-unixsrc.tgz"
3. Rename it to anything of your choice; e.g. "vnc-smc", which we refer to below
4. Get the patch I wrote, found at: http://www.tokenstar.com/james/download/vnc-smc-linuxcommon-v0.1.diff
5. Apply this patch: "cd vnc-smc", then "patch -p1 < [path-to]/vnc-smc-linuxcommon-v0.1.diff"
6. As per the VNC README file, build vncviewer by running "cd unix", "./configure", "make"

VNC server
----------

To build the Xvnc server is a bit harder.  Instructions are found the
VNC README file, but can be summarised as follows:
0. Make sure you have built the VNC viewer as above on the same machine,
or a machine with the same C libraries
1. Get the X 4.3.0 distribution files (X430src-1.tgz, X430src-2.tgz,
X430src-3.tgz)
2. Make sure you are in the vnc-smc directory
3. "tar -zxvf [path-to] X430src-1.tgz" (and again for -2.tgz and -3.tgz)
4. run "patch -Np0 <xc.patch"
5. cd xc
6. make World (this takes *ages*)  WARNING: make sure to do this on a
machine which has the same library versions as
7. The Xvnc binary should now be found at xc/programs/Xserver/Xvnc

To start Xvnc, the easiest way is to use the "vncserver" script, but
make sure your path is such that the correct Xvnc (the new one) is
default.  To find out where the default is, run "which Xvnc".  To make
the default point at the version you've just compiled, symlink that
version into ~/bin/, e.g. "ln -s <path-to>vnc-smc/unix/xc//Xvnc ~/bin".
Otherwise, you might end up running vanilla VNC server not the patched one.

Usage instructions:
-------------------

1. Use "vnc-smc/unix/vncpasswd/vncpasswd" to set a password
2. Start a VNC server on a trusted machine (e.g. "vncserver
-AlwaysShared" if you have made the symlink above)
3. Start a VNC viewer on a trusted personal device (e.g. "vncviewer
[machinename]:[displaynumber]" or just "vncviewer") entering the
password that you just set
4. Start an obfuscated VNC viewer on an untrusted device (e.g.
"vncviewer [machinename]:[displaynumber]" entering a null password
5. On the trusted VNC viewer, you can use the menu (F8) to set an option
"Keep window centred".  Shrink the viewing window (if you are using a PC
as the trusted device) so only a small portion is visible
6. Move the mouse around on the untrusted device - note the trusted
device's viewport moves to keep the mouse centred
7. Notice you cannot click or type on the untrusted device