blog_os - GitLite

KO | EN

gitlite — search

#react #typescript #go #android #rust #linux #docker #nodejs #macos #windows #kubernetes #vue #ios #mcp

blog_os

(★ 17,669)

Writing an OS in Rust

File Explorer

Download Latest Version (.zip)

- - blog.yml
  - check-links.yml
  - scheduled-builds.yml
- FUNDING.yml
- - _index.ar.md
  - _index.es.md
  - _index.fa.md
  - _index.fr.md
  - _index.ja.md
  - _index.ko.md
  - _index.md
  - _index.pt-BR.md
  - _index.ru.md
  - _index.tr.md
  - _index.zh-CN.md
  - _index.zh-TW.md
  - LICENSE-CC-BY-NC
  - README.md
- - red-zone-overwrite.dia
  - red-zone.dia
  - x86_64-page-table-translation-addresses.svg
  - xmm-overwrite.dia
- - CNAME
  - favicon.ico
  - handling-exceptions-with-naked-fns.html
- - 404.html
  - base.html
  - index.html
  - news-page.html
  - news-section.html
  - plain.html
  - redirect-to-frontpage.html
  - rss.xml
  - section.html
  - snippets.html
  - status-update-page.html
  - status-update-section.html
- .gitignore
- before_build.py
- config.toml
- requirements.txt
- typos.toml
- .bash_aliases
- Dockerfile
- entrypoint.sh
- README.md
- merge.fish
- push.fish
.gitignore
giscus.json
LICENSE-APACHE
LICENSE-MIT
README.md

# Installation Guide

1. Get the code

git clone https://github.com/phil-opp/blog_os

Downloads the entire project code from GitHub to your computer.

cd blog_os

Moves into the project folder you just downloaded.

2. Docker

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Docker Desktop Needed to build and run containers. Install it and keep it running in the background.

docker build -f docker/Dockerfile -t blog-os .

Builds a runnable image based on the Dockerfile.

docker run -p 8080:80 blog-os

Runs the built image as an actual container.

✅ Run docker compose ps to check the containers are Up. If the README mentions a port, open http://localhost:PORT in your browser.

3. Python

Easy

Prerequisites

Git Needed to download the project code from GitHub.
Python 3 On Windows, be sure to check 'Add Python to PATH' during installation.

pip install -r blog/requirements.txt

Installs the Python libraries listed in requirements.txt (or similar).

python <실행할 파일명>.py # README에서 정확한 실행 파일명을 확인하세요

Runs the Python script (or module).

✅ If it runs without errors and prints output in the terminal, it worked.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Blog OS

