Company Products/Technology Services News/Events Support Spacer Contact Partners Customers
English    日本語
Products Photo

Product Documentation for
Devicescape Universal Wireless Platform

Documentation Home for Devicescape Universal Wireless Platform | Package Guide

Package GuidePreviousNextIndex

 


BusyBox package

Information on this package is covered here.

Package
Description
License
BusyBox
BusyBox multicall binary that provides UNIX environment.

Summary

BusyBox combines tiny versions of many common UNIX utilities into a single small executable. It provides minimalist replacements for most of the utilities you usually find in GNU coreutils, util-linux, etc. The utilities in BusyBox generally have fewer options than their full-featured GNU cousins; however, the options that are included provide the expected functionality and behave very much like their GNU counterparts.

BusyBox has been written with size-optimization and limited resources in mind. It is also extremely modular so you can easily include or exclude commands (or features) at compile time. This makes it easy to customize your embedded systems. To create a working system, just add /dev, /etc, and a Linux kernel. BusyBox provides a fairly complete POSIX environment for any small or embedded system.

BusyBox is extremely configurable. This allows you to include only the components you need, thereby reducing binary size. Run 'make config' or 'make menuconfig' to select the functionality that you wish to enable. The run 'make' to compile BusyBox using your configuration.1

The Devicescape distribution includes the following features from BusyBox by default:

[
getty
ln
reboot
tftp
ar
grep
loadkmap
reset
top
ash
gunzip
logger
rm
touch
cat
gzip
login
rmdir
tr
chgrp
halt
ls
rmmod
traceroute
chmod
head
lsmod
route
true
chown
hostname
md5sum
run-parts
tty
chroot
httpd
mkdir
sed
udhcpc
clear
id
mknod
sh
udhcpd
cp
ifconfig
modprobe
sleep
umount
cut
ifdown
more
sort
uname
df
ifup
mount
start-stop-daemon
uniq
dirname
inetd
mv
swapoff
uptime
dmesg
init
netstat
swapon
vconfig
echo
insmod
passwd
syslogd
vi
expr
ip
ping
sync
wc
false
iproute
poweroff
tail
wget
fgrep
kill
ps
tar
which
find
killall
pwd
telnet
whoami
free
klogd
 
telnetd
xargs
     
test
zcat

Usage

Start/Stop Options

The platform provides initialization scripts for some of the more commonly used daemons in the BusyBox set. These are:

Daemon
Package
telnetd
ds-init-telnetd

Additionally, the platform provides init scripts used to initialize the basic system functions, such as loading kernel modules, starting networking and mounting file systems. These scripts are all built using the init support in BusyBox. The scripts are provided in the ds-init package, and are run using the standard "/etc/init.d/script start|stop|restart" syntax, or by using indexed symbolic links from the /etc/rc.d directory (for example, /etc/rc.d/S20mountall -> /etc/init.d/mountall). The scripts that are included are:

Script
Description
getty
Starts/stops the getty service
mountall
Mounts all filesystems listed in /etc/fstab
networking
Starts all interfaces listed as "auto" in the /etc/network/interfaces file

/etc/init.d/rc handles the automatic execution of the init scripts that are linked into /etc/rc.d .

Runtime Configuration

While BusyBox itself has no real runtime configuration, some of the services that it provides do have. These are provided by the ds-init, ds-setup and ds-config-* packages. Here is a list of the runtime configuration-related files provided:

File
Description
/etc/group
Sample group file
/etc/hostname
Sample hostname
/etc/inittab
The processes to run at startup
/etc/network/interfaces
List of networking interfaces that can be used as arguments to ifup or ifdown. (See Summary.)
/etc/passwd
Sample password file. By default this contains only the user root, and has no password set.
/etc/resolv.conf
A symbolic link to /var/etc/resolv.conf so that the DNS information is stored in a RAM filesystem. If the system is not using DHCP to obtain this, then the link should be replaced with an actual file.

Command Line Options

See http://www.busybox.net/downloads/BusyBox.html for a complete set of command line options for every tool provided by BusyBox.

Building the Package

No special steps are needed, other than editing the configuration files.

Follow standard instructions for building userspace packages in the Devicescape Developer Guide topic on "Building the Packages", see subtopic: "Building a Userspace Package from a Source RPM"

Licensing

GPL2 (GNU General Public License, v.2)

See see http://www.busybox.net/license.html for information on complying with the Busybox license.

Related Packages

Required

ds-init ds-setup, ds-config-*, uClibc packages as described in Quick View of All Packages

Suggested

ds-init-httpd, ds-init-telnetd packages as described in Quick View of All Packages

1This description is taken from the BusyBox man page. To view the full man page, see http://www.busybox.net/downloads/BusyBox.html.

Package GuidePreviousNextIndex