build-once run-anywhere c library
Go to file
Justine Tunney 8a91518633 Fix issues revealed by ECMAScript test262
Cosmopolitan's QuickJS is now equally conformant and performant, with
the exception of Atomics, which have been disabled since Cosmopolitan
currently doesn't support pthreads.

QuickJS memory usage -- BigNum 2021-03-27 version, 64-bit, malloc limit: -1

NAME                    COUNT     SIZE
memory allocated          937   131764  (140.6 per block)
memory used               938   116103  (8 overhead, 16.7 average slack)
atoms                     513    21408  (41.7 per atom)
objects                   170    12279  (72.2 per object)
  properties              864    15531  (5.1 per object)
  shapes                   58    12995  (224.1 per shape)
bytecode functions         13     1512
  bytecode                 13      867  (66.7 per function)
C functions                99
arrays                      1
  fast arrays               1
  elements                  1       16  (1.0 per fast array)

Result: 35/74740 errors, 1279 excluded, 485 skipped, 19 new, 2 fixed

real    2m40.828s
user    2m29.764s
sys     0m10.939s
2021-04-10 17:15:35 -07:00
.github Create FUNDING.yml 2021-01-29 14:56:22 -08:00
.vscode Get VSCode working with Linux and WSL (#116) 2021-03-09 10:12:39 -08:00
ape Provide option to have APE not modify itself 2021-04-07 21:01:57 -07:00
build Fix issues revealed by ECMAScript test262 2021-04-10 17:15:35 -07:00
dsp Remove garbage collector macro from header (#114) 2021-03-07 20:23:29 -08:00
examples Fix issues revealed by ECMAScript test262 2021-04-10 17:15:35 -07:00
libc Fix issues revealed by ECMAScript test262 2021-04-10 17:15:35 -07:00
net Parse Content-Range with missing right hand side 2021-04-01 18:52:54 -07:00
test Fix issues revealed by ECMAScript test262 2021-04-10 17:15:35 -07:00
third_party Fix issues revealed by ECMAScript test262 2021-04-10 17:15:35 -07:00
tool Fix issues revealed by ECMAScript test262 2021-04-10 17:15:35 -07:00
usr/share Add Cosmopolitan Honeybadger to README.md 2021-02-04 03:31:03 -08:00
.clang-format Add x86_64-linux-gnu emulator 2020-08-25 04:43:42 -07:00
.gitignore Make terminal ui binaries work well everywhere 2020-10-19 06:38:31 -07:00
.travis.yml Disable Travis emails 2021-03-07 08:29:43 -08:00
LICENSE Add title to the LICENSE file 2021-02-27 13:25:59 -08:00
Makefile Get Fabrice Bellard's JavaScript engine to build 2021-04-09 01:06:57 -07:00
README.md Cosmopolitan 0.3 2021-03-29 03:20:03 -07:00

Cosmopolitan Honeybadger

Cosmopolitan

Cosmopolitan Libc makes C a build-once run-anywhere language, like Java, except it doesn't need an interpreter or virtual machine. Instead, it reconfigures stock GCC and Clang to output a POSIX-approved polyglot format that runs natively on Linux + Mac + Windows + FreeBSD + OpenBSD + NetBSD + BIOS with the best possible performance and the tiniest footprint imaginable.

Background

For an introduction to this project, please read the αcτµαlly pδrταblε εxεcµταblε blog post and cosmopolitan libc website. We also have API documentation.

Getting Started

If you're doing your development work on Linux or BSD then you need just five files to get started. Here's what you do on Linux:

wget https://justine.lol/cosmopolitan/cosmopolitan-amalgamation-0.3.zip
unzip cosmopolitan-amalgamation-0.3.zip
printf 'main() { printf("hello world\\n"); }\n' >hello.c
gcc -g -Os -static -nostdlib -nostdinc -fno-pie -no-pie -mno-red-zone \
  -fno-omit-frame-pointer -pg -mnop-mcount \
  -o hello.com.dbg hello.c -fuse-ld=bfd -Wl,-T,ape.lds \
  -include cosmopolitan.h crt.o ape.o cosmopolitan.a
objcopy -S -O binary hello.com.dbg hello.com

You now have a portable program. Please note that your APE binary will assimilate itself as a conventional resident of your platform after the first run, so it can be fast and efficient for subsequent executions.

./hello.com
bash -c './hello.com'  # zsh/fish workaround (we upstreamed a patch)

So if you intend to copy the binary to Windows or Mac then please do that before you run it, not after.

If you're developing on Windows or MacOS then you need to download an x86_64-pc-linux-gnu toolchain beforehand. See the Compiling on Windows tutorial. It's needed because the ELF object format is what makes universal binaries possible.

Cosmopolitan can also be compiled from source on any Linux distro.

wget https://justine.lol/cosmopolitan/cosmopolitan-0.3.tar.gz
tar xf cosmopolitan-0.3.tar.gz  # see releases page
cd cosmopolitan
make -j16
o//examples/hello.com
find o -name \*.com | xargs ls -rShal | less

Support Vector

Platform Min Version Circa
AMD K8 Venus 2005
Intel Core 2006
New Technology Vista 2006
GNU/Systemd 2.6.18 2007
XNU's Not UNIX! 15.6 2018
FreeBSD 12 2018
OpenBSD 6.4 2018
NetBSD 9.1 2020