source: MondoRescue/branches/stable/mindi-busybox/examples/bootfloppy/bootfloppy.txt @ 1770

Last change on this file since 1770 was 1770, checked in by Bruno Cornec, 12 years ago
  • Better output for mindi-busybox revision
  • Remove dummy file created on NFS - report from Arnaud Tiger <arnaud.tiger_at_hp.com>
  • strace useful for debug
  • fix new versions for pb (2.0.0 for mindi and 1.7.2 for mindi-busybox)
  • fix build process for mindi-busybox + options used in that version (dd for label-partitions-as-necessary)
  • fix typo in label-partitions-as-necessary which doesn't seem to work
  • Update to busybox 1.7.2
  • perl is now required at restore time to support uuid swap partitions (and will be used for many other thigs

in the future for sure)

  • next mindi version will be 2.0.0 due to all the changes made in it (udev may break working distros)
  • small optimization in mindi on keyboard handling (one single find instead of multiple)
  • better interaction for USB device when launching mindi manually
  • attempt to automatically guess block disk size for ramdisk
  • fix typos in bkphw
  • Fix the remaining problem with UUID support for swap partitions
  • Updates mondoarchive man page for USB support
  • Adds preliminary Hardware support to mindi (Proliant SSSTK)
  • Tries to add udev support also for rhel4
  • Fix UUID support which was still broken.
  • Be conservative in test for the start-nfs script
  • Update config file for mindi-busybox for 1.7.2 migration
  • Try to run around a busybox bug (1.2.2 pb on inexistant links)
  • Add build content for mindi-busybox in pb
  • Remove distributions content for mindi-busybox
  • Fix a warning on inexistant raidtab
  • Solve problem on tmpfs in restore init (Problem of inexistant symlink and busybox)
  • Create MONDO_CACHE and use it everywhere + creation at start
  • Really never try to eject a USB device
  • Fix a issue with &> usage (replaced with 1> and 2>)
  • Adds magic file to depllist in order to have file working + ldd which helps for debugging issues
  • tty modes correct to avoid sh error messages
  • Use ext3 normally and not ext2 instead
  • USB device should be corrected after reading (take 1st part)
  • Adds a mount_USB_here function derived from mount_CDROM_here
  • usb detection place before /dev detection in device name at restore time
  • Fix when restoring from USB: media is asked in interactive mode
  • Adds USB support for mondorestore
  • mount_cdrom => mount_media
  • elilo.efi is now searched throughout /boot/efi and not in a fixed place as there is no standard
  • untar-and-softlink => untar (+ interface change)
  • suppress useless softlinks creation/removal in boot process
  • avoids udevd messages on groups
  • Increase # of disks to 99 as in mindi at restore time (should be a conf file parameter)
  • skip existing big file creation
  • seems to work correctly for USB mindi boot
  • Adds group and tty link to udev conf
  • Always load usb-torage (even 2.6) to initiate USB bus discovery
  • Better printing of messages
  • Attempt to fix a bug in supporting OpenSusE 10.3 kernel for initramfs (mindi may now use multiple regex for kernel initrd detection)
  • Links were not correctly done as non relative for modules in mindi
  • exclusion of modules denied now works
  • Also create modules in their ordinary place, so that classical modprobe works + copy modules.dep
  • Fix bugs for DENY_MODS handling
  • Add device /dev/console for udev
  • ide-generic should now really be excluded
  • Fix a bug in major number for tty
  • If udev then adds modprobe/insmod to rootfs
  • tty0 is also cretaed with udev
  • ide-generic put rather in DENY_MODS
  • udevd remove from deplist s handled in mindi directly
  • better default for mindi when using --usb
  • Handles dynamically linked busybox (in case we want to use it soon ;-)
  • Adds fixed devices to create for udev
  • ide-generic should not be part of the initrd when using libata v2
  • support a dynamically linked udev (case on Ubuntu 7.10 and Mandriva 2008.0 so should be quite generic) This will give incitation to move to dyn. linked binaries in the initrd which will help for other tasks (ia6 4)
  • Improvement in udev support (do not use cl options not available in busybox)
  • Udev in mindi
    • auto creation of the right links at boot time with udev-links.conf(from Mandriva 2008.0)
    • rework startup of udev as current makes kernel crash (from Mandriva 2008.0)
    • add support for 64 bits udev
  • Try to render MyInsmod? silent at boot time
  • Adds udev support (mandatory for newest distributions to avoid remapping of devices in a different way as on the original system)
  • We also need vaft format support for USB boot
  • Adds libusual support (Ubuntu 7.10 needs it for USB)
  • Improve Ubuntu/Debian? keyboard detection and support
  • pbinit adapted to new pb (0.8.10). Filtering of docs done in it
  • Suppress some mondo warnings and errors on USB again
  • Tries to fix lack of files in deb mindi package
  • Verify should now work for USB devices
  • More log/mesages improvement for USB support
  • - Supress g_erase_tmpdir_and_scratchdir
  • Improve some log messages for USB support
  • Try to improve install in mindi to avoid issues with isolinux.cfg not installed vene if in the pkg :-(
  • Improve mindi-busybox build
  • In conformity with pb 0.8.9
  • Add support for Ubuntu 7.10 in build process
  • Add USB Key button to Menu UI (CD streamer removed)
  • Attempt to fix error messages on tmp/scratch files at the end by removing those dir at the latest possible.
  • Fix a bug linked to the size of the -E param which could be used (Arnaud Tiger/René? Ribaud).
  • Integrate ~/.pbrc content into mondorescue.pb (required project-builder >= 0.8.7)
  • Put mondorescue in conformity with new pb filtering rules
  • Add USB support at restore time (no test done yet). New start-usb script PB varibale added where useful
  • Unmounting USB device before removal of temporary scratchdir
  • Stil refining USB copy back to mondo (one command was not executed)
  • No need to have the image subdor in the csratchdir when USB.
  • umount the USB partition before attempting to use it
  • Remove useless copy from mindi to mondo at end of USB handling

(risky merge, we are raising the limits of 2 diverging branches. The status of stable is not completely sure as such. Will need lots of tests, but it's not yet done :-()
(merge -r1692:1769 $SVN_M/branches/2.2.5)

File size: 4.5 KB
Line 
1Building a Busybox Boot Floppy
2==============================
3
4This document describes how to buid a boot floppy using the following
5components:
6
7 - Linux Kernel (http://www.kernel.org)
8 - uClibc: C library (http://www.uclibc.org/)
9 - Busybox: Unix utilities (http://busybox.net/)
10 - Syslinux: bootloader (http://syslinux.zytor.com)
11
12It is based heavily on a paper presented by Erik Andersen at the 2001 Embedded
13Systems Conference.
14
15
16
17Building The Software Components
18--------------------------------
19
20Detailed instructions on how to build Busybox, uClibc, or a working Linux
21kernel are beyond the scope of this document. The following guidelines will
22help though:
23
24    - Stock Busybox from CVS or a tarball will work with no modifications to
25      any files. Just extract and go.
26    - Ditto uClibc.
27    - Your Linux kernel must include support for initrd or else the floppy
28      won't be able to mount it's root file system.
29
30If you require further information on building Busybox uClibc or Linux, please
31refer to the web pages and documentation for those individual programs.
32
33
34
35Making a Root File System
36-------------------------
37
38The following steps will create a root file system.
39
40 - Create an empty file that you can format as a filesystem:
41
42    dd if=/dev/zero of=rootfs bs=1k count=4000
43
44 - Set up the rootfs file we just created to be used as a loop device (may not
45   be necessary)
46
47    losetup /dev/loop0 rootfs
48
49 - Format the rootfs file with a filesystem:
50
51    mkfs.ext2 -F -i 2000 rootfs
52
53 - Mount the file on a mountpoint so we can place files in it:
54
55    mkdir loop
56    mount -o loop rootfs loop/
57
58    (you will probably need to be root to do this)
59
60 - Copy on the C library, the dynamic linking library, and other necessary
61   libraries. For this example, we copy the following files from the uClibc
62   tree:
63
64    mkdir loop/lib
65    (chdir to uClibc directory)
66    cp -a libc.so* uClibc*.so \
67        ld.so-1/d-link/ld-linux-uclibc.so* \
68        ld.so-1/libdl/libdl.so* \
69        crypt/libcrypt.so* \
70        (path to)loop/lib
71
72 - Install the Busybox binary and accompanying symlinks:
73
74    (chdir to busybox directory)
75    make CONFIG_PREFIX=(path to)loop/ install
76
77 - Make device files in /dev:
78
79    This can be done by running the 'mkdevs.sh' script. If you want the gory
80    details, you can read the script.
81
82 - Make necessary files in /etc:
83
84    For this, just cp -a the etc/ directory onto rootfs. Again, if you want
85    all the details, you can just look at the files in the dir.
86
87 - Unmount the rootfs from the mountpoint:
88
89    umount loop
90
91 - Compress it:
92
93    gzip -9 rootfs
94
95
96Making a SYSLINUX boot floppy
97-----------------------------
98
99The following steps will create the boot floppy.
100
101Note: You will need to have the mtools package installed beforehand.
102
103 - Insert a floppy in the drive and format it with an MSDOS filesystem:
104
105    mformat a:
106
107    (if the system doesn't know what device 'a:' is, look at /etc/mtools.conf)
108
109 - Run syslinux on the floppy:
110
111    syslinux -s /dev/fd0
112
113    (the -s stands for "safe, slow, and stupid" and should work better with
114    buggy BIOSes; it can be omitted)
115
116 - Put on a syslinux.cfg file:
117
118    mcopy syslinux.cfg a:
119
120    (more on syslinux.cfg below)
121
122 - Copy the root file system you made onto the MSDOS formatted floppy
123
124    mcopy rootfs.gz a:
125
126 - Build a linux kernel and copy it onto the disk with the filename 'linux'
127
128    mcopy bzImage a:linux
129
130
131Sample syslinux.cfg
132~~~~~~~~~~~~~~~~~~~
133
134The following simple syslinux.cfg file should work. You can tweak it if you
135like.
136
137----begin-syslinux.cfg---------------
138DEFAULT linux
139APPEND initrd=rootfs.gz root=/dev/ram0
140TIMEOUT 10
141PROMPT 1
142----end-syslinux.cfg---------------
143
144Some changes you could make to syslinux.cfg:
145
146 - This value is the number seconds it will wait before booting. You can set
147   the timeout to 0 (or omit) to boot instantly, or you can set it as high as
148   10 to wait awhile.
149
150 - PROMPT can be set to 0 to disable the 'boot:' prompt.
151
152 - you can add this line to display the contents of a file as a welcome
153   message:
154
155    DISPLAY display.txt
156
157
158
159Additional Resources
160--------------------
161
162Other useful information on making a Linux bootfloppy is available at the
163following URLs:
164
165http://www.linuxdoc.org/HOWTO/Bootdisk-HOWTO/index.html
166http://www.linux-embedded.com/howto/Embedded-Linux-Howto.html
167http://linux-embedded.org/howto/LFS-HOWTO.html
168http://linux-embedded.org/pmhowto.html
169http://recycle.lbl.gov/~ldoolitt/embedded/ (Larry Doolittle's stuff)
170
171
172
173Possible TODOs
174--------------
175
176The following features that we might want to add later:
177
178 - support for additional filesystems besides ext2, i.e. minix
179 - different libc, static vs dynamic loading
180 - maybe using an alternate bootloader
Note: See TracBrowser for help on using the repository browser.