1 Article 1 source code

2 ---------------------

3 Author: John Tsiombikas <nuclear@member.fsf.org>

4

5 License: GNU GPL v3 or any later version published by the free software

6 foundation. See COPYING for details.

7

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.

13

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.

19

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:

24

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

28

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.

31

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.

39

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