2 Copyright (C) 2000, Entity Cyber, Inc.
4 Authors: Gary Byers (gb@thinguin.org)
5 Marty Connor (mdc@thinguin.org)
7 This software may be used and distributed according to the terms
8 of the GNU Public License (GPL), incorporated herein by reference.
12 This is just a little bit of code and data that can get prepended
13 to a ROM image in order to allow bootloaders to load the result
14 as if it were a Linux kernel image.
16 A real Linux kernel image consists of a one-sector boot loader
17 (to load the image from a floppy disk), followed a few sectors
18 of setup code, followed by the kernel code itself. There's
19 a table in the first sector (starting at offset 497) that indicates
20 how many sectors of setup code follow the first sector and which
21 contains some other parameters that aren't interesting in this
24 When a bootloader loads the sectors that comprise a kernel image,
25 it doesn't execute the code in the first sector (since that code
26 would try to load the image from a floppy disk.) The code in the
27 first sector below doesn't expect to get executed (and prints an
28 error message if it ever -is- executed.)
30 We don't require much in the way of setup code. Historically, the
31 Linux kernel required at least 4 sectors of setup code.
32 Therefore, at least 4 sectors must be present even though we don't
37 FILE_LICENCE ( GPL_ANY )
39 #define SETUPSECS 4 /* Minimal nr of setup-sectors */
40 #define PREFIXSIZE ((SETUPSECS+1)*512)
41 #define PREFIXPGH (PREFIXSIZE / 16 )
42 #define BOOTSEG 0x07C0 /* original address of boot-sector */
43 #define INITSEG 0x9000 /* we move boot here - out of the way */
44 #define SETUPSEG 0x9020 /* setup starts here */
45 #define SYSSEG 0x1000 /* system loaded at 0x10000 (65536). */
51 .section ".prefix", "ax", @progbits
53 This is a minimal boot sector. If anyone tries to execute it (e.g., if
54 a .lilo file is dd'ed to a floppy), print an error message.
58 jmp $BOOTSEG, $1f /* reload cs:ip to match relocation addr */
60 movw $0x2000, %di /* 0x2000 is arbitrary value >= length
61 of bootsect + room for stack */
68 movw %ax, %ss /* put stack at BOOTSEG:0x2000. */
72 movw $why_end-why, %cx
75 movw $0x0007, %bx /* page 0, attribute 7 (normal) */
76 movb $0x0e, %ah /* write char, tty mode */
83 why: .ascii "This image cannot be loaded from a floppy disk.\r\n"
88 The following header is documented in the Linux source code at
89 Documentation/x86/boot.txt
99 .section ".zinfo.fixup", "a", @progbits /* Compressor fixups */
115 /* Manually specify a two-byte jmp instruction here rather
116 * than leaving it up to the assembler. */
118 .byte setup_code - header
120 .byte 'H', 'd', 'r', 'S'
122 .word 0x0207 /* 2.07 */
150 /* We don't use an initrd but some bootloaders (e.g. SYSLINUX) have
151 * been known to require this field. Set the value to 2 GB. This
152 * value is also used by the Linux kernel. */
164 hardware_subarch_data:
165 .byte 0, 0, 0, 0, 0, 0, 0, 0
168 We don't need to do too much setup.
170 This code gets loaded at SETUPSEG:0. It wants to start
171 executing the image that's loaded at SYSSEG:0 and
172 whose entry point is SYSSEG:0.
175 /* We expect to be contiguous in memory once loaded. The Linux image
176 * boot process requires that setup code is loaded separately from
177 * "non-real code". Since we don't need any information that's left
178 * in the prefix, it doesn't matter: we just have to ensure that
179 * %cs:0000 is where the start of the image *would* be.
181 ljmp $(SYSSEG-(PREFIXSIZE/16)), $run_gpxe
186 We're now at the beginning of the kernel proper.
189 /* Set up stack just below 0x7c00 */
197 /* Set up real-mode stack */
201 /* Jump to .text16 segment */
205 .section ".text16", "awx", @progbits
210 popl %ecx /* discard */
215 /* Boot next device */