1
Fork 0
hermetic_cc_toolchain/README.md

92 lines
3.5 KiB
Markdown
Raw Normal View History

2021-06-08 15:58:04 +03:00
[![builds.sr.ht status](https://builds.sr.ht/~motiejus/bazel-zig-cc.svg)](https://builds.sr.ht/~motiejus/bazel-zig-cc)
2021-06-08 15:56:58 +03:00
# Bazel zig cc toolchain for Go
2021-04-10 01:05:01 +03:00
2021-08-06 14:30:25 +03:00
This is an early stage zig-cc toolchain that can cross-compile cgo programs to these os/archs:
2021-04-10 01:05:01 +03:00
2021-08-05 12:24:26 +03:00
- amd64-linux-gnu.2.19
- amd64-linux-musl
2021-08-06 14:30:25 +03:00
- arm64-linux-gnu.2.28
2021-08-05 12:24:26 +03:00
- arm64-linux-musl
- amd64-macos
- arm64-macos
2021-06-19 16:47:48 +03:00
2021-08-06 14:30:25 +03:00
# Usage
2021-08-06 14:33:30 +03:00
Add this to your `WORKSPACE`:
```
BAZEL_ZIG_CC_VERSION = "0.2"
http_archive(
name = "bazel-zig-cc",
sha256 = "0af0493e2d4822a94803e8a83703d25e0f9d8fe6ec4daf3b0ed3ca4cd6076650",
strip_prefix = "bazel-zig-cc-{}".format(BAZEL_ZIG_CC_VERSION),
urls = ["https://git.sr.ht/~motiejus/bazel-zig-cc/archive/{}.tar.gz".format(BAZEL_ZIG_CC_VERSION)],
)
load("@bazel-zig-cc//toolchain:defs.bzl", zig_register_toolchains = "register_toolchains")
zig_register_toolchains()
```
This will register the "default" toolchains. Look into `register_toolchains` on
which parameters it accepts.
2021-06-08 06:56:37 +03:00
# Testing
2021-04-10 01:05:01 +03:00
2021-06-08 07:01:34 +03:00
## linux cgo + glibc 2.19
2021-04-10 01:05:01 +03:00
2021-06-08 06:56:37 +03:00
```
2021-08-06 14:30:25 +03:00
$ bazel build --platforms @io_bazel_rules_go//go/toolchain:linux_amd64_cgo //test:hello
$ file bazel-out/k8-fastbuild-ST-d17813c235ce/bin/test/hello_/hello
bazel-out/k8-fastbuild-ST-d17813c235ce/bin/test/hello_/hello: ELF 64-bit LSB executable, x86-64, version 1 (SYSV), dynamically linked, interpreter /lib64/ld-linux-x86-64.so.2, for GNU/Linux 2.0.0, Go BuildID=redacted, with debug_info, not stripped
2021-06-08 06:56:37 +03:00
```
2021-06-08 07:01:34 +03:00
## linux cgo + musl
2021-04-10 01:05:01 +03:00
```
$ bazel build \
--platforms @io_bazel_rules_go//go/toolchain:linux_amd64_cgo \
--extra_toolchains @zig_sdk//:x86_64-linux-musl_toolchain //test:hello
...
$ file ../bazel-out/k8-fastbuild-ST-d17813c235ce/bin/test/hello_/hello
../bazel-out/k8-fastbuild-ST-d17813c235ce/bin/test/hello_/hello: ELF 64-bit LSB executable, x86-64, version 1 (SYSV), statically linked, Go BuildID=redacted, with debug_info, not stripped
$ ../bazel-out/k8-fastbuild-ST-d17813c235ce/bin/test/hello_/hello
hello, world
2021-04-10 01:05:01 +03:00
```
2021-04-10 02:58:05 +03:00
2021-06-17 12:37:43 +03:00
## macos cgo
2021-06-08 07:01:34 +03:00
```
2021-08-06 14:30:25 +03:00
$ bazel build --platforms @io_bazel_rules_go//go/toolchain:darwin_amd64_cgo //test:gognu
2021-06-08 07:01:34 +03:00
...
2021-06-17 12:37:43 +03:00
$ file bazel-bin/test/gognu_/gognu
bazel-bin/test/gognu_/gognu: Mach-O 64-bit x86_64 executable, flags:<NOUNDEFS|DYLDLINK|TWOLEVEL|PIE>
2021-06-08 07:01:34 +03:00
```
2021-06-07 23:22:51 +03:00
## Transient docker environment
2021-04-10 02:58:05 +03:00
```
2021-06-07 23:22:51 +03:00
$ docker run -ti --rm -v $(pwd):/x -w /x debian:buster-slim
2021-06-10 07:27:01 +03:00
# apt update && apt install curl -y && curl -L https://github.com/bazelbuild/bazelisk/releases/download/v1.9.0/bazelisk-linux-amd64 > /usr/local/bin/bazel && chmod +x /usr/local/bin/bazel
2021-04-10 02:58:05 +03:00
# export CC=/usr/bin/false
```
2021-06-08 06:56:37 +03:00
And run the `bazel build` commands above. Take a look at `.build.yml` and see
how CI does it.
2021-06-08 08:00:53 +03:00
2021-06-17 12:37:43 +03:00
# Known Issues
2021-06-08 08:00:53 +03:00
2021-08-06 14:30:25 +03:00
- [ziglang/zig #9485 glibc 2.27 or older: fcntl64 not found, but zig's glibc headers refer it] (https://github.com/ziglang/zig/issues/9485)
2021-07-21 19:37:55 +03:00
- [ziglang/zig #9431 FileNotFound when compiling macos](https://github.com/ziglang/zig/issues/9431)
2021-06-19 12:17:58 +03:00
- [rules/go #2894 Per-arch_target linker flags](https://github.com/bazelbuild/rules_go/issues/2894)
2021-06-08 15:56:58 +03:00
2021-06-17 12:37:43 +03:00
Closed issues:
2021-06-08 15:56:58 +03:00
2021-07-02 12:32:50 +03:00
- [ziglang/zig #9139 zig c++ hanging when compiling in parallel](https://github.com/ziglang/zig/issues/9139) (CLOSED)
2021-07-21 19:37:55 +03:00
- [golang/go #46644 cmd/link: with CC=zig: SIGSERV when cross-compiling to darwin/amd64](https://github.com/golang/go/issues/46644) (CLOSED)
2021-06-17 12:41:14 +03:00
- [ziglang/zig #9050 golang linker segfault](https://github.com/ziglang/zig/issues/9050) (CLOSED)
- [ziglang/zig #7917 [meta] better c/c++ toolchain compatibility](https://github.com/ziglang/zig/issues/7917) (CLOSED)
- [ziglang/zig #7915 ar-compatible command for zig cc](https://github.com/ziglang/zig/issues/7915) (CLOSED)