From ac4c92da3b5305c244b5c48692c5542db4b6946c Mon Sep 17 00:00:00 2001 From: Rob Landley Date: Thu, 11 May 2006 17:21:13 +0000 Subject: [PATCH] More about configuring busybox. --- docs/busybox.net/FAQ.html | 76 ++++++++++++++++++++++++++++++++------- 1 file changed, 64 insertions(+), 12 deletions(-) diff --git a/docs/busybox.net/FAQ.html b/docs/busybox.net/FAQ.html index 07c1fd4e9..6bc144df6 100644 --- a/docs/busybox.net/FAQ.html +++ b/docs/busybox.net/FAQ.html @@ -8,16 +8,17 @@ have additions to this FAQ document, we would love to add them,

General questions

    -
  1. How can I get started using BusyBox? -
  2. How do I build a BusyBox-based system? -
  3. Which Linux kernel versions are supported? -
  4. Which architectures does BusyBox run on? -
  5. Which C libraries are supported? -
  6. Can I include BusyBox as part of the software on my device? -
  7. Where can I find other small utilities since busybox does not include the features I want?
    8. -
  8. I demand that you to add <favorite feature> right now! How come you don't answer all my questions on the mailing list instantly? I demand that you help me with all of my problems Right Now! -
  9. I need help with BusyBox! What should I do? -
  10. I need you to add <favorite feature>! Are the BusyBox developers willing to be paid in order to fix bugs or add in <favorite feature>? Are you willing to provide support contracts? +
  11. How can I get started using BusyBox?
    12. +
  12. How do I configure busybox?
    13. +
  13. How do I build a BusyBox-based system?
    14. +
  14. Which Linux kernel versions are supported?
    15. +
  15. Which architectures does BusyBox run on?
    16. +
  16. Which C libraries are supported?
    17. +
  17. Can I include BusyBox as part of the software on my device?
    18. +
  18. Where can I find other small utilities since busybox does not include the features I want?
    19. +
  19. I demand that you to add <favorite feature> right now! How come you don't answer all my questions on the mailing list instantly? I demand that you help me with all of my problems Right Now!
    20. +
  20. I need help with BusyBox! What should I do?
    21. +
  21. I need you to add <favorite feature>! Are the BusyBox developers willing to be paid in order to fix bugs or add in <favorite feature>? Are you willing to provide support contracts?

Troubleshooting

@@ -61,10 +62,10 @@ have additions to this FAQ document, we would love to add them,

How can I get started using BusyBox?

If you just want to try out busybox without installing it, download the - tarball, extract it, run "make allyesconfig", and then run "make". + tarball, extract it, run "make defconfig", and then run "make".

- This will create a busybox binary with all features enabled. To try + This will create a busybox binary with almost all features enabled. To try out a busybox applet, type "./busybox [appletname] [options]", for example "./busybox ls -l" or "./busybox cat LICENSE". Type "./busybox" to see a command list, and "busybox appletname --help" to see a brief @@ -90,6 +91,57 @@ have additions to this FAQ document, we would love to add them, standalone shell is dependent on the existence of /proc/self/exe, so before using it in a chroot environment you must mount /proc.)

+ +
+

+

How do I configure busybox?

+

Busybox is configured similarly to the linux kernel. Create a default + configuration and then run "make menuconfig" to modify it. The end + result is a .config file that tells the busybox build process what features + to include. So instead of "./configure; make; make install" the equivalent + busybox build would be "make defconfig; make; make install". +

+ +

Busybox configured with all features enabled is a little under a megabyte + dynamically linked on x86. To create a smaller busybox, configure it with + fewer features. Individual busybox applets cost anywhere from a few + hundred bytes to tens of kilobytes. Disable unneeded applets to save, + space, using menuconfig. +

+ +

The most important busybox configurators are:

+ + + +

Some other configuration options are:

+ + +

Menuconfig modifies your .config file through an interactive menu where you can enable or disable + busybox features, and get help about each feature. + + +

To build a smaller busybox binary, run "make menuconfig" and disable the features you don't need. (Or run "make allnoconfig" and then use