https://github.com/smallkirby/norn

The x64 Operating System written in Zig from scratch. Under development.
https://github.com/smallkirby/norn

os zig

Last synced: 5 months ago
JSON representation

The x64 Operating System written in Zig from scratch. Under development.

• Host: GitHub
• URL: https://github.com/smallkirby/norn
• Owner: smallkirby
• License: mit
• Created: 2024-11-24T08:49:55.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2025-11-03T04:11:37.000Z (8 months ago)
• Last Synced: 2025-11-03T05:25:30.506Z (8 months ago)
• Topics: os, zig
• Language: Zig
• Homepage:
• Size: 988 KB
• Stars: 7
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Norn

![Zig](https://shields.io/badge/Zig-v0%2E15%2E1-blue?logo=zig&color=F7A41D&style=for-the-badge)

![Lint](https://github.com/smallkirby/norn/actions/workflows/lint.yml/badge.svg)

![Unit Tests](https://github.com/smallkirby/norn/actions/workflows/unittest.yml/badge.svg)

![Runtime Tests (init)](https://github.com/smallkirby/norn/actions/workflows/runtimetest-testinit.yml/badge.svg)

![Runtime Tests (busybox)](https://github.com/smallkirby/norn/actions/workflows/runtimetest-busybox.yml/badge.svg)

![Runtime Tests (USB HID driver)](https://github.com/smallkirby/norn/actions/workflows/runtimetest-hid.yml/badge.svg)

## Development

```bash

zig build update-bootparams

# Run on QEMU

zig build run -Dlog_level=debug --summary all -Druntime_test -Doptimize=Debug

# Unit Test

zig build test --summary all -Druntime_test=true

```

### Options

| Option | Type | Description | Default |

|---|---|---|---|

| `bootparams` | Path | Path to the Surtr boot parameters file. | `assets/boot/bootparams` |

| `debug_exit` | Flag | Add `isa-debug-exit` device. When enabled, Norn can terminate QEMU with arbitrary exit code. | `$runtime_test` |

| `debug_intr` | Flag | Print all interrupts and exceptions for debugging. | `false` |

| `debug_syscall` | Flag | Print context for the unhandled or ignored syscalls. | `false` |

| `graphics` | Flag | Enable QEMU graphical output. | `false` |

| `log_level` | String: `debug`, `info`, `warn`, `error` | Logging level. Output under the logging level is suppressed. | `info` |

| `no_kvm` | Flag | Disable KVM. | `false` |

| `optimize` | String: `Debug`, `ReleaseFast`, `ReleaseSmall` | Optimization level. | `Debug` |

| `runtime_test` | Flag | Run runtime tests. | `false` |

| `wait_qemu` | Flag | Make QEMU wait for being attached by GDB. | `false` |

## LICENSE

[Licensed under the MIT License](LICENSE) unless otherwise specified.