User:Gso321/Zig

Warning, this page is a work in progress by Gso321 (talk | contribs). Treat its contents with caution.

Resources

Home

Official documentation

Package information

Binary package information

Wikipedia

GitHub

Bugs (upstream)

Blog

Blog

LICENSE

Zig is under MIT license.

Zig is a general-purpose programming language and toolchain for maintaining robust, optimal and reusable software. Zig aims to replace C as the better language while being able to compile both C and C++.

dev-lang/zig and dev-lang/zig-bin are Zig's packages. dev-lang/zig is complied from source while dev-lang/zig-bin is a binary (no compiling). The rest of this article assumes the user is using dev-lang/zig (dev-lang/zig-bin may be replaced with dev-lang/zig-bin if the user uses it instead).

Installation

Kernel

Zig supports at least Linux kernel 3.16+.

USE flags

USE flags for dev-lang/zig A robust, optimal, and maintainable programming language

Data provided by the Gentoo Package Database · Last update: 2023-01-20 03:54 More information about USE flags

USE flags for dev-lang/zig-bin A robust, optimal, and maintainable programming language

Data provided by the Gentoo Package Database · Last update: 2023-01-20 03:54 More information about USE flags

Emerge

Warning
Zig is currently unstable. To learn why unstable is bad experience, see this.

Important
When compiling, Zig may use around 9.6 GiB RAM prior to 0.11.0.

Change dev-lang/zig ACCEPT_KEYWORDS:

root #echo "dev-lang/zig ~amd64" >> /etc/portage/package.accept_keywords

Then compile the package:

root #emerge --ask -q dev-lang/zig

Configuration

Warning
Compiling most packages with Zig results in build errors or runtime errors!!!

Setting custom-cflags useflag is NOT supported by upstream.

Note
zig cc and zig c++ uses clang for now.

The system may be configured to compile selected packages other than gcc, clang, or other C/C++ compilers using zig. Some packages, like sys-devel/gcc requires setting custom-cflags:

FILE /etc/portage/profile/package.use.force

sys-devel/gcc custom-cflags

Basic example

FILE /etc/portage/env/complier-zig

CC="zig cc"
CXX="zig c++"
AR="zig ar"
# zig nm doesn't exist
RANLIB="zig ranlib"

COMMON_FLAGS="-O2 -march=native -pipe"
CFLAGS="${COMMON_FLAGS}"
CXXFLAGS="${COMMON_FLAGS}"

Then modify the file to the system's needs:

FILE /etc/portage/package.envUsing the Zig compiler for app-foo/bar and app-bar/baz

app-foo/bar compiler-zig
app-bar/baz compiler-zig

Usage

zig cc and zig c++ are Zig's C and C++ compiler respectively.