{"id":16948634,"url":"https://github.com/dentosal/rust_os","last_synced_at":"2025-03-22T13:31:10.444Z","repository":{"id":83101266,"uuid":"50018244","full_name":"Dentosal/rust_os","owner":"Dentosal","description":"My hobby operating system microkernel written in Rust","archived":false,"fork":false,"pushed_at":"2023-02-27T02:24:59.000Z","size":1107,"stargazers_count":44,"open_issues_count":0,"forks_count":7,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-18T11:38:47.629Z","etag":null,"topics":["hobby-project","microkernel","operating-system","osdev","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Dentosal.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-01-20T09:09:39.000Z","updated_at":"2025-02-07T10:38:51.000Z","dependencies_parsed_at":null,"dependency_job_id":"1aa45d48-54bb-4364-8038-5eb88442b44a","html_url":"https://github.com/Dentosal/rust_os","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dentosal%2Frust_os","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dentosal%2Frust_os/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dentosal%2Frust_os/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dentosal%2Frust_os/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Dentosal","download_url":"https://codeload.github.com/Dentosal/rust_os/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244962788,"owners_count":20539225,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hobby-project","microkernel","operating-system","osdev","rust"],"created_at":"2024-10-13T21:51:44.507Z","updated_at":"2025-03-22T13:31:10.402Z","avatar_url":"https://github.com/Dentosal.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# D7 operating system ![build status](https://github.com/Dentosal/rust_os/actions/workflows/ci.yml/badge.svg?branch=master)\n\nOperating system for modern x86-64 computers, written in Rust.\n\n## Current features:\n* Multitasking: tickless event-driven round-robin scheduler\n* Executable programs, in ELF format\n* IPC: PubSub messaging and named pipes\n* Keyboard input\n* Virtual TTYs\n* Disk IO:\n    * ATA PIO\n    * VirtIO-blk (Read only)\n* Networking:\n    * Drivers for NE2000 and RTL8139\n    * IPv4 stack, supporting TCP, UDP, DNS, DHCP, ARP\n* Services\n    * Serviced - startup and service status queries\n    * Netd - Manages network interfaces and sockets\n\n## Roadmap items:\n* Shell\n* Virtual filesystem\n* Automated test suite\n* Porting software\n    * Shell utilities\n    * Text editor\n    * Compilers\n    * Self-hosting\n* (Better) support for...\n    * Filesystems:\n        * ramfs\n        * ext2\n        * some network filesystem, possibly a custom one\n    * NICs:\n        * Intel E1000 driver\n        * VirtIO-net driver\n    * USB and Audio devices\n\n\n# Development\n\nThis is a learning project. Currently code contributions are not accepted, as I'd like to learn to fix the problems myself. Forking the project is of course possible, if you'd like to develop something based on this.\nFeel free to submit issues on GitHub if you find any bugs.\n\n# Compiling and Running\n\nThe project is using Vagrant to virtualize the building environment. While being a little slower, this means that building the system on any supported platform should Just Work™. If you have a Unix-like system, install Qemu and\n\n```bash\ngit clone https://github.com/Dentosal/rust_os.git \u0026\u0026 cd rust_os \u0026\u0026 ./autobuild.sh -ug\n```\n\nSometimes shared folder feature will not work, and you get an error message about missing `/vagrant` etc. In that case installing vbguest plugin should help:\n\n```bash\nvagrant plugin install vagrant-vbguest\n```\n\n\nIf you don't have a Unix-like system, then you should probably get one, they are pretty awesome compared to old DOS systems or [Dentosal/rust_os](https://github.com/Dentosal/rust_os/). However, building on WSL is also possible. Just install the required tools (see [Vagrantfile](Vagrantfile)), and the run `./autobuild.sh -n`\n\n## Dependencies\n\nBuilding with default automated build system required that Vagrant is installed. I use VirtualBox as my Vagrant provider, but [other providers](https://www.vagrantup.com/docs/providers/) should work as well.\n\nVagrant isn't actually required: on systems with apt, like Debian or Ubuntu, it should be reasonably easy to just install the dependencies by hand. The install script can be found from `Vagrantfile`.\n\nYou will also need a virtual machine. Qemu is suggested, but Bochs should work as well. VirtualBox can also be used, but the project isn't actively tested with it. Moreover, you must run it yourself.\n\n## Actually running\n\nWith Qemu and Vagrant installed, run `./autobuild.sh -ug`. With Bochs: `./autobuild.sh -ugb`. To use VirtualBox, run `./autobuild.sh -ugv`.\n\n## Local development without Vagrant\n\n```bash\ncargo fmt \u0026\u0026 ./autobuild.sh\n```\n\n# License\nThis project is licensed under the MIT license, which can be found in the file called LICENSE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdentosal%2Frust_os","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdentosal%2Frust_os","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdentosal%2Frust_os/lists"}