gkbmdz/vbcc repository overview

⁠VBCC Compiler and Assembler

Multi platform, multi target compiler, assembler and linker.

⁠SYNOPSIS

Dockerfile to build a Linux based image that can create containers for the purpose of providing build tools to cross compile on an 'x86' based host that target multiple platforms.

⁠Build Tools

The following table shows the base build tools:

⁠VASM Assemblers

⁠VBCC Compilers

⁠Other Build Tools

⁠Docker Image Details

The Docker image uses 2 stages. The first stage is based on an alpine linux image and is used to download and extract the vbcc and vasm binaries.

The second stage is based on an alpine linux image with glibc. The 'make' program is installed and some environment variables are set. The binaries are copied from the first stage to the second stage and /home/dev/project is set as the working directory. Finally 'make' is set as the command to run when the container is started.

⁠Usage

The container can be used to build the project from the local computer in a couple of ways. The container can be run interactively and build commands can be entered in the cli. The preferred method is to run the container as part of a build process from the local computer project directory.

The following is an example of a project directory structure:

project
├── inc
├── obj
├── out
├── src
└── Makefile

From the local computer shell, inside the project folder a 'docker run' command can be issued to automatically build the project. The command can be entered manually or automatically from an IDE as part of a build task or process.

Depending on the host OS and shell being used, the command to run the container will differ slightly. The commands that follow will map a local project folder into the container at /home/dev/project and automatically run 'make' using the Makefile within the project folder.

⁠Windows Host

⁠Linux Host