cosmopolitan/libc/sysv
Justine Tunney 14e192e5ba Introduce --strace flag for system call tracing
This is similar to the --ftrace (c function call trace) flag, except
it's less noisy since it only logs system calls to stderr. Having this
flag is valuable because (1) system call tracing tells us a lot about
the behavior of complex programs and (2) it's usually very hard to get
system call tracing on various operating systems, e.g. strace, ktrace,
dtruss, truss, nttrace, etc. Especially on Apple platforms where even
with the special boot trick, debuggers still aren't guaranteed to work.

    make -j8 o//examples
    o//examples/hello.com --strace

This is enabled by default in MODE=, MODE=opt, and MODE=dbg. In MODE=dbg
extra information will be printed.

    make -j8 MODE=dbg o/dbg/examples
    o/dbg/examples/hello.com --strace |& less

This change also changes:

- Rename IsText() → _istext()
- Rename IsUtf8() → _isutf8()
- Fix madvise() on Windows NT
- Fix empty string case of inet_ntop()
- vfork() wrapper now saves and restores errno
- Update xsigaction() to yoink syscall support
2022-03-18 18:07:28 -07:00
..
calls Make improvements 2022-03-16 13:40:10 -07:00
consts Make improvements 2022-03-16 13:40:10 -07:00
errfuns Remove more nonstandard stuff from cosmopolitan.h 2021-03-01 00:18:23 -08:00
machcalls Productionize new APE loader and more 2021-10-02 08:27:03 -07:00
consts.sh Make improvements 2022-03-16 13:40:10 -07:00
describeos.greg.c Introduce --strace flag for system call tracing 2022-03-18 18:07:28 -07:00
errfuns.h Add MODE=optlinux build mode (#141) 2021-10-14 19:36:49 -07:00
errfuns.sh Change license 2020-12-27 17:18:44 -08:00
g_syscount.S Clean old .source directive out of asm code 2022-03-18 12:43:21 -07:00
gen.sh Remove more nonstandard stuff from cosmopolitan.h 2021-03-01 00:18:23 -08:00
machcalls.sh Productionize new APE loader and more 2021-10-02 08:27:03 -07:00
macros.internal.h Make improvements 2020-12-01 03:43:40 -08: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 Introduce --strace flag for system call tracing 2022-03-18 18:07:28 -07:00
syscall.S Add MODE=optlinux build mode (#141) 2021-10-14 19:36:49 -07:00
syscalls.sh Make improvements 2022-03-16 13:40:10 -07:00
systemfive.S Introduce --strace flag for system call tracing 2022-03-18 18:07:28 -07:00
sysv.mk Introduce --strace flag for system call tracing 2022-03-18 18:07:28 -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