sborovic/dmzOS
1
2
Fork 1
Code Issues 8 Pull Requests Packages Projects 4 Releases Wiki Activity
8 Commits 1 Branch 0 Tags 62 KiB
C 100%
5438b0f495
Go to file
sborovic 5438b0f495 Update README.md
2024-02-15 17:08:03 +00:00
LICENSE Update LICENSE 2024-02-09 11:55:59 +00:00
README.md Update README.md 2024-02-15 17:08:03 +00: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 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.
  • 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.