Jump to content

BusyBox

From Wikipedia, the free encyclopedia

This is an old revision of this page, as edited by 71.243.115.137 (talk) at 12:41, 13 October 2009 (→‎Commands). The present address (URL) is a permanent link to this revision, which may differ significantly from the current revision.

BusyBox
Original author(s)Bruce Perens
Developer(s)Erik Andersen, Rob Landley, Denys Vlasenko
Stable release
1.14.3 / August 2, 2009 (2009-08-02)
Preview release
1.15.0 / August 23, 2009 (2009-08-23)
Repository
Written inC
Operating systemUnix-like
TypeIndependent SUSp XCU implementation
LicenseGNU General Public License
Websitehttp://www.busybox.net

BusyBox is a software application released as Free software under the GNU General Public License [1] that provides many standard Unix tools, much like the larger (but more capable) GNU Core Utilities. BusyBox is designed to be a small executable for use with the Linux kernel, which makes it ideal for use with embedded devices. It has been called "The Swiss Army Knife of Embedded Linux".

In late 2007, BusyBox also came to prominence for actively prosecuting alleged, and in at least one case proven, violations of its copyright under GPL in US-based courts of law.[citation needed]

History

Originally written by Bruce Perens in 1996, the intent of BusyBox was to put a complete bootable system on a single floppy that would be both a rescue disk and an installer for the Debian distribution. It has since then become the de facto standard for embedded Linux devices and Linux distribution installers. Since each Linux executable requires several kilobytes of overhead, having the BusyBox program combine over two hundred programs together can save considerable space.

BusyBox was maintained by Enrique Zanardi and focused on the needs of the Debian boot-floppies installer system until early 1998, when it was taken over by Dave Cinege for The Linux Router Project (LRP). Cinege made several additions, created a modularized build environment, and shifted BusyBox's focus into general high level embedded systems. As LRP development slowed down in 1999, Erik Andersen, then of Lineo, Inc., took over the project and was the official maintainer between December 1999 and March 2006. During this time the Linux embedded market place exploded in growth, and BusyBox matured greatly, expanding both its user base and functionality.

Denys Vlasenko is the current maintainer of BusyBox.

Features

BusyBox can be customized to provide a subset of over two hundred utilities. It can provide most of the utilities specified in the Single Unix Specification plus many others that a user would expect to see on a Linux system. BusyBox uses the ash shell.[2][3]

A full list of the utilities implemented can be found on the BusyBox site.[4]

Single binary

Typical computer programs have a separate binary (executable) file for each application. BusyBox is a single binary, which is a conglomerate of many applications, each of which can be accessed by calling the single BusyBox binary with various names (supported by having a symbolic link or hard link for each different name[5]) in a specific manner with appropriate arguments.

BusyBox benefits from the single binary approach as it reduces the overheads introduced by the executable file format (typically ELF), and it allows code to be shared between multiple applications without requiring a library. This technique is similar to what is provided by the crunchgen[6] command in FreeBSD. However, BusyBox provides simplified versions of the utilities (for example, an ls command without file sorting ability), while a crunchgen generated sum of all the utilities would offer the fully functional versions.

Sharing of the common code, along with routines written with size-optimization in mind, enables a BusyBox system to be much smaller than a system built with the corresponding full versions of the utilities replaced by BusyBox. The research [7] which compared GNU, Busybox, asmutils and Perl implementations of the standard Unix commands show that in some situations BusyBox may perform faster than other implementations, but not always.

Examples

Programs included in BusyBox can be run simply by adding their name as an argument to the BusyBox executable:

/bin/busybox ls

More commonly, the desired command names are linked (using hard or symbolic links) to the BusyBox executable; BusyBox notices the name it is called as, and runs the appropriate command, for example just

/bin/ls

after /bin/ls is linked to /bin/busybox.

Commands

for help type command name --help

  • ash
  • awk
  • cat
  • chmod
  • cp - copy
  • date
  • dd - Copy a file with converting and formatting
  • df - Print filesystem usage statistics
  • dmesg
  • echo
  • egrep
  • fgrep
  • grep - Search for PATTERN in each FILE or standard input
  • gunzip
  • gzip
  • kill - Kill a process
  • ln - Create a link named LINK_NAME or DIRECTORY to the specified TARGET.
  • login - Begin a new session on the system
  • ls - list of files or folders
  • mdu
  • mkdir - Create a folder
  • more - View FILE or standard input one screen full at a time, not long list to scroll
  • mount
  • mv - move file
  • netstat - Display networking information
  • ntpc
  • ntpsync
  • nvram
  • pidof - List PIDs of all processes with names that match NAMEs
  • ping - Send ICMP ECHO_REQUEST packets to network hosts
  • ps - Report process status
  • pwd - print working directory
  • rm - erase file
  • rmdir - remove directory
  • rstats - copyright of BusyBox
  • sed - script to interpret from file or input
  • sh
  • sleep
  • sync - Write all buffered file system blocks to disk
  • tar
  • touch - Update the last-modified date on the given FILE[s]
  • umount
  • uname
  • usleep - Pause for N [microseconds]
  • vi - Edit FILE
  • watch - Execute a program periodically
  • zcat - Uncompress to stdout

