=over 4
-=item I<ar>
+=item B<adjtimex>
+
+adjtimex [B<-q>] [B<-o> offset] [B<-f> frequency] [B<-p> timeconstant] [B<-t> tick]
+
+Reads and optionally sets system timebase parameters.
+See adjtimex(2).
+
+Options:
+
+ -q quiet mode - do not print
+ -o offset time offset, microseconds
+ -f frequency frequency adjust, integer kernel units (65536 is 1ppm)
+ (positive values make the system clock run fast)
+ -t tick microseconds per tick, usually 10000
+ -p timeconstant
+
+-------------------------------
+
+=item B<ar>
ar -[ovR]{ptx} archive filenames
-------------------------------
-=item I<basename>
+=item B<basename>
basename FILE [SUFFIX]
-------------------------------
-=item I<cat>
+=item B<cat>
cat [FILE]...
-------------------------------
-=item I<chgrp>
+=item B<chgrp>
chgrp [OPTION]... GROUP FILE...
-------------------------------
-=item I<chmod>
+=item B<chmod>
chmod [B<-R>] MODE[,MODE]... FILE...
-------------------------------
-=item I<chown>
+=item B<chown>
-chown [OPTION]... OWNER[<.|:>[GROUP] FILE...
+chown [OPTION]... OWNER[<.|:>[GROUP]] FILE...
Change the owner and/or group of each FILE to OWNER and/or GROUP.
-------------------------------
-=item I<chroot>
+=item B<chroot>
chroot NEWROOT [COMMAND...]
-------------------------------
-=item I<chvt>
+=item B<chvt>
chvt N
-------------------------------
-=item I<clear>
+=item B<clear>
clear
-------------------------------
-=item I<cmp>
+=item B<cmp>
cmp FILE1 [FILE2]
-------------------------------
-=item I<cp>
+=item B<cp>
cp [OPTION]... SOURCE DEST
-------------------------------
-=item I<cut>
+=item B<cut>
cut [OPTION]... [FILE]...
-------------------------------
-=item I<date>
+=item B<date>
date [OPTION]... [+FORMAT]
-------------------------------
-=item I<dc>
+=item B<dc>
dc expression ...
-------------------------------
-=item I<dd>
+=item B<dd>
dd [if=FILE] [of=FILE] [bs=N] [count=N] [skip=N]
[seek=N] [conv=notrunc|sync]
-------------------------------
-=item I<deallocvt>
+=item B<deallocvt>
deallocvt N
-------------------------------
-=item I<df>
+=item B<df>
df [B<-hmk>] [filesystem ...]
-------------------------------
-=item I<dirname>
+=item B<dirname>
dirname [FILENAME ...]
-------------------------------
-=item I<dmesg>
+=item B<dmesg>
dmesg [B<-c>] [B<-n> LEVEL] [B<-s> SIZE]
-------------------------------
-=item I<dos2unix>
+=item B<dos2unix>
dos2unix [option] [file]
-------------------------------
-=item I<dpkg>
+=item B<dpkg>
dpkg [B<-i>|B<-r>|-B<-unpack>|-B<-configure>] my.deb
-------------------------------
-=item I<dpkg_deb>
+=item B<dpkg_deb>
dpkg_deb [B<-cexX>] file directory
-------------------------------
-=item I<du>
+=item B<du>
du [B<-lshmk>] [FILE]...
-------------------------------
-=item I<dumpkmap>
+=item B<dumpkmap>
dumpkmap > keymap
-------------------------------
-=item I<dutmp>
+=item B<dutmp>
dutmp [FILE]
-------------------------------
-=item I<echo>
+=item B<echo>
echo [B<-neE>] [ARG ...]
-------------------------------
-=item I<expr>
+=item B<env>
+
+env [-] [B<-iu>] [name=value ...] [command]
+
+Prints the current environment or runs a program after setting
+up the specified environment.
+
+Options:
+
+ -, -i start with an empty environment
+ -u remove variable from the environment
+
+-------------------------------
+
+=item B<expr>
expr EXPRESSION
-------------------------------
-=item I<false>
+=item B<false>
false
-------------------------------
-=item I<fbset>
+=item B<fbset>
fbset [options] [mode]
-------------------------------
-=item I<fdflush>
+=item B<fdflush>
fdflush DEVICE
-------------------------------
-=item I<find>
+=item B<find>
find [PATH...] [EXPRESSION]
EXPRESSION may consist of:
-follow Dereference symbolic links.
- -name PATTERN File name (leading directories removed) matches PATTERN.
+ -name PATTERN File name (leading directories removed) matches PATTERN. -print Print (default and assumed).
+
-type X Filetype matches X (where X is one of: f,d,l,b,c,...)
-perm PERMS Permissions match any of (+NNN); all of (-NNN);
or exactly (NNN)
-------------------------------
-=item I<free>
+=item B<free>
free
-------------------------------
-=item I<freeramdisk>
+=item B<freeramdisk>
freeramdisk DEVICE
-------------------------------
-=item I<fsck_minix>
+=item B<fsck_minix>
fsck_minix [B<-larvsmf>] /dev/name
-------------------------------
-=item I<getopt>
+=item B<getopt>
getopt [OPTIONS]...
-------------------------------
-=item I<grep>
+=item B<grep>
grep [B<-ihHnqvs>] pattern [files...]
-------------------------------
-=item I<gunzip>
+=item B<gunzip>
gunzip [OPTION]... FILE
-------------------------------
-=item I<gzip>
+=item B<gzip>
gzip [OPTION]... FILE
-------------------------------
-=item I<halt>
+=item B<halt>
halt
-------------------------------
-=item I<head>
+=item B<head>
head [OPTION] [FILE]...
-------------------------------
-=item I<hostid>
+=item B<hostid>
hostid
-------------------------------
-=item I<hostname>
+=item B<hostname>
hostname [OPTION] {hostname | B<-F> file}
-------------------------------
-=item I<id>
+=item B<id>
id [OPTIONS]... [USERNAME]
-------------------------------
-=item I<ifconfig>
+=item B<ifconfig>
ifconfig [B<-a>] <interface> [<address>]
-------------------------------
-=item I<init>
+=item B<init>
init
::sysinit:/etc/init.d/rcS
::askfirst:/bin/sh
- ::ctrlaltdel:/sbin/reboot
- ::shutdown:/sbin/swapoff -a
- ::shutdown:/bin/umount -a -r
if it detects that /dev/console is _not_ a serial console, it will also run:
tty2::askfirst:/bin/sh
- tty3::askfirst:/bin/sh
- tty4::askfirst:/bin/sh
If you choose to use an /etc/inittab file, the inittab entry format is as follows:
<action>:
Valid actions include: sysinit, respawn, askfirst, wait,
- once, ctrlaltdel, and shutdown.
+ once, and ctrlaltdel.
The available actions can be classified into two groups: actions
that are run only once, and actions that are re-run when the specified
'wait' actions, like 'sysinit' actions, cause init to wait until
the specified task completes. 'once' actions are asyncronous,
therefore, init does not wait for them to complete. 'ctrlaltdel'
- actions are run when the system detects that someone on the system
- console has pressed the CTRL-ALT-DEL key combination. Typically one
- wants to run 'reboot' at this point to cause the system to reboot.
- Finally the 'shutdown' action specifies the actions to taken when
- init is told to reboot. Unmounting filesystems and disabling swap
- is a very good here.
+ actions are run immediately before init causes the system to reboot
+ (unmounting filesystems with a 'ctrlaltdel' action is a very good
+ idea).
Run repeatedly actions:
::sysinit:/etc/init.d/rcS
- ::askfirst:-/bin/sh
- tty2::askfirst:-/bin/sh
+ ::askfirst:-/bin/sh
+ tty2::askfirst:-/bin/sh
tty3::askfirst:-/bin/sh
tty4::askfirst:-/bin/sh
tty4::respawn:/sbin/getty 38400 tty5
tty5::respawn:/sbin/getty 38400 tty6
- ::ctrlaltdel:/sbin/reboot
- ::shutdown:/bin/umount -a -r
- ::shutdown:/sbin/swapoff -a
+
+
+ ::ctrlaltdel:/bin/umount -a -r
+ ::ctrlaltdel:/sbin/swapoff -a
-------------------------------
-=item I<insmod>
+=item B<insmod>
insmod [OPTION]... MODULE [symbol=value]...
-------------------------------
-=item I<kill>
+=item B<kill>
kill [B<-signal>] process-id [process-id ...]
-------------------------------
-=item I<killall>
+=item B<killall>
killall [B<-signal>] process-name [process-name ...]
-------------------------------
-=item I<klogd>
+=item B<klogd>
klogd B<-n>
-------------------------------
-=item I<length>
+=item B<length>
length STRING
-------------------------------
-=item I<ln>
+=item B<ln>
ln [OPTION] TARGET... LINK_NAME|DIRECTORY
-------------------------------
-=item I<loadacm>
+=item B<loadacm>
loadacm < mapfile
-------------------------------
-=item I<loadfont>
+=item B<loadfont>
loadfont < font
-------------------------------
-=item I<loadkmap>
+=item B<loadkmap>
loadkmap < keymap
-------------------------------
-=item I<logger>
+=item B<logger>
logger [OPTION]... [MESSAGE]
-------------------------------
-=item I<logname>
+=item B<logname>
logname
-------------------------------
-=item I<logread>
+=item B<logread>
logread
-------------------------------
-=item I<ls>
+=item B<ls>
ls [B<-1AacCdeFilnpLRrSsTtuvwxXhk>] [filenames...]
-------------------------------
-=item I<lsmod>
+=item B<lsmod>
lsmod
-------------------------------
-=item I<makedevs>
+=item B<makedevs>
makedevs NAME TYPE MAJOR MINOR FIRST LAST [s]
-------------------------------
-=item I<md5sum>
+=item B<md5sum>
md5sum [OPTION] [FILE]...
or: md5sum [OPTION] B<-c> [FILE]
-------------------------------
-=item I<mkdir>
+=item B<mkdir>
mkdir [OPTION] DIRECTORY...
-------------------------------
-=item I<mkfifo>
+=item B<mkfifo>
mkfifo [OPTIONS] name
-------------------------------
-=item I<mkfs_minix>
+=item B<mkfs_minix>
mkfs_minix [B<-c> | B<-l> filename] [B<-nXX>] [B<-iXX>] /dev/name [blocks]
-------------------------------
-=item I<mknod>
+=item B<mknod>
mknod [OPTIONS] NAME TYPE MAJOR MINOR
-------------------------------
-=item I<mkswap>
+=item B<mkswap>
mkswap [B<-c>] [B<-v0>|B<-v1>] device [block-count]
-------------------------------
-=item I<mktemp>
+=item B<mktemp>
mktemp [B<-q>] TEMPLATE
-------------------------------
-=item I<more>
+=item B<more>
more [FILE ...]
-------------------------------
-=item I<mount>
+=item B<mount>
mount [flags] device directory [B<-o> options,more-options]
-------------------------------
-=item I<mt>
+=item B<mt>
mt [B<-f> device] opcode value
-------------------------------
-=item I<mv>
+=item B<mv>
mv SOURCE DEST
or: mv SOURCE... DIRECTORY
-------------------------------
-=item I<nc>
+=item B<nc>
nc [IP] [port]
-------------------------------
-=item I<nslookup>
+=item B<nslookup>
nslookup [HOST]
-------------------------------
ping [OPTION]... host
-------------------------------
pivot_root new_root put_old
-------------------------------
poweroff
-------------------------------
printf FORMAT [ARGUMENT...]
-------------------------------
ps
-------------------------------
pwd
-------------------------------
-=item I<rdate>
+=item B<rdate>
rdate [OPTION] HOST
-------------------------------
-=item I<readlink>
+=item B<readlink>
readlink
-------------------------------
-=item I<reboot>
+=item B<reboot>
reboot
-------------------------------
-=item I<renice>
+=item B<renice>
renice priority pid [pid ...]
-------------------------------
-=item I<reset>
+=item B<reset>
reset
-------------------------------
-=item I<rm>
+=item B<rm>
rm [OPTION]... FILE...
-------------------------------
-=item I<rmdir>
+=item B<rmdir>
rmdir [OPTION]... DIRECTORY...
-------------------------------
-=item I<rmmod>
+=item B<rmmod>
rmmod [OPTION]... [MODULE]...
-------------------------------
-=item I<route>
+=item B<route>
route [{add|del|flush}]
-------------------------------
-=item I<rpmunpack>
+=item B<rpmunpack>
rpmunpack < package.rpm | gunzip | cpio B<-idmuv>
-------------------------------
-=item I<sed>
+=item B<sed>
sed [B<-Vhnef>] pattern [files...]
-------------------------------
-=item I<setkeycodes>
+=item B<setkeycodes>
setkeycodes SCANCODE KEYCODE ...
-------------------------------
-=item I<sh>
+=item B<sh>
sh [FILE]...
or: sh B<-c> command [args]...
-------------------------------
-=item I<sleep>
+=item B<sleep>
sleep N
-------------------------------
-=item I<sort>
+=item B<sort>
sort [B<-n>] [B<-r>] [FILE]...
-------------------------------
-=item I<stty>
+=item B<stty>
stty [B<-a>|g] [B<-F> device] [SETTING]...
-------------------------------
-=item I<swapoff>
+=item B<swapoff>
swapoff [OPTION] [device]
-------------------------------
-=item I<swapon>
+=item B<swapon>
swapon [OPTION] [device]
-------------------------------
-=item I<sync>
+=item B<sync>
sync
-------------------------------
-=item I<syslogd>
+=item B<syslogd>
syslogd [OPTION]...
-------------------------------
-=item I<tail>
+=item B<tail>
tail [OPTION]... [FILE]...
-------------------------------
-=item I<tar>
+=item B<tar>
tar -[cxtvO] [-B<-exclude> File] [B<-X> File][B<-f> tarFile] [FILE(s)] ...
-------------------------------
-=item I<tee>
+=item B<tee>
tee [OPTION]... [FILE]...
-------------------------------
-=item I<telnet>
+=item B<telnet>
telnet host [port]
-------------------------------
-=item I<test>
+=item B<test>
test EXPRESSION
or [ EXPRESSION ]
-------------------------------
-=item I<tftp>
+=item B<tftp>
tftp command SOURCE DEST
-------------------------------
-=item I<touch>
+=item B<touch>
touch [B<-c>] file [file ...]
-------------------------------
-=item I<tr>
+=item B<tr>
tr [B<-cds>] STRING1 [STRING2]
-------------------------------
-=item I<true>
+=item B<true>
true
-------------------------------
-=item I<tty>
+=item B<tty>
tty
-------------------------------
-=item I<umount>
+=item B<umount>
umount [flags] filesystem|directory
-------------------------------
-=item I<uname>
+=item B<uname>
uname [OPTION]...
-------------------------------
-=item I<uniq>
+=item B<uniq>
uniq [OPTION]... [INPUT [OUTPUT]]
-------------------------------
-=item I<unix2dos>
+=item B<unix2dos>
unix2dos [option] [file]
-------------------------------
-=item I<update>
+=item B<update>
update [options]
-------------------------------
-=item I<uptime>
+=item B<uptime>
uptime
-------------------------------
-=item I<usleep>
+=item B<usleep>
usleep N
-------------------------------
-=item I<uudecode>
+=item B<uudecode>
uudecode [FILE]...
Options:
- -o FILE direct output to FILE$ uudecode -o busybox busybox.uu
-$ ls B<-l> busybox
-B<-rwxr>-xr-x 1 ams ams 245264 Jun 7 21:35 busybox
-
+ -o FILE direct output to FILE
+
+Example:
+
+ $ uudecode -o busybox busybox.uu
+ $ ls -l busybox
+ -rwxr-xr-x 1 ams ams 245264 Jun 7 21:35 busybox
+
-------------------------------
-=item I<uuencode>
+=item B<uuencode>
uuencode [OPTION] [INFILE] REMOTEFILE
-------------------------------
-=item I<watchdog>
+=item B<watchdog>
watchdog DEV
-------------------------------
-=item I<wc>
+=item B<wc>
wc [OPTION]... [FILE]...
-------------------------------
-=item I<wget>
+=item B<wget>
wget [B<-c>] [B<-O> file] url
-------------------------------
-=item I<which>
+=item B<which>
which [COMMAND ...]
-------------------------------
-=item I<whoami>
+=item B<whoami>
whoami
-------------------------------
-=item I<xargs>
+=item B<xargs>
xargs [COMMAND] [ARGS...]
-------------------------------
-=item I<yes>
+=item B<yes>
yes [OPTION]... [STRING]...
-------------------------------
-=item I<zcat>
+=item B<zcat>
zcat FILE
-------------------------------
-=back
-
=head1 LIBC NSS
GNU Libc uses the Name Service Switch (NSS) to configure the behavior of the C
=cut
-# $Id: busybox.pod,v 1.93 2001/04/03 18:01:51 andersen Exp $
+# $Id: busybox.pod,v 1.94 2001/04/05 19:41:23 beppu Exp $
--- /dev/null
+=head1 LIBC NSS
+
+GNU Libc uses the Name Service Switch (NSS) to configure the behavior of the C
+library for the local environment, and to configure how it reads system data,
+such as passwords and group information. BusyBox has made it Policy that it
+will never use NSS, and will never use and libc calls that make use of NSS.
+This allows you to run an embedded system without the need for installing an
+/etc/nsswitch.conf file and without and /lib/libnss_* libraries installed.
+
+If you are using a system that is using a remote LDAP server for authentication
+via GNU libc NSS, and you want to use BusyBox, then you will need to adjust the
+BusyBox source. Chances are though, that if you have enough space to install
+of that stuff on your system, then you probably want the full GNU utilities.
+
+=head1 SEE ALSO
+
+textutils(1), shellutils(1), etc...
+
+=head1 MAINTAINER
+
+Erik Andersen <andersee@debian.org> <andersen@lineo.com>
+
+=head1 AUTHORS
+
+The following people have contributed code to BusyBox whether
+they know it or not.
+
+
+=for html <br>
+
+Erik Andersen <andersen@lineo.com>, <andersee@debian.org>
+
+ Tons of new stuff, major rewrite of most of the
+ core apps, tons of new apps as noted in header files.
+
+=for html <br>
+
+Edward Betts <edward@debian.org>
+
+ expr, hostid, logname, tty, wc, whoami, yes
+
+=for html <br>
+
+John Beppu <beppu@lineo.com>
+
+ du, head, nslookup, sort, tee, uniq
+
+=for html <br>
+
+Brian Candler <B.Candler@pobox.com>
+
+ tiny-ls(ls)
+
+=for html <br>
+
+Randolph Chung <tausq@debian.org>
+
+ fbset, ping, hostname, and mkfifo
+
+=for html <br>
+
+Dave Cinege <dcinege@psychosis.com>
+
+ more(v2), makedevs, dutmp, modularization, auto links file,
+ various fixes, Linux Router Project maintenance
+
+=for html <br>
+
+Karl M. Hegbloom <karlheg@debian.org>
+
+ cp_mv.c, the test suite, various fixes to utility.c, &c.
+
+=for html <br>
+
+Daniel Jacobowitz <dan@debian.org>
+
+ mktemp.c
+
+=for html <br>
+
+Matt Kraai <kraai@alumni.carnegiemellon.edu>
+
+ documentation, bugfixes
+
+=for html <br>
+
+John Lombardo <john@deltanet.com>
+
+ dirname, tr
+
+=for html <br>
+
+Glenn McGrath <bug1@netconnect.com.au>
+
+ ar.c
+
+=for html <br>
+
+Bruce Perens <bruce@pixar.com>
+
+ Original author of BusyBox. His code is still in many apps.
+
+=for html <br>
+
+Chip Rosenthal <chip@unicom.com>, <crosenth@covad.com>
+
+ wget - Contributed by permission of Covad Communications
+
+=for html <br>
+
+Pavel Roskin <proski@gnu.org>
+
+ Lots of bugs fixes and patches.
+
+=for html <br>
+
+Gyepi Sam <gyepi@praxis-sw.com>
+
+ Remote logging feature for syslogd
+
+=for html <br>
+
+Linus Torvalds <torvalds@transmeta.com>
+
+ mkswap, fsck.minix, mkfs.minix
+
+=for html <br>
+
+Mark Whitley <markw@lineo.com>
+
+ sed remix, bug fixes, style-guide, etc.
+
+=for html <br>
+
+Charles P. Wright <cpwright@villagenet.com>
+
+ gzip, mini-netcat(nc)
+
+=for html <br>
+
+Enrique Zanardi <ezanardi@ull.es>
+
+ tarcat (since removed), loadkmap, various fixes, Debian maintenance
+
+=cut
+
+# $Id: busybox_footer.pod,v 1.1 2001/04/05 19:41:23 beppu Exp $
--- /dev/null
+# 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
+
projects / oweals / busybox.git / commitdiff