[PATCH] VirtualBox headless VNC support by LibVNCServer (20100421)

[Daisuke Aoyama]

Hi all,

First, thank you for porting great software and thank you for using my
patch.

This archive contains an individual patch files and a modified Makefile for
virtualbox-ose 3.1.6_3. Please select an options you want before building.
And make it by normal way.

I tested the binary on FreeNAS 0.7.1 stable (FreeBSD 7.2-RELEASE-p7
amd64/i386 kernel) and FreeNAS 0.7.2 devel (FreeBSD 7.3-RELEASE amd64/i386
kernel).

What's new?
-----------
Fix some bugs.
Add modifier hook such as AltGr.
Add the ability to parse non-US keymaps.
(the code is referred to Hubert Tournier's patch)

How to use
----------
# cd /usr/ports/emulators/virtualbox-ose
# tar xvf /path/to/vboxvnc-20100421.tar.gz
# tar xvf /path/to/vboxint18-20100310.tar.gz      (optional)
# make config
# make

It provides an internal VNC server for guest OS console access in
VBoxHeadless frontend.
Supported Options:
   -v, -vnc, --vnc on|off                Enable (default) or disable the VNC
Server
   -a, -vncaddress, --vncaddress <ip>    IP address the VNC server will bind
to
   -p, -vncport, --vncport <port>        Port number the VNC server will
bind to
   -k, -vnckeymap, --vnckeymap <keymap>  Keyboard mapfile (default: builtin
US)
   -S, -vncsecret, --vncsecret <secret>  VNC Authentication secret

three options at one line is an equivalent option, for example:
"-v on", "-vnc on", "--vnc on" are same feature.

-v option specify whether VNC server starts in the machine.
default is on (enable).

-a and -p options specify IP address and port number of VNC server.
default IP is wildcard, port is 5900. If you have multiple IPs(NICs)
in your system, you can select the listen address of the server.

-k option specify the keyboard layout convert from VNC keys to Scancodes.
default is US standard 101keys. (I tested only US 101 keyboard)
If you want another keyboard, you can spcify the path of kbdmap(5).
In the standard installation of FreeBSD, it's located in
/usr/share/syscons/keymaps/.
for example, "-k /usr/share/syscons/keymaps/jp.106.kbd" uses JP 106
keyboard.

-S option specify the password of the VNC server.
However, it have security risk in common server. It assumed used with
FreeNAS (limited user environment). Please consider the risk by using
command line.

When starting the VM, the proctitle is changed like below (you can see
by "ps axww"):
VBoxHeadless: VM: TestVM4 Port: 5900 Auth: off (VBoxHeadless)


vboxint18-20100310.tar.gz (optional patch):
[PATCH] VirtualBox INT18 patch for gPXE iSCSI boot/install
http://lists.freebsd.org/pipermail/freebsd-emulation/2010-March/007540.html

-- 
Regards,
Daisuke Aoyama
-------------- next part --------------
A non-text attachment was scrubbed...
Name: vboxvnc-20100421.tar.gz
Type: application/octet-stream
Size: 13499 bytes
Desc: not available
Url : http://lists.freebsd.org/pipermail/freebsd-emulation/attachments/20100422/09f6ff9a/vboxvnc-20100421.tar.obj