Giter VIP home page Giter VIP logo

fuzzyos's Introduction

FuzzyOS CI Hits

32-bit x86 multiprocessing OS capable of running console or graphical user applications.

Release

Please find all releases at https://github.com/scopeInfinity/FuzzyOS/releases

The boot image can be found under Assets for the corresponding release.

Screenshots

The screenshots can be located as Artifacts under completed run on Actions/CI.

Bootloader Kernel Turnup
image image
Simple Shell cat
image image
fork() TicTacToe Game
image image
PingPong Game Logo Programming
gif gif
Desktop
image

Boot OS

How to get boot image?

  • Download image from one of the Release.
  • Or directly build image using make images after cloning the repository.

Boot on VirtualBox

  • Create VM with FuzzyOS.vdi as storage.

Boot on VMware

  • Create VM with FuzzyOS.vmdk as storage.
Boot on a real machine
  • Use dd or scripts/burn.sh to burn image into the disk (potentially destructive).
  • bash scripts/burn.sh build/FuzzyOS.raw /path/to/devicefile

Features

Feature Exists
Boot: Legacy BIOS ✔️
Boot: UEFI
Disk partitioning style: MBR ✔️
Disk partitioning style: GPT
Exported disk image: vmdk ✔️
Exported disk image: vdi ✔️
Exported disk image: raw ✔️
kernel <-> app and app <-> app isolation ✔️
opearating-mode: real mode (boot-loader + realmode-library) ✔️
opearating-mode: protected mode (kernel + user application) ✔️
driver: disk IO ✔️
driver: PIC ✔️
driver: PIT ✔️
driver: Keyboard ✔️
file-system: FFS (in-house) (read-only) ✔️
interrupt handler ✔️
syscall: text console IO ✔️
syscall: graphics ✔️
syscall: keyboard ✔️
syscall: file handlers ✔️
process-scheduler: Round Robin ✔️
file-system: FFS (custom) (read-only) ✔️
display: text-mode ✔️
display: graphics-vga 320x200 256 colors ✔️
concurrency: Multiprocessing ✔️
concurrency: Multithreading
parallelism
security in scope
networking
app-build: Support C ✔️
app-build: Support C++ ✔️
app-build: C/C++ Standard Libraries (as needed) ✔️
app-runtime: Heap memory allocation ✔️
application: calculator ✔️
application: cat ✔️
application: desktop ✔️
application: echo ✔️
application: forkbomb ✔️
application: logo ✔️
application: ls ✔️
application: ping-pong ✔️
application: sh (terminal) ✔️
application: simplecpp (example) ✔️
application: more ✔️
application: multiprocessing (example) ✔️
application: tictactoe ✔️
application: Your's? Yes, raise a PR ✔️

Development

Prerequisite

bash before_install.sh
make clean

QEMU Quick Launch

make qemu

Build

Use make to build binaries and image files.

make
Tests

At this moment tests works by injecting predefined ASM in the source code which halts the execution at the point of interest. After that tests can make use of QEMU monitor to verify the current state with expected state.

make test
Debug

Execute QEMU in debug mode and setup GDB server.

make qemu_debug

And then connect to GDB Server.

make qemu_debug_connect

Want to Contribute?

CONTRIBUTING.md

fuzzyos's People

Contributors

dreampearl avatar scopeinfinity avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar

fuzzyos's Issues

Add unit-test for implementation of <stdlib.h>

Example PR for the unit-test for the implementation of <string.h>: #36

  • int min(int a, int b);
  • int max(int a, int b);
  • int abs(int a);
  • int atoi(const char *s)
  • void itoa(int num, char *s, int base);
  • void ftoa(double num, char *s);

Improve escape sequences support in *printf(...)

Source

Specification

Source: https://en.wikipedia.org/wiki/Printf_format_string#Format_placeholder_specification

  • syntax for a format placeholder: %[parameter][flags][width][.precision][length]type

To keep things simple we can go with the subset of the following options to build an minimum viable product

  • Type field:
    • '%'
    • 'd' 'i'
    • 'u'
    • 'f' 'F'
    • 'g' 'G'
    • 'x' 'X'
    • 'o'
    • 's'
    • 'c'
    • 'p'
  • Length field:
  • Flags field:
    • The field may be omitted (default, current behaviour)
    • '-' minus
    • '+' plus
    • ' ' space
    • '0'
  • Width field:
    • The field may be omitted (default, current behaviour)
    • or a numeric integer value
    • or a dynamic value when passed as another argument when indicated by an asterisk *.
  • Precision field:
    • The field may be omitted (default, current behaviour)
    • or a numeric integer value
    • or a dynamic value when passed as another argument when indicated by an asterisk *.

Multiple small pull requests are way better than one giant one :)

va_arg for arguments other than 4 bytes

As for now va_arg increases the internal pointer by 4 bytes on each occurrence, which is not ideal if the argument passed size is different (ex. long long, double, long double or custom data structure using struct).

A bit of additional context (if interested):

  • Within FuzzyOS we are pushing arguments on the internal stack instead of relying on register arguments (default behavior).
    • We are overriding the default behavior using the -m32 flag of gcc.

This isn't a problem while passing char, short as they are auto promoted to int-size.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.