.github/ISSUE_TEMPLATE

-**Reproduction**: [describe how you are able to reproduce ("trigger") this bug/issue.]
-
-**Expected behavior**: [describe the behavior you would expect the repro to yield.]
-
-**Actual behavior**: [describe the actual behavior, which is presented through the repro.].
-
-**Build information**: [output of `rustc -V`, `git rev-parse HEAD`, `qemu-i386 -version`, `uname -a`, etc.]
-
-**Blocking/related**: [issues or PRs blocking or being related to this issue.]
-
-**Misc**: [optional: for other relevant information that should be known or cannot be described in the other fields.]
-
-------
-
-_If the above does not fit the nature of the issue feel free to modify it._

.gitignore

-Cargo.lock
-build
-target
-initfs/bin
-filesystem/bin
-filesystem/ref
-filesystem/sbin
+/build/
+/prefix/
+.config
+**/my_*
+# Local settings folder for Jetbrains products (RustRover, IntelliJ, CLion)
+.idea/
+# Local settings folder for Visual Studio Professional
+.vs/
+# Local settings folder for vscode
+.vscode/
+# Local settings folder for the devcontainer extension that most IDEs support.
+.devcontainer/

.gitlab-ci.yml

+# The GitLab Continuous Integration configuration
+image: "ubuntu:22.04"
+
+variables:
+  GIT_STRATEGY: "clone"
+  GIT_SUBMODULE_STRATEGY: "recursive"
+
+before_script:
+ # Disable the wget progress bar
+ - echo 'show-progress = off' >> ~/.wgetrc
+ - |
+    export DEBIAN_FRONTEND=noninteractive
+    apt-get update -qq &&
+    apt-get install -qq \
+        bison \
+        build-essential \
+        curl \
+        flex \
+        fuse3 \
+        git \
+        libfuse-dev \
+        nasm \
+        pkg-config \
+        texinfo \
+        wget \
+        help2man \
+        autoconf \
+        automake \
+        zstd &&
+    curl https://sh.rustup.rs -sSf | sh -s -- -y --default-toolchain none
+
+img:
+    script:
+     - |
+        source "$HOME/.cargo/env" &&
+        curl -L --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/cargo-bins/cargo-binstall/main/install-from-binstall-release.sh | bash &&
+        cargo binstall --no-confirm --version 0.1.1 cargo-config &&
+        cargo binstall --no-confirm --version 1.16.0 just &&
+        cargo binstall --no-confirm --version 0.27.0 cbindgen &&
+        cargo build --manifest-path installer/Cargo.toml --release &&
+        PODMAN_BUILD=0 REPO_BINARY=1 make ci-img IMG_TAG=$CI_COMMIT_REF_NAME
+    artifacts:
+        paths:
+         - build/img/
+        expire_in: 1 week

.gitlab/issue_templates/Issue_template.md

