1
2This directory contains some "host tools" that may be useful for
3porting CFE.
4
5MKBOOTIMAGE
6-----------
7
8The 'mkbootimage' program is used to attach a CFE boot block to
9an image file.  Boot blocks are used on block-structured devices
10such as disks and CD-ROM.
11
12The boot block contains information to help CFE locate the boot
13loader program and verify its validity.  To create boot file,
14link your boot loader to be executable within CFE's boot
15environment (it should be a binary file, not an ELF file).
16
17Convert the file to a boot block using:
18
19	mkbootimage [-EB] [-EL] myfile.elf myfile.boot
20
21Supply the -EB or -EL switch to configure the target endianness,
22since the values in the boot block are endian-specific.
23
24
25INSTALLBOOT
26-----------
27
28Once you have a boot file, the 'installboot' program can 
29insert the boot file into a simulated disk file (such as the
30file that you can use with the IDE emulation in the 
31BCM12500's functional simulator).  The 'installboot' program
32installs your boot file into a disk image file starting at 
33the first sector, preserving the beginning part of the boot
34sector where the the boot block lives.
35
36Install the boot block using:
37
38	installboot myfile.boot my_disk_image.dsk
39
40Where the "my_disk_image.dsk" is the simulated disk file for
41the functional simulator.
42
43installboot could probably be ported to the target OS to
44install boot blocks on raw disk devices.
45
46
47
48
49
50