d/bond
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Update ReadME.txt

Browse Source
This commit is contained in:
secXsQuared 2018-02-13 13:29:45 -05:00 committed by GitHub
parent 9256f5b575
commit 142d30cea2
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 34 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
ReadME.txt
View File

@ -1,3 +1,35 @@
My Hobby OS kernel.
My Hobby x86-64 OS kernel.
The main purpose is to understand OS kernel design choices and develop reverse-engineering experiences - stick to the assembly debugger.
# Building and Debugging Guide
## Environment
Any Linux distribution / Bash for Windows + GCC cross compiler.
## Required packages
To compile the kernel, the following modules are required on linux system, please install these:
nasm, xorriso, grub-common, grub-pc-bin
## Cross-compiler
### Method 1 - Compile one yourself.
Just follow the instructions here: https://wiki.osdev.org/GCC_Cross-Compiler
Remember to set the "TARGET" to x86_64-elf instead of i686-elf and build libgcc without redzone https://wiki.osdev.org/Libgcc_without_red_zone.
### Method 2 - Precompiled binaries
Here is my precompiled cross compiler. Feel free to use it.
VERSION: GCC 7.3 + Binutils 2.30
HOST: x86_64-pc-linux-gnu
CONFIGURED WITH: --target=x86_64-elf --disable-nls --enable-languages=c,c++ --without-headers
1. Download "cross.tar.gz" from https://drive.google.com/file/d/1ssQblBLk7I3ZqFPoeViVlsBvDMXcJFa1/view?usp=sharing
2. Run "tar -xvf cross.tar.gz -C $HOME/opt/cross"
## Compilation
Run "make all" in the root directory
The makefile generates secxkrnl.iso (kernel image), secxkrnl.elf(kernel executable), secxkrnl.dmp(kernel disassembly) at the end.
To clean all generated files, run "make clean"
## Running
On windows run "qemu.bat"
On linux run "./qemu.bat"