This repository contains the source code for the _Writing an OS in Rust_ series at [os.phil-opp.com](https://os.phil-opp.com).

If you have questions, open an issue or chat with us [on Gitter](https://gitter.im/phil-opp/blog_os).

## Where is the code?

The code for each post lives in a separate git branch. This makes it possible to see the intermediate state after each post.

**The code for the latest post is available [here][latest-post].**

[latest-post]: https://github.com/phil-opp/blog_os/tree/post-12

You can find the branch for each post by following the `(source code)` link in the [post list](#posts) below. The branches are named `post-XX` where `XX` is the post number, for example `post-03` for the _VGA Text Mode_ post or `post-07` for the _Hardware Interrupts_ post. For build instructions, see the Readme of the respective branch.

You can check out a branch in a subdirectory using [git worktree]:

[git worktree]: https://git-scm.com/docs/git-worktree

```
git worktree add code post-10
```

The above command creates a subdirectory named `code` that contains the code for the 10th post ("Heap Allocation").

## Posts

The goal of this project is to provide step-by-step tutorials in individual blog posts. We currently have the following set of posts:

**Bare Bones:**

- [A Freestanding Rust Binary](https://os.phil-opp.com/freestanding-rust-binary/)
    ([source code](https://github.com/phil-opp/blog_os/tree/post-01))
- [A Minimal Rust Kernel](https://os.phil-opp.com/minimal-rust-kernel/)
    ([source code](https://github.com/phil-opp/blog_os/tree/post-02))
- [VGA Text Mode](https://os.phil-opp.com/vga-text-mode/)
    ([source code](https://github.com/phil-opp/blog_os/tree/post-03))
- [Testing](https://os.phil-opp.com/testing/)
    ([source code](https://github.com/phil-opp/blog_os/tree/post-04))

**Interrupts:**

- [CPU Exceptions](https://os.phil-opp.com/cpu-exceptions/)
    ([source code](https://github.com/phil-opp/blog_os/tree/post-05))
- [Double Faults](https://os.phil-opp.com/double-fault-exceptions/)
    ([source code](https://github.com/phil-opp/blog_os/tree/post-06))
- [Hardware Interrupts](https://os.phil-opp.com/hardware-interrupts/)
    ([source code](https://github.com/phil-opp/blog_os/tree/post-07))

**Memory Management:**

- [Introduction to Paging](https://os.phil-opp.com/paging-introduction/)
    ([source code](https://github.com/phil-opp/blog_os/tree/post-08))
- [Paging Implementation](https://os.phil-opp.com/paging-implementation/)
    ([source code](https://github.com/phil-opp/blog_os/tree/post-09))
- [Heap Allocation](https://os.phil-opp.com/heap-allocation/)
    ([source code](https://github.com/phil-opp/blog_os/tree/post-10))
- [Allocator Designs](https://os.phil-opp.com/allocator-designs/)
    ([source code](https://github.com/phil-opp/blog_os/tree/post-11))

**Multitasking**:

- [Async/Await](https://os.phil-opp.com/async-await/)
    ([source code](https://github.com/phil-opp/blog_os/tree/post-12))

## First Edition Posts

The current version of the blog is already the second edition. The first edition is outdated and no longer maintained, but might still be useful. The posts of the first edition are:

<details><summary><i>Click to expand</i></summary>

**Bare Bones:**

- [A Minimal x86 Kernel](https://os.phil-opp.com/multiboot-kernel.html)
      ([source code](https://github.com/phil-opp/blog_os/tree/first_edition_post_1))
- [Entering Long Mode](https://os.phil-opp.com/entering-longmode.html)
      ([source code](https://github.com/phil-opp/blog_os/tree/first_edition_post_2))
- [Set Up Rust](https://os.phil-opp.com/set-up-rust.html)
      ([source code](https://github.com/phil-opp/blog_os/tree/first_edition_post_3))
- [Printing to Screen](https://os.phil-opp.com/printing-to-screen.html)
      ([source code](https://github.com/phil-opp/blog_os/tree/first_edition_post_4))

**Memory Management:**

- [Allocating Frames](https://os.phil-opp.com/allocating-frames.html)
      ([source code](https://github.com/phil-opp/blog_os/tree/first_edition_post_5))
- [Page Tables](https://os.phil-opp.com/modifying-page-tables.html)
      ([source code](https://github.com/phil-opp/blog_os/tree/first_edition_post_6))
- [Remap the Kernel](https://os.phil-opp.com/remap-the-kernel.html)
      ([source code](https://github.com/phil-opp/blog_os/tree/first_edition_post_7))
- [Kernel Heap](https://os.phil-opp.com/kernel-heap.html)
      ([source code](https://github.com/phil-opp/blog_os/tree/first_edition_post_8))

**Exceptions:**

- [Handling Exceptions](https://os.phil-opp.com/handling-exceptions.html)
      ([source code](https://github.com/phil-opp/blog_os/tree/first_edition_post_9))
- [Double Faults](https://os.phil-opp.com/double-faults.html)
      ([source code](https://github.com/phil-opp/blog_os/tree/first_edition_post_10))

**Additional Resources:**

- [Cross Compile Binutils](https://os.phil-opp.com/cross-compile-binutils.html)
- [Cross Compile libcore](https://os.phil-opp.com/cross-compile-libcore.html)
- [Set Up GDB](https://os.phil-opp.com/set-up-gdb)
- [Handling Exceptions using Naked Functions](https://os.phil-opp.com/handling-exceptions-with-naked-fns.html)
    - [Catching Exceptions](https://os.phil-opp.com/catching-exceptions.html)
          ([source code](https://github.com/phil-opp/blog_os/tree/catching_exceptions))
    - [Better Exception Messages](https://os.phil-opp.com/better-exception-messages.html)
          ([source code](https://github.com/phil-opp/blog_os/tree/better_exception_messages))
    - [Returning from Exceptions](https://os.phil-opp.com/returning-from-exceptions.html)
          ([source code](https://github.com/phil-opp/blog_os/tree/returning_from_exceptions))

</details>

## License

This project, with exception of the `blog/content` folder, is licensed under either of

- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or
  https://www.apache.org/licenses/LICENSE-2.0)
- MIT license ([LICENSE-MIT](LICENSE-MIT) or https://opensource.org/licenses/MIT)

at your option.

For licensing of the `blog/content` folder, see the [`blog/content/README.md`](blog/content/README.md).

### Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.