apio/Luna

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

Go to file

apio 5c2718545f base+tools: Add a welcome file and store the license inside the OS		2023-08-22 15:08:07 +02:00
.vscode	libos: Document it entirely using Doxygen comments =D	2023-06-09 22:45:06 +02:00
apps	init: Stop using the removed 'signal' pledge	2023-08-22 13:36:33 +02:00
base	base+tools: Add a welcome file and store the license inside the OS	2023-08-22 15:08:07 +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: Remove the 'signal' promise and make signal functions require stdio instead	2023-08-22 13:34:30 +02:00
libc	kernel+libc: Add a memstat() syscall	2023-08-17 20:15:32 +02:00
libluna	libluna: Make Vector grow exponentially	2023-08-22 11:53:42 +02:00
libos	kernel+libos: Call Vector::try_reserve where it is appropriate	2023-08-22 11:54:00 +02:00
ports	ports: Port required libraries to build GCC	2023-08-08 19:51:45 +02:00
shell	sh: Use input_file instead of hardcoding stdin everywhere in tcsetpgrp()	2023-07-21 21:08:27 +02:00
tests	libc: Add putenv	2023-08-11 17:59:04 +02:00
tools	base+tools: Add a welcome file and store the license inside the OS	2023-08-22 15:08:07 +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	base+tools: Add a welcome file and store the license inside the OS	2023-08-22 15:08:07 +02:00
CMakeLists.txt	all: Start calling this release 0.5.0	2023-08-16 09:57:38 +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	README: More features	2023-08-08 16:19:38 +02:00

README.md

Luna

A simple 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, shebang scripts or arbitrary binary formats (registered through kernel modules, which are not supported yet =D).
Boots from an ext2 root filesystem (a bit slow for now).
System call interface and C Library, aiming to be almost POSIX-compatible.
Support for several third-party programs, including the GNU binutils suite of utilities.
POSIX signal support.
Designed to be portable, no need to be restricted to x86_64.
Everything is UTF-8.
UNIX local domain sockets, allowing for local IPC.
POSIX shared memory support.
Environment-agnostic utility library, which can be used in both kernel and userspace.
Return-oriented error propagation, inspired by Rust and SerenityOS. No exceptions here :).
An extensive set of standard Unix utilities, from ls to uname to base64. Written in modern C++ and very small amounts of code, using Luna's practical OS library.

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?

Yes! A ports system is in place, and you can use the build scripts to add some ports to your image. More information in the Ports page.

License

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