cosmopolitan/libc/sysv
Justine Tunney 2ec413b5a9
Fix bugs in poll(), select(), ppoll(), and pselect()
poll() and select() now delegate to ppoll() and pselect() for assurances
that both polyfill implementations are correct and well-tested. Poll now
polyfills XNU and BSD quirks re: the hanndling of POLLNVAL and the other
similar status flags. This change resolves a misunderstanding concerning
how select(exceptfds) is intended to map to POLPRI. We now use E2BIG for
bouncing requests that exceed the 64 handle limit on Windows. With pipes
and consoles on Windows our poll impl will now report POLLHUP correctly.

Issues with Windows path generation have been fixed. For example, it was
problematic on Windows to say: posix_spawn_file_actions_addchdir_np("/")
due to the need to un-UNC paths in some additional places. Calling fstat
on UNC style volume path handles will now work. posix_spawn now supports
simulating the opening of /dev/null and other special paths on Windows.

Cosmopolitan no longer defines epoll(). I think wepoll is a nice project
for using epoll() on Windows socket handles. However we need generalized
file descriptor support to make epoll() for Windows work well enough for
inclusion in a C library. It's also not worth having epoll() if we can't
get it to work on XNU and BSD OSes which provide different abstractions.
Even epoll() on Linux isn't that great of an abstraction since it's full
of footguns. Last time I tried to get it to be useful I had little luck.
Considering how long it took to get poll() and select() to be consistent
across platforms, we really have no business claiming to have epoll too.
While it'd be nice to have fully implemented, the only software that use
epoll() are event i/o libraries used by things like nodejs. Event i/o is
not the best paradigm for handling i/o; threads make so much more sense.
2024-09-02 00:29:52 -07:00
..
calls Create variables for page size 2024-07-18 21:16:53 -07:00
consts Fix bugs in poll(), select(), ppoll(), and pselect() 2024-09-02 00:29:52 -07:00
dos2errno Fix some more issues 2023-09-21 11:41:42 -07:00
errfuns Remove .internal from more header filenames 2024-08-04 12:52:25 -07:00
BUILD.mk Introduce cosmocc flags -mdbg -mtiny -moptlinux 2024-07-26 05:10:25 -07:00
consts.sh Add some documentation 2024-07-19 04:46:26 -07:00
describeos.greg.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
dos2errno.sh more modeline errata (#1019) 2023-12-16 23:07:10 -05:00
errfun.S Remove .internal from more header filenames 2024-08-04 12:52:25 -07:00
errfun2.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
errfuns.h Add dontthrow attribute to most libc functions 2024-01-09 01:26:03 -08:00
errfuns.sh flip et / noet in modelines 2023-12-07 22:17:11 -05:00
errno.c Release Cosmopolitan v3.3 2024-02-20 13:27:59 -08:00
gen.sh Remove .internal from more header filenames 2024-08-04 12:52:25 -07:00
hostos.S Remove .internal from more header filenames 2024-08-04 12:52:25 -07:00
macros.internal.h Remove .internal from more header filenames 2024-08-04 12:52:25 -07:00
README.md Initial import 2020-06-15 07:18:57 -07:00
restorert.S Remove .internal from more header filenames 2024-08-04 12:52:25 -07:00
strace.greg.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
syscall2.S Remove .internal from more header filenames 2024-08-04 12:52:25 -07:00
syscall3.S Remove .internal from more header filenames 2024-08-04 12:52:25 -07:00
syscall4.S Remove .internal from more header filenames 2024-08-04 12:52:25 -07:00
syscalls.sh Create variables for page size 2024-07-18 21:16:53 -07:00
syscon.S Remove .internal from more header filenames 2024-08-04 12:52:25 -07:00
syscount.S Remove .internal from more header filenames 2024-08-04 12:52:25 -07:00
syslib.S Remove .internal from more header filenames 2024-08-04 12:52:25 -07:00
sysret.c flip et / noet in modelines 2023-12-07 22:17:11 -05:00
systemfive.S Remove .internal from more header filenames 2024-08-04 12:52:25 -07:00
sysv.c Introduce cosmocc flags -mdbg -mtiny -moptlinux 2024-07-26 05:10:25 -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