+<!-- Thank you for taking the time to submit an issue! By following these comments and filling out the sections below, you can help the developers get the necessary information to fix your issue. Please provide a single issue per report. You can also preview this report before submitting it. Feel free to modify/remove sections to fit the nature of your issue. -->
+
+<!-- Please search to check that your issue has not been created already. By preventing duplicate issues, you can help keep the repository organized. If your current issue has already been created and is still unresolved, you can contribute by commenting there. -->
+<!-- Replace the empty checkbox [ ] below with a checked one [x] if you have already searched for your issue. -->
+- [ ] I agree that I have searched opened and closed issues to prevent duplicates.
+
+--------------------
+
+
+
+## Description
+<!-- Briefly summarize/describe the issue that you are experiencing below. -->
+Replace me
+
+
+
+## Environment info
+<!-- To understand where your issue originates, please include some relevant information about your environment. -->
+
+<!-- If you are using a pre-built release of Redox, please specify the release version below. -->
+- Redox OS Release:
+0.0.0 Remove me
+
+<!-- If you have built Redox OS yourself, please provide the following information: -->
+- Operating system:
+Replace me
+- `uname -a`:
+`Replace me`
+- `rustc -V`:
+`Replace me`
+- `git rev-parse HEAD`:
+`Replace me`
+<!-- Depending on your issue, additional information about your environment (network config, package versions, dependencies, etc.) can also help. You can list that below. -->
+- Replace me:
+Replace me
+
+
+
+## Steps to reproduce
+<!-- If possible, please list the steps to reproduce ("trigger") your issue below. Being detailed definitely helps speed up bug fixes. -->
+1. Replace me
+2. Replace me
+3. ...
+
+
+
+## Behavior
+<!-- It may seem obvious to know what to expect, but isolating the behavior from everything else simplifies the development process. Remember to provide a single issue in this report. You can use the References section below to link your issues together. -->
+
+<!-- Describe the behavior you expect your steps should yield (i.e., correct behavior). -->
+- **Expected behavior**:
+Replace me
+
+<!-- Describe the behavior you observed when running your steps (i.e., buggy behavior). -->
+- **Actual behavior**:
+Replace me
+
+<!-- **Logs?** Posting a log can help developers find your particular issue more easily. Please wrap your code in code blocks using triple back-ticks ``` to increase readability. -->
+```
+Replace me
+```
+
+<!-- **Solution?** Have a solution in mind? Propose your solution below. -->
+- **Proposed solution**:
+Replace me
+
+<!-- **Screenshots?** Make it easier to get your point across with screenshots. You can drag & drop or paste your images below. -->
+
+
+
+## Optional references
+<!-- If you have found issues or pull requests that are related to or blocking this issue, please link them below. See https://help.github.com/articles/autolinked-references-and-urls/ for more options. You can also link related code snippets by providing the permalink. See https://help.github.com/articles/creating-a-permanent-link-to-a-code-snippet/ for more information. -->
+
+Related to:
+- #0000 Remove me
+- Replace me
+- ...
+
+Blocked by:
+- #0000 Remove me
+- ...
+
+
+
+## Optional extras
+<!-- If you have other relevant information not found in other sections, you can include it below. -->
+Replace me
+
+<!-- **Code?** Awesome! You can also create a pull request with a reference to this issue. -->
+<!-- **Files?** Attach your relevant files by dragging & dropping or pasting them below. -->
+
+<!-- You also can preview your report before submitting it. Thanks for contributing to Redox! -->

.gitmodules

-[submodule "rust"]
-	path = rust
-	url = https://github.com/redox-os/rust.git
-[submodule "ion"]
-	path = programs/ion
-	url = https://github.com/redox-os/ion.git
-[submodule "programs/coreutils"]
-	path = programs/coreutils
-	url = https://github.com/redox-os/coreutils.git
-[submodule "schemes/redoxfs"]
-	path = schemes/redoxfs
-	url = https://github.com/redox-os/redoxfs
-[submodule "programs/extrautils"]
-	path = programs/extrautils
-	url = https://github.com/redox-os/extrautils.git
-[submodule "programs/smith"]
-	path = programs/smith
-	url = https://github.com/IGI-111/Smith.git
-[submodule "programs/userutils"]
-	path = programs/userutils
-	url = https://github.com/redox-os/userutils.git
-[submodule "programs/netutils"]
-	path = programs/netutils
-	url = https://github.com/redox-os/netutils.git
-[submodule "schemes/orbital"]
-	path = schemes/orbital
-	url = https://github.com/redox-os/orbital.git
-[submodule "programs/orbutils"]
-	path = programs/orbutils
-	url = https://github.com/redox-os/orbutils.git
-[submodule "filesystem/ui"]
-	path = filesystem/ui
-	url = https://github.com/redox-os/orbdata.git
-[submodule "programs/acid"]
-	path = programs/acid
-	url = https://github.com/redox-os/acid.git
-[submodule "programs/tar"]
-	path = programs/tar
-	url = https://github.com/redox-os/tar-rs.git
-[submodule "programs/pkgutils"]
-	path = programs/pkgutils
-	url = https://github.com/redox-os/pkgutils.git
+[submodule "cookbook"]
+	path = cookbook
+	url = https://gitlab.redox-os.org/redox-os/cookbook.git
+	branch = master
 [submodule "installer"]
 	path = installer
-	url = https://github.com/redox-os/installer.git
-[submodule "syscall"]
-	path = syscall
-	url = https://github.com/redox-os/syscall.git
-[submodule "crates/docgen"]
-	path = crates/docgen
-	url = https://github.com/redox-os/docgen.git
-[submodule "libstd_real/openlibm"]
-	path = libstd/openlibm
-	url = https://github.com/redox-os/openlibm.git
-[submodule "programs/binutils"]
-	path = programs/binutils
-	url = https://github.com/redox-os/binutils.git
+	url = https://gitlab.redox-os.org/redox-os/installer.git
+	branch = master
+[submodule "rust"]
+	path = rust
+	url = https://gitlab.redox-os.org/redox-os/rust.git
+	branch = redox-2025-01-12
+	update = none
+[submodule "redoxfs"]
+	path = redoxfs
+	url = https://gitlab.redox-os.org/redox-os/redoxfs.git
+	branch = master
+[submodule "relibc"]
+	path = relibc
+	url = https://gitlab.redox-os.org/redox-os/relibc.git
+	branch = master

.travis.yml

-sudo: required
-language: rust
-rust:
-  - nightly
-os:
-  - linux
-#  - osx
-dist: trusty
-before_install:
-    - if [ `uname` = "Linux" ]; then
-        sudo apt-get install -qq nasm pkg-config fuse libfuse-dev;
-        sudo modprobe fuse;
-        sudo chmod 666 /dev/fuse;
-        sudo chown root:$USER /etc/fuse.conf;
-      fi
-    - if [ `uname` = "Darwin" ]; then
-        brew update;
-        brew install nasm gcc49 pkg-config Caskroom/cask/osxfuse;
-        brew tap glendc/gcc_cross_compilers;
-        brew install glendc/gcc_cross_compilers/x64-elf-binutils glendc/gcc_cross_compilers/x64-elf-gcc;
-      fi
-script:
-  - make clean
-  - make all -j 2
-notifications:
-  email: false
-  webhooks: http://37.139.9.28:54863/travis
-  

Cargo.toml

-[package]
-name = "kernel"
-version = "0.1.0"
-
-[lib]
-name = "kernel"
-path = "kernel/lib.rs"
-crate-type = ["staticlib"]
-
-[dependencies]
-bitflags = "*"
-spin = "*"
-redox_syscall = { path = "syscall/" }
-
-[dependencies.goblin]
-git = "https://github.com/redox-os/goblin.git"
-default-features = false
-features = ["elf32", "elf64"]
-
-[dev-dependencies]
-arch_test = { path = "arch/test" }
-
-[target.'cfg(target_arch = "arm")'.dependencies]
-arch_arm = { path = "arch/arm" }
-
-[target.'cfg(target_arch = "x86_64")'.dependencies]
-arch_x86_64 = { path = "arch/x86_64" }
-
-[features]
-default = []
-live = []
-
-[profile.dev]
-panic = "unwind"
-
-[profile.release]
-panic = "abort"

HARDWARE.md

+# Hardware Compatibility
+
+This document tracks the current hardware compatibility of Redox.
+
+- [Why hardware reports are needed?](#why-hardware-reports-are-needed)
+- [What if my computer is customized?](#what-if-my-computer-is-customized)
+- [Status](#status)
+- [General](#general)
+- [Template](#template)
+- [Recommended](#recommended)
+- [Booting](#booting)
+- [Broken](#broken)
+
+## Why hardware reports are needed?
+
+Each computer model have different hardware interface/firmware implementations and devices, which can cause the following problems:
+
+- Boot bugs
+- Lack of device support
+- Performance degradation
+
+These reports helps us to fix the problems above.
+
+## What if my computer is customized?
+
+You can use the "Custom" word on the "Vendor" and "Model" categories, we also recommend to add your `pciutils` log on [this document link](https://gitlab.redox-os.org/redox-os/drivers/-/blob/master/COMMUNITY-HW.md?ref_type=heads) to help us with probable porting.
+
+## Status
+
+- Broken - The system can't boot.
+- Booting - The system boots with some issues.
+- Recommended - The system start with all features working.
+
+## General
+
+This section cover things to consider.
+
+- ACPI support is incomplete (some things are hardcoded on the kernel)
+- Only USB input devices are supported
+- Wi-Fi is not supported
+- GPU drivers aren't supported (only VESA and UEFI GOP)
+- Automatic operating system discovery on boot loader is not implemented (remember this before installing Redox)
+
+## Template
+
+You will use this template to insert your computer on the table.
+
+```
+|  |  |  |  |  |  |  |  |
+```
+
+## Recommended
+
+| **Vendor** | **Model** | **Redox Version** | **Image Date** | **Variant** | **CPU Architecture** | **Motherboard Firmware** | **Report** |
+|------------|-----------|-------------------|----------------|-------------|----------------------|--------------------------|------------|
+| System76 | Galago Pro (galp5) | 0.8.0 | 11-11-2022 | desktop | x86-64 | UEFI | Boots to Orbital |
+| System76 | Lemur Pro (lemp9) | 0.8.0 | 11-11-2022 | desktop | x86-64 | UEFI | Boots to Orbital |
+| Lenovo | IdeaPad Y510P | 0.8.0 | 11-11-2022 | desktop | x86-64 | BIOS, UEFI | Boots to Orbital |
+
+## Booting
+
+| **Vendor** | **Model** | **Redox Version** | **Image Date** | **Variant** | **CPU Architecture** | **Motherboard Firmware** | **Report** |
+|------------|-----------|-------------------|----------------|-------------|----------------------|--------------------------|------------|
+| System76 | Oryx Pro (oryp10) | 0.8.0 | 11-11-2022 | desktop | x86-64 | UEFI | Boots to Orbital, No touchpad support, though it should be working |
+| System76 | Pangolin (pang12) | 0.8.0 | 11-11-2022 | desktop | x86-64 | UEFI | Boots to Orbital, No touchpad support, requires I2C HID |
+| Dell | XPS 13 (9350) | 0.8.0 | 11-11-2022 | desktop | x86-64 | BIOS, UEFI | Boots to Orbital, NVMe driver livelocks |
+| Dell | XPS 13 (9350) | 0.8.0 | 11-11-2022 | desktop | i686 | BIOS | Boots to Orbital, NVMe driver livelocks |
+| HP | Dev One | 0.8.0 | 11-11-2022 | desktop | x86-64 | UEFI | Boots to Orbital, No touchpad support, requires I2C HID |
+| ASUS | X554L | 0.8.0 | 11-11-2022 | desktop | x86-64 | BIOS | Boots to Orbital, No audio, HDA driver cannot find output pins |
+| ASUS | ROG g55vw | 0.8.0 | 11-11-2023 | desktop | x86-64 | BIOS | Boots to Orbital, UEFI panic in SETUP |
+| ASUS | PRIME B350M-E (custom) | 0.9.0 | 20-09-2024 | desktop | x86-64 | UEFI | Partial support for the PS/2 keyboard, PS/2 mouse is broken |
+| ASUS | Eee PC 900 | 0.8.0 | 11-11-2022 | desktop | i686 | BIOS | Boots to Orbital, No ethernet driver, Correct video mode not offered (firmware issue) |
+| Toshiba | Satellite L500 | 0.8.0 | 11-11-2022 | desktop | x86-64 | BIOS | Boots to Orbital, No ethernet driver, Correct video mode not offered (firmware issue) |
+| Raspberry Pi | 3 Model B+ | 0.8.0 | Unknown | server | ARM64 | U-Boot | Boots to UART serial console (pl011) |
+| Lenovo | ThinkPad Yoga 260 Laptop - Type 20FE | 0.9.0 | 07-09-2024 | demo | x86-64 | UEFI | Boots to Orbital, No audio |
+| Lenovo | Yoga S730-13IWL | 0.9.0 | 09-11-2024 | desktop | x86-64 | UEFI | Boots to Orbital, No trackpad or USB mouse input support |
+
+## Broken
+
+| **Vendor** | **Model** | **Redox Version** | **Image Date** | **Variant** | **CPU Architecture** | **Motherboard Firmware** | **Report** |
+|------------|-----------|-------------------|----------------|-------------|----------------------|--------------------------|------------|
+| HP | EliteBook 2570p | 0.8.0 | 23-11-2022 | demo | x86-64 | BIOS (CSM mode?) | Gets to resolution selection, Fails assert in `src/os/bios/mod.rs:77` after selecting resolution |
+| BEELINK | U59 | 0.8.0 | 30-05-2024 | server | x86-64 | Unknown | Aborts after panic in xhcid |
+| ASUS | PN41 | 0.8.0 | 30-05-2024 | server | x86-64 | Unknown | Aborts after panic in xhcid |
+| Lenovo | G570 | 0.8.0 | 11-11-2022 | desktop | x86-64 | BIOS | Bootloader panics in `alloc_zeroed_page_aligned`, Correct video mode not offered (firmware issue) |
+| Lenovo | IdeaPad Y510P | 0.8.0 | 11-11-2022 | desktop | i686 | BIOS | Panics on `phys_to_virt overflow`, probably having invalid mappings for 32-bit |
+| Framework | Laptop 16 (AMD Ryzen 7040 Series) | 0.9.0 | 07-09-2024 | server, demo | x86-64 | UEFI | Black screen and unresponsive after the bootloader and resolution selection |
+| Toshiba | Satellite L500 | 0.8.0 | 11-11-2022 | desktop | i686 | BIOS | Correct video mode not offered (firmware issue), Panics on `phys_to_virt overflow`, probably having invalid mappings for 32-bit |
+| Panasonic | Toughbook CF-18 | 0.8.0 | 11-11-2022 | desktop | i686 | BIOS | Hangs after PIT initialization |
+| XMG (Schenker) | Apex 17 (M21) | 0.9.0 | 30-09-2024 | demo, server | x86-64 | UEFI | After selecting resolution, (release) repeats `...::interrupt::irq::ERROR -- Local apic internal error: ESR=0x40` a few times before it freezes; (daily) really slowly prints statements from `...::rmm::INFO` before it abruptly aborts |
+| HP | Compaq nc6120 | 0.9.0 | 2024-11-08 | desktop, server | i686 | BIOS | Unloads into memory at a rate slower than 1MB/s after selecting resolution. When unloading is complete the logger initializes and crashes after kernel::acpi, some information about APIC is printed. Boot logs do not progress after this point. |
+

README.md

 <p align="center">
-<img alt="Redox" height="120" src="https://github.com/redox-os/assets/raw/master/logo.png">
+<img alt="Redox" width="346" src="https://gitlab.redox-os.org/redox-os/assets/raw/master/logos/redox/logo.png">
 </p>
 
-**Redox** is an operating system written in Rust, a language with focus on safety and high performance. Redox, following the microkernel design, aims to be secure, usable, and free. Redox is inspired by previous kernels and operating systems, such as SeL4, Minix, Plan 9, and BSD.
+This repository is the **Build System** for Redox OS.
 
-Redox _is not_ just a kernel, it's a full-featured Operating System, providing packages (memory allocator, file system, display manager, core utilities, etc.) that together makes up a functional and convenient operating system. You can loosly think of it as the GNU or BSD ecosystem, but in a memory safe language and with modern technology. See [this list](#ecosystem) for overview of the ecosystem.
+Redox is under active development by a vibrant community, you can see the key links below:
 
-The website can be found at https://www.redox-os.org.
+- [The **main website** for Redox OS](https://www.redox-os.org).
+- [The Redox Book](https://doc.redox-os.org/book/) and [Build Instructions](https://doc.redox-os.org/book/podman-build.html).
+- [Redox Chat and Support](https://matrix.to/#/#redox-join:matrix.org).
+- [Patreon](https://www.patreon.com/redox_os), [Donate](https://redox-os.org/donate/) and [Merch](https://redox-os.creator-spring.com/).
+- Scroll down for a list of key Redox components and their repositories.
 
-Please make sure you use the **latest nightly** of `rustc` before building (for more troubleshooting, see ["Help! Redox won't compile!"](#compile-help)).
+[Redox](https://www.redox-os.org) is an open-source operating system written in Rust, a language with focus on safety, efficiency and high performance. Redox uses a microkernel architecture, and aims to be reliable, secure, usable, correct, and free. Redox is inspired by previous operating systems, such as seL4, MINIX, Plan 9, Linux and BSD.
 
-[![Travis Build Status](https://travis-ci.org/redox-os/redox.svg?branch=master)](https://travis-ci.org/redox-os/redox)
-[![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE.md)
+Redox _is not_ just a kernel, it's a **full-featured operating system**, providing components (file system, display server, core utilities, etc.) that together make up a functional and convenient operating system. Redox uses the COSMIC desktop apps, and provides source code compatibility with many Rust, Linux and BSD programs.
 
-## Contents
+[![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
 
-* [What it looks like](#what-it-looks-like)
-* [Ecosystem](#ecosystem)
-* [Help! Redox won't compile](#compile-help)
-* [Contributing to Redox](#contributing)
-* [Cloning, Building and running](#cloning-building-running)
- * [Quick Setup](#quick-setup)
- * [Manual Setup](#manual-setup)
+## More Links
 
-## <a name="what-it-looks-like"> What it looks like </a>
+- [Book](https://doc.redox-os.org/book/)
+- [Contribute](CONTRIBUTING.md)
+- [Hardware Compatibility](https://doc.redox-os.org/book/hardware-support.html)
+- Run Redox in a [Virtual Machine](https://doc.redox-os.org/book/running-vm.html) or on [Real Hardware](https://doc.redox-os.org/book/real-hardware.html)
+- [Trying Out Redox](https://doc.redox-os.org/book/trying-out-redox.html)
+- [Building Redox](https://doc.redox-os.org/book/podman-build.html)
+- [Build System Documentation](https://doc.redox-os.org/book/build-system-reference.html)
+- [Developer FAQ](https://doc.redox-os.org/book/developer-faq.html)
+- [Chat/Discussions/Help](https://doc.redox-os.org/book/chat.html)
 
-<img alt="Redox" height="150" src="https://github.com/redox-os/assets/raw/master/screenshots/Desktop.png">
-<img alt="Redox" height="150" src="https://github.com/redox-os/assets/raw/master/screenshots/Fancy_opacity.png">
-<img alt="Redox" height="150" src="https://github.com/redox-os/assets/raw/master/screenshots/File_manager.png">
+## Ecosystem
 
-<img alt="Redox" height="150" src="https://github.com/redox-os/assets/raw/master/screenshots/Sodium_v1.png">
-<img alt="Redox" height="150" src="https://github.com/redox-os/assets/raw/master/screenshots/Boot.png">
-<img alt="Redox" height="150" src="https://github.com/redox-os/assets/raw/master/screenshots/start.png">
+Some of the key repositories on the Redox GitLab:
 
-## <a name="ecosystem"> Ecosystem </a>
+| Essential Repos                                                                      | Maintainer
+|--------------------------------------------------------------------------------------|---------------------------
+| [Kernel](https://gitlab.redox-os.org/redox-os/kernel)                                | **@jackpot51**
+| [RedoxFS (default filesystem)](https://gitlab.redox-os.org/redox-os/redoxfs)         | **@jackpot51**
+| [Drivers](https://gitlab.redox-os.org/redox-os/drivers)                              | **@jackpot51**
+| [Orbital (display server and window manager)](https://gitlab.redox-os.org/redox-os/orbital) | **@jackpot51**
+| [pkgutils (current package manager)](https://gitlab.redox-os.org/redox-os/pkgutils)  | **@jackpot51**
+| [relibc (C POSIX library written in Rust)](https://gitlab.redox-os.org/redox-os/relibc)            | **@jackpot51**
+| [netstack (network stack)](https://gitlab.redox-os.org/redox-os/netstack)                            | **@jackpot51**
+| [Ion (defauilt shell)](https://gitlab.redox-os.org/redox-os/ion)                              | **@jackpot51**
+| [Termion (terminal library)](https://gitlab.redox-os.org/redox-os/termion)           | **@jackpot51**
+| This repo - the root of the Build System                                             | **@jackpot51**
+| [cookbook (Build system for system components and programs)](https://gitlab.redox-os.org/redox-os/cookbook) | **@jackpot51** **@hatred_45**
+| [Redoxer (Tool for Redox development testing)](https://gitlab.redox-os.org/redox-os/redoxer) | **@jackpot51**
+| [The Redox Book](https://gitlab.redox-os.org/redox-os/book)                          | **@hatred_45**
 
-The ecosystem and software Redox OS provides is listed below.
+## What it looks like
 
-| Name (lexiographic order)                                                   | Maintainer
-|-----------------------------------------------------------------------------|---------------------------
-| [Ion (shell)](https://github.com/redox-os/ion)                              | [**@skylerberg**](https://github.com/skylerberg) & [**@jackpot51**](https://github.com/jackpot51)
-| [RANSID](https://github.com/redox-os/ransid)                                | [**@jackpot51**](https://github.com/jackpot51)
-| [Sodium (editor)](https://github.com/redox-os/sodium)                       | [**@ticki**](https://github.com/ticki)
-| [Standard library](https://github.com/redox-os/libstd)                      | [**@jackpot51**](https://github.com/jackpot51)
-| [TFS (filesystem)](https://github.com/ticki/tfs)                            | [**@ticki**](https://github.com/ticki)
-| [The Redox book](https://github.com/redox-os/book)                          | [**@ticki**](https://github.com/ticki)
-| [The old kernel](https://github.com/redox-os/old)                           | abandoned
-| [ZFS](https://github.com/redox-os/zfs)                                      | abandoned, superseded by TFS
-| [acid tests](https://github.com/redox-os/acid)                              | [**@jackpot51**](https://github.com/jackpot51) (co.: [**@ticki**](https://github.com/ticki), [**@nilset](https://github.com/nilset))
-| [binutils](https://github.com/redox-os/binutils)                            | [**@ticki**](https://github.com/ticki)
-| [bots (other internal bots)](https://github.com/redox-os/bots)              | [**@ticki**](https://github.com/ticki)
-| [cookbook](https://github.com/redox-os/cookbook)                            | [**@jackpot51**](https://github.com/jackpot51)
-| [coreutils](https://github.com/redox-os/coreutils)                          | [**@ticki**](https://github.com/ticki) (co.: [**@stratact**](https://github.com/stratact))
-| [extrautils](https://github.com/redox-os/extrautils)                        | [**@ticki**](https://github.com/ticki)
-| [games](https://github.com/redox-os/games)                                  | [**@ticki**](https://github.com/ticki)
-| [kernel](https://github.com/redox-os/kernel)                                | [**@jackpot51**](https://github.com/jackpot51)
-| [libextra](https://github.com/redox-os/libextra)                            | [**@ticki**](https://github.com/ticki)
-| [libpager](https://github.com/redox-os/libpager)                            | [**@ticki**](https://github.com/ticki)
-| [magnet (future package manager)](https://github.com/redox-os/magnet)       | [**@ticki**](https://github.com/ticki)
-| [netutils](https://github.com/redox-os/netutils)                            | [**@jackpot51**](https://github.com/jackpot51)
-| [orbclient](https://github.com/redox-os/orbclient)                          | [**@jackpot51**](https://github.com/jackpot51)
-| [orbdata](https://github.com/redox-os/orbdata)                              | [**@jackpot51**](https://github.com/jackpot51)
-| [orbital](https://github.com/redox-os/orbital)                              | [**@jackpot51**](https://github.com/jackpot51)
-| [orbtk](https://github.com/redox-os/orbtk)                                  | [**@stratact**](https://github.com/stratact)
-| [orbutils](https://github.com/redox-os/orbutils)                            | [**@jackpot51**](https://github.com/jackpot51)
-| [pkgutils (current package manager)](https://github.com/redox-os/pkgutils)  | [**@jackpot51**](https://github.com/jackpot51)
-| [playbot (internal REPL bot)](https://github.com/redox-os/platbot)          | [**@ticki**](https://github.com/ticki)
-| [ralloc](https://github.com/redox-os/ralloc)                                | [**@ticki**](https://github.com/ticki)
-| [redoxfs (old filesystem)](https://github.com/redox-os/redoxfs)             | [**@jackpot51**](https://github.com/jackpot51)
-| [syscall](https://github.com/redox-os/syscall)                              | [**@jackpot51**](https://github.com/jackpot51)
-| [userutils](https://github.com/redox-os/userutils)                          | [**@jackpot51**](https://github.com/jackpot51)
+See [Redox in Action](https://www.redox-os.org/screens/) for photos and videos.
 
-## <a name="compile-help"> Help! Redox won't compile! </a>
+<img alt="Redox" height="150" src="https://gitlab.redox-os.org/redox-os/website/-/raw/master/static/img/screenshot/orbital-visual.png">
+<img alt="Redox" height="150" src="https://gitlab.redox-os.org/redox-os/website/-/raw/master/static/img/screenshot/cosmic-programs.png">
+<img alt="Redox" height="150" src="https://gitlab.redox-os.org/redox-os/website/-/raw/master/static/img/screenshot/cosmic-term-screenfetch.png">
 
-Sometimes things go wrong when compiling. Try the following before opening an issue:
-
-1. Run `make clean`.
-2. Run `git clean -X -f -d`.
-3. Make sure you have **the latest version of Rust nightly!** ([rustup.rs](https://www.rustup.rs) is recommended for managing Rust versions).
-4. Update **GNU Make**, **NASM** and **QEMU/VirtualBox**.
-5. Pull the upstream master branch (`git remote add upstream git@github.com:redox-os/redox.git; git pull upstream master`).
-6. Update submodules (`git submodule update --recursive --init`).
-
-and then rebuild!
-
-## <a name="contributing"> Contributing to Redox </a>
-
-If you're interested in this project, and you'd like to help us out, [here](CONTRIBUTING.md) is a list of ways you can do just that.
-
-## <a name="cloning-building-running"> Cloning, Building, and Running </a>
-
-Redox is big (even compressed)! So cloning Redox takes a lot of bandwidth, and (depending on your data plan) can be costly, so clone at your own risk!
-
-### <a name="quick-setup" /> Quick Setup </a>
-
-```bash
-$ cd path/to/your/projects/folder/
-
-# Run bootstrap setup
-$ curl -sf https://raw.githubusercontent.com/redox-os/redox/master/bootstrap.sh -o bootstrap.sh && bash -e bootstrap.sh
-
-# Build Redox
-$ make all
-
-# Launch using QEMU
-$ make qemu
-# Launch using QEMU without using KVM (Kernel Virtual Machine). Try if QEMU gives an error.
-$ make qemu kvm=no
-```
-
-#### QEMU with KVM
-
-To use QEMU with KVM (kernel-based virtual Machine), which is faster than without KVM, you need a CPU with Intel® Virtualization Technology (Intel® VT) or AMD Virtualization™ (AMD-V™) support. Most systems have this disabled in the BIOS by default, so you may need to reboot and enable the feature in the BIOS.
-
-### <a name="manual-setup"> Manual Setup </a>
-
-To manually clone, build and run Redox using a Linux host, run the following commands (with exceptions, be sure to read the comments):
-```bash
-$ cd path/to/your/projects/folder/
-
-# HTTPS
-$ git clone https://github.com/redox-os/redox.git --origin upstream --recursive
-# SSH
-$ git clone git@github.com:redox-os/redox.git --origin upstream --recursive
-
-$ cd redox/
-
-# Install/update dependencies
-$ bash bootstrap.sh -d
-
-# Install rustup.rs
-$ curl https://sh.rustup.rs -sSf | sh
-
-# Set override toolchain to nightly build
-$ rustup override set nightly
-
-# For successive builds start here. If this is your first build, just continue
-
-# Update git submodules
-$ git submodule update --recursive --init
-
-# Build Redox
-$ make all
-
-# Launch using QEMU
-$ make qemu
-# Launch using QEMU without using KVM (Kernel Virtual Machine). Try if QEMU gives an error.
-$ make qemu kvm=no
-```
+<img alt="Redox" height="150" src="https://gitlab.redox-os.org/redox-os/website/-/raw/master/static/img/screenshot/cosmic-edit-redox.png">
+<img alt="Redox" height="150" src="https://gitlab.redox-os.org/redox-os/website/-/raw/master/static/img/screenshot/image-viewer.png">
+<img alt="Redox" height="150" src="https://gitlab.redox-os.org/redox-os/assets/raw/master/screenshots/Boot.png">

arch/arm/Cargo.toml

-[package]
-name = "arch_arm"
-version = "0.1.0"
-
-[dependencies]
-bitflags = "*"
-hole_list_allocator = { path = "../../crates/hole_list_allocator"}
-spin = "*"

arch/arm/src/context.rs

-#[derive(Debug)]
-pub struct Context;
-
-impl Context {
-    pub fn new() -> Self {
-        Context
-    }
-}
-

arch/arm/src/externs.rs

-/// Memcpy
-///
-/// Copy N bytes of memory from one location to another.
-#[no_mangle]
-pub unsafe extern fn memcpy(dest: *mut u8, src: *const u8,
-                            n: usize) -> *mut u8 {
-    let mut i = 0;
-    while i < n {
-        *dest.offset(i as isize) = *src.offset(i as isize);
-        i += 1;
-    }
-
-    dest
-}
-
-/// Memmove
-///
-/// Copy N bytes of memory from src to dest. The memory areas may overlap.
-#[no_mangle]
-pub unsafe extern fn memmove(dest: *mut u8, src: *const u8,
-                             n: usize) -> *mut u8 {
-    if src < dest as *const u8 {
-        let mut i = n;
-        while i != 0 {
-            i -= 1;
-            *dest.offset(i as isize) = *src.offset(i as isize);
-        }
-    } else {
-        let mut i = 0;
-        while i < n {
-            *dest.offset(i as isize) = *src.offset(i as isize);
-            i += 1;
-        }
-    }
-
-    dest
-}
-
-/// Memset
-///
-/// Fill a block of memory with a specified value.
-#[no_mangle]
-pub unsafe extern fn memset(s: *mut u8, c: i32, n: usize) -> *mut u8 {
-    let mut i = 0;
-    while i < n {
-        *s.offset(i as isize) = c as u8;
-        i += 1;
-    }
-
-    s
-}
-
-/// Memcmp
-///
-/// Compare two blocks of memory.
-#[no_mangle]
-pub unsafe extern fn memcmp(s1: *const u8, s2: *const u8, n: usize) -> i32 {
-    let mut i = 0;
-
-    while i < n {
-        let a = *s1.offset(i as isize);
-        let b = *s2.offset(i as isize);
-        if a != b {
-            return a as i32 - b as i32
-        }
-        i += 1;
-    }
-
-    0
-}

arch/arm/src/interrupt.rs

-//! Interrupt instructions
-
-/// Clear interrupts
-#[inline(always)]
-pub unsafe fn disable() {
-}
-
-/// Set interrupts
-#[inline(always)]
-pub unsafe fn enable() {
-}
-
-/// Set interrupts and halt
-#[inline(always)]
-pub unsafe fn enable_and_halt() {
-    halt();
-}
-
-/// Halt instruction
-#[inline(always)]
-pub unsafe fn halt() {
-    //asm!("wfi" : : : : "volatile");
-    asm!("nop" : : : : "volatile");
-}
-
-/// Get a stack trace
-//TODO: Check for stack being mapped before dereferencing
-#[inline(never)]
-pub unsafe fn stack_trace() {
-}

arch/arm/src/lib.rs

-//! Architecture support for ARM
-
-#![feature(asm)]
-#![feature(lang_items)]
-#![feature(naked_functions)]
-#![no_std]
-
-extern crate hole_list_allocator as allocator;
-#[macro_use]
-extern crate bitflags;
-extern crate spin;
-
-/// Print to console
-#[macro_export]
-macro_rules! print {
-    ($($arg:tt)*) => ({});
-}
-
-/// Print with new line to console
-#[macro_export]
-macro_rules! println {
-    ($fmt:expr) => (print!(concat!($fmt, "\n")));
-    ($fmt:expr, $($arg:tt)*) => (print!(concat!($fmt, "\n"), $($arg)*));
-}
-
-/// Context switching
-pub mod context;
-
-/// Memset, memcpy, etc.
-pub mod externs;
-
-/// Interrupt handling
-pub mod interrupt;
-
-/// Panic support
-pub mod panic;
-
-/// Initialization function
-pub mod start;

arch/arm/src/linker.ld

-ENTRY(kstart)
-OUTPUT_ARCH(arm)
-OUTPUT_FORMAT(elf32-littlearm)
-
-KERNEL_OFFSET = 0;
-
-SECTIONS {
-    . = KERNEL_OFFSET;
-
-    .text : AT(ADDR(.text) - KERNEL_OFFSET) {
-        __text_start = .;
-        *(.text*)
-	. = ALIGN(4096);
-        __text_end = .;
-    }
-
-	.rodata : AT(ADDR(.rodata) - KERNEL_OFFSET) {
-        __rodata_start = .;
-        *(.rodata*)
-	. = ALIGN(4096);
-        __rodata_end = .;
-    }
-
-    .data : AT(ADDR(.data) - KERNEL_OFFSET) {
-        __data_start = .;
-        *(.data*)
-	. = ALIGN(4096);
-        __data_end = .;
-    }
-
-    .tdata : AT(ADDR(.tdata) - KERNEL_OFFSET) {
-        __tdata_start = .;
-        *(.tdata*)
-        . = ALIGN(4096);
-        __tdata_end = .;
-        __tbss_start = .;
-        *(.tbss*)
-        . += 8;
-        . = ALIGN(4096);
-        __tbss_end = .;
-    }
-
-    .bss : AT(ADDR(.bss) - KERNEL_OFFSET) {
-        __bss_start = .;
-        *(.bss*)
-        . = ALIGN(4096);
-        __bss_end = .;
-    }
-
-    __end = .;
-
-    /DISCARD/ : {
-        *(.comment*)
-        *(.debug*)
-        *(.eh_frame*)
-        *(.gcc_except_table*)
-        *(.note*)
-        *(.rel.eh_frame*)
-    }
-}

arch/arm/src/panic.rs

-//! Intrinsics for panic handling
-
-use interrupt;
-
-#[cfg(not(test))]
-#[lang = "eh_personality"]
-extern "C" fn eh_personality() {}
-
-#[cfg(not(test))]
-/// Required to handle panics
-#[lang = "panic_fmt"]
-extern "C" fn panic_fmt(fmt: ::core::fmt::Arguments, file: &str, line: u32) -> ! {
-    println!("PANIC: {}", fmt);
-    println!("FILE: {}", file);
-    println!("LINE: {}", line);
-
-    unsafe { interrupt::stack_trace(); }
-
-    println!("HALT");
-    loop {
-        unsafe { interrupt::halt(); }
-    }
-}
-
-#[allow(non_snake_case)]
-#[no_mangle]
-/// Required to handle panics
-pub extern "C" fn _Unwind_Resume() -> ! {
-    loop {
-        unsafe { interrupt::halt(); }
-    }
-}
-
-/// Required for linker
-#[no_mangle]
-pub extern "C" fn __aeabi_unwind_cpp_pr0() {
-    loop {}
-}

arch/arm/src/start.rs

-const SERIAL_BASE: *mut u8 = 0x16000000 as *mut u8;
-const SERIAL_FLAG_REGISTER: *const u8 = 0x16000018 as *const u8;
-const SERIAL_BUFFER_FULL: u8 =  (1 << 5);
-
-unsafe fn putc (c: u8)
-{
-    /* Wait until the serial buffer is empty */
-    while *SERIAL_FLAG_REGISTER & SERIAL_BUFFER_FULL == SERIAL_BUFFER_FULL {}
-
-    /* Put our character, c, into the serial buffer */
-    *SERIAL_BASE = c;
-}
-
-unsafe fn puts(string: &str)
-{
-    for b in string.bytes() {
-        putc(b);
-    }
-}
-
-#[no_mangle]
-#[naked]
-pub unsafe extern fn kstart() -> ! {
-    asm!("mov sp, 0x18000" : : : : "volatile");
-    puts("TEST\r\n");
-    loop {}
-}