apio/Luna

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

Go to file

apio 9a00b29304 All checks were successful continuous-integration/drone/push Build is passing Details ports: Basic ports system + nasm port		2023-07-24 17:07:49 +02:00
.vscode	libos: Document it entirely using Doxygen comments =D	2023-06-09 22:45:06 +02:00
apps	init: Make the log stream line-buffered	2023-07-24 11:54:49 +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: Log the release name and build date in the boot log	2023-07-24 11:48:01 +02:00
libc	libc: Fix typo in fopen description	2023-07-24 11:57:47 +02:00
libluna	libc+libluna: Add case-insensitive string comparison functions	2023-07-22 11:58:28 +02:00
libos	libos: Make os::File a wrapper around stdio's FILE	2023-07-22 12:40:02 +02:00
ports/nasm	ports: Basic ports system + nasm port	2023-07-24 17:07:49 +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	ports: Basic ports system + nasm port	2023-07-24 17:07:49 +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	ports: Basic ports system + nasm port	2023-07-24 17:07:49 +02:00
CMakeLists.txt	all: Error out on bidirectional characters (CVE-2021-42574)	2023-07-24 15:06:48 +02:00
LICENSE	Update year range in LICENSE :)	2023-01-02 13:08:42 +01:00
luna.json	tools: Make the Ext2 partition bigger (32M)	2023-07-22 16:11:34 +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.