sock v0.3.0 — Network link queries and IPv6 zone resolution

[hayabusa-cloud]

Introduction

• sock is a zero-allocation socket library for Go, providing TCP, UDP, Unix, SCTP, and raw socket types built directly on the zcall assembly syscall package. All sockets are created with SOCK_NONBLOCK and SOCK_CLOEXEC flags and return iofd.FD file descriptors for integration with io_uring async I/O. Address serialization is zero-allocation, encoding directly into kernel sockaddr structures without intermediate heap objects.
• The package implements an adaptive I/O model following the Three-Tier Progress Model (Strike-Spin-Adapt) with network-tuned backoff for deadline-based retry, and provides Linux-specific features including SO_ZEROCOPY, SCM_RIGHTS file descriptor passing, TCP_INFO diagnostics, multicast group management, and UDP batch operations via sendmmsg/recvmmsg.

Usage

conn, _ := sock.DialTCP4(nil, raddr)
n, err := conn.Read(buf)
if err == iox.ErrWouldBlock {
    // Non-blocking — kernel not ready
}

links, _ := sock.Links()
lo, _ := sock.LinkByName("lo")
byIndex, _ := sock.LinkByIndex(lo.Index)

Highlights

This release adds a Link type and Linux-native network link query functions (Links, LinkByName, LinkByIndex) backed by zcall, replacing net.Interface* calls in IPv6 zone ID resolution. Zone resolution now resolves interface names via zcall and falls back to numeric strings for unknown indices.

What's Changed

Features

• Add Link type and Links, LinkByName, LinkByIndex functions for Linux network link queries via zcall (feat: network link query API and integrate into IPv6 zone resolution #26)
• IPv6 zone resolution now uses link query helpers instead of net.Interface*; numeric fallback for unknown zone indices (feat: network link query API and integrate into IPv6 zone resolution #26)

Documentation

• Align adaptive I/O comments and package overview to Three-Tier Progress Model

Compatibility

• Go: 1.26+
• Platforms: linux/amd64, linux/arm64, linux/riscv64, linux/loong64, darwin/amd64, darwin/arm64, freebsd/amd64, freebsd/arm64

---

This discussion was created from the release sock v0.3.0 — Network link queries and IPv6 zone resolution.