cosmo-compat 10.0.0

Libc shims where Cosmopolitan and Rust's std disagree — link it into a cosmo target and the fixes apply themselves
Documentation

cosmo-compat

Libc shims for the places where Cosmopolitan Libc and Rust's std disagree. Link it into a cosmo target and the fixes apply themselves — each is a #[no_mangle] definition the linker prefers over the one in libcosmo.a, because an archive member is only pulled in to satisfy a symbol that is still undefined.

The shim is necessary, but an explicit Cargo dependency is optional since version 10: cargo-cosmo and cosmo-build inject it automatically. Cosmopolitan declares char *__xpg_strerror_r(int, char *, size_t) — the GNU contract — while Rust's std links that same symbol expecting the POSIX XSI one, which returns int. std reinterprets the returned pointer as an int, finds the sign bit set, and panics with strerror_r failure. The practical effect is that formatting any io::Error aborts the program, so ordinary error paths break long before anything exotic does.

The crate also carries the stage-2 normalization shim: cosmopolitan resolves OS constants at load time while rustc bakes in Linux's values at compile time, so 126 libc entry points are --wrapped and translated at the boundary.

Use

For projects retaining an explicit dependency, pair with the same major of cosmo-build, which sets cfg(cosmo) and adds the --wrap flags:

[target.'cfg(cosmo)'.dependencies]
cosmo-compat = "10"
#[cfg(cosmo)]
extern crate cosmo_compat as _;

The cosmo-compat and cosmo-build versions must match: the wrap list the linker is given lives in cosmo-build, and a symbol wrapped without a translator is a link error.

See the repository for how the constant tables are extracted and what is verified on which OS.

MIT licensed. Embeds constant tables extracted from Cosmopolitan Libc (ISC) — see NOTICE in the repository.