Initial import from FreeBSD RELENG_4:
[dragonfly.git] / sys / i386 / boot / dosboot / readme
1 Hi Everybody!\r
2 \r
3 This is version 1.5 of "fbsdboot", a program that allows you to boot a kernel\r
4 from a MS-DOS partition or a FreeBSD partition. This program runs using DOS.\r
5 It works with various memory managers (like  EMM386, 386MAX) under certain\r
6 circumstances.\r
7 \r
8 First, a FreeBSD kernel is always loaded to memory starting at 0x100000. To\r
9 assure that loading the kernel *does not* overwrite memory used by memory\r
10 managers, high memory for the kernel is allocated and after loading the kernel\r
11 it's moved to 0x100000.\r
12 \r
13 Second, there are many ways to switch to protected mode which is necessary to\r
14 start the kernel. Each BIOS gives you the possibility to use INT15H (AH=89H)\r
15 to do that. But some memory-managers like 386max does not allow you to use\r
16 this method.\r
17 \r
18 An other way to do the switch is to use DPMI services, but they do not\r
19 guarantee, that the protected mode application is executed with privilege\r
20 level 0. Therefore this method is *not* used.\r
21 \r
22 VCPI services offer another way to switch to protected mode, and VCPI servers\r
23 are built into "emm386.exe", "386max" and "qemm". That's why, this method is\r
24 implemented in fbsdboot.exe.\r
25 \r
26 Fbsdboot.exe tries to switch to protected mode using VCPI services. If they're\r
27 not available INT15H is used to do the switch. If that fails, it's not possible\r
28 for this version of fbsdboot.exe to boot a kernel :-(.\r
29 \r
30 You can get commandline options of fbsdboot if you start it with "-?" as option!\r
31 \r
32 I don't know, if fbsdboot works with QEMM, as I don't have the possibility to\r
33 test it.\r
34 \r
35 Enjoy and have fun!\r
36 \r
37 Christian.\r
38 cg@fimp01.fim.uni-linz.ac.at\r
39 \r
40 \r
41 PS: Many thanks to Bruce Evans for his assistance!\r