cosmopolitan/libc
Justine Tunney 0c630d95b5
Rewrite Cosmopolitan Ar
The build/bootstrap/ar.com program is now tinier. This change reduces
its size from 140kb to 53kb. Nothing was traded away. Cosmopolitan Ar
performance is now 2x better than llvm-ar largely thanks to using the
copy_file_range() system call. This change homebrews a new allocation
API that addresses the shortcomings of the C standard library design.
Using these new balloc() and reballoc() functions I managed to reduce
memory consumption so much that Cosmpolitan Ar should now use roughly
100x fewer bytes of peak resident memory compared to llvm-ar. Correct
behavior with better compatibility has been assured. Binary output is
now pretty much bit-identical to llvm-ar, as of this change. This can
and should be the living proof we need to show that a better world is
possible for software.
2023-07-02 10:19:16 -07:00
..
calls Rewrite Cosmopolitan Ar 2023-07-02 10:19:16 -07:00
crt Fully support OpenBSD 7.3 2023-07-01 18:14:27 -07:00
dns Clean up more code 2023-06-18 01:00:05 -07:00
elf Rewrite Cosmopolitan Ar 2023-07-02 10:19:16 -07:00
fmt Implement more toolchain fixes 2023-06-18 05:39:31 -07:00
integral Implement more toolchain fixes 2023-06-18 05:39:31 -07:00
intrin Fix recvfrom on Windows (closes #841) (#844) 2023-06-30 23:39:55 -07:00
isystem Implement more toolchain fixes 2023-06-18 05:39:31 -07:00
linux Fix bugs in cosmocc toolchain 2023-06-08 23:44:03 -07:00
log Implement swapcontext() and makecontext() 2023-07-02 09:01:44 -07:00
mem Implement swapcontext() and makecontext() 2023-07-02 09:01:44 -07:00
nexgen32e Clean up more code 2023-06-18 01:00:05 -07:00
nt Clean up more code 2023-06-18 01:00:05 -07:00
runtime Implement swapcontext() and makecontext() 2023-07-02 09:01:44 -07:00
sock Get us closer to building busybox 2023-06-18 04:13:45 -07:00
stdio Rewrite Cosmopolitan Ar 2023-07-02 10:19:16 -07:00
str Clean up more code 2023-06-18 01:00:05 -07:00
sysv Update Windows IP_MULTICAST constants to use Ws2tcpip.h values (#839) (#842) 2023-07-01 19:44:27 -07:00
testlib Fully support OpenBSD 7.3 2023-07-01 18:14:27 -07:00
thread Implement swapcontext() and makecontext() 2023-07-02 09:01:44 -07:00
time Clean up more code 2023-06-18 01:00:05 -07:00
tinymath Clean up more code 2023-06-18 01:00:05 -07:00
vga Clean up more code 2023-06-18 01:00:05 -07:00
x Implement more toolchain fixes 2023-06-18 05:39:31 -07:00
zipos Clean up more code 2023-06-18 01:00:05 -07:00
ar.h Rewrite Cosmopolitan Ar 2023-07-02 10:19:16 -07: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 Upgrade cosmopolitan gcc and binutils to 2.35.2 2023-06-18 00:54:14 -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 Implement more toolchain fixes 2023-06-18 05:39:31 -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 Get us closer to building busybox 2023-06-18 04:13:45 -07:00
type2str.h Improve new C23 checked arithmetic feature 2023-06-16 15:32:18 -07:00
zip.internal.h Remove old zip base skew hack 2023-06-17 04:20:16 -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.