https://github.com/robertkist/vbcc_installer
Automated installer for VBCC Amiga C Compilers on Unix/Mac
https://github.com/robertkist/vbcc_installer
amiga c cpp retrocomputing vbcc
Last synced: 3 months ago
JSON representation
Automated installer for VBCC Amiga C Compilers on Unix/Mac
- Host: GitHub
- URL: https://github.com/robertkist/vbcc_installer
- Owner: robertkist
- License: mit
- Created: 2023-05-23T02:01:29.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2023-05-23T14:42:16.000Z (about 2 years ago)
- Last Synced: 2025-01-16T02:21:27.125Z (5 months ago)
- Topics: amiga, c, cpp, retrocomputing, vbcc
- Language: Makefile
- Homepage:
- Size: 6.84 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# vbcc_installer
## About
An automated build script for [VBCC](http://sun.hasenbraten.de/vbcc/) m68k Amiga C Compilers for Unix based systems (MacOS, Linux, etc.).
## Usage
Steps to download VBCC, build it, and verify it by building a simple hello world program:
```commandline
> make download
> make setup
> make hello
```
The compiled VBCC compiler and Amiga SDK (aka NDK) will be in the folder `./sdk`.
The other folders and files can be deleted.
## Installation
The compiler and the Amiga SDK (aka NDK) can be found in the `sdk` folder. You can then copy it to its final destination, such as the `/usr/local` or the `/opt` directory.
Finally, add the VBCC executables to the path and set the VBCC environment variable.
You can do this in the config file of your shell, such as .zhrc (zsh) or .bashrc (bash)
Example, assuming installation in `/opt`:
```bash
export PATH=/opt/vbcc/sdk/vbcc/bin:$PATH
export VBCC=/opt/vbcc/sdk/vbcc
```
## Changing VBCC Versions
Edit the `Makefile` and change the constants on top of it to download newer
versions of VBCC and its targets.
## Compiling Code
Before you compile, make sure the `sdk/vbcc/bin` is in your PATH and that the VBCC environment variable is set.
Compiling (assuming installation in `/opt`):
```commandline
> vc -L/opt/sdk/NDK_3.9/Include/linker_libs -I/opt/sdk/NDK_3.9/Include/include_h +kick13 hello.c -lamiga -lauto -o hello
```
## Dependencies
You need the following tools:
* a compiler, such as gcc or clang
* the `make` tool
* the `wget` tool to download VBCC
* the `lha` tool to extract `.lha` archives
On macOS you can install `wget` and `lha` via [Homebrew](https://brew.sh/) and
install XCode's command line tools to get `make` and a C compiler.