summaryrefslogtreecommitdiff
path: root/docs/busybox_header.pod
diff options
context:
space:
mode:
authorJohn Beppu2001-04-05 19:41:23 +0000
committerJohn Beppu2001-04-05 19:41:23 +0000
commit5bca0afb319688577437ae7a291151131c53c04f (patch)
tree9d18eece3754ce60d692079f8142dc481d349315 /docs/busybox_header.pod
parent9a1395b9fd8f07c36ac87c23928244b7a2d6ac72 (diff)
downloadbusybox-5bca0afb319688577437ae7a291151131c53c04f.zip
busybox-5bca0afb319688577437ae7a291151131c53c04f.tar.gz
- split busybox.pod into a header and footer.
the body will be generated by docs/autodocifier.pl
Diffstat (limited to 'docs/busybox_header.pod')
-rw-r--r--docs/busybox_header.pod72
1 files changed, 72 insertions, 0 deletions
diff --git a/docs/busybox_header.pod b/docs/busybox_header.pod
new file mode 100644
index 0000000..1208afa
--- /dev/null
+++ b/docs/busybox_header.pod
@@ -0,0 +1,72 @@
+# vi: set sw=4 ts=4:
+
+=head1 NAME
+
+BusyBox - The Swiss Army Knife of Embedded Linux
+
+=head1 SYNTAX
+
+ BusyBox <function> [arguments...] # or
+
+ <function> [arguments...] # if symlinked
+
+=head1 DESCRIPTION
+
+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 fileutils, shellutils, findutils, textutils, grep, gzip,
+tar, etc. BusyBox provides a fairly complete POSIX environment for any small
+or embedded system. 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 a kernel, a shell (such as ash),
+and an editor (such as elvis-tiny or ae).
+
+=head1 USAGE
+
+When you create a link to BusyBox for the function you wish to use, when BusyBox
+is called using that link it will behave as if the command itself has been invoked.
+
+For example, entering
+
+ ln -s ./BusyBox ls
+ ./ls
+
+will cause BusyBox to behave as 'ls' (if the 'ls' command has been compiled
+into BusyBox).
+
+You can also invoke BusyBox by issuing the command as an argument on the
+command line. For example, entering
+
+ ./BusyBox ls
+
+will also cause BusyBox to behave as 'ls'.
+
+=head1 COMMON OPTIONS
+
+Most BusyBox commands support the B<--help> option to provide a
+terse runtime description of their behavior.
+
+=head1 COMMANDS
+
+Currently defined functions include:
+
+ar, basename, busybox, cat, chgrp, chmod, chown, chroot, chvt, clear, cmp, cp,
+cut, date, dc, dd, deallocvt, df, dirname, dmesg, dos2unix, dpkg, dpkg-deb, du,
+dumpkmap, dutmp, echo, expr, false, fbset, fdflush, find, free, freeramdisk,
+fsck.minix, getopt, grep, gunzip, gzip, halt, head, hostid, hostname, id,
+ifconfig, init, insmod, kill, killall, klogd, length, ln, loadacm, loadfont,
+loadkmap, logger, logname, ls, lsmod, makedevs, md5sum, mkdir, mkfifo,
+mkfs.minix, mknod, mkswap, mktemp, more, mount, mt, mv, nc, nslookup, ping,
+pivot_root, poweroff, printf, ps, pwd, rdate, readlink, reboot, renice, reset,
+rm, rmdir, rmmod, route, rpmunpack, sed, setkeycodes, sh, sleep, sort, stty,
+swapoff, swapon, sync, syslogd, tail, tar, tee, telnet, test, tftp, touch, tr,
+true, tty, umount, uname, uniq, unix2dos, update, uptime, usleep, uudecode,
+uuencode, watchdog, wc, wget, which, whoami, xargs, yes, zcat, [
+
+=over 4
+