OS/2 build instructions

The OS/2 port is not yet completed. These instructions are here for those who wish to help out.

Prerequisites on OS/2

• OS/2 running on Intel hardware... ;-)
• GCC 3.3.5 CSD1:
  ​ftp://ftp.netlabs.org/pub/gcc/gcc-3.3.5-csd1.zip
• SDL:
  ​ftp://ftp.netlabs.org/pub/sdl/sdl-1.2.10-bin-20060602.zip
  Unpack this into tools/os2.x86/libsdl/v1.2.10-20060602/. If you get compiler errors in the SDL headers, a small fix needs to be applied. TODO: link to patch.
• Later: Latest Qt3:
  ​ftp://ftp.netlabs.org/pub/qt3/
  Unpack this into tools/os2.x86/qt/v3.x.y/.
• ...

Building VirtualBox

1. Load the gcc environment (gccenv.cmd).
2. Make sure the environment variables USER or USERNAME is set to something sensible.
3. Change to the root directory of the sources and execute

   kBuild\envos2.cmd
   

4. To build type

   kmk
   

   The default is to a release build, should you wish to do a debug or profile build add BUILD_TYPE=debug or BUILD_TYPE=profile as argument to kmk or set it as an environment variable.

Running VirtualBox

Since this is work in progress there are just testcases and a not very useful VBoxBFE to run at this point. If you like to see the VBoxBFE SDL window and immediatly hit an assertion, do this:

1. Change directory to out\os2.x86\release\bin
2. Add this directory to the BEGINLIBPATH variable (full path, remember).
3. Set the env.var.: VBOX_SUPLIB_FAKE=fake
4. Execute .\VBoxBFE.exe -m 64. You should now get a brief glimpse of a SDL window and then a fatal assertion saying it doesn't know how to load VMMR0.r0.