2021-02-04 03:30:47 -08:00
|
|
|
|

|
|
|
|
|
|
2020-06-15 07:18:57 -07:00
|
|
|
|
# Cosmopolitan
|
|
|
|
|
|
2021-01-28 16:19:10 -08:00
|
|
|
|
[Cosmopolitan Libc](https://justine.lol/cosmopolitan/index.html) makes C
|
|
|
|
|
a build-once run-anywhere language, like Java, except it doesn't need an
|
2021-02-08 09:19:00 -08:00
|
|
|
|
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.
|
2021-01-28 16:19:10 -08:00
|
|
|
|
|
|
|
|
|
## Background
|
|
|
|
|
|
|
|
|
|
For an introduction to this project, please read the [αcτµαlly pδrταblε
|
|
|
|
|
εxεcµταblε](https://justine.lol/ape.html) blog post and [cosmopolitan
|
|
|
|
|
libc](https://justine.lol/cosmopolitan/index.html) website. We also have
|
|
|
|
|
[API documentation](https://justine.lol/cosmopolitan/documentation.html).
|
|
|
|
|
|
|
|
|
|
## Getting Started
|
|
|
|
|
|
2021-02-08 09:19:00 -08:00
|
|
|
|
If you're doing your development work on Linux or BSD then you need just
|
|
|
|
|
five files to get started:
|
2021-01-28 16:19:10 -08:00
|
|
|
|
|
|
|
|
|
```sh
|
2021-02-09 20:36:07 -08:00
|
|
|
|
wget https://justine.lol/cosmopolitan/cosmopolitan-amalgamation-0.2.zip
|
2021-02-19 12:47:13 -05:00
|
|
|
|
unzip cosmopolitan-amalgamation-0.2.zip
|
2021-02-18 16:32:31 -08:00
|
|
|
|
printf 'main() { printf("hello world\\n"); }\n' >hello.c
|
2021-02-08 09:19:00 -08:00
|
|
|
|
gcc -g -O -static -nostdlib -nostdinc -fno-pie -no-pie -mno-red-zone \
|
|
|
|
|
-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
|
|
|
|
|
./hello.com
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
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](https://justine.lol/cosmopolitan/windows-compiling.html)
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
```sh
|
2021-02-09 20:36:07 -08:00
|
|
|
|
wget https://justine.lol/cosmopolitan/cosmopolitan-0.2.tar.gz
|
|
|
|
|
tar xf cosmopolitan-0.2.tar.gz # see releases page
|
|
|
|
|
cd cosmopolitan-0.2
|
2021-02-07 06:11:44 -08:00
|
|
|
|
make -j16
|
2021-01-28 16:19:10 -08:00
|
|
|
|
o//examples/hello.com
|
2021-02-07 06:11:44 -08:00
|
|
|
|
find o -name \*.com | xargs ls -rShal | less
|
2021-01-28 16:19:10 -08:00
|
|
|
|
```
|
2021-02-28 16:40:36 -08:00
|
|
|
|
|
|
|
|
|
## 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 |
|