Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.
This is the official repository of the LibertyOS kernel. LibertyOS is an operating system, built with Rust, that is open-source, free-to-use, and open to new contributors. Everything in LOS is, or will be, built from scratch. Currently, LOS supports x86_64 systems, and can be booted on real hardware, using a simple bootloader. This operating system is being worked on continuously, and all changes are logged in the VERSIONHISTORY.md file (in the root directory of this repository). If you want to see a more detailed explanation of changes between versions, you can read the commits on the GitHub repository.
How to Contribute
Would you like to help make this kernel even better? We have plenty of things that need to be done, and we could always use help doing them! There is a folder in this repository (called "ideas") which contains different files that explain an idea for the kernel. If you have a new idea, simply create a new file within the ideas folder, submit a pull request, and one of us will merge your idea into the main branch. There are a lot of great features being worked on right now, and we could use as many talented developers as we can get!
Blog
As of August 22, 2022, there is a blog file (BLOG.md). This will explain some of the design decisions that are made, some of the issues in development, and what to expect in the near future. LibertyOS is not dead. There is a bright future ahead for this project.
Building/Running LibertyOS
- Clone this repository.
- Navigate to the location that you cloned this repository to.
- Ensure you have installed the following:
- cURL
- QEMU
- Run the bootstrap script (./bootstrap.sh)
- Compile the kernel with "cargo build --release", or run the kernel in QEMU, using "cargo run --release".
CURRENTLY IMPLEMENTED FEATURES
- Support for x86-64 architecture
- Support for Rust's core and alloc crates
- Memory allocation, using linked-lists, buddy-allocation, and bump-allocation
- Basic error-handling
- Built-in support for running LOS with QEMU
- Support for several keyboard layouts
- Basic support for asynchronous functions, including a basic task-executor
- Support for reading/writing to filesystems (support for specific filesystems has yet to be implemented, but the foundations have been implemented already)
- Uses a core library, built for LibertyOS (libcore)
- Supports mathematical calculations, including basic algebra, geometry, etc.
- Support for C-types
- Basic support for parsing fonts
- Time-keeping
- System-calls
- Basic process-management
- Support for stdin, stdout, and stderr
- Basic support for running processes in userspace
WIP FEATURES
- A basic filesystem, built for LibertyOS
- Full documentation for the entire kernel
- Full support for reading/writing to FAT filesystems
- Basic networking capabilities
- Support for computer mice
- A basic shell
PLANNED FEATURES
- Support for ARM-based targets
- Support for glibc/musl (or, perhaps, rewriting certain parts of them)
- Support for FAT, FAT32, EXFAT filesystems
- Support for ext2, ext3, ext4 filesystems
- Support for NTFS filesystem
- Hostnames
- Ability to update the kernel from within the operating system
- Support for non-English characters
- Full support for Unicode
- Basic customization
CURRENTLY EXPECTED BEHAVIOUR
- The kernel initializes the critical portions of LibertyOS
- The kernel displays a message about the setup process
- The kernel encounters a page-fault. :(