cosmopolitan/libc/sysv
Justine Tunney 85f64f3851
Make futexes 100x better on x86 MacOS
Thanks to @autumnjolitz (in #876) the Cosmopolitan codebase is now
acquainted with Apple's outstanding ulock system calls which offer
something much closer to futexes than Grand Central Dispatch which
wasn't quite as good, since its wait function can't be interrupted
by signals (therefore necessitating a busy loop) and it also needs
semaphore objects to be created and freed. Even though ulock is an
internal Apple API, strictly speaking, the benefits of futexes are
so great that it's worth the risk for now especially since we have
the GCD implementation still as a quick escape hatch if it changes

Here's why this change is important for x86 XNU users. Cosmo has a
suboptimal polyfill when the operating system doesn't offer an API
that let's us implement futexes properly. Sadly we had to use that
on X86 XNU until now. The polyfill works using clock_nanosleep, to
poll the futex in a busy loop with exponential backoff. On XNU x86
clock_nanosleep suffers from us not being able to use a fast clock
gettime implementation, which had a compounding effect that's made
the polyfill function even more poorly. On X86 XNU we also need to
polyfill sched_yield() using select(), which made things even more
troublesome. Now that we have futexes we don't have any busy loops
anymore for both condition variables and thread joining so optimal
performance is attained. To demonstrate, consider these benchmarks

Before:

    $ ./lockscale_test.com -b
    consumed 38.8377   seconds real time and
              0.087131 seconds cpu time

After:

    $ ./lockscale_test.com -b
    consumed 0.007955 seconds real time and
             0.011515 seconds cpu time

Fixes #876
2023-10-03 15:15:43 -07:00
..
calls Make futexes 100x better on x86 MacOS 2023-10-03 15:15:43 -07:00
consts Make improvements 2023-10-03 06:17:16 -07:00
dos2errno Fix some more issues 2023-09-21 11:41:42 -07:00
errfuns Get --ftrace working on aarch64 2023-06-05 23:35:31 -07:00
consts.sh Make improvements 2023-10-03 06:17:16 -07:00
describeos.greg.c Remove malloc() dependency on pledge() / unveil() 2022-07-24 21:51:37 -07:00
dos2errno.sh Fix some more issues 2023-09-21 11:41:42 -07:00
errfun.S Introduce native support for MacOS ARM64 2023-05-20 04:17:03 -07:00
errfun2.c Fix bugs in cosmocc toolchain 2023-06-08 23:44:03 -07:00
errfuns.h Get aarch64 hello world working 2023-05-10 04:20:47 -07:00
errfuns.sh Change license 2020-12-27 17:18:44 -08:00
errno.c Incorporate more small improvements 2023-07-23 10:57:18 -07:00
gen.sh Make improvements 2023-09-18 21:04:47 -07:00
hostos.S Introduce native support for MacOS ARM64 2023-05-20 04:17:03 -07:00
macros.internal.h Implement thread cancellation for aarch64 2023-09-07 08:48:38 -07:00
README.md Initial import 2020-06-15 07:18:57 -07:00
restorert.S Get LIBC_RUNTIME and LIBC_CALLS building on aarch64 2023-05-10 04:20:47 -07:00
strace.greg.c Make more threading improvements 2022-11-01 23:28:26 -07:00
syscall2.S Make futexes 100x better on x86 MacOS 2023-10-03 15:15:43 -07:00
syscall3.S Make futexes 100x better on x86 MacOS 2023-10-03 15:15:43 -07:00
syscall4.S Make futexes 100x better on x86 MacOS 2023-10-03 15:15:43 -07:00
syscalls.sh Make futexes 100x better on x86 MacOS 2023-10-03 15:15:43 -07:00
syscon.S Improve aarch64 native support some more 2023-06-04 08:58:47 -07:00
syscount.S Make considerably more progress on AARCH64 2023-05-12 22:42:57 -07:00
syslib.S Introduce native support for MacOS ARM64 2023-05-20 04:17:03 -07:00
sysret.c Get LIBC_RUNTIME and LIBC_CALLS building on aarch64 2023-05-10 04:20:47 -07:00
systemfive.S Make improvements 2023-09-18 21:04:47 -07:00
sysv.c Make improvements 2023-09-18 21:04:47 -07:00
sysv.mk Make futexes 100x better on x86 MacOS 2023-10-03 15:15:43 -07:00

SYNOPSIS

System Five Import Libraries

OVERVIEW

Bell System Five is the umbrella term we use to describe Linux, FreeBSD, OpenBSD, and Mac OS X which all have nearly-identical application binary interfaces that stood the test of time, having definitions nearly the same as those of AT&T back in the 1980's.

Cosmopolitan aims to help you build apps that can endure over the course of decades, just like these systems have: without needing to lift a finger for maintenance churn, broken builds, broken hearts.

The challenge to System V binary compatibility basically boils down to numbers. All these systems agree on what services are provided, but tend to grant them wildly different numbers.

We address this by putting all the numbers in a couple big shell scripts, ask the GNU Assembler to encode them into binaries using an efficient LEB128 encoding, unpacked by _init(), and ref'd via extern const. It gives us good debuggability, and any costs are gained back by fewer branches in wrapper functions.z