Appliances

It is very common to find BusyBox used in Linux-based appliances, examples of which include:

A more complete list can be found on the official website (see external links below).

GPL lawsuits

What was claimed to be the first US lawsuit over a GPL violation concerned use of BusyBox in an embedded device. The lawsuit[8], case 07-CV-8205 in the United States District Court for the Southern District of New York was filed on 20 September 2007 by the Software Freedom Law Center (SFLC) on behalf of Andersen and Landley against Monsoon Multimedia Inc., after BusyBox code was discovered in a firmware upgrade and attempts to contact the company had apparently failed. The case was settled with release of the Monsoon version of the source and payment of an undisclosed amount of money to Andersen and Landley.[9]

On 21 November 2007, the SFLC brought two similar lawsuits on behalf of Andersen and Landley against two more companies, Xterasys (case 07-CV-10456) and High-Gain Antennas (case 07-CV-10455).[10][11] The Xterasys case was settled on December 17 for release of source code used and an undisclosed payment,[12] and the High-Gain Antennas case on March 6, 2008 for active license compliance and an undisclosed payment.[13] On 7 December 2007, a case was brought against Verizon Communications over its distribution of firmware for Actiontec routers that it distributes;[14][15] this case was settled March 17, 2008 on condition of license compliance, appointment of an officer to oversee future compliance with free software licenses, and payment of an undisclosed sum.[16] Further suits were brought on June 9, 2008 against Bell Microproducts (case 08-CV-5270) and Super Micro Computer (case 08-CV-5269),[17] the Super Micro case being settled on 23 July, 2008.[18]. BusyBox and Bell Microproducts also settled out of court on 17 October, 2008. Anderson v. Bell Microproducts, Inc., No. 08-cv-5270, Doc. No. 16 (S.D.N.Y. Oct. 17, 2008) (notice of voluntary dismissal).

No other developers, including original author Bruce Perens and long time maintainer Dave Cinege, were represented in these actions or party to the settlements.

Notes

  1. ^ Busy Box Licence
  2. ^ http://busybox.net/cgi-bin/viewcvs.cgi/trunk/busybox/shell/Config.in?rev=11083 The 'ash' shell adds about 60k in the default configuration and is the most complete and most pedantically correct shell included with busybox. This shell is actually a derivative of the Debian 'dash' shell (by Herbert Xu), which was created by porting the 'ash' shell(written by Kenneth Almquist) from NetBSD.
  3. ^ ash variants
  4. ^ BusyBox - The Swiss Army Knife of Embedded Linux
  5. ^ http://www-128.ibm.com/developerworks/library/l-busybox/index.html
  6. ^ crunchgen man page at freebsd.org
  7. ^ Doug Thayer, Keith Miller (16–17 April 2004). "Four UNIX Programs in Four UNIX Collections: Seeking Consistency in an Open Source Icon" (PDF). Proceedings of Midwest Instruction and Computing Symposium. University of Minnesota, Morris. {{cite conference}}: Unknown parameter |booktitle= ignored (|book-title= suggested) (help)
  8. ^ On Behalf of BusyBox Developers Andersen and Landley, SFLC Files First Ever U.S. GPL Violation Lawsuit (Software Freedom Law Center 20 September 2007)
  9. ^ Settlement reached in Busybox-Monsoon GPL case (Bruce Byfield, Linux.com, 30 October 2007)
  10. ^ Linux legal team sues over GPL violations (Martin LaMonica, CNET News.com, 21 November 2007)
  11. ^ SFLC press release
  12. ^ SFLC press release
  13. ^ BusyBox Developers and High-Gain Antennas Agree to Dismiss GPL Lawsuit (SFLC press release)
  14. ^ Open-source legal group strikes again on BusyBox, suing Verizon (Grant Gross, Computerworld, Dec 7 2007)
  15. ^ SFLC press release
  16. ^ Verizon Settles Open Source Software Lawsuit (Paul McDougell, InformationWeek, March 17, 2008)
  17. ^ SFLC Files Another Round of GPL Violation Lawsuits on Behalf of BusyBox Developers (SFLC press release)
  18. ^ BusyBox Developers and Supermicro Agree to End GPL Lawsuit: Good Faith Discussions Result in Dismissal of Copyright Infringement Case (SFLC press release)