source: branches/stable/mindi-busybox/INSTALL @ 1770

Last change on this file since 1770 was 1770, checked in by Bruno Cornec, 13 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: 5.2 KB
Line 
1Building:
2=========
3
4The BusyBox build process is similar to the Linux kernel build:
5
6  make menuconfig     # This creates a file called ".config"
7  make                # This creates the "busybox" executable
8  make install        # or make CONFIG_PREFIX=/path/from/root install
9
10The full list of configuration and install options is available by typing:
11
12  make help
13
14Quick Start:
15============
16
17The easy way to try out BusyBox for the first time, without having to install
18it, is to enable all features and then use "standalone shell" mode with a
19blank command $PATH.
20
21To enable all features, use "make defconfig", which produces the largest
22general-purpose configuration.  (It's allyesconfig minus debugging options,
23optional packaging choices, and a few special-purpose features requiring
24extra configuration to use.)
25
26  make defconfig
27  make
28  PATH= ./busybox ash
29
30Standalone shell mode causes busybox's built-in command shell to run
31any built-in busybox applets directly, without looking for external
32programs by that name.  Supplying an empty command path (as above) means
33the only commands busybox can find are the built-in ones.
34
35Note that the standalone shell requires CONFIG_BUSYBOX_EXEC_PATH
36to be set appropriately, depending on whether or not /proc/self/exe is
37available or not. If you do not have /proc, then point that config option
38to the location of your busybox binary, usually /bin/busybox.
39
40Configuring Busybox:
41====================
42
43Busybox is optimized for size, but enabling the full set of functionality
44still results in a fairly large executable -- more than 1 megabyte when
45statically linked.  To save space, busybox can be configured with only the
46set of applets needed for each environment.  The minimal configuration, with
47all applets disabled, produces a 4k executable.  (It's useless, but very small.)
48
49The manual configurator "make menuconfig" modifies the existing configuration.
50(For systems without ncurses, try "make config" instead.) The two most
51interesting starting configurations are "make allnoconfig" (to start with
52everything disabled and add just what you need), and "make defconfig" (to
53start with everything enabled and remove what you don't need).  If menuconfig
54is run without an existing configuration, make defconfig will run first to
55create a known starting point.
56
57Other starting configurations (mostly used for testing purposes) include
58"make allbareconfig" (enables all applets but disables all optional features),
59"make allyesconfig" (enables absolutely everything including debug features),
60and "make randconfig" (produce a random configuration).
61
62Configuring BusyBox produces a file ".config", which can be saved for future
63use.  Run "make oldconfig" to bring a .config file from an older version of
64busybox up to date.
65
66Installing Busybox:
67===================
68
69Busybox is a single executable that can behave like many different commands,
70and BusyBox uses the name it was invoked under to determine the desired
71behavior.  (Try "mv busybox ls" and then "./ls -l".)
72
73Installing busybox consists of creating symlinks (or hardlinks) to the busybox
74binary for each applet enabled in busybox, and making sure these symlinks are
75in the shell's command $PATH.  Running "make install" creates these symlinks,
76or "make install-hardlinks" creates hardlinks instead (useful on systems with
77a limited number of inodes).  This install process uses the file
78"busybox.links" (created by make), which contains the list of enabled applets
79and the path at which to install them.
80
81Installing links to busybox is not always necessary.  The special applet name
82"busybox" (or with any optional suffix, such as "busybox-static") uses the
83first argument to determine which applet to behave as, for example
84"./busybox cat LICENSE".  (Running the busybox applet with no arguments gives
85a list of all enabled applets.) The standalone shell can also call busybox
86applets without links to busybox under other names in the filesystem.  You can
87also configure a standaone install capability into the busybox base applet,
88and then install such links at runtime with one of "busybox --install" (for
89hardlinks) or "busybox --install -s" (for symlinks).
90
91If you enabled the busybox shared library feature (libbusybox.so) and want
92to run tests without installing, set your LD_LIBRARY_PATH accordingly when
93running the executable:
94
95  LD_LIBRARY_PATH=`pwd` ./busybox
96
97Building out-of-tree:
98=====================
99
100By default, the BusyBox build puts its temporary files in the source tree.
101Building from a read-only source tree, or building multiple configurations from
102the same source directory, requires the ability to put the temporary files
103somewhere else.
104
105To build out of tree, cd to an empty directory and configure busybox from there:
106
107  make -f /path/to/source/Makefile defconfig
108  make
109  make install
110
111Alternately, use the O=$BUILDPATH option (with an absolute path) during the
112configuration step, as in:
113
114  make O=/some/empty/directory allyesconfig
115  cd /some/empty/directory
116  make
117  make CONFIG_PREFIX=. install
118
119More Information:
120=================
121
122Se also the busybox FAQ, under the questions "How can I get started using
123BusyBox" and "How do I build a BusyBox-based system?"  The BusyBox FAQ is
124available from http://www.busybox.net/FAQ.html or as the file
125docs/busybox.net/FAQ.html in this tarball.
Note: See TracBrowser for help on using the repository browser.