cosmopolitan/libc
Justine Tunney 4778cd4d27
Fix bugs in termios library and cleanup code
This change fixes an issue with the tcflow() magic numbers that was
causing bash to freeze up on Linux. While auditing termios polyfills,
several other issues were identified with XNU/BSD compatibility.

Out of an abundance of caution this change undefines as much surface
area from libc/calls/struct/termios.h as possible, so that autoconf
scripts are less likely to detect non-POSIX teletypewriter APIs that
haven't been polyfilled by Cosmopolitan.

This is a *breaking change* for your static archives in /opt/cosmos if
you use the cosmocc toolchain. That's because this change disables the
ioctl() undiamonding trick for code outside the monorepo, specifically
because it'll lead to brittle ABI breakages like this. If you're using
the cosmocc toolchain, you'll need to rebuild libraries like ncurses,
readline, etc. Yes diamonds cause bloat. To work around that, consider
using tcgetwinsize() instead of ioctl(TIOCGWINSZ) since it'll help you
avoid pulling every single ioctl-related polyfill into the linkage.

The cosmocc script was specifying -DNDEBUG for some reason. It's fixed.
2023-06-14 19:30:52 -07:00
..
calls Fix bugs in termios library and cleanup code 2023-06-14 19:30:52 -07:00
crt [metal] Fix some issues that were breaking UEFI boot (#822) 2023-05-26 18:29:25 -07:00
dns Fix bugs in termios library and cleanup code 2023-06-14 19:30:52 -07:00
elf Rewrite .zip.o file linker 2023-06-10 09:29:44 -07:00
fmt Rewrite .zip.o file linker 2023-06-10 09:29:44 -07:00
integral Introduce #include <cosmo.h> to toolchain users 2023-06-09 18:03:05 -07:00
intrin Fix bugs in termios library and cleanup code 2023-06-14 19:30:52 -07:00
isystem Rewrite .zip.o file linker 2023-06-10 09:29:44 -07:00
linux Fix bugs in cosmocc toolchain 2023-06-08 23:44:03 -07:00
log Rewrite .zip.o file linker 2023-06-10 09:29:44 -07:00
mem Rewrite .zip.o file linker 2023-06-10 09:29:44 -07:00
nexgen32e Rewrite .zip.o file linker 2023-06-10 09:29:44 -07:00
nt Validate privileged code relationships 2023-06-08 04:38:06 -07:00
runtime Fix bugs in termios library and cleanup code 2023-06-14 19:30:52 -07:00
sock Rewrite .zip.o file linker 2023-06-10 09:29:44 -07:00
stdio Fix bugs in termios library and cleanup code 2023-06-14 19:30:52 -07:00
str Fix bugs in termios library and cleanup code 2023-06-14 19:30:52 -07:00
stubs Introduce native support for MacOS ARM64 2023-05-20 04:17:03 -07:00
sysv Fix bugs in termios library and cleanup code 2023-06-14 19:30:52 -07:00
testlib Rewrite .zip.o file linker 2023-06-10 09:29:44 -07:00
thread Introduce #include <cosmo.h> to toolchain users 2023-06-09 18:03:05 -07:00
time Rewrite .zip.o file linker 2023-06-10 09:29:44 -07:00
tinymath Get GCC to mostly build with Cosmo 2023-06-09 06:41:34 -07:00
vga [metal] Clean up code for getting pointer to struct mman (#828) 2023-06-11 10:32:39 -07:00
x Make improvements to cosmocc toolchain 2023-06-10 15:50:01 -07:00
zipos Rewrite .zip.o file linker 2023-06-10 09:29:44 -07:00
ar.h Add a turfwar hilbert decoration 2023-01-03 18:28:35 -08:00
assert.h Make improvements to cosmocc toolchain 2023-06-10 15:50:01 -07:00
atomic.h Optimize memory layout 2022-09-12 04:26:52 -07:00
complex.h Port a lot more code to AARCH64 2023-05-14 09:37:26 -07:00
dce.h Validate privileged code relationships 2023-06-08 04:38:06 -07:00
disclaimer.inc
dos.internal.h Introduce #include <cosmo.h> to toolchain users 2023-06-09 18:03:05 -07:00
empty.s Do some basic build tuning 2023-05-10 04:20:46 -07:00
errno.h Fix bugs in cosmocc toolchain 2023-06-08 23:44:03 -07:00
imag.internal.h Remove evil constants from cosmopolitan.h 2022-12-17 00:42:45 -08:00
inttypes.h Fix inttypes.h FAST16 macros to have a correct definition (#791) 2023-03-29 00:19:40 -07:00
iso646.internal.h Add more missing C / C++ headers 2022-09-04 04:53:52 -07:00
libc.mk Add VGA support on bare metal (#588) 2022-09-06 18:41:08 -07:00
limits.h Improve cosmo's conformance to libc-test 2022-10-10 17:52:41 -07:00
literal.h Improve cosmo's conformance to libc-test 2022-10-10 17:52:41 -07:00
mach.internal.h Introduce #include <cosmo.h> to toolchain users 2023-06-09 18:03:05 -07:00
macho.internal.h Fiddle around with Mach-O 2023-05-20 04:13:49 -07:00
macros.internal.h Fix bugs in cosmocc toolchain 2023-06-08 23:44:03 -07:00
math.h Make more ML improvements 2023-05-16 08:07:23 -07:00
notice.inc
notice.internal.h
paths.h Embed cocmd.com interpreter for system() / open() 2022-10-02 15:29:57 -07:00
README.md Reformat libc README.md (#437) 2022-06-21 07:50:42 -07:00
stdalign.internal.h Add more missing C / C++ headers 2022-09-04 04:53:52 -07:00
stdckdint.h Rewrite .zip.o file linker 2023-06-10 09:29:44 -07:00
type2str.h Improve synchronization 2022-04-15 15:31:55 -07:00
zip.internal.h Fix bugs in termios library and cleanup code 2023-06-14 19:30:52 -07:00

Cosmopolitan Standard Library

This directory defines static archives defining functions, like printf(), mmap(), win32, etc. Please note that the Cosmopolitan build configuration doesn't link any C/C++ library dependencies by default, so you still have the flexibility to choose the one provided by your system. If you'd prefer Cosmopolitan, just add $(LIBC) and $(CRT) to your linker arguments.

Your library is compromised of many bite-sized static archives. We use the checkdeps tool to guarantee that the contents of the archives are organized in a logical way that's easy to use with or without our makefile infrastructure, since there's no cyclic dependencies.

The Cosmopolitan Library exports only the most stable canonical system calls for all supported operating systems, regardless of which platform is used for compilation. We polyfill many of the APIs, e.g. read(), write() so they work consistently everywhere while other apis, e.g. CreateWindowEx(), might only work on one platform, in which case they become no-op functions on others.

Cosmopolitan polyfill wrappers will usually use the dollar sign naming convention, so they may be bypassed when necessary. This same convention is used when multiple implementations of string library and other performance-critical function are provided to allow Cosmopolitan to go fast on both old and newer computers.

We take an approach to configuration that relies heavily on the compiler's dead code elimination pass (libc/dce.h). Most of the code is written so that, for example, folks not wanting support for OpenBSD can flip a bit in SUPPORT_VECTOR and that code will be omitted from the build. The same is true for builds that are tuned using -march=native which effectively asks the library to not include runtime support hooks for x86 processors older than what you use.

Please note that, unlike Cygwin or MinGW, Cosmopolitan does not achieve broad support by bolting on a POSIX emulation layer. We do nothing more than (in most cases) stateless API translations that get you 90% of the way there in a fast lightweight manner. We therefore can't address some of the subtle differences, such as the nuances of absolute paths on Windows. Our approach could be compared to something more along the lines of, "the Russians just used a pencil to write in space", versus spending millions researching a pen like NASA.