Dawning Kit, Foundational Software Development Kit. Zero dependency: C standard Library, Cross Architecture Assembler.
/bitBit Kit: Provides foundational primitives for code generation in a bare bones UNIX environment./docDoc Kit: HTML & Markdown utilities./linuxLinux Kit: Modular OS primitives evolved from Dawning EOS - a complete experimental Linux distribution that proved zero-dependency, profile-based system building./standardC Standard: Entirely self-contained C standard library, also pioneering new syntax and clearer semantics./testTest Kit: Testing utilities, cross architecture
Foundational primitives for code generation, provides "ring zero" level utils for building executables, it's all in shell so portability isn't a concern, and is transparent for your most critical path, where opaque and complex 3rd party binaries might be a concern. This aims for being ideal for boot strapping toolchains from nothing, a full "compiled yourself down to the last byte"
Usage:
. bit/kit.shrespects endianness, before running any of the primitives you can set big endianness
then unset BIG_ENDIAN=0 to go back to the default little endian target.
BIG_ENDIAN=1Byte functions take any amount of args, each arg is separately represented in the functions size, you can input hex (0x7f) or chars ( ELF -> "E", "L" "F" ), or plain ints
bit_8 bit_16 bit_32 bit_64 bit128 hex_dump elf
Generates a ELF executable header and outputs a working executable
. bit/kit.sh
elf_example() {
bit_8 0x48, 0xc7, 0xc0, 0x3c, 0x00, 0x00, 0x00 # mov $60, %rax
bit_8 0x48, 0xc7, 0xc7, 0x00, 0x00, 0x00, 0x00 # mov $0, %rdi
bit_8 0x0f, 0x05 # x86_64 linux syscall
}
elf bin/program elf_example. bit/kit.sh
example() {
bit_8 0x48, 0xc7, 0xc0, 0x3c, 0x00, 0x00, 0x00 # mov $60, %rax
bit_8 0x48, 0xc7, 0xc7, 0x00, 0x00, 0x00, 0x00 # mov $0, %rdi
bit_8 0x0f, 0x05 # x86_64 linux syscall
}
hex_dump exampleoutput:
example 16 bytes
00000000 48 c7 c0 3c 00 00 00 48 c7 c7 00 00 00 00 0f 05 H..<...H........Bit kit also have wasm primitives for generating WebAssembly modules,
wasm_var wasm_section wasm
. bit/kit.sh
type_section() {
wasm_var 1 # 1 type
bit_8 0x60 # func type
bit_8 0x00, 0x01, 0x7F # () -> i32
}
function_section() {
wasm_var 1 # 1 function
wasm_var 0 # uses type 0
}
export_section() {
wasm_var 1 # 1 export
wasm_var 4 # name length
bit_8 "main" # name
bit_8 0x00, 0x00 # func export, index 0
}
code_section() {
wasm_var 1 # 1 function
wasm_var 2 # body size
bit_8 0x41, 0x00, 0x0B # i32.const 0, end
}
wasm_module() {
wasm_section 1 type_section
wasm_section 3 function_section
wasm_section 7 export_section
wasm_section 10 code_section
}
wasm example.wasm wasm_moduleprimitives to generate HTML and Markdown documentation in HTML. Works entirely within shell itself, this outputs ugly HTML to not waste space.
Example turning this readme into a HTML file:
. doc/kit.sh
doc README.md > README.html. doc/kit.sh
less_css "style/*.css" dist/style.cssoutput: CSS: 2.0 KB → 1.2 KB (37% smaller)
Linux Distro primitives evolved from Dawning EOS
Warning
This is currently being moved from the Dawning EOS repository to this one.
Ensure to cd into dawning-kit/linux before running build.sh
Minimal config for x86_x64
sudo sh build.sh arch/x64 debug_noneMinimal config for raspberry pis (WIP)
sudo sh build.sh arch/arm.pi debug_noneif you want to run this in a virtual machine for testing:
sh build.run.shbut, you need https://www.qemu.org/
Syntax shapes the way you think. Better thinking should be standardized.
The Dawning C Standard library is a effort to develop a new entirely self contained standard library, It's also trying to lay the ground work for less error prone DX and type semantics in C.
Traditional type systems and APIs prioritize implementation details over clear expression of intent.
The Type system is explicit about ranges, memory layouts, and semantic meaning.
Types like positive, bipolar, and decimal communicate intention, not just implementation.
The improved clarity aims to make systems programming safer AND faster by having lower cognative load on the programmer.
By carefully re-designing the API and type expression, code can become more effective to think, write and audit.
Provides automated test runner for multiple architectures with QEMU.
. test/kit.sh
# path / file_name + .<arch> - becomes the expected usage pattern
test_all /path/to/bin/folder file_nameDid you know this effort has gone 100% out of my pocket? If you think this project speaks for itself, consider supporting on github sponsors to continue making projects like these a reality, open & free.
Supporter or not, you can always reach me on My Discord Server, my primary communication channel Questions, feedback or support related to any of my projects, or if you need consulting.
Logos, Branding, Trademarks - Copyright Dawn Larsson 2022
Repository: Apache-2.0 license