apio/Luna

A simple POSIX-based operating system for 64-bit computers

Go to file

apio 5110d740b8 All checks were successful continuous-integration/drone/push Build is passing Details all: Update the version number to 0.4.0		2023-07-22 12:11:02 +02:00
.vscode	libos: Document it entirely using Doxygen comments =D	2023-06-09 22:45:06 +02:00
apps	libc: Implement read buffering =D	2023-07-22 11:17:51 +02:00
base	base: Rename selene-home.sh to mount-home.sh	2023-07-12 19:47:45 +02:00
initrd	kernel+apps+base+tools: Use Ext2 for the root partition file system	2023-07-10 13:05:06 +02:00
kernel	kernel/x86_64: Provide an alternate kernel stack for exceptions	2023-07-21 15:14:52 +02:00
libc	libc+libluna: Add case-insensitive string comparison functions	2023-07-22 11:58:28 +02:00
libluna	libc+libluna: Add case-insensitive string comparison functions	2023-07-22 11:58:28 +02:00
libos	libos: Add Process::exit()	2023-07-21 21:21:08 +02:00
shell	sh: Use input_file instead of hardcoding stdin everywhere in tcsetpgrp()	2023-07-21 21:08:27 +02:00
tests	tests+kernel+init: Run tests automatically in a headless way	2023-07-21 14:09:37 +02:00
tools	tools: Make replace-stdint.sh replace types only if they're followed by a space	2023-07-22 11:59:41 +02:00
.clang-format	Update .clang-format	2022-12-21 20:22:44 +01:00
.drone.yml	Update drone.yml	2023-07-21 14:11:44 +02:00
.gdbconf	Make GDB use the correct kernel file	2022-12-03 17:34:14 +01:00
.gitignore	kernel+apps+base+tools: Use Ext2 for the root partition file system	2023-07-10 13:05:06 +02:00
CMakeLists.txt	all: Update the version number to 0.4.0	2023-07-22 12:11:02 +02:00
LICENSE	Update year range in LICENSE :)	2023-01-02 13:08:42 +01:00
luna.json	kernel+apps+base+tools: Use Ext2 for the root partition file system	2023-07-10 13:05:06 +02:00
README.md	Update README.md	2023-07-22 11:45:35 +02:00

README.md

Luna

A very basic POSIX-based operating system for personal computers, written in C++.

Another UNIX clone?

Yes, another UNIX clone.

Features

x86_64-compatible lightweight kernel.
Preemptive multitasking, with a round-robin scheduler.
Virtual file system with a simple tmpfs and read-only ext2 support.
Can load ELF programs from the file system as userspace tasks.
Boots from an ext2 root filesystem (a bit slow for now).
System call interface and C Library, aiming to be mostly POSIX-compatible.
POSIX signal support.
Designed to be portable, no need to be restricted to x86_64.
Designed around UTF-8.
Environment-agnostic utility library, which can be used in both kernel and userspace.
Return-oriented error propagation, inspired by Rust and SerenityOS.
Build system uses CMake.

Setup

To build and run Luna, you will need to build a cross-compiler and cross-binutils for x86_64-luna.

For this, you should start by installing the required dependencies.

Then, run tools/setup.sh to build the toolchain.

Please beware that building GCC and Binutils can take some time, depending on your machine.

Running

To run Luna in a virtual machine, you should have QEMU installed.

Additionally, the build process needs some extra dependencies to run: cmake, ninja, nasm and genext2fs.

tools/run.sh is the script you should use in most cases. It will build changed files, install, make an ISO image, and run Luna in QEMU.

If you have no toolchain set up, run.sh will build it automatically, which means that you don't necessarily have to run setup.sh since run.sh does it for you.

Prebuilt images

Prebuilt ISO images (numbered) for every version can be found at pub.cloudapio.eu.

These images are built manually whenever a new release is created, and thus don't reflect the latest changes on the main branch.

Every hour, this server pulls the latest commits on main and builds an hourly ISO image. The ten most recent ones can be found in the hourly directory, and Luna-latest.iso should always be symlinked to the newest one.

These images do reflect the latest changes on the main branch, but are obviously less stable. Additionally, an hourly image will be skipped if building the latest commit of the project fails.

Is there third-party software I can use on Luna?

There is no infrastructure for porting third-party software nor there are any patches in the repo for now, but some third-party programs can run on Luna, including my own library.

License

Luna is open-source and free software under the BSD-2 License.