Skip to content

Latest commit

 

History

History
58 lines (42 loc) · 2.15 KB

Porting.md

File metadata and controls

58 lines (42 loc) · 2.15 KB
Raw

Porting to a new platform

Porting to a new 32 or 64 bit platform is usually automatically handled by make full:

  • The makefile compiles src/tools/make/configure.c with the platform's default C compiler.
  • configure.c determines which types to use for 32 and 64 bit variables, and their alignment.
  • configure.c uses a number of strategies to determine the operating system it is running on and what the appropriate installation directory will be.
  • configure.c sets makefile variables that are used to select which of 5 sets of pre-prepared C source files to build to create the bootstrap compiler.

On most systems this will be sufficient for make full to build and install the compiler and libraries.

make full will terminate with a message such as:

--- Branch v2docs freebsd gcc LP64 confidence tests passed ---

Updating configure.c

Most likely you will only need to change configure.c if it cannot determine the correct install directory.

In this case add code to src/tools/make/configure.c's function determineOS() to set the os variable to the name of the new OS platform.

The following variables are also set by determineOS() to the followind defaults:

variable set to example
platform Base platform "unix"
binext Binary file extension ""
staticlink Static linking option "-static"

If your new platform does not support static linking, set the staticlink variable to "".

Then modify determineInstallDirectory() to select the correct instalation root based on the changes you have made to determineOS().

The platform variable selects which variety of the Platform module is compiled. Vishap provides two varieties, one specific to the Windows API (Platformwindows.Mod), and one suitable for Unix-like systems including Linux, BSD, Android and cygwin (Platformunix.Mod).

If you are porting to a system that does not provide a Unix style API, it will be necessary to implement a new variant of Platform.Mod providing the same interface as Platformunix.Mod and Platform Windows.Mod.