cosmopolitan/libc/sysv
Justine Tunney 98254a7c1f Make pledge() and unveil() work amazingly
This change reconciles our pledge() implementation with the OpenBSD
kernel source code. We now a polyfill that's much closer to OpenBSD's
behavior. For example, it was discovered that "stdio" permits threads.
There were a bunch of Linux system calls that needed to be added, like
sched_yield(). The exec / execnative category division is now dropped.
We're instead using OpenBSD's "prot_exec" promise for launching APE
binaries and dynamic shared objects. We also now filter clone() flags.

The pledge.com command has been greatly improved. It now does unveiling
by default when Landlock is available. It's now smart enough to unveil a
superset of paths that OpenBSD automatically unveils with pledge(), such
as /etc/localtime. pledge.com also now checks if the executable being
launched is a dynamic shared object, in which case it unveils libraries.

These changes now make it possible to pledge curl on ubuntu 20.04 glibc:

    pledge.com -p 'stdio rpath prot_exec inet dns tty sendfd recvfd' \
        curl -s https://justine.lol/hello.txt

Here's what pledging curl on Alpine 3.16 with Musl Libc looks like:

    pledge.com -p 'stdio rpath prot_exec dns inet' \
        curl -s https://justine.lol/hello.txt

Here's what pledging curl.com w/ ape loader looks like:

    pledge.com -p 'stdio rpath prot_exec dns inet' \
        o//examples/curl.com https://justine.lol/hello.txt

The most secure sandbox, is curl.com converted to static ELF:

    o//tool/build/assimilate.com o//examples/curl.com
    pledge.com -p 'stdio rpath dns inet' \
        o//examples/curl.com https://justine.lol/hello.txt

A weird corner case needed to be handled when resolving symbolic links
during the unveiling process, that's arguably a Landlock bug. It's not
surprising since Musl and Glibc are also inconsistent here too.
2022-07-19 21:33:49 -07:00
..
calls Make pledge() and unveil() work amazingly 2022-07-19 21:33:49 -07:00
consts Make pledge() and unveil() work amazingly 2022-07-19 21:33:49 -07:00
errfuns Make improvements 2022-05-28 00:28:09 -07:00
consts.sh Make pledge() and unveil() work amazingly 2022-07-19 21:33:49 -07:00
describeos.greg.c Introduce --strace flag for system call tracing 2022-03-18 18:07:28 -07:00
errfun.S Make improvements 2022-05-28 00:28:09 -07:00
errfuns.h Make improvements 2022-05-24 10:58:48 -07:00
errfuns.sh Change license 2020-12-27 17:18:44 -08:00
errno.c Fix stdio regression 2022-05-19 00:51:15 -07:00
errno_location.greg.c Simplify TLS and reduce startup latency 2022-07-18 04:10:54 -07:00
gen.sh Make improvements 2022-05-28 00:28:09 -07:00
macros.internal.h Support thread local storage 2022-05-16 13:20:08 -07:00
README.md Initial import 2020-06-15 07:18:57 -07:00
restorert.S Clean old .source directive out of asm code 2022-03-18 12:43:21 -07:00
strace.greg.c Make some systemic improvements 2022-05-18 16:52:36 -07:00
syscall.S Add MODE=optlinux build mode (#141) 2021-10-14 19:36:49 -07:00
syscalls.sh Make pledge() and unveil() work amazingly 2022-07-19 21:33:49 -07:00
syscount.S Make some systemic improvements 2022-05-18 16:52:36 -07:00
systemfive.S Show crash reports on SIGSYS 2022-06-23 13:01:01 -07:00
sysv.mk Simplify TLS and reduce startup latency 2022-07-18 04:10:54 -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