Skip to content

Windows_Build.md

Latest commit

 

History

History
55 lines (51 loc) · 2.26 KB

Windows_Build.md

File metadata and controls

55 lines (51 loc) · 2.26 KB
Raw

Welcome to the Windows build instructions

Important

It is always wise to verify script contents before running

Important

If for some reason powershell gives you an error indicating that running scripts are disabled on this system, you can solve this by running the script in the following manner powershell -ExecutionPolicy Bypass -File scripts\script.ps1

# 1. Clone the repo with depth 1 (we dont need the git history here)
$ git clone https://github.com/rfmineguy/2024_barebones_os.git --depth=1
# 2. Retrieve and setup the docker image require to build this project
#  - This step requires docker to be installed
#  - This step also pulls down and generates an image that is around 1GB in size
$ .\scripts\build.ps1 docker_get 
# 3. Create fat drive to mount in qemu and use as the active drive for the kernel's operations
#  - This step isn't technically mandatory, but the kernel does a lot more if you do this step
$ .\scripts\build.ps1 create_disk
# 4. Build the iso file
#  - This step uses the previously built docker image and the software installed
#      to it to build the c source files with a i686-elf cross compiler toolchain
$ .\scripts\build.ps1 build
# 5. Verify that the iso file is multiboot1 compatible (multiboot2 might be in the future) 
#  - If this indicates that its not multiboot compatible, I broke something (oops)
#  - This step uses the previously built docker image and the software installed
#      to it to check if the generated iso image contains valid multiboot headers
$ .\scripts\build.ps1 checkmboot
# 6. Finally run the kernel in qemu
#  - This step uses qemu-sysstem-i386 to run the kernel iso
#  - The i686 and i386 architectures are mostly compatible with each other
$ .\scripts\build.ps1 qemu

Bonus

So the filesystem is created on the host machine, which means we can add more files to it during the build phase. To do this you need to edit scripts/debian.Makefile

1. Look for the section titled `create_fat_fs` 
2. Add a new `mcopy` where you replace the `fatfiles/name.txt` with your file and replace `"::name.txt"` with your filename
    a. Note: It's important that this new line is formatted as such
       mcopy -i out/main.img fatfiles/new.txt "::new.txt"