1BUSYBOX(1) BusyBox BUSYBOX(1)
2
6 BusyBox - The Swiss Army Knife of Embedded Linux
7
9 busybox <applet> [arguments...] # or
10 <applet> [arguments...] # if symlinked
12
14 BusyBox combines tiny versions of many common UNIX utilities into a
15 single small executable. It provides minimalist replacements for most
16 of the utilities you usually find in GNU coreutils, util-linux, etc.
17 The utilities in BusyBox generally have fewer options than their full-
18 featured GNU cousins; however, the options that are included provide
19 the expected functionality and behave very much like their GNU
20 counterparts.
21 BusyBox has been written with size-optimization and limited resources
23 in mind. It is also extremely modular so you can easily include or
24 exclude commands (or features) at compile time. This makes it easy to
25 customize your embedded systems. To create a working system, just add
26 /dev, /etc, and a Linux kernel. BusyBox provides a fairly complete
27 POSIX environment for any small or embedded system.
28 BusyBox is extremely configurable. This allows you to include only the
30 components you need, thereby reducing binary size. Run 'make config' or
31 'make menuconfig' to select the functionality that you wish to enable.
32 Then run 'make' to compile BusyBox using your configuration.
33 After the compile has finished, you should use 'make install' to
35 install BusyBox. This will install the 'bin/busybox' binary, in the
36 target directory specified by CONFIG_PREFIX. CONFIG_PREFIX can be set
37 when configuring BusyBox, or you can specify an alternative location at
38 install time (i.e., with a command line like 'make
39 CONFIG_PREFIX=/tmp/foo install'). If you enabled any applet
40 installation scheme (either as symlinks or hardlinks), these will also
41 be installed in the location pointed to by CONFIG_PREFIX.
42
44 BusyBox is a multi-call binary. A multi-call binary is an executable
45 program that performs the same job as more than one utility program.
46 That means there is just a single BusyBox binary, but that single
47 binary acts like a large number of utilities. This allows BusyBox to
48 be smaller since all the built-in utility programs (we call them
49 applets) can share code for many common operations.
50 You can also invoke BusyBox by issuing a command as an argument on the
52 command line. For example, entering
53 /bin/busybox ls
55 will also cause BusyBox to behave as 'ls'.
57 Of course, adding '/bin/busybox' into every command would be painful.
59 So most people will invoke BusyBox using links to the BusyBox binary.
60 For example, entering
62 ln -s /bin/busybox ls
64 ./ls
65 will cause BusyBox to behave as 'ls' (if the 'ls' command has been
67 compiled into BusyBox). Generally speaking, you should never need to
68 make all these links yourself, as the BusyBox build system will do this
69 for you when you run the 'make install' command.
70 If you invoke BusyBox with no arguments, it will provide you with a
72 list of the applets that have been compiled into your BusyBox binary.
73
75 Most BusyBox applets support the --help argument to provide a terse
76 runtime description of their behavior. If the
77 CONFIG_FEATURE_VERBOSE_USAGE option has been enabled, more detailed
78 usage information will also be available.
79
81 Currently available applets include:
82 [, [[, ash, basename, bunzip2, bzcat, cat, chroot, chvt, clear, cp,
84 cpio, cut, date, dd, depmod, df, dirname, dmesg, du, echo, eject,
85 env, expr, false, fbset, fdisk, ftpget, gunzip, gzip, halt, head,
86 insmod, ip, ipaddr, iplink, iproute, kill, killall, killall5, ln,
87 ls, lsmod, lzmacat, md5sum, mdev, mkdir, mknod, modprobe, mount, mv,
88 ping, ping6, poweroff, ps, pwd, reboot, reset, rm, rmdir, rmmod,
89 run-parts, setkeycodes, sh, sleep, sync, tail, tar, tee, test, true,
90 umount, uname, unlzma, unzip, yes, zcat
91
93 basename
94 basename FILE [SUFFIX]
95 Strip directory path and suffixes from FILE. If specified, also
97 remove any trailing SUFFIX.
98 bunzip2
100 bunzip2 [OPTIONS] [FILE]
101 Uncompress FILE (or standard input if FILE is '-' or omitted)
103 Options:
105 -c Write to standard output
107 -f Force
108 bzcat
110 bzcat FILE
111 Uncompress to stdout
113 cat cat [-u] [FILE]...
115 Concatenate FILE(s) and print them to stdout
117 Options:
119 -u Use unbuffered i/o (ignored)
121 chroot
123 chroot NEWROOT [PROG [ARGS]]
124 Run PROG with root directory set to NEWROOT
126 chvt
128 chvt N
129 Change the foreground virtual terminal to /dev/ttyN
131 clear
133 clear
134 Clear screen
136 cp cp [OPTIONS] SOURCE DEST
138 Copy SOURCE to DEST, or multiple SOURCE(s) to DIRECTORY
140 Options:
142 -a Same as -dpR
144 -d,-P Preserve links
145 -H,-L Dereference all symlinks (default)
146 -p Preserve file attributes if possible
147 -f Force overwrite
148 -i Prompt before overwrite
149 -R,-r Recurse directories
150 -l,-s Create (sym)links
151 cpio
153 cpio -[tidmvu] [-F FILE]
154 Extract or list files from a cpio archive Main operation mode:
156 -t List
158 -i Extract
159 Options:
160 -d Make leading directories
162 -m Preserve mtime
163 -v Verbose
164 -u Overwrite
165 -F Input file
166 cut cut [OPTIONS] [FILE]...
168 Print selected fields from each input FILE to standard output
170 Options:
172 -b LIST Output only bytes from LIST
174 -c LIST Output only characters from LIST
175 -d CHAR Use CHAR instead of tab as the field delimiter
176 -s Output only the lines containing delimiter
177 -f N Print only these fields
178 -n Ignored
179 date
181 date [OPTIONS] [+FMT] [TIME]
182 Display time (using +FMT), or set time
184 Options:
186 [-s] TIME Set time to TIME
188 -u Work in UTC (don't convert to local time)
189 -R Output RFC-822 compliant date string
190 -I[SPEC] Output ISO-8601 compliant date string
191 SPEC='date' (default) for date only,
192 'hours', 'minutes', or 'seconds' for date and
193 time to the indicated precision
194 -r FILE Display last modification time of FILE
195 -d TIME Display TIME, not 'now'
196 -D FMT Use FMT for -d TIME conversion
197 Recognized TIME formats:
199 hh:mm[:ss]
201 [YYYY.]MM.DD-hh:mm[:ss]
202 YYYY-MM-DD hh:mm[:ss]
203 [[[[[YY]YY]MM]DD]hh]mm[.ss]
204 dd dd [if=FILE] [of=FILE] [ibs=N] [obs=N] [bs=N] [count=N] [skip=N]
206 [seek=N] [conv=notrunc|noerror|sync|fsync]
207 Copy a file with converting and formatting
209 Options:
211 if=FILE Read from FILE instead of stdin
213 of=FILE Write to FILE instead of stdout
214 bs=N Read and write N bytes at a time
215 ibs=N Read N bytes at a time
216 obs=N Write N bytes at a time
217 count=N Copy only N input blocks
218 skip=N Skip N input blocks
219 seek=N Skip N output blocks
220 conv=notrunc Don't truncate output file
221 conv=noerror Continue after read errors
222 conv=sync Pad blocks with zeros
223 conv=fsync Physically write data out before finishing
224 Numbers may be suffixed by c (x1), w (x2), b (x512), kD (x1000), k
226 (x1024), MD (x1000000), M (x1048576), GD (x1000000000) or G
227 (x1073741824)
228 df df [-Pkmhai] [-B SIZE] [FILESYSTEM...]
230 Print filesystem usage statistics
232 Options:
234 -P POSIX output format
236 -k 1024-byte blocks (default)
237 -m 1M-byte blocks
238 -h Human readable (e.g. 1K 243M 2G)
239 -a Show all filesystems
240 -i Inodes
241 -B SIZE Blocksize
242 dirname
244 dirname FILENAME
245 Strip non-directory suffix from FILENAME
247 dmesg
249 dmesg [-c] [-n LEVEL] [-s SIZE]
250 Print or control the kernel ring buffer
252 Options:
254 -c Clear ring buffer after printing
256 -n LEVEL Set console logging level
257 -s SIZE Buffer size
258 du du [-aHLdclsxhmk] [FILE]...
260 Summarize disk space used for each FILE and/or directory. Disk
262 space is printed in units of 512 bytes.
263 Options:
265 -a Show file sizes too
267 -H Follow symlinks on command line
268 -L Follow all symlinks
269 -d N Limit output to directories (and files with -a) of depth < N
270 -c Show grand total
271 -l Count sizes many times if hard linked
272 -s Display only a total for each argument
273 -x Skip directories on different filesystems
274 -h Sizes in human readable format (e.g., 1K 243M 2G )
275 -m Sizes in megabytes
276 -k Sizes in kilobytes
277 echo
279 echo [-neE] [ARG...]
280 Print the specified ARGs to stdout
282 Options:
284 -n Suppress trailing newline
286 -e Interpret backslash-escaped characters (i.e., \t=tab)
287 -E Disable interpretation of backslash-escaped characters
288 eject
290 eject [-t] [-T] [DEVICE]
291 Eject specified DEVICE (or default /dev/cdrom)
293 Options:
295 -s SCSI device
297 -t Close tray
298 -T Open/close tray (toggle)
299 env env [-iu] [-] [name=value]... [PROG [ARGS]]
301 Print the current environment or run PROG after setting up the
303 specified environment
304 Options:
306 -, -i Start with an empty environment
308 -u Remove variable from the environment
309 expr
311 expr EXPRESSION
312 Print the value of EXPRESSION to standard output.
314 EXPRESSION may be:
316 ARG1 | ARG2 ARG1 if it is neither null nor 0, otherwise ARG2
318 ARG1 & ARG2 ARG1 if neither argument is null or 0, otherwise 0
319 ARG1 < ARG2 1 if ARG1 is less than ARG2, else 0. Similarly:
320 ARG1 <= ARG2
321 ARG1 = ARG2
322 ARG1 != ARG2
323 ARG1 >= ARG2
324 ARG1 > ARG2
325 ARG1 + ARG2 Sum of ARG1 and ARG2. Similarly:
326 ARG1 - ARG2
327 ARG1 * ARG2
328 ARG1 / ARG2
329 ARG1 % ARG2
330 STRING : REGEXP Anchored pattern match of REGEXP in STRING
331 match STRING REGEXP Same as STRING : REGEXP
332 substr STRING POS LENGTH Substring of STRING, POS counted from 1
333 index STRING CHARS Index in STRING where any CHARS is found, or 0
334 length STRING Length of STRING
335 quote TOKEN Interpret TOKEN as a string, even if
336 it is a keyword like 'match' or an
337 operator like '/'
338 (EXPRESSION) Value of EXPRESSION
339 Beware that many operators need to be escaped or quoted for shells.
341 Comparisons are arithmetic if both ARGs are numbers, else
342 lexicographical. Pattern matches return the string matched between
343 \( and \) or null; if \( and \) are not used, they return the
344 number of characters matched or 0.
345 false
347 false
348 Return an exit code of FALSE (1)
350 fbset
352 fbset [OPTIONS] [MODE]
353 Show and modify frame buffer settings
355 fdisk
357 fdisk [-ul] [-C CYLINDERS] [-H HEADS] [-S SECTORS] [-b SSZ] DISK
358 Change partition table
360 Options:
362 -u Start and End are in sectors (instead of cylinders)
364 -l Show partition table for each DISK, then exit
365 -b 2048 (for certain MO disks) use 2048-byte sectors
366 -C CYLINDERS Set number of cylinders/heads/sectors
367 -H HEADS
368 -S SECTORS
370 ftpget
372 ftpget [OPTIONS] HOST LOCAL_FILE REMOTE_FILE
373 Retrieve a remote file via FTP
375 Options:
377 -c,--continue Continue previous transfer
379 -v,--verbose Verbose
380 -u,--username Username
381 -p,--password Password
382 -P,--port Port number
383 gunzip
385 gunzip [OPTIONS] [FILE]...
386 Uncompress FILEs (or standard input)
388 Options:
390 -c Write to standard output
392 -f Force
393 -t Test file integrity
394 gzip
396 gzip [OPTIONS] [FILE]...
397 Compress FILEs (or standard input)
399 Options:
401 -c Write to standard output
403 -d Decompress
404 -f Force
405 halt
407 halt [-d delay] [-n] [-f]
408 Halt the system
410 Options:
412 -d Delay interval for halting
414 -n No call to sync()
415 -f Force halt (don't go through init)
416 head
418 head [OPTIONS] [FILE]...
419 Print first 10 lines of each FILE to standard output. With more
421 than one FILE, precede each with a header giving the file name.
422 With no FILE, or when FILE is -, read standard input.
423 Options:
425 -n NUM Print first NUM lines instead of first 10
427 -c NUM Output the first NUM bytes
428 -q Never output headers giving file names
429 -v Always output headers giving file names
430 insmod
432 insmod FILE [symbol=value]...
433 Load the specified kernel modules into the kernel
435 ip ip [OPTIONS] {address | route | link | } {COMMAND}
437 ip [OPTIONS] OBJECT {COMMAND} where OBJECT := {address | route |
439 link | } OPTIONS := { -f[amily] { inet | inet6 | link } |
440 -o[neline] }
441 ipaddr
443 ipaddr { {add|del} IFADDR dev STRING | {show|flush} [dev
444 STRING] [to PREFIX] }
445 ipaddr {add|delete} IFADDR dev STRING ipaddr {show|flush} [dev
447 STRING] [scope SCOPE-ID] [to PREFIX] [label PATTERN]
448 IFADDR := PREFIX | ADDR peer PREFIX [broadcast ADDR]
449 [anycast ADDR] [label STRING] [scope SCOPE-ID] SCOPE-ID
450 := [host | link | global | NUMBER]
451 iplink
453 iplink { set DEVICE { up | down | arp { on | off } | show [DEVICE]
454 }
455 iplink set DEVICE { up | down | arp | multicast { on | off } |
457 dynamic { on | off } | mtu MTU }
458 iplink show [DEVICE]
459 iproute
461 iproute { list | flush | { add | del | change | append |
462 replace | monitor } ROUTE }
463 iproute { list | flush } SELECTOR iproute get ADDRESS [from ADDRESS
465 iif STRING] [oif STRING] [tos TOS] iproute { add |
466 del | change | append | replace | monitor } ROUTE
467 SELECTOR := [root PREFIX] [match PREFIX] [proto
468 RTPROTO] ROUTE := [TYPE] PREFIX [tos TOS] [proto
469 RTPROTO] [metric METRIC]
470 kill
472 kill [-l] [-SIG] PID...
473 Send a signal (default is TERM) to given PIDs
475 Options:
477 -l List all signal names and numbers
479 killall
481 killall [-l] [-q] [-SIG] process-name...
482 Send a signal (default is TERM) to given processes
484 Options:
486 -l List all signal names and numbers
488 -q Do not complain if no processes were killed
489 killall5
491 killall5 [-l] [-SIG] [-o PID]...
492 Send a signal (default is TERM) to all processes outside current
494 session
495 Options:
497 -l List all signal names and numbers
499 -o PID Do not signal this PID
500 ln ln [OPTIONS] TARGET... LINK_NAME|DIRECTORY
502 Create a link named LINK_NAME or DIRECTORY to the specified TARGET.
504 Use '--' to indicate that all following arguments are non-options.
505 Options:
507 -s Make symlinks instead of hardlinks
509 -f Remove existing destination files
510 -n Don't dereference symlinks - treat like normal file
511 -b Make a backup of the target (if exists) before link operation
512 -S suf Use suffix instead of ~ when making backup files
513 ls ls [-1AacCdeFilnpLRsTtuwxhk] [FILE]...
515 List directory contents
517 Options:
519 -1 List in a single column
521 -A Don't list . and ..
522 -a Don't hide entries starting with .
523 -C List by columns
524 -c With -l: sort by ctime
525 -d List directory entries instead of contents
526 -e List full date and time
527 -F Append indicator (one of */=@|) to entries
528 -i List inode numbers
529 -l Long listing format
530 -n List numeric UIDs and GIDs instead of names
531 -p Append indicator (one of /=@|) to entries
532 -L List entries pointed to by symlinks
533 -R List subdirectories recursively
534 -s List the size of each file, in blocks
535 -T NUM Assume tabstop every NUM columns
536 -t With -l: sort by modification time
537 -u With -l: sort by access time
538 -w NUM Assume the terminal is NUM columns wide
539 -x List by lines
540 -h List sizes in human readable format (1K 243M 2G)
541 lsmod
543 lsmod
544 List the currently loaded kernel modules
546 lzmacat
548 lzmacat FILE
549 Uncompress to stdout
551 md5sum
553 md5sum [OPTIONS] [FILE]...
554 or: md5sum [OPTIONS] -c [FILE]
555 Print or check MD5 checksums
557 Options:
559 -c Check sums against given list
561 -s Don't output anything, status code shows success
562 -w Warn about improperly formatted checksum lines
563 mdev
565 mdev [-s]
566 -s Scan /sys and populate /dev during system boot
568 It can be run by kernel as a hotplug helper. To activate it:
570 echo /bin/mdev >/proc/sys/kernel/hotplug It uses /etc/mdev.conf
571 with lines [-]DEVNAME UID:GID PERM [>|=PATH] [@|$|*PROG]
572 mkdir
574 mkdir [OPTIONS] DIRECTORY...
575 Create DIRECTORY
577 Options:
579 -m Set permission mode (as in chmod), not rwxrwxrwx - umask
581 -p No error if existing, make parent directories as needed
582 mknod
584 mknod [OPTIONS] NAME TYPE MAJOR MINOR
585 Create a special file (block, character, or pipe)
587 Options:
589 -m Create the special file using the specified mode (default a=rw)
591 TYPEs include:
592 b: Make a block device
594 c or u: Make a character device
595 p: Make a named pipe (MAJOR and MINOR are ignored)
596 modprobe
598 modprobe [-knqrsv] MODULE [symbol=value...]
599 Options:
601 -n Dry run
603 -q Quiet
604 -r Remove module (stacks) or do autoclean
605 -s Report via syslog instead of stderr
606 -v Verbose
607 -b Apply blacklist to module names too
608 mount
610 mount [flags] DEVICE NODE [-o OPT,OPT]
611 Mount a filesystem. Filesystem autodetection requires /proc be
613 mounted.
614 Options:
616 -a Mount all filesystems in fstab
618 -f Dry run
619 -r Read-only mount
620 -w Read-write mount (default)
621 -t FSTYPE Filesystem type
622 -O OPT Mount only filesystems with option OPT (-a only)
623 -o OPT:
624 [a]sync Writes are [a]synchronous
625 [no]atime Disable/enable updates to inode access times
626 [no]diratime Disable/enable atime updates to directories
627 [no]relatime Disable/enable atime updates relative to modification time
628 [no]dev (Dis)allow use of special device files
629 [no]exec (Dis)allow use of executable files
630 [no]suid (Dis)allow set-user-id-root programs
631 [r]shared Convert [recursively] to a shared subtree
632 [r]slave Convert [recursively] to a slave subtree
633 [r]private Convert [recursively] to a private subtree
634 [un]bindable Make mount point [un]able to be bind mounted
635 bind Bind a directory to an additional location
636 move Relocate an existing mount point
637 remount Remount a mounted filesystem, changing its flags
638 ro/rw Read-only/read-write mount
639 There are EVEN MORE flags that are specific to each filesystem
641 You'll have to see the written documentation for those filesystems
642 mv mv [OPTIONS] SOURCE DEST or: mv [OPTIONS] SOURCE... DIRECTORY
644 Rename SOURCE to DEST, or move SOURCE(s) to DIRECTORY
646 Options:
648 -f Don't prompt before overwriting
650 -i Interactive, prompt before overwrite
651 ping
653 ping host
654 Send ICMP ECHO_REQUEST packets to network hosts
656 ping6
658 ping6 host
659 Send ICMP ECHO_REQUEST packets to network hosts
661 poweroff
663 poweroff [-d delay] [-n] [-f]
664 Halt and shut off power
666 Options:
668 -d Delay interval for halting
670 -n No call to sync()
671 -f Force power off (don't go through init)
672 ps ps
674 Report process status
676 Options:
678 -o col1,col2=header Select columns for display
680 pwd pwd
682 Print the full filename of the current working directory
684 reboot
686 reboot [-d delay] [-n] [-f]
687 Reboot the system
689 Options:
691 -d Delay interval for rebooting
693 -n No call to sync()
694 -f Force reboot (don't go through init)
695 reset
697 reset
698 Reset the screen
700 rm rm [OPTIONS] FILE...
702 Remove (unlink) the FILE(s). Use '--' to indicate that all
704 following arguments are non-options.
705 Options:
707 -i Always prompt before removing
709 -f Never prompt
710 -r,-R Remove directories recursively
711 rmdir
713 rmdir [OPTIONS] DIRECTORY...
714 Remove the DIRECTORY, if it is empty.
716 Options:
718 -p|--parents Include parents
720 -ignore-fail-on-non-empty
721 rmmod
723 rmmod [OPTIONS] [MODULE]...
724 Unload the specified kernel modules from the kernel
726 Options:
728 -w Wait until the module is no longer used
730 -f Force unloading
731 -a Remove all unused modules (recursively)
732 run-parts
734 run-parts [-t] [-a ARG] [-u MASK] DIRECTORY
735 Run a bunch of scripts in a directory
737 Options:
739 -t Print what would be run, but don't actually run anything
741 -a ARG Pass ARG as argument for every program
742 -u MASK Set the umask to MASK before running every program
743 setkeycodes
745 setkeycodes SCANCODE KEYCODE...
746 Set entries into the kernel's scancode-to-keycode map, allowing
748 unusual keyboards to generate usable keycodes.
749 SCANCODE may be either xx or e0xx (hexadecimal), and KEYCODE is
751 given in decimal
752 sleep
754 sleep [N]...
755 Pause for a time equal to the total of the args given, where each
757 arg can have an optional suffix of (s)econds, (m)inutes, (h)ours,
758 or (d)ays
759 sync
761 sync
762 Write all buffered blocks to disk
764 tail
766 tail [OPTIONS] [FILE]...
767 Print last 10 lines of each FILE to standard output. With more
769 than one FILE, precede each with a header giving the file name.
770 With no FILE, or when FILE is -, read standard input.
771 Options:
773 -c N[kbm] Output the last N bytes
775 -n N[kbm] Print last N lines instead of last 10
776 -f Output data as the file grows
777 -q Never output headers giving file names
778 -s SEC Wait SEC seconds between reads with -f
779 -v Always output headers giving file names
780 If the first character of N (bytes or lines) is a '+', output
782 begins with the Nth item from the start of each file, otherwise,
783 print the last N items in the file. N bytes may be suffixed by k
784 (x1024), b (x512), or m (1024^2).
785 tar tar -[czjaxtvO] [-X FILE] [-f TARFILE] [-C DIR] [FILE(s)]...
787 Create, extract, or list files from a tar file
789 Options:
791 c Create
793 x Extract
794 t List
795 Archive format selection:
796 z Filter the archive through gzip
798 j Filter the archive through bzip2
799 a Filter the archive through lzma
800 File selection:
801 f Name of TARFILE or "-" for stdin
803 O Extract to stdout
804 exclude File to exclude
805 X File with names to exclude
806 C Change to directory DIR before operation
807 v Verbose
808 tee tee [OPTIONS] [FILE]...
810 Copy standard input to each FILE, and also to standard output
812 Options:
814 -a Append to the given FILEs, do not overwrite
816 -i Ignore interrupt signals (SIGINT)
817 test
819 test EXPRESSION ]
820 Check file types, compare values etc. Return a 0/1 exit code
822 depending on logical value of EXPRESSION
823 true
825 true
826 Return an exit code of TRUE (0)
828 umount
830 umount [flags] FILESYSTEM|DIRECTORY
831 Unmount file systems
833 Options:
835 -a Unmount all file systems
837 -r Try to remount devices as read-only if mount is busy
838 -l Lazy umount (detach filesystem)
839 -f Force umount (i.e., unreachable NFS server)
840 uname
842 uname [-amnrspv]
843 Print system information.
845 Options:
847 -a Print all
849 -m The machine (hardware) type
850 -n Hostname
851 -r OS release
852 -s OS name (default)
853 -p Processor type
854 -v OS version
855 unlzma
857 unlzma [OPTIONS] [FILE]
858 Uncompress FILE (or standard input if FILE is '-' or omitted)
860 Options:
862 -c Write to standard output
864 -f Force
865 unzip
867 unzip [-opts[modifiers]] file[.zip] [list] [-x xlist] [-d exdir]
868 Extract files from ZIP archives
870 Options:
872 -l List archive contents (with -q for short form)
874 -n Never overwrite existing files (default)
875 -o Overwrite files without prompting
876 -p Send output to stdout
877 -q Quiet
878 -x Exclude these files
879 -d Extract files into this directory
880 yes yes [OPTIONS] [STRING]
882 Repeatedly output a line with STRING, or 'y'
884 zcat
886 zcat FILE
887 Uncompress to stdout
889
891 GNU Libc (glibc) uses the Name Service Switch (NSS) to configure the
892 behavior of the C library for the local environment, and to configure
893 how it reads system data, such as passwords and group information.
894 This is implemented using an /etc/nsswitch.conf configuration file, and
895 using one or more of the /lib/libnss_* libraries. BusyBox tries to
896 avoid using any libc calls that make use of NSS. Some applets however,
897 such as login and su, will use libc functions that require NSS.
898 If you enable CONFIG_USE_BB_PWD_GRP, BusyBox will use internal
900 functions to directly access the /etc/passwd, /etc/group, and
901 /etc/shadow files without using NSS. This may allow you to run your
902 system without the need for installing any of the NSS configuration
903 files and libraries.
904 When used with glibc, the BusyBox 'networking' applets will similarly
906 require that you install at least some of the glibc NSS stuff (in
907 particular, /etc/nsswitch.conf, /lib/libnss_dns*, /lib/libnss_files*,
908 and /lib/libresolv*).
909 Shameless Plug: As an alternative, one could use a C library such as
911 uClibc. In addition to making your system significantly smaller,
912 uClibc does not require the use of any NSS support files or libraries.
913
915 Denis Vlasenko <vda.linux@googlemail.com>
916
918 The following people have contributed code to BusyBox whether they know
919 it or not. If you have written code included in BusyBox, you should
920 probably be listed here so you can obtain your bit of eternal glory.
921 If you should be listed here, or the description of what you have done
922 needs more detail, or is incorect, please send in an update.
923 Emanuele Aina <emanuele.aina@tiscali.it>
925 run-parts
926 Erik Andersen <andersen@codepoet.org>
928 Tons of new stuff, major rewrite of most of the
930 core apps, tons of new apps as noted in header files.
931 Lots of tedious effort writing these boring docs that
932 nobody is going to actually read.
933 Laurence Anderson <l.d.anderson@warwick.ac.uk>
935 rpm2cpio, unzip, get_header_cpio, read_gz interface, rpm
937 Jeff Angielski <jeff@theptrgroup.com>
939 ftpput, ftpget
941 Edward Betts <edward@debian.org>
943 expr, hostid, logname, whoami
945 John Beppu <beppu@codepoet.org>
947 du, nslookup, sort
949 Brian Candler <B.Candler@pobox.com>
951 tiny-ls(ls)
953 Randolph Chung <tausq@debian.org>
955 fbset, ping, hostname
957 Dave Cinege <dcinege@psychosis.com>
959 more(v2), makedevs, dutmp, modularization, auto links file,
961 various fixes, Linux Router Project maintenance
962 Jordan Crouse <jordan@cosmicpenguin.net>
964 ipcalc
966 Magnus Damm <damm@opensource.se>
968 tftp client insmod powerpc support
970 Larry Doolittle <ldoolitt@recycle.lbl.gov>
972 pristine source directory compilation, lots of patches and fixes.
974 Glenn Engel <glenne@engel.org>
976 httpd
978 Gennady Feldman <gfeldman@gena01.com>
980 Sysklogd (single threaded syslogd, IPC Circular buffer support,
982 logread), various fixes.
983 Karl M. Hegbloom <karlheg@debian.org>
985 cp_mv.c, the test suite, various fixes to utility.c, &c.
987 Daniel Jacobowitz <dan@debian.org>
989 mktemp.c
991 Matt Kraai <kraai@alumni.cmu.edu>
993 documentation, bugfixes, test suite
995 Stephan Linz <linz@li-pro.net>
997 ipcalc, Red Hat equivalence
999 John Lombardo <john@deltanet.com>
1001 tr
1003 Glenn McGrath <bug1@iinet.net.au>
1005 Common unarchving code and unarchiving applets, ifupdown, ftpgetput,
1007 nameif, sed, patch, fold, install, uudecode.
1008 Various bugfixes, review and apply numerous patches.
1009 Manuel Novoa III <mjn3@codepoet.org>
1011 cat, head, mkfifo, mknod, rmdir, sleep, tee, tty, uniq, usleep, wc, yes,
1013 mesg, vconfig, make_directory, parse_mode, dirname, mode_string,
1014 get_last_path_component, simplify_path, and a number trivial libbb routines
1015 also bug fixes, partial rewrites, and size optimizations in
1017 ash, basename, cal, cmp, cp, df, du, echo, env, ln, logname, md5sum, mkdir,
1018 mv, realpath, rm, sort, tail, touch, uname, watch, arith, human_readable,
1019 interface, dutmp, ifconfig, route
1020 Vladimir Oleynik <dzo@simtreas.ru>
1022 cmdedit; xargs(current), httpd(current);
1024 ports: ash, crond, fdisk, inetd, stty, traceroute, top;
1025 locale, various fixes
1026 and irreconcilable critic of everything not perfect.
1027 Bruce Perens <bruce@pixar.com>
1029 Original author of BusyBox in 1995, 1996. Some of his code can
1031 still be found hiding here and there...
1032 Tim Riker <Tim@Rikers.org>
1034 bug fixes, member of fan club
1036 Kent Robotti <robotti@metconnect.com>
1038 reset, tons and tons of bug reports and patches.
1040 Chip Rosenthal <chip@unicom.com>, <crosenth@covad.com>
1042 wget - Contributed by permission of Covad Communications
1044 Pavel Roskin <proski@gnu.org>
1046 Lots of bugs fixes and patches.
1048 Gyepi Sam <gyepi@praxis-sw.com>
1050 Remote logging feature for syslogd
1052 Linus Torvalds <torvalds@transmeta.com>
1054 mkswap, fsck.minix, mkfs.minix
1056 Mark Whitley <markw@codepoet.org>
1058 grep, sed, cut, xargs(previous),
1060 style-guide, new-applet-HOWTO, bug fixes, etc.
1061 Charles P. Wright <cpwright@villagenet.com>
1063 gzip, mini-netcat(nc)
1065 Enrique Zanardi <ezanardi@ull.es>
1067 tarcat (since removed), loadkmap, various fixes, Debian maintenance
1069 Tito Ragusa <farmatito@tiscali.it>
1071 devfsd and size optimizations in strings, openvt and deallocvt.
1073version 1.15.1 2015-02-19 BUSYBOX(1)