This is a maintenance fork
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Justine Tunney 1bc3a25505 Improve documentation 11 months ago
..
alg Improve documentation 11 months ago
bits Improve documentation 11 months ago
calls Improve documentation 11 months ago
crt Get Cosmopolitan into releasable state 1 year ago
crypto Add chibicc 12 months ago
dns Improve documentation 11 months ago
elf Improve documentation 11 months ago
fmt Improve documentation 11 months ago
integral Auto-generate some documentation 11 months ago
intrin Make minor improvements 11 months ago
isystem Fold conv package into fmt 12 months ago
linux Improve documentation 11 months ago
log Improve documentation 11 months ago
math Improve documentation 11 months ago
mem Improve documentation 11 months ago
nexgen32e Improve documentation 11 months ago
nt Improve documentation 11 months ago
ohmyplus Get Cosmopolitan into releasable state 1 year ago
rand Improve documentation 11 months ago
runtime Improve documentation 11 months ago
sock Improve documentation 11 months ago
stdio Improve documentation 11 months ago
str Improve documentation 11 months ago
stubs Make improvements 1 year ago
sysv Improve documentation 11 months ago
testlib Improve documentation 11 months ago
time Improve documentation 11 months ago
tinymath Improve documentation 11 months ago
unicode Improve documentation 11 months ago
x Improve documentation 11 months ago
zipos Improve documentation 11 months ago
README.md Add x86_64-linux-gnu emulator 1 year ago
assert.h Add chibicc 12 months ago
complex.h Make improvements 1 year ago
dce.h Auto-generate some documentation 11 months ago
disclaimer.inc Initial import 1 year ago
errno.h Add minor improvements and cleanup 1 year ago
inttypes.h Initial import 1 year ago
libc.mk Fold conv package into fmt 12 months ago
limits.h Add x86_64-linux-gnu emulator 1 year ago
literal.h Initial import 1 year ago
mach.h Initial import 1 year ago
macho.internal.h Get Cosmopolitan into releasable state 1 year ago
macros-cpp.internal.inc Make minor improvements 11 months ago
macros.h Make minor improvements 11 months ago
macros.internal.inc Make minor improvements 11 months ago
math.h Auto-generate some documentation 11 months ago
notice.inc Add scouts honor escape hatch for source embedding 1 year ago
notice.internal.h Add epoll and do more release readiness changes 1 year ago
paths.h Initial import 1 year ago
zip.h Add fixes performance and static web server 1 year ago

README.md

SYNOPSIS

Cosmopolitan Standard Library.

OVERVIEW

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.