mirrors/cosmopolitan
1
0
Fork 0
mirror of https://github.com/jart/cosmopolitan.git synced 2025-02-07 06:53:33 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
mirror of https://github.com/jart/cosmopolitan
107 commits 9 branches 118 tags 319 MiB
C 80.2%
Assembly 6.9%
Lua 5.4%
C++ 2.7%
Shell 2.1%
Other 2.5%
Find a file
Justine Tunney 1ff9ab95ac Make C memory safe like Rust 
This change enables Address Sanitizer systemically w/ `make MODE=dbg`.
Our version of Rust's `unsafe` keyword is named `noasan` which is used
for two functions that do aligned memory chunking, like `strcpy.c` and
we need to fix the tiny DEFLATE code, but that's it everything else is
fabulous you can have all the fischer price security blankets you need

Best of all is we're now able to use the ASAN data in Blinkenlights to
colorize the memory dumps. See the screenshot below of a test program:

  https://justine.lol/blinkenlights/asan.png

Which is operating on float arrays stored on the stack, with red areas
indicating poisoned memory, and the green areas indicate valid memory.
2021-02-01 03:58:46 -08:00
.github Create FUNDING.yml 2021-01-29 14:56:22 -08:00
ape Make C memory safe like Rust 2021-02-01 03:58:46 -08:00
build Make C memory safe like Rust 2021-02-01 03:58:46 -08:00
dsp Make C memory safe like Rust 2021-02-01 03:58:46 -08:00
examples Make C memory safe like Rust 2021-02-01 03:58:46 -08:00
libc Make C memory safe like Rust 2021-02-01 03:58:46 -08:00
net Make C memory safe like Rust 2021-02-01 03:58:46 -08:00
test Make C memory safe like Rust 2021-02-01 03:58:46 -08:00
third_party Make C memory safe like Rust 2021-02-01 03:58:46 -08:00
tool Make C memory safe like Rust 2021-02-01 03:58:46 -08:00
usr/share Add epoll and do more release readiness changes 2020-11-28 12:01:51 -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
Makefile Remove sun musl fdlibm math library 2021-01-31 18:25:16 -08:00
NOTICE Change license 2020-12-27 17:18:44 -08:00
README.md Cosmopolitan 0.1.2 2021-01-30 10:13:13 -08:00

README.md

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 to output a POSIX-approved polyglot format that runs natively on Linux + Mac + Windows + FreeBSD + OpenBSD + 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

Here's how to get started with the freestanding hermetically-sealed monolithic source repository:

tar xf cosmopolitan-0.1.2.tar.gz  # see our releases page
cd cosmo
make -j12
o//examples/hello.com

Here's how to get started with the amalgamated binaries, which let you bring your own build system:

unzip cosmopolitan-amalgamated-0.1.2.zip  # see our releases page
echo 'main() { printf("hello world\n"); }' >hello.c
gcc -g -O -static -fno-pie -no-pie -mno-red-zone -nostdlib -nostdinc \
  -o hello.com.dbg hello.c -Wl,--gc-sections -Wl,-z,max-page-size=0x1000 -fuse-ld=bfd \
  -Wl,-T,ape.lds -include cosmopolitan.h crt.o ape.o cosmopolitan.a
objcopy -SO binary hello.com.dbg hello.com
./hello.com