kern

view README @ 6:7e40f14617ed

forgot to add stdarg.h and stdlib.c
author John Tsiombikas <nuclear@member.fsf.org>
date Thu, 13 Jan 2011 20:24:10 +0200
parents ebe5e0e44a9d
children b4264d173aae
line source
1 Article 1 source code
2 ---------------------
3 Author: John Tsiombikas <nuclear@member.fsf.org>
5 License: GNU GPL v3 or any later version published by the free software
6 foundation. See COPYING for details.
8 About
9 -----
10 This is the supplemental source code for the first part of the introduction to
11 kernel development articles. It deals with booting up from a multiboot-compliant
12 boot loader and using the VGA for text output.
14 Compiling & Running
15 -------------------
16 To compile kernel image (kernel.elf) just type make (or gmake, if your default
17 make tool is not GNU make). A script called "run" is supplied that will use qemu
18 to run the kernel in a virtual machine.
20 If you wish to boot up the kernel on your computer you need a multiboot
21 compliant boot loader like GRUB. Since you probably already have GRUB installed
22 if you're running a GNU/Linux distribution, just add an entry to the GRUB config
23 file (commonly /boot/grub/menu.lst) similar to this one and reboot:
25 title My kernel
26 root (hdX,Y) # where X is the disk number and Y the partition (first being 0)
27 kernel /path/to/kernel_code/kernel.elf # change this to the actual path
29 In case you are using GRUB 2 instead of the original GRUB, you'll have to
30 consult the documentation on how to modify the above into the GRUB 2 syntax.
32 Disclaimer
33 ----------
34 All programs contain bugs, and this sample code will undoubtedly have its share.
35 Running buggy kernel code on the real machine is very dangerous and may result
36 in data loss or even damage to your computer in extreme cases. The author
37 assumes no responsibility for any such eventuality. Run this code on your
38 computer at your own risk.
40 Contact
41 -------
42 For any comments or suggestions regarding the articles or this supplemental
43 code, please contact me at nuclear@member.fsf.org