sborovic
/
dmzOS
1
2
Fork 1
Code Issues 8 Pull Requests Packages Projects 4 Releases Wiki Activity
16 Commits 1 Branch 0 Tags 62 KiB
C 100%
Go to file
sborovic e932f929fd Update README.md 2024-02-17 12:36:42 +00:00
Dockerfiles Add LLVM and lld to the c_toolchain env 2024-02-16 19:49:25 +01:00
config Add the base containerized c toolchain environment 2024-02-14 02:58:33 +01:00
dmzOS/test Add the base containerized c toolchain environment 2024-02-14 02:58:33 +01:00
.gitignore Add the base containerized c toolchain environment 2024-02-14 02:58:33 +01:00
LICENSE Update LICENSE 2024-02-09 11:55:59 +00:00
README.md Update README.md 2024-02-17 12:36:42 +00:00
docker-compose.yml Move docker files to the Dockerfiles dir 2024-02-14 11:32:13 +01:00

README.md

dmzOS

About

dmzOS is an operating system written by a group of computer enthusiasts gathered around Decentrala. You are free to explore, learn, and contribute!

Description

  • Written from scratch in C and asm.
  • POSIX-compliant (as we are aspiring to Stan Dard).
  • For the amd64 architecture.
  • Extensively documented.

Goals

  • Sharpen low-level programming skills.
  • Familiarize with amd64 architecture details.
  • Have fun along the way!

Success criteria

  • Run vim on the OS.

Rules

  • Please provide an adequate entry in the Wiki for each non-trivial code contribution.

To learn more about the project, please refer to the Wiki.

DevOps

Development environment

Essential software (plus dependencies) that are needed for the development are available through a custom Ubuntu-based Docker image (located in Dockerfiles/dockerfile.c_toolchain as well as on Docker Hub). This includes:

  • gcc: The GNU Compiler Collection.
  • indent GNU C code formatter.
  • clang: a compiler front end for the C, C++, Objective-C, and Objective-C++ programming languages
  • clang-format: a tool to automatically format C/C++/Objective-C code
  • gdb: The GNU Debugger.
  • make: a tool which controls the generation of executables and other non-source files of a program from the program's source files.
  • objdump: a command-line program for displaying various information about object files.
  • nasm: The Netwide Assembler is an assembler and disassembler for the Intel x86 architecture.
  • xxd: a command-line program that may be used to manage, convert, and display binary files.
  • ld: The GNU Linker.
  • lld: a linker from the LLVM project that is a drop-in replacement for system linkers and runs much faster than them.
  • vim: a highly configurable text editor.

Note A .vimrc file with a rule to format code on buffer save in line with Kernighan and Ritchie style (with 4-space indentation) comes pre-installed inside the image.

Booting the latest .iso image of dmzOS is done using a Dockerized QEMU.

Command cheatsheet

  • To get into a bash shell that is bound to the dmzOS directory:
docker-compose run --rm c_toolchain

Note Any changes in the container's dmzOS directory will be reflected in the local dmzOS directory.