nuclear@4: Article 1 source code
nuclear@4: ---------------------
nuclear@1: Author: John Tsiombikas <nuclear@member.fsf.org>
nuclear@4: 
nuclear@4: License: GNU GPL v3 or any later version published by the free software
nuclear@4:     foundation. See COPYING for details.
nuclear@4: 
nuclear@4: About
nuclear@4: -----
nuclear@4: This is the supplemental source code for the first part of the introduction to
nuclear@4: kernel development articles. It deals with booting up from a multiboot-compliant
nuclear@4: boot loader and using the VGA for text output.
nuclear@4: 
nuclear@4: Compiling & Running
nuclear@4: -------------------
nuclear@4: To compile kernel image (kernel.elf) just type make (or gmake, if your default
nuclear@4: make tool is not GNU make). A script called "run" is supplied that will use qemu
nuclear@4: to run the kernel in a virtual machine.
nuclear@4: 
nuclear@4: If you wish to boot up the kernel on your computer you need a multiboot
nuclear@4: compliant boot loader like GRUB. Since you probably already have GRUB installed
nuclear@4: if you're running a GNU/Linux distribution, just add an entry to the GRUB config
nuclear@4: file (commonly /boot/grub/menu.lst) similar to this one and reboot:
nuclear@4: 
nuclear@4: title My kernel
nuclear@4: root (hdX,Y)  # where X is the disk number and Y the partition (first being 0)
nuclear@4: kernel /path/to/kernel_code/kernel.elf    # change this to the actual path
nuclear@4: 
nuclear@4: In case you are using GRUB 2 instead of the original GRUB, you'll have to
nuclear@4: consult the documentation on how to modify the above into the GRUB 2 syntax.
nuclear@4: 
nuclear@4: Disclaimer
nuclear@4: ----------
nuclear@4: All programs contain bugs, and this sample code will undoubtedly have its share.
nuclear@4: Running buggy kernel code on the real machine is very dangerous and may result
nuclear@4: in data loss or even damage to your computer in extreme cases. The author
nuclear@4: assumes no responsibility for any such eventuality. Run this code on your
nuclear@4: computer at your own risk.
nuclear@4: 
nuclear@4: Contact
nuclear@4: -------
nuclear@4: For any comments or suggestions regarding the articles or this supplemental
nuclear@4: code, please contact me at nuclear@member.fsf.org