ziglang/libc-abi-tools
9
7
Fork 1
Code Issues 4 Pull requests Activity Actions
A repository that collects libc ABI files for multiple versions and provides tools to combine them into one data set.
133 commits 1 branch 0 tags 17 MiB
  • Zig 100%
Find a file
Alex Rønne Petersen 8df1a69415
All checks were successful
ci / build (push) Successful in 26s
Details
glibc: consolidate: remove powerpc64 
ziglang/zig#31491
2026-03-13 06:32:03 +01:00
.forgejo/workflows build: install the output of running list.zig 2026-01-31 10:41:34 +01:00
freebsd build: add steps for invoking the tools 2026-01-31 10:41:54 +01:00
glibc glibc: consolidate: remove powerpc64 2026-03-13 06:32:03 +01:00
musl build: add steps for invoking the tools 2026-01-31 10:41:54 +01:00
netbsd netbsd: remove evbsh3sf 2026-03-08 02:17:15 +01:00
openbsd build: add steps for invoking the tools 2026-01-31 10:41:54 +01:00
serenity build: add steps for invoking the tools 2026-01-31 10:41:54 +01:00
.gitignore update .gitignore 2026-01-26 20:28:48 +01:00
build.zig build: add steps for invoking the tools 2026-01-31 10:41:54 +01:00
build.zig.zon add build script 2026-01-26 20:42:44 +01:00
LICENSE LICENSE: No year range. 2025-05-08 15:32:03 +02:00
list.zig list.zig: Update to new Reader interface. 2025-09-06 13:39:57 +08:00
README.md README: update list.zig invocation 2026-01-31 10:51:15 +01:00

README.md

libc ABI tools

This repository contains a collection of tools to be used by Zig maintainers to generate abilists files for various libc implementations; Zig users have no direct use for this repository.

An abilists file can be used by the Zig compiler to generate an accurate stub shared library when dynamically linking libc in cross-compilation scenarios. The generated abilists files are shipped with the Zig compiler, so an effort is made to keep them compact.

Currently supported libcs:

abilists binary format

All integers are stored little-endian.

  • u8 number of libc libraries. For each:
    • null-terminated name, e.g. "c\x00", "m\x00", "dl\x00", "pthread\x00"
  • u8 number of libc versions, sorted ascending. For each:
    • u8 major
    • u8 minor
    • u8 patch
  • u8 number of targets. For each:
    • null-terminated target string, e.g. "arm-linux-gnueabi\x00"
  • u16 number of function inclusions
    • null-terminated symbol name (not repeated for subsequent same symbol inclusions)
    • Set of Function Inclusions
  • u16 number of object inclusions
    • null-terminated symbol name (not repeated for subsequent same symbol inclusions)
    • Set of Object Inclusions
  • u16 number of TLS inclusions
    • null-terminated symbol name (not repeated for subsequent same symbol inclusions)
    • Set of TLS Inclusions

Set of Function Inclusions:

  • uleb128 (u64) set of targets this inclusion applies to (1 << INDEX_IN_TARGET_LIST)
  • u8 index of libc library this inclusion applies to
    • unversioned is indicated if 1 << 5 bit is set in library index
    • weak linkage is indicated if 1 << 6 bit is set in library index
    • last inclusion is indicated if 1 << 7 bit is set in library index
  • [N]u8 set of libc versions this inclusion applies to
    • last version index is indicated if 1 << 7 bit is set in version index

Set of Object Inclusions:

  • uleb128 (u64) set of targets this inclusion applies to (1 << INDEX_IN_TARGET_LIST)
  • uleb128 (u16) object size
  • u8 index of libc library this inclusion applies to
    • unversioned is indicated if 1 << 5 bit is set in library index
    • weak linkage is indicated if 1 << 6 bit is set in library index
    • last inclusion is indicated if 1 << 7 bit is set in library index
  • [N]u8 set of libc versions this inclusion applies to
    • last version index is indicated if 1 << 7 bit is set in version index

Set of TLS Inclusions:

  • uleb128 (u64) set of targets this inclusion applies to (1 << INDEX_IN_TARGET_LIST)
  • uleb128 (u16) object size
  • u8 index of libc library this inclusion applies to
    • unversioned is indicated if 1 << 5 bit is set in library index
    • weak linkage is indicated if 1 << 6 bit is set in library index
    • last inclusion is indicated if 1 << 7 bit is set in library index
  • [N]u8 set of libc versions this inclusion applies to
    • last version index is indicated if 1 << 7 bit is set in version index

Debugging an abilists file

zig build list -- abilists