mcandre / tonixxx

cross-compiler shipyard

tonixxx: cross-compiler shipyard

EXAMPLE

$ cd examples/fewer

$ tonixxx boil
2018/12/30 23:22:56 Artifacts merged to ~/.tonixxx/fewer/bin

$ tree ~/.tonixxx/fewer/bin
~/.tonixxx/fewer/bin
├── freebsd-amd64
│   └── fewer
├── linux-glibc-2.24-amd64
│   └── fewer
├── linux-glibc-2.28-arm64
│   └── fewer
├── macos-amd64
│   └── fewer
├── windows-amd64
│   └── fewer.exe

API DOCUMENTATION

https://godoc.org/github.com/mcandre/tonixxx

DOWNLOAD

https://github.com/mcandre/tonixxx/releases

INSTALL FROM SOURCE

$ go install github.com/mcandre/tonixxx/cmd/tonixxx@latest

ABOUT

tonixxx assists developers in cross-compiling software projects. No need for dedicated hardware, nor dual booting, nor configuring obscure toolchains. Instead, tonixxx pours your code through arrays of Vagrant boxes, yielding robust, reliable binaries targeting assorted operating system kernel environments.

tonixxx chips away at integration surprises, testing the very limits of portability! For example, the C application fewer is written to closely match the C89/C99 standards, as opposed to newer standards, in order to support Windows and MirBSD builds. Without tonixxx, developers must rely on dedicated contributors to report any issues, compared to spotting issues early in the development process.

C89/C99 are just one way among many to structure your applications. If you really want to emphasize C11 and higher, then you can elect to drop Windows and MirBSD support. Remember, these are simply examples. tonixxx itself is agnostic of programming language and platforms, giving you the power to decide which software stacks and environments you want to end up using. It's great for automating software ports from your laptop or CI server!

See the examples directory for more demonstrative templates for building application ports.

• C: fewer
• C++: palindrome
• D: potato
• Haskell: mo
• Rust: bronze

How to cross-compile your project with tonixxx

1. List your build steps in a tonixxx.yaml file.
2. Label your build bots.
3. Run tonixxx boil.

See examples/ for more details on configuring tonixxx.yaml recipes and provisioning build bots for a variety of programming languages.

See tonixxx -help for more information on tonixxx invocation syntax.

Finally, sudo may be requisite for producing buildbot boxes for alternate architecture VM's, a known issue with vagrant-libvirt, but critically, sudo should be avoided when importing or running buildbots.

LICENSE

FreeBSD

RUNTIME REQUIREMENTS

• Vagrant
• vagrant-rsync-back
• Relevant hypervisors for your configured Vagrant boxes (e.g. VirtualBox, VMware, qemu, Hyper-V)
• Your choice of Vagrant boxes for targeted compilation, with synced folders enabled using rsync.
• Sufficient available RAM and disk space for your Vagrant boxes

Recommended

• VirtualBox + extension pack
• VMware
• qemu 2.12+
• KVM
• OpenBIOS
• openhackware
• qemu-skiboot
• libguestfs-tools
• vagrant-libvirt
• Taurine (macOS), Caffeine (Windows), Caffeine (Linux) can prevent hibernation during any long builds
• tree

CONTRIBUTING

For more information on developing tonixxx itself, see DEVELOPMENT.md.

SEE ALSO

• Cross-platform toolchains can be configured, though the process is fairly masochistic. May involve chroots.
• Docker is a fantastic resource for projects targeting the Linux kernel (from different host operating systems!)
• factorio generates Go application ports based on the standard Go toolchain
• Go provides superb out-of-the-box cross-compilation features. As a matter of fact, tonixxx was inspired as a workaround in order to support cross-compilation for non-Go projects, including Rust, C, and C++.
• libuv provides a cross-platform abstraction layer for C/C++ applications.
• LLVM bitcode offers an abstract assembler format for C/C++ code.
• mucus provides base VM's for managing alternate architectures
• snek is a leaner, Docker-based cross-platform system
• trust integrates CI systems with Rust ports.
• tug automates multi-platform Docker image builds.
• WASM provides a portable interface for C/C++ code.
• xgo automates cross-compiling Go applications, including cgo apps with native dependencies.

DISCLAIMER

tonixxx is not magic, but simply a Go wrapper for Vagrant. It won't do the hard work of rewriting your application to support more platforms, but it will lower some barriers to cross-platform development.

• Doesn't rely on soft links
• Doesn't rely on sh/bat scripts
• Doesn't erase your code when vagrant rsync-backing
• Doesn't force you to use any particular build tools or build workflows
• Does accelerate development and testing
• Does support UNIX and Windows hosts, as well as UNIX and Windows targets
• Does support configuration commenting
• Works best with reasonably modern guests featuring preemptive multitasking
• WSL hosts may present difficulties

Good luck and keep coding!