Trident is an operating system originally developed as part of a series on Medium and MBP2 before being co-opted into a personal research project.

As of 2023.11, you will need:

The Rust nightly as of 2023.11.12, which you may obtain through the official website: https://rust-lang.org/learn/get-started
Docker to run the build environment: https://www.docker.com/get-started/

Trident

VERSION: 3.0.1/EARLY/UNRELEASED
LICENSE: Apache-2.0
INFO:

The upstream kernel and runtime library source code can be found within this repository.

Usage

TODO: Update this section when userland modules are created.

Install

For Contributors

To build and install System 3, you will need to install several Rust components:

rustup target install x86_64-unknown-none
rustup component add llvm-tools-preview rust-src
cargo install just

You will also need to install QEMU. You can install QEMU through your package manager, if you're on Linux or macOS, or here if you are on Windows.

These prerequisites will need to be installed prior to cargo run, else you are liable to experience extreme frustration, anger, and possibly death from the mental health spiral you will face due in large part to poor documentation by me. You have been warned, and your trial begins now.

Once the prerequisites are fulfilled, and if you are using QEMU, you may simply run cargo run and watch the magic as it unfolds. If you are using VirtualBox or another VM software, or if you are installing to hardware, you will need to first create a bootable disk image, which you can find in the /docs/contributor folder.

For Users

When using this system, it is recommended to install to a virtual machine, as the kernel is not ready for any level of normal usage.

To install the kernel to your system, you'll need to build it from source and launch it from QEMU or another virtual machine:

git clone https://codeberg.org/mbp2/system-3.git
cd system-3
cargo build

Development

You will eventually be able to develop your own extensions to Trident 3 through a planned Extensions API.

Contributing

If you'd like to contribute to this project, please fork it and submit pull requests with your desired features.

Fork the project;
Create your feature branch (git checkout -b my-new-feature);
Commit your changes (git commit -am 'Add some feature');
Push to the branch (git push origin my-new-feature);
Create a new Pull Request.

An operating system for the future