Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1 | # vi: set sw=4 ts=4: |
John Beppu | 08e7f75 | 2000-04-13 03:22:20 +0000 | [diff] [blame] | 2 | |
John Beppu | 3a1b6be | 2000-01-18 15:45:59 +0000 | [diff] [blame] | 3 | =head1 NAME |
| 4 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 5 | BusyBox - The Swiss Army Knife of Embedded Linux |
John Beppu | 3a1b6be | 2000-01-18 15:45:59 +0000 | [diff] [blame] | 6 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 7 | =head1 SYNTAX |
John Beppu | 3a1b6be | 2000-01-18 15:45:59 +0000 | [diff] [blame] | 8 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 9 | BusyBox <function> [arguments...] # or |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 10 | |
| 11 | <function> [arguments...] # if symlinked |
John Beppu | 3a1b6be | 2000-01-18 15:45:59 +0000 | [diff] [blame] | 12 | |
| 13 | =head1 DESCRIPTION |
| 14 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 15 | BusyBox combines tiny versions of many common UNIX utilities into a single |
| 16 | small executable. It provides minimalist replacements for most of the utilities |
| 17 | you usually find in fileutils, shellutils, findutils, textutils, grep, gzip, |
| 18 | tar, etc. BusyBox provides a fairly complete POSIX environment for any small |
Eric Andersen | 98cd53e | 2000-06-16 19:56:44 +0000 | [diff] [blame] | 19 | or embedded system. The utilities in BusyBox generally have fewer options than |
Eric Andersen | f2fffef | 2000-06-05 17:23:06 +0000 | [diff] [blame] | 20 | their full-featured GNU cousins; however, the options that are included provide |
Pavel Roskin | 1a804e4 | 2000-06-21 21:38:00 +0000 | [diff] [blame] | 21 | the expected functionality and behave very much like their GNU counterparts. |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 22 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 23 | BusyBox has been written with size-optimization and limited resources in mind. |
| 24 | It is also extremely modular so you can easily include or exclude commands (or |
| 25 | features) at compile time. This makes it easy to customize your embedded |
| 26 | systems. To create a working system, just add a kernel, a shell (such as ash), |
| 27 | and an editor (such as elvis-tiny or ae). |
| 28 | |
| 29 | =head1 USAGE |
| 30 | |
| 31 | When you create a link to BusyBox for the function you wish to use, when BusyBox |
| 32 | is called using that link it will behave as if the command itself has been invoked. |
| 33 | |
| 34 | For example, entering |
| 35 | |
| 36 | ln -s ./BusyBox ls |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 37 | ./ls |
| 38 | |
| 39 | will cause BusyBox to behave as 'ls' (if the 'ls' command has been compiled |
Pavel Roskin | 1a804e4 | 2000-06-21 21:38:00 +0000 | [diff] [blame] | 40 | into BusyBox). |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 41 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 42 | You can also invoke BusyBox by issuing the command as an argument on the |
| 43 | command line. For example, entering |
| 44 | |
| 45 | ./BusyBox ls |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 46 | |
| 47 | will also cause BusyBox to behave as 'ls'. |
John Beppu | 08fe43d | 2000-01-19 12:39:16 +0000 | [diff] [blame] | 48 | |
Erik Andersen | eef6580 | 2000-04-19 05:12:02 +0000 | [diff] [blame] | 49 | =head1 COMMON OPTIONS |
| 50 | |
| 51 | Most BusyBox commands support the B<--help> option to provide a |
| 52 | terse runtime description of their behavior. |
| 53 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 54 | =head1 COMMANDS |
| 55 | |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 56 | Currently defined functions include: |
| 57 | |
Eric Andersen | cff3fe3 | 2000-09-20 19:22:26 +0000 | [diff] [blame] | 58 | ar, basename, cat, chgrp, chmod, chown, chroot, chvt, clear, cp, cut, date, dc, |
| 59 | dd, deallocvt, df, dirname, dmesg, dos2unix, du, dumpkmap, dutmp, echo, false, |
| 60 | fbset, fdflush, find, free, freeramdisk, fsck.minix, getopt, grep, gunzip, |
| 61 | gzip, halt, head, hostid, hostname, id, init, insmod, kill, killall, length, |
| 62 | ln, loadacm, loadfont, loadkmap, logger, logname, ls, lsmod, makedevs, mkdir, |
| 63 | mkfifo, mkfs.minix, mknod, mkswap, mktemp, more, mount, mt, mv, nc, nslookup, |
| 64 | ping, poweroff, printf, ps, pwd, rdate, reboot, renice, reset, rm, rmdir, |
| 65 | rmmod, sed, setkeycodes, sh, sleep, sort, swapoff, swapon, sync, syslogd, tail, |
| 66 | tar, tee, telnet, test, touch, tr, true, tty, umount, uname, uniq, unix2dos, |
Eric Andersen | 5b17693 | 2000-09-22 20:22:28 +0000 | [diff] [blame] | 67 | unrpm, update, uptime, usleep, uudecode, uuencode, wc, which, whoami, xargs, |
| 68 | yes, zcat, [ |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 69 | |
Erik Andersen | a19bc64 | 2000-05-02 06:40:02 +0000 | [diff] [blame] | 70 | ------------------------------- |
| 71 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 72 | =over 4 |
| 73 | |
Eric Andersen | 86ab8a3 | 2000-06-02 03:21:42 +0000 | [diff] [blame] | 74 | =item ar |
| 75 | |
| 76 | Usage: ar [optxvV] archive [filenames] |
| 77 | |
| 78 | Extract or list files from an ar archive. |
| 79 | |
| 80 | Options: |
| 81 | |
| 82 | o preserve original dates |
| 83 | p extract to stdout |
| 84 | t list |
| 85 | x extract |
| 86 | v verbosely list files processed |
| 87 | |
| 88 | ------------------------------- |
| 89 | |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 90 | =item basename |
| 91 | |
Erik Andersen | ac130e1 | 2000-05-10 05:00:31 +0000 | [diff] [blame] | 92 | Usage: basename FILE [SUFFIX] |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 93 | |
Erik Andersen | ac130e1 | 2000-05-10 05:00:31 +0000 | [diff] [blame] | 94 | Strips directory path and suffixes from FILE. |
| 95 | If specified, also removes any trailing SUFFIX. |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 96 | |
Pavel Roskin | 1a804e4 | 2000-06-21 21:38:00 +0000 | [diff] [blame] | 97 | Example: |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 98 | |
| 99 | $ basename /usr/local/bin/foo |
| 100 | foo |
| 101 | $ basename /usr/local/bin/ |
| 102 | bin |
Erik Andersen | ac130e1 | 2000-05-10 05:00:31 +0000 | [diff] [blame] | 103 | $ basename /foo/bar.txt .txt |
| 104 | bar |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 105 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 106 | ------------------------------- |
| 107 | |
Erik Andersen | a6c7522 | 2000-04-18 00:00:52 +0000 | [diff] [blame] | 108 | =item cat |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 109 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 110 | Usage: cat [FILE ...] |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 111 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 112 | Concatenates FILE(s) and prints them to the standard output. |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 113 | |
| 114 | Example: |
| 115 | |
| 116 | $ cat /proc/uptime |
| 117 | 110716.72 17.67 |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 118 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 119 | ------------------------------- |
| 120 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 121 | =item chgrp |
| 122 | |
| 123 | Usage: chgrp [OPTION]... GROUP FILE... |
| 124 | |
| 125 | Change the group membership of each FILE to GROUP. |
Erik Andersen | 26702fe | 2000-04-17 16:44:46 +0000 | [diff] [blame] | 126 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 127 | Options: |
| 128 | |
| 129 | -R change files and directories recursively |
Erik Andersen | 26702fe | 2000-04-17 16:44:46 +0000 | [diff] [blame] | 130 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 131 | Example: |
| 132 | |
| 133 | $ ls -l /tmp/foo |
| 134 | -r--r--r-- 1 andersen andersen 0 Apr 12 18:25 /tmp/foo |
| 135 | $ chgrp root /tmp/foo |
| 136 | $ ls -l /tmp/foo |
| 137 | -r--r--r-- 1 andersen root 0 Apr 12 18:25 /tmp/foo |
| 138 | |
| 139 | ------------------------------- |
| 140 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 141 | =item chmod |
| 142 | |
John Beppu | f17792c | 2000-04-13 03:16:01 +0000 | [diff] [blame] | 143 | Usage: chmod [B<-R>] MODE[,MODE]... FILE... |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 144 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 145 | Changes file access permissions for the specified FILE(s) (or directories). |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 146 | Each MODE is defined by combining the letters for WHO has access to the file, |
| 147 | an OPERATOR for selecting how the permissions should be changed, and a |
Eric Andersen | 98cd53e | 2000-06-16 19:56:44 +0000 | [diff] [blame] | 148 | PERMISSION for FILE(s) (or directories). |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 149 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 150 | WHO may be chosen from |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 151 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 152 | u User who owns the file |
| 153 | g Users in the file's Group |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 154 | o Other users not in the file's group |
| 155 | a All users |
| 156 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 157 | OPERATOR may be chosen from |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 158 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 159 | + Add a permission |
| 160 | - Remove a permission |
| 161 | = Assign a permission |
Pavel Roskin | 1a804e4 | 2000-06-21 21:38:00 +0000 | [diff] [blame] | 162 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 163 | PERMISSION may be chosen from |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 164 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 165 | r Read |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 166 | w Write |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 167 | x Execute (or access for directories) |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 168 | s Set user (or group) ID bit |
Eric Andersen | 98cd53e | 2000-06-16 19:56:44 +0000 | [diff] [blame] | 169 | t Sticky bit (for directories prevents removing files by non-owners) |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 170 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 171 | Alternately, permissions can be set numerically where the first three |
| 172 | numbers are calculated by adding the octal values, such as |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 173 | |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 174 | 4 Read |
| 175 | 2 Write |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 176 | 1 Execute |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 177 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 178 | An optional fourth digit can also be used to specify |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 179 | |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 180 | 4 Set user ID |
| 181 | 2 Set group ID |
Eric Andersen | 98cd53e | 2000-06-16 19:56:44 +0000 | [diff] [blame] | 182 | 1 Sticky bit |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 183 | |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 184 | Options: |
| 185 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 186 | -R Change files and directories recursively. |
Pavel Roskin | 1a804e4 | 2000-06-21 21:38:00 +0000 | [diff] [blame] | 187 | |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 188 | Example: |
| 189 | |
| 190 | $ ls -l /tmp/foo |
| 191 | -rw-rw-r-- 1 root root 0 Apr 12 18:25 /tmp/foo |
| 192 | $ chmod u+x /tmp/foo |
| 193 | $ ls -l /tmp/foo |
| 194 | -rwxrw-r-- 1 root root 0 Apr 12 18:25 /tmp/foo* |
| 195 | $ chmod 444 /tmp/foo |
| 196 | $ ls -l /tmp/foo |
| 197 | -r--r--r-- 1 root root 0 Apr 12 18:25 /tmp/foo |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 198 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 199 | ------------------------------- |
| 200 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 201 | =item chown |
| 202 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 203 | Usage: chown [OPTION]... OWNER[<.|:>[GROUP] FILE... |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 204 | |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 205 | Changes the owner and/or group of each FILE to OWNER and/or GROUP. |
John Beppu | 5a50def | 2000-04-17 17:46:46 +0000 | [diff] [blame] | 206 | |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 207 | Options: |
| 208 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 209 | -R Changes files and directories recursively |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 210 | |
| 211 | Example: |
| 212 | |
| 213 | $ ls -l /tmp/foo |
| 214 | -r--r--r-- 1 andersen andersen 0 Apr 12 18:25 /tmp/foo |
| 215 | $ chown root /tmp/foo |
| 216 | $ ls -l /tmp/foo |
| 217 | -r--r--r-- 1 root andersen 0 Apr 12 18:25 /tmp/foo |
| 218 | $ chown root.root /tmp/foo |
| 219 | ls -l /tmp/foo |
| 220 | -r--r--r-- 1 root root 0 Apr 12 18:25 /tmp/foo |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 221 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 222 | ------------------------------- |
| 223 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 224 | =item chroot |
| 225 | |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 226 | Usage: chroot NEWROOT [COMMAND...] |
| 227 | |
| 228 | Run COMMAND with root directory set to NEWROOT. |
Pavel Roskin | 1a804e4 | 2000-06-21 21:38:00 +0000 | [diff] [blame] | 229 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 230 | Example: |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 231 | |
| 232 | $ ls -l /bin/ls |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 233 | lrwxrwxrwx 1 root root 12 Apr 13 00:46 /bin/ls -> /BusyBox |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 234 | $ mount /dev/hdc1 /mnt -t minix |
| 235 | $ chroot /mnt |
| 236 | $ ls -l /bin/ls |
| 237 | -rwxr-xr-x 1 root root 40816 Feb 5 07:45 /bin/ls* |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 238 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 239 | ------------------------------- |
| 240 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 241 | =item chvt |
| 242 | |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 243 | Usage: chvt N |
| 244 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 245 | Changes the foreground virtual terminal to /dev/ttyN |
John Beppu | 50ed067 | 2000-04-13 23:44:04 +0000 | [diff] [blame] | 246 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 247 | ------------------------------- |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 248 | |
Eric Andersen | 028fb62 | 2000-07-04 20:07:13 +0000 | [diff] [blame] | 249 | =item clear |
| 250 | |
| 251 | Clears the screen. |
| 252 | |
| 253 | ------------------------------- |
| 254 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 255 | =item cp |
| 256 | |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 257 | Usage: cp [OPTION]... SOURCE DEST |
| 258 | |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 259 | or: cp [OPTION]... SOURCE... DIRECTORY |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 260 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 261 | Copies SOURCE to DEST, or multiple SOURCE(s) to DIRECTORY. |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 262 | |
Erik Andersen | e31c066 | 2000-05-02 05:32:07 +0000 | [diff] [blame] | 263 | Options: |
| 264 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 265 | -a Same as -dpR |
| 266 | -d Preserves links |
Eric Andersen | 98cd53e | 2000-06-16 19:56:44 +0000 | [diff] [blame] | 267 | -p Preserves file attributes if possible |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 268 | -R Copies directories recursively |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 269 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 270 | ------------------------------- |
| 271 | |
Erik Andersen | 73c8c9c | 2000-05-13 05:36:13 +0000 | [diff] [blame] | 272 | =item cut |
| 273 | |
| 274 | Usage: cut [OPTION]... [FILE]... |
| 275 | |
| 276 | Prints selected fields from each input FILE to standard output. |
| 277 | |
| 278 | Options: |
| 279 | |
Eric Andersen | 1386e70 | 2000-06-26 12:14:30 +0000 | [diff] [blame] | 280 | -b LIST Output only bytes from LIST |
| 281 | -c LIST Output only characters from LIST |
| 282 | -d CHAR Use CHAR instead of tab as the field delimiter |
Pavel Roskin | 0010ee4 | 2000-07-21 15:10:57 +0000 | [diff] [blame] | 283 | -s Output only the lines containing delimiter |
Eric Andersen | 1386e70 | 2000-06-26 12:14:30 +0000 | [diff] [blame] | 284 | -f N Print only these fields |
| 285 | -n Ignored |
Erik Andersen | 73c8c9c | 2000-05-13 05:36:13 +0000 | [diff] [blame] | 286 | |
| 287 | Example: |
| 288 | |
| 289 | $ echo "Hello world" | cut -f 1 -d ' ' |
| 290 | Hello |
| 291 | $ echo "Hello world" | cut -f 2 -d ' ' |
| 292 | world |
| 293 | |
| 294 | |
| 295 | ------------------------------- |
| 296 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 297 | =item date |
| 298 | |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 299 | Usage: date [OPTION]... [+FORMAT] |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 300 | |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 301 | or: date [OPTION] [MMDDhhmm[[CC]YY][.ss]] |
| 302 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 303 | Displays the current time in the given FORMAT, or sets the system date. |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 304 | |
| 305 | Options: |
Erik Andersen | e31c066 | 2000-05-02 05:32:07 +0000 | [diff] [blame] | 306 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 307 | -R Outputs RFC-822 compliant date string |
| 308 | -s Sets time described by STRING |
| 309 | -u Prints or sets Coordinated Universal Time |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 310 | |
| 311 | Example: |
John Beppu | f17792c | 2000-04-13 03:16:01 +0000 | [diff] [blame] | 312 | |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 313 | $ date |
| 314 | Wed Apr 12 18:52:41 MDT 2000 |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 315 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 316 | ------------------------------- |
| 317 | |
John Beppu | 0021679 | 2000-06-21 19:06:16 +0000 | [diff] [blame] | 318 | =item dc |
| 319 | |
| 320 | Usage: dc expression ... |
| 321 | |
| 322 | This is a Tiny RPN calculator that understands the |
| 323 | following operations: +, -, /, *, and, or, not, eor. |
| 324 | If no arguments are given, dc will process input from STDIN. |
| 325 | |
| 326 | The behaviour of BusyBox/dc deviates (just a little ;-) from |
| 327 | GNU/dc, but this will be remedied in the future. |
| 328 | |
| 329 | Example: |
| 330 | |
| 331 | $ dc 2 2 + |
| 332 | 4 |
| 333 | $ dc 8 8 \* 2 2 + / |
| 334 | 16 |
| 335 | $ dc 0 1 and |
| 336 | 0 |
| 337 | $ dc 0 1 or |
| 338 | 1 |
| 339 | $ echo 72 9 div 8 mul | dc |
| 340 | 64 |
| 341 | |
| 342 | ------------------------------- |
| 343 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 344 | =item dd |
| 345 | |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 346 | Usage: dd [if=name] [of=name] [bs=n] [count=n] [skip=n] [seek=n] |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 347 | |
| 348 | Copy a file, converting and formatting according to options |
| 349 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 350 | if=FILE read from FILE instead of stdin |
| 351 | of=FILE write to FILE instead of stdout |
| 352 | bs=n read and write n bytes at a time |
| 353 | count=n copy only n input blocks |
| 354 | skip=n skip n input blocks |
| 355 | seek=n skip n output blocks |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 356 | |
| 357 | Numbers may be suffixed by w (x2), k (x1024), b (x512), or M (x1024^2) |
Pavel Roskin | 1a804e4 | 2000-06-21 21:38:00 +0000 | [diff] [blame] | 358 | |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 359 | Example: |
| 360 | |
| 361 | $ dd if=/dev/zero of=/dev/ram1 bs=1M count=4 |
| 362 | 4+0 records in |
| 363 | 4+0 records out |
| 364 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 365 | ------------------------------- |
| 366 | |
Eric Andersen | 028fb62 | 2000-07-04 20:07:13 +0000 | [diff] [blame] | 367 | =item deallocvt |
| 368 | |
| 369 | Usage: deallocvt N |
| 370 | |
| 371 | Deallocates unused virtual terminal /dev/ttyN |
| 372 | |
| 373 | ------------------------------- |
| 374 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 375 | =item df |
| 376 | |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 377 | Usage: df [filesystem ...] |
| 378 | |
| 379 | Prints the filesystem space used and space available. |
| 380 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 381 | Example: |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 382 | |
| 383 | $ df |
| 384 | Filesystem 1k-blocks Used Available Use% Mounted on |
| 385 | /dev/sda3 8690864 8553540 137324 98% / |
| 386 | /dev/sda1 64216 36364 27852 57% /boot |
| 387 | $ df /dev/sda3 |
| 388 | Filesystem 1k-blocks Used Available Use% Mounted on |
| 389 | /dev/sda3 8690864 8553540 137324 98% / |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 390 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 391 | ------------------------------- |
| 392 | |
| 393 | =item dirname |
| 394 | |
| 395 | Usage: dirname NAME |
| 396 | |
| 397 | Strip non-directory suffix from file name |
| 398 | |
| 399 | Example: |
| 400 | |
| 401 | $ dirname /tmp/foo |
| 402 | /tmp |
| 403 | $ dirname /tmp/foo/ |
| 404 | /tmp |
| 405 | |
| 406 | ------------------------------- |
| 407 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 408 | =item dmesg |
| 409 | |
John Beppu | f17792c | 2000-04-13 03:16:01 +0000 | [diff] [blame] | 410 | Usage: dmesg [B<-c>] [B<-n> level] [B<-s> bufsize] |
Pavel Roskin | 1a804e4 | 2000-06-21 21:38:00 +0000 | [diff] [blame] | 411 | |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 412 | Print or controls the kernel ring buffer. |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 413 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 414 | ------------------------------- |
| 415 | |
Eric Andersen | cff3fe3 | 2000-09-20 19:22:26 +0000 | [diff] [blame] | 416 | =item dos2unix |
| 417 | |
| 418 | Usage: dos2unix < dosfile > unixfile |
| 419 | |
| 420 | Converts a text file from dos format to unix format. |
| 421 | |
| 422 | ------------------------------- |
| 423 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 424 | =item du |
| 425 | |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 426 | Usage: du [OPTION]... [FILE]... |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 427 | |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 428 | Summarize disk space used for each FILE and/or directory. |
| 429 | Disk space is printed in units of 1k (i.e. 1024 bytes). |
| 430 | |
| 431 | Options: |
John Beppu | f17792c | 2000-04-13 03:16:01 +0000 | [diff] [blame] | 432 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 433 | -l count sizes many times if hard linked |
| 434 | -s display only a total for each argument |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 435 | |
| 436 | Example: |
| 437 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 438 | $ ./BusyBox du |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 439 | 16 ./CVS |
| 440 | 12 ./kernel-patches/CVS |
| 441 | 80 ./kernel-patches |
| 442 | 12 ./tests/CVS |
| 443 | 36 ./tests |
| 444 | 12 ./scripts/CVS |
| 445 | 16 ./scripts |
| 446 | 12 ./docs/CVS |
| 447 | 104 ./docs |
| 448 | 2417 . |
Pavel Roskin | 1a804e4 | 2000-06-21 21:38:00 +0000 | [diff] [blame] | 449 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 450 | ------------------------------- |
| 451 | |
Eric Andersen | 61dc057 | 2000-07-11 17:29:36 +0000 | [diff] [blame] | 452 | =item dumpkmap |
| 453 | |
| 454 | Usage: dumpkmap |
| 455 | |
Eric Andersen | 337ec1b | 2000-11-17 17:23:16 +0000 | [diff] [blame] | 456 | Prints out a binary keyboard translation table to standard output. |
Eric Andersen | 61dc057 | 2000-07-11 17:29:36 +0000 | [diff] [blame] | 457 | |
Eric Andersen | 18a1014 | 2000-09-01 16:12:57 +0000 | [diff] [blame] | 458 | Example: |
| 459 | |
| 460 | $ dumpkmap > keymap |
| 461 | |
Eric Andersen | 61dc057 | 2000-07-11 17:29:36 +0000 | [diff] [blame] | 462 | ------------------------------- |
| 463 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 464 | =item dutmp |
| 465 | |
| 466 | Usage: dutmp [FILE] |
| 467 | |
| 468 | Dump utmp file format (pipe delimited) from FILE |
| 469 | or stdin to stdout. |
| 470 | |
| 471 | Example: |
| 472 | |
| 473 | $ dutmp /var/run/utmp |
| 474 | 8|7||si|||0|0|0|955637625|760097|0 |
| 475 | 2|0|~|~~|reboot||0|0|0|955637625|782235|0 |
| 476 | 1|20020|~|~~|runlevel||0|0|0|955637625|800089|0 |
| 477 | 8|125||l4|||0|0|0|955637629|998367|0 |
| 478 | 6|245|tty1|1|LOGIN||0|0|0|955637630|998974|0 |
| 479 | 6|246|tty2|2|LOGIN||0|0|0|955637630|999498|0 |
| 480 | 7|336|pts/0|vt00andersen|andersen|:0.0|0|0|0|955637763|0|0 |
Pavel Roskin | 1a804e4 | 2000-06-21 21:38:00 +0000 | [diff] [blame] | 481 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 482 | ------------------------------- |
| 483 | |
| 484 | =item echo |
| 485 | |
| 486 | Usage: echo [-neE] [ARG ...] |
| 487 | |
| 488 | Prints the specified ARGs to stdout |
| 489 | |
| 490 | Options: |
| 491 | |
| 492 | -n suppress trailing newline |
| 493 | -e interpret backslash-escaped characters (i.e. \t=tab etc) |
| 494 | -E disable interpretation of backslash-escaped characters |
| 495 | |
| 496 | Example: |
| 497 | |
| 498 | $ echo "Erik is cool" |
| 499 | Erik is cool |
| 500 | $ echo -e "Erik\nis\ncool" |
| 501 | Erik |
| 502 | is |
| 503 | cool |
| 504 | $ echo "Erik\nis\ncool" |
| 505 | Erik\nis\ncool |
Pavel Roskin | 1a804e4 | 2000-06-21 21:38:00 +0000 | [diff] [blame] | 506 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 507 | ------------------------------- |
| 508 | |
Eric Andersen | 2aa1091 | 2000-11-14 21:28:09 +0000 | [diff] [blame] | 509 | =item expr |
Eric Andersen | 1b355eb | 2000-09-05 17:37:48 +0000 | [diff] [blame] | 510 | |
| 511 | |
| 512 | Usage: expr EXPRESSION |
| 513 | |
| 514 | Prints the value of EXPRESSION to standard output. |
| 515 | |
| 516 | EXPRESSION may be: |
| 517 | |
| 518 | ARG1 | ARG2 ARG1 if it is neither null nor 0, otherwise ARG2 |
| 519 | ARG1 & ARG2 ARG1 if neither argument is null or 0, otherwise 0 |
| 520 | ARG1 < ARG2 ARG1 is less than ARG2 |
| 521 | ARG1 <= ARG2 ARG1 is less than or equal to ARG2 |
| 522 | ARG1 = ARG2 ARG1 is equal to ARG2 |
| 523 | ARG1 != ARG2 ARG1 is unequal to ARG2 |
| 524 | ARG1 >= ARG2 ARG1 is greater than or equal to ARG2 |
| 525 | ARG1 > ARG2 ARG1 is greater than ARG2 |
| 526 | ARG1 + ARG2 arithmetic sum of ARG1 and ARG2 |
| 527 | ARG1 - ARG2 arithmetic difference of ARG1 and ARG2 |
| 528 | ARG1 * ARG2 arithmetic product of ARG1 and ARG2 |
| 529 | ARG1 / ARG2 arithmetic quotient of ARG1 divided by ARG2 |
| 530 | ARG1 % ARG2 arithmetic remainder of ARG1 divided by ARG2 |
| 531 | STRING : REGEXP anchored pattern match of REGEXP in STRING |
| 532 | match STRING REGEXP same as STRING : REGEXP |
| 533 | substr STRING POS LENGTH substring of STRING, POS counted from 1 |
| 534 | index STRING CHARS index in STRING where any CHARS is found, or 0 |
| 535 | length STRING length of STRING |
| 536 | quote TOKEN interpret TOKEN as a string, even if it is a |
| 537 | keyword like `match' or an operator like `/' |
| 538 | ( EXPRESSION ) value of EXPRESSION |
| 539 | |
| 540 | Beware that many operators need to be escaped or quoted for shells. |
| 541 | Comparisons are arithmetic if both ARGs are numbers, else |
| 542 | lexicographical. Pattern matches return the string matched between |
| 543 | \( and \) or null; if \( and \) are not used, they return the number |
| 544 | of characters matched or 0. |
| 545 | |
| 546 | ------------------------------- |
| 547 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 548 | =item false |
| 549 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 550 | Returns an exit code of FALSE (1) |
| 551 | |
| 552 | Example: |
| 553 | |
| 554 | $ false |
| 555 | $ echo $? |
| 556 | 1 |
| 557 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 558 | ------------------------------- |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 559 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 560 | =item fbset |
| 561 | |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 562 | Usage: fbset [options] [mode] |
| 563 | |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 564 | Show and modify frame buffer device settings |
| 565 | |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 566 | Options: |
| 567 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 568 | -h |
| 569 | -fb |
| 570 | -db |
| 571 | -a |
| 572 | -i |
| 573 | -g |
| 574 | -t |
| 575 | -accel |
| 576 | -hsync |
| 577 | -vsync |
| 578 | -laced |
| 579 | -double |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 580 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 581 | Example: |
| 582 | |
| 583 | $ fbset |
| 584 | mode "1024x768-76" |
| 585 | # D: 78.653 MHz, H: 59.949 kHz, V: 75.694 Hz |
| 586 | geometry 1024 768 1024 768 16 |
| 587 | timings 12714 128 32 16 4 128 4 |
| 588 | accel false |
| 589 | rgba 5/11,6/5,5/0,0/0 |
| 590 | endmode |
| 591 | |
| 592 | ------------------------------- |
| 593 | |
| 594 | =item fdflush |
| 595 | |
| 596 | Usage: fdflush device |
| 597 | |
| 598 | Force floppy disk drive to detect disk change |
| 599 | |
| 600 | ------------------------------- |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 601 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 602 | =item find |
| 603 | |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 604 | Usage: find [PATH...] [EXPRESSION] |
| 605 | |
| 606 | Search for files in a directory hierarchy. The default PATH is |
| 607 | the current directory; default EXPRESSION is '-print' |
| 608 | |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 609 | |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 610 | EXPRESSION may consist of: |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 611 | |
| 612 | -follow Dereference symbolic links. |
| 613 | -name PATTERN File name (leading directories removed) matches PATTERN. |
| 614 | -print print the full file name followed by a newline to stdout. |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 615 | |
| 616 | Example: |
| 617 | |
| 618 | $ find / -name /etc/passwd |
| 619 | /etc/passwd |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 620 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 621 | ------------------------------- |
| 622 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 623 | =item free |
| 624 | |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 625 | Usage: free |
| 626 | |
Erik Andersen | 7ab9c7e | 2000-05-12 19:41:47 +0000 | [diff] [blame] | 627 | Displays the amount of free and used system memory. |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 628 | |
| 629 | Example: |
| 630 | |
| 631 | $ free |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 632 | total used free shared buffers |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 633 | Mem: 257628 248724 8904 59644 93124 |
| 634 | Swap: 128516 8404 120112 |
| 635 | Total: 386144 257128 129016 |
| 636 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 637 | ------------------------------- |
| 638 | |
| 639 | =item freeramdisk |
| 640 | |
| 641 | Usage: freeramdisk DEVICE |
| 642 | |
Erik Andersen | 7ab9c7e | 2000-05-12 19:41:47 +0000 | [diff] [blame] | 643 | Frees all memory used by the specified ramdisk. |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 644 | |
| 645 | Example: |
| 646 | |
| 647 | $ freeramdisk /dev/ram2 |
| 648 | |
| 649 | ------------------------------- |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 650 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 651 | =item fsck.minix |
| 652 | |
John Beppu | f17792c | 2000-04-13 03:16:01 +0000 | [diff] [blame] | 653 | Usage: fsck.minix [B<-larvsmf>] /dev/name |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 654 | |
| 655 | Performs a consistency check for MINIX filesystems. |
| 656 | |
Eric Andersen | 2086e3d | 2000-07-04 22:17:01 +0000 | [diff] [blame] | 657 | Options: |
John Beppu | f17792c | 2000-04-13 03:16:01 +0000 | [diff] [blame] | 658 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 659 | -l Lists all filenames |
| 660 | -r Perform interactive repairs |
| 661 | -a Perform automatic repairs |
| 662 | -v verbose |
| 663 | -s Outputs super-block information |
| 664 | -m Activates MINIX-like "mode not cleared" warnings |
| 665 | -f Force file system check. |
| 666 | |
| 667 | ------------------------------- |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 668 | |
Eric Andersen | a1f16bb | 2000-08-21 22:02:34 +0000 | [diff] [blame] | 669 | =item getopt |
| 670 | |
| 671 | Usage: getopt [OPTIONS]... |
| 672 | |
| 673 | Parse command options |
| 674 | |
| 675 | Options: |
| 676 | |
| 677 | -a, --alternative Allow long options starting with single -\n" |
| 678 | -l, --longoptions=longopts Long options to be recognized\n" |
| 679 | -n, --name=progname The name under which errors are reported\n" |
| 680 | -o, --options=optstring Short options to be recognized\n" |
| 681 | -q, --quiet Disable error reporting by getopt(3)\n" |
| 682 | -Q, --quiet-output No normal output\n" |
| 683 | -s, --shell=shell Set shell quoting conventions\n" |
| 684 | -T, --test Test for getopt(1) version\n" |
| 685 | -u, --unqote Do not quote the output\n" |
| 686 | |
| 687 | Example: |
Eric Andersen | e4c4d69 | 2000-08-21 23:29:45 +0000 | [diff] [blame] | 688 | |
Eric Andersen | a1f16bb | 2000-08-21 22:02:34 +0000 | [diff] [blame] | 689 | $ cat getopt.test |
| 690 | #!/bin/sh |
| 691 | GETOPT=`getopt -o ab:c:: --long a-long,b-long:,c-long:: \ |
| 692 | -n 'example.busybox' -- "$@"` |
| 693 | if [ $? != 0 ] ; then exit 1 ; fi |
| 694 | eval set -- "$GETOPT" |
| 695 | while true ; do |
| 696 | case $1 in |
| 697 | -a|--a-long) echo "Option a" ; shift ;; |
| 698 | -b|--b-long) echo "Option b, argument \`$2'" ; shift 2 ;; |
| 699 | -c|--c-long) |
| 700 | case "$2" in |
| 701 | "") echo "Option c, no argument"; shift 2 ;; |
| 702 | *) echo "Option c, argument \`$2'" ; shift 2 ;; |
| 703 | esac ;; |
| 704 | --) shift ; break ;; |
| 705 | *) echo "Internal error!" ; exit 1 ;; |
| 706 | esac |
| 707 | done |
| 708 | |
| 709 | |
| 710 | ------------------------------- |
| 711 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 712 | =item grep |
| 713 | |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 714 | Usage: grep [OPTIONS]... PATTERN [FILE]... |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 715 | |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 716 | Search for PATTERN in each FILE or standard input. |
| 717 | |
Eric Andersen | 2086e3d | 2000-07-04 22:17:01 +0000 | [diff] [blame] | 718 | Options: |
John Beppu | f17792c | 2000-04-13 03:16:01 +0000 | [diff] [blame] | 719 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 720 | -h suppress the prefixing filename on output |
| 721 | -i ignore case distinctions |
| 722 | -n print line number with output lines |
| 723 | -q be quiet. Returns 0 if result was found, 1 otherwise |
Erik Andersen | a19bc64 | 2000-05-02 06:40:02 +0000 | [diff] [blame] | 724 | -v select non-matching lines |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 725 | |
Eric Andersen | 98cd53e | 2000-06-16 19:56:44 +0000 | [diff] [blame] | 726 | This version of grep matches full regular expressions. |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 727 | |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 728 | Example: |
| 729 | |
| 730 | $ grep root /etc/passwd |
| 731 | root:x:0:0:root:/root:/bin/bash |
| 732 | $ grep ^[rR]oo. /etc/passwd |
| 733 | root:x:0:0:root:/root:/bin/bash |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 734 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 735 | ------------------------------- |
| 736 | |
| 737 | =item gunzip |
| 738 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 739 | Usage: gunzip [OPTION]... FILE |
| 740 | |
| 741 | Uncompress FILE (or standard input if FILE is '-'). |
| 742 | |
| 743 | Options: |
| 744 | |
| 745 | -c Write output to standard output |
| 746 | -t Test compressed file integrity |
| 747 | |
| 748 | Example: |
| 749 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 750 | $ ls -la /tmp/BusyBox* |
| 751 | -rw-rw-r-- 1 andersen andersen 557009 Apr 11 10:55 /tmp/BusyBox-0.43.tar.gz |
| 752 | $ gunzip /tmp/BusyBox-0.43.tar.gz |
| 753 | $ ls -la /tmp/BusyBox* |
| 754 | -rw-rw-r-- 1 andersen andersen 1761280 Apr 14 17:47 /tmp/BusyBox-0.43.tar |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 755 | |
| 756 | ------------------------------- |
| 757 | |
| 758 | =item gzip |
| 759 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 760 | Usage: gzip [OPTION]... FILE |
| 761 | |
| 762 | Compress FILE with maximum compression. |
John Beppu | 9057b6a | 2000-04-16 10:22:28 +0000 | [diff] [blame] | 763 | When FILE is '-', reads standard input. Implies B<-c>. |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 764 | |
| 765 | Options: |
| 766 | |
| 767 | -c Write output to standard output instead of FILE.gz |
Eric Andersen | d0fa0a1 | 2000-12-13 17:59:37 +0000 | [diff] [blame] | 768 | -d decompress |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 769 | |
| 770 | Example: |
| 771 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 772 | $ ls -la /tmp/BusyBox* |
| 773 | -rw-rw-r-- 1 andersen andersen 1761280 Apr 14 17:47 /tmp/BusyBox-0.43.tar |
| 774 | $ gzip /tmp/BusyBox-0.43.tar |
| 775 | $ ls -la /tmp/BusyBox* |
| 776 | -rw-rw-r-- 1 andersen andersen 554058 Apr 14 17:49 /tmp/BusyBox-0.43.tar.gz |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 777 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 778 | |
| 779 | ------------------------------- |
| 780 | |
| 781 | =item halt |
| 782 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 783 | Usage: halt |
| 784 | |
Eric Andersen | 98cd53e | 2000-06-16 19:56:44 +0000 | [diff] [blame] | 785 | This command halts the system. |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 786 | |
| 787 | ------------------------------- |
| 788 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 789 | =item head |
| 790 | |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 791 | Usage: head [OPTION] [FILE]... |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 792 | |
| 793 | Print first 10 lines of each FILE to standard output. |
| 794 | With more than one FILE, precede each with a header giving the |
| 795 | file name. With no FILE, or when FILE is -, read standard input. |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 796 | |
| 797 | Options: |
John Beppu | f17792c | 2000-04-13 03:16:01 +0000 | [diff] [blame] | 798 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 799 | -n NUM Print first NUM lines instead of first 10 |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 800 | |
| 801 | Example: |
| 802 | |
| 803 | $ head -n 2 /etc/passwd |
| 804 | root:x:0:0:root:/root:/bin/bash |
| 805 | daemon:x:1:1:daemon:/usr/sbin:/bin/sh |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 806 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 807 | ------------------------------- |
| 808 | |
| 809 | =item hostid |
| 810 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 811 | Usage: hostid |
| 812 | |
| 813 | Prints out a unique 32-bit identifier for the current |
| 814 | machine. The 32-bit identifier is intended to be unique |
| 815 | among all UNIX systems in existence. |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 816 | |
| 817 | ------------------------------- |
| 818 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 819 | =item hostname |
| 820 | |
John Beppu | f17792c | 2000-04-13 03:16:01 +0000 | [diff] [blame] | 821 | Usage: hostname [OPTION] {hostname | B<-F> file} |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 822 | |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 823 | Get or set the hostname or DNS domain name. If a hostname is given |
John Beppu | f17792c | 2000-04-13 03:16:01 +0000 | [diff] [blame] | 824 | (or a file with the B<-F> parameter), the host name will be set. |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 825 | |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 826 | Options: |
John Beppu | f17792c | 2000-04-13 03:16:01 +0000 | [diff] [blame] | 827 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 828 | -s Short |
| 829 | -i Addresses for the hostname |
| 830 | -d DNS domain name |
Eric Andersen | 0d5835a | 2000-10-12 22:30:31 +0000 | [diff] [blame] | 831 | -F, --file FILE Use the contents of FILE to specify the hostname |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 832 | |
| 833 | Example: |
| 834 | |
| 835 | $ hostname |
| 836 | slag |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 837 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 838 | ------------------------------- |
| 839 | |
Erik Andersen | 73c8c9c | 2000-05-13 05:36:13 +0000 | [diff] [blame] | 840 | =item id |
| 841 | |
| 842 | Print information for USERNAME or the current user |
| 843 | |
| 844 | Options: |
| 845 | |
| 846 | -g prints only the group ID |
| 847 | -u prints only the user ID |
| 848 | -r prints the real user ID instead of the effective ID (with -ug) |
| 849 | |
| 850 | Example: |
| 851 | |
| 852 | $ id |
| 853 | uid=1000(andersen) gid=1000(andersen) |
| 854 | |
| 855 | ------------------------------- |
| 856 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 857 | =item init |
| 858 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 859 | Usage: init |
| 860 | |
| 861 | Init is the parent of all processes. |
| 862 | |
| 863 | This version of init is designed to be run only by the kernel. |
| 864 | |
| 865 | BusyBox init doesn't support multiple runlevels. The runlevels field of |
| 866 | the /etc/inittab file is completely ignored by BusyBox init. If you want |
| 867 | runlevels, use sysvinit. |
| 868 | |
| 869 | BusyBox init works just fine without an inittab. If no inittab is found, |
| 870 | it has the following default behavior: |
| 871 | |
| 872 | ::sysinit:/etc/init.d/rcS |
| 873 | ::askfirst:/bin/sh |
| 874 | |
| 875 | if it detects that /dev/console is _not_ a serial console, it will also run: |
| 876 | |
| 877 | tty2::askfirst:/bin/sh |
| 878 | |
| 879 | If you choose to use an /etc/inittab file, the inittab entry format is as follows: |
| 880 | |
| 881 | <id>:<runlevels>:<action>:<process> |
| 882 | |
| 883 | <id>: |
| 884 | |
| 885 | WARNING: This field has a non-traditional meaning for BusyBox init! |
| 886 | The id field is used by BusyBox init to specify the controlling tty for |
| 887 | the specified process to run on. The contents of this field are |
| 888 | appended to "/dev/" and used as-is. There is no need for this field to |
| 889 | be unique, although if it isn't you may have strange results. If this |
Eric Andersen | 0d2acb0 | 2000-12-18 20:36:02 +0000 | [diff] [blame] | 890 | field is left blank, the controlling tty is set to the console. Also |
| 891 | note that if BusyBox detects that a serial console is in use, then only |
| 892 | entries whose controlling tty is either the serial console or /dev/null |
| 893 | will be run. BusyBox init does nothing with utmp. We don't need no |
| 894 | stinkin' utmp. |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 895 | |
| 896 | <runlevels>: |
| 897 | |
| 898 | The runlevels field is completely ignored. |
| 899 | |
| 900 | <action>: |
| 901 | |
| 902 | Valid actions include: sysinit, respawn, askfirst, wait, |
| 903 | once, and ctrlaltdel. |
| 904 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 905 | |
Eric Andersen | eb4218d | 2000-12-08 20:38:00 +0000 | [diff] [blame] | 906 | The available actions can be classified into two groups: actions |
| 907 | that are run only once, and actions that are re-run when the specified |
| 908 | process exits. |
| 909 | |
| 910 | Run only-once actions: |
| 911 | |
| 912 | 'sysinit' is the first item run on boot. init waits until all |
| 913 | sysinit actions are completed before continuing. Following the |
| 914 | completion of all sysinit actions, all 'wait' actions are run. |
| 915 | 'wait' actions, like 'sysinit' actions, cause init to wait until |
| 916 | the specified task completes. 'once' actions are asyncronous, |
| 917 | therefore, init does not wait for them to complete. 'ctrlaltdel' |
| 918 | actions are run immediately before init causes the system to reboot |
| 919 | (unmounting filesystems with a 'ctrlaltdel' action is a very good |
| 920 | idea). |
| 921 | |
| 922 | Run repeatedly actions: |
| 923 | |
| 924 | 'respawn' actions are run after the 'once' actions. When a process |
| 925 | started with a 'respawn' action exits, init automatically restarts |
| 926 | it. Unlike sysvinit, BusyBox init does not stop processes from |
| 927 | respawning out of control. The 'askfirst' actions acts just like |
| 928 | respawn, except that before running the specified process it |
| 929 | displays the line "Please press Enter to activate this console." |
| 930 | and then waits for the user to press enter before starting the |
| 931 | specified process. |
| 932 | |
| 933 | Unrecognized actions (like initdefault) will cause init to emit an |
| 934 | error message, and then go along with its business. All actions are |
| 935 | run in the reverse order from how they appear in /etc/inittab. |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 936 | |
| 937 | <process>: |
| 938 | |
| 939 | Specifies the process to be executed and it's command line. |
| 940 | |
| 941 | |
| 942 | Example /etc/inittab file: |
| 943 | |
| 944 | # This is run first except when booting in single-user mode. |
| 945 | # |
| 946 | ::sysinit:/etc/init.d/rcS |
| 947 | |
| 948 | # /bin/sh invocations on selected ttys |
| 949 | # |
| 950 | # Start an "askfirst" shell on the console (whatever that may be) |
Pavel Roskin | c9db2e8 | 2000-09-15 17:24:13 +0000 | [diff] [blame] | 951 | ::askfirst:-/bin/sh |
| 952 | # Start an "askfirst" shell on /dev/tty2-4 |
| 953 | tty2::askfirst:-/bin/sh |
| 954 | tty3::askfirst:-/bin/sh |
| 955 | tty4::askfirst:-/bin/sh |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 956 | |
| 957 | # /sbin/getty invocations for selected ttys |
| 958 | # |
Pavel Roskin | c9db2e8 | 2000-09-15 17:24:13 +0000 | [diff] [blame] | 959 | tty4::respawn:/sbin/getty 38400 tty5 |
| 960 | tty5::respawn:/sbin/getty 38400 tty6 |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 961 | |
| 962 | |
| 963 | # Example of how to put a getty on a serial line (for a terminal) |
| 964 | # |
Eric Andersen | 8ce85ce | 2000-09-26 22:20:06 +0000 | [diff] [blame] | 965 | #::respawn:/sbin/getty -L ttyS0 9600 vt100 |
| 966 | #::respawn:/sbin/getty -L ttyS1 9600 vt100 |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 967 | # |
| 968 | # Example how to put a getty on a modem line. |
Eric Andersen | 8ce85ce | 2000-09-26 22:20:06 +0000 | [diff] [blame] | 969 | #::respawn:/sbin/getty 57600 ttyS2 |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 970 | |
| 971 | # Stuff to do before rebooting |
Pavel Roskin | c9db2e8 | 2000-09-15 17:24:13 +0000 | [diff] [blame] | 972 | ::ctrlaltdel:/bin/umount -a -r |
| 973 | ::ctrlaltdel:/sbin/swapoff -a |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 974 | |
| 975 | ------------------------------- |
| 976 | |
Eric Andersen | feb47c0 | 2000-06-21 21:03:13 +0000 | [diff] [blame] | 977 | =item insmod |
| 978 | |
| 979 | Usage: insmod [OPTION]... MODULE [symbol=value]... |
| 980 | |
| 981 | Loads the specified kernel modules into the kernel. |
| 982 | |
| 983 | Options: |
| 984 | |
| 985 | -f Force module to load into the wrong kernel version. |
| 986 | -k Make module autoclean-able. |
| 987 | -v verbose output |
| 988 | -x do not export externs |
| 989 | |
| 990 | ------------------------------- |
| 991 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 992 | =item kill |
| 993 | |
John Beppu | f17792c | 2000-04-13 03:16:01 +0000 | [diff] [blame] | 994 | Usage: kill [B<-signal>] process-id [process-id ...] |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 995 | |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 996 | Send a signal (default is SIGTERM) to the specified process(es). |
| 997 | |
| 998 | Options: |
John Beppu | f17792c | 2000-04-13 03:16:01 +0000 | [diff] [blame] | 999 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1000 | -l List all signal names and numbers. |
Erik Andersen | 62dc17a | 2000-04-13 01:18:23 +0000 | [diff] [blame] | 1001 | |
| 1002 | Example: |
| 1003 | |
| 1004 | $ ps | grep apache |
| 1005 | 252 root root S [apache] |
| 1006 | 263 www-data www-data S [apache] |
| 1007 | 264 www-data www-data S [apache] |
| 1008 | 265 www-data www-data S [apache] |
| 1009 | 266 www-data www-data S [apache] |
| 1010 | 267 www-data www-data S [apache] |
| 1011 | $ kill 252 |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1012 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1013 | ------------------------------- |
| 1014 | |
| 1015 | =item killall |
| 1016 | |
John Beppu | 9057b6a | 2000-04-16 10:22:28 +0000 | [diff] [blame] | 1017 | Usage: killall [B<-signal>] process-name [process-name ...] |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1018 | |
| 1019 | Send a signal (default is SIGTERM) to the specified process(es). |
| 1020 | |
| 1021 | Options: |
John Beppu | 9057b6a | 2000-04-16 10:22:28 +0000 | [diff] [blame] | 1022 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1023 | -l List all signal names and numbers. |
| 1024 | |
| 1025 | Example: |
| 1026 | |
| 1027 | $ killall apache |
| 1028 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1029 | ------------------------------- |
| 1030 | |
| 1031 | =item length |
| 1032 | |
Erik Andersen | 7ab9c7e | 2000-05-12 19:41:47 +0000 | [diff] [blame] | 1033 | Usage: length STRING |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1034 | |
Erik Andersen | 7ab9c7e | 2000-05-12 19:41:47 +0000 | [diff] [blame] | 1035 | Prints out the length of the specified STRING. |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1036 | |
| 1037 | Example: |
Erik Andersen | a19bc64 | 2000-05-02 06:40:02 +0000 | [diff] [blame] | 1038 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1039 | $ length "Hello" |
| 1040 | 5 |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1041 | |
| 1042 | ------------------------------- |
| 1043 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 1044 | =item ln |
| 1045 | |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1046 | Usage: ln [OPTION] TARGET... LINK_NAME|DIRECTORY |
Erik Andersen | a19bc64 | 2000-05-02 06:40:02 +0000 | [diff] [blame] | 1047 | |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1048 | Create a link named LINK_NAME or DIRECTORY to the specified TARGET |
Eric Andersen | addc9c2 | 2000-06-21 22:53:24 +0000 | [diff] [blame] | 1049 | You may use '--' to indicate that all following arguments are non-options. |
Pavel Roskin | 1a804e4 | 2000-06-21 21:38:00 +0000 | [diff] [blame] | 1050 | |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1051 | Options: |
| 1052 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1053 | -s make symbolic links instead of hard links |
| 1054 | -f remove existing destination files |
Pavel Roskin | 1a804e4 | 2000-06-21 21:38:00 +0000 | [diff] [blame] | 1055 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1056 | Example: |
| 1057 | |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 1058 | $ ln -s BusyBox /tmp/ls |
Erik Andersen | a19bc64 | 2000-05-02 06:40:02 +0000 | [diff] [blame] | 1059 | $ ls -l /tmp/ls |
Erik Andersen | cf8d38a | 2000-04-21 01:23:36 +0000 | [diff] [blame] | 1060 | lrwxrwxrwx 1 root root 7 Apr 12 18:39 ls -> BusyBox* |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1061 | |
| 1062 | ------------------------------- |
| 1063 | |
| 1064 | =item loadacm |
| 1065 | |
Erik Andersen | 3fe7f9f | 2000-04-19 03:59:10 +0000 | [diff] [blame] | 1066 | Usage: loadacm |
| 1067 | |
| 1068 | Loads an acm from standard input. |
| 1069 | |
| 1070 | Example: |
| 1071 | |
| 1072 | $ loadacm < /etc/i18n/acmname |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1073 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1074 | ------------------------------- |
| 1075 | |
| 1076 | =item loadfont |
| 1077 | |
Erik Andersen | a6c7522 | 2000-04-18 00:00:52 +0000 | [diff] [blame] | 1078 | Usage: loadfont |
| 1079 | |
| 1080 | Loads a console font from standard input. |
| 1081 | |
Erik Andersen | 3fe7f9f | 2000-04-19 03:59:10 +0000 | [diff] [blame] | 1082 | Example: |
| 1083 | |
| 1084 | $ loadfont < /etc/i18n/fontname |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1085 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1086 | ------------------------------- |
| 1087 | |
| 1088 | =item loadkmap |
| 1089 | |
Erik Andersen | 3fe7f9f | 2000-04-19 03:59:10 +0000 | [diff] [blame] | 1090 | Usage: loadkmap |
| 1091 | |
| 1092 | Loads a binary keyboard translation table from standard input. |
| 1093 | |
| 1094 | Example: |
| 1095 | |
| 1096 | $ loadkmap < /etc/i18n/lang-keymap |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1097 | |
| 1098 | ------------------------------- |
| 1099 | |
| 1100 | =item logger |
| 1101 | |
| 1102 | Usage: logger [OPTION]... [MESSAGE] |
| 1103 | |
Matt Kraai | 004827d | 2001-01-02 22:54:12 +0000 | [diff] [blame^] | 1104 | Write MESSAGE to the system log. If MESSAGE is omitted, log stdin. |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1105 | |
| 1106 | Options: |
| 1107 | |
| 1108 | -s Log to stderr as well as the system log. |
| 1109 | -t Log using the specified tag (defaults to user name). |
| 1110 | -p Enter the message with the specified priority. |
| 1111 | This may be numerical or a ``facility.level'' pair. |
| 1112 | |
| 1113 | Example: |
| 1114 | |
| 1115 | $ logger "hello" |
| 1116 | |
| 1117 | ------------------------------- |
| 1118 | |
| 1119 | =item logname |
| 1120 | |
| 1121 | Usage: logname |
| 1122 | |
| 1123 | Print the name of the current user. |
| 1124 | |
| 1125 | Example: |
| 1126 | |
| 1127 | $ logname |
| 1128 | root |
| 1129 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1130 | ------------------------------- |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1131 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 1132 | =item ls |
| 1133 | |
Eric Andersen | 5b17693 | 2000-09-22 20:22:28 +0000 | [diff] [blame] | 1134 | Usage: ls [B<-1acdelnpuxACFLR>] [filenames...] |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1135 | |
| 1136 | Options: |
| 1137 | |
| 1138 | -a do not hide entries starting with . |
| 1139 | -c with -l: show ctime (the time of last |
| 1140 | modification of file status information) |
| 1141 | -d list directory entries instead of contents |
| 1142 | -e list both full date and full time |
| 1143 | -l use a long listing format |
| 1144 | -n list numeric UIDs and GIDs instead of names |
| 1145 | -p append indicator (one of /=@|) to entries |
| 1146 | -u with -l: show access time (the time of last |
| 1147 | access of the file) |
| 1148 | -x list entries by lines instead of by columns |
| 1149 | -A do not list implied . and .. |
| 1150 | -C list entries by columns |
| 1151 | -F append indicator (one of */=@|) to entries |
Eric Andersen | a42982e | 2000-06-07 17:28:53 +0000 | [diff] [blame] | 1152 | -R list subdirectories recursively |
Eric Andersen | 5b17693 | 2000-09-22 20:22:28 +0000 | [diff] [blame] | 1153 | -L list entries pointed to by symbolic links |
John Beppu | 50ed067 | 2000-04-13 23:44:04 +0000 | [diff] [blame] | 1154 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1155 | ------------------------------- |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1156 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 1157 | =item lsmod |
| 1158 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1159 | Usage: lsmod |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1160 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1161 | Shows a list of all currently loaded kernel modules. |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1162 | |
| 1163 | ------------------------------- |
| 1164 | |
| 1165 | =item makedevs |
| 1166 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1167 | Usage: makedevs NAME TYPE MAJOR MINOR FIRST LAST [s] |
| 1168 | |
| 1169 | Creates a range of block or character special files |
| 1170 | |
| 1171 | TYPEs include: |
| 1172 | |
| 1173 | b: Make a block (buffered) device. |
| 1174 | c or u: Make a character (un-buffered) device. |
| 1175 | p: Make a named pipe. MAJOR and MINOR are ignored for named pipes. |
| 1176 | |
| 1177 | FIRST specifies the number appended to NAME to create the first device. |
| 1178 | LAST specifies the number of the last item that should be created. |
| 1179 | If 's' is the last argument, the base device is created as well. |
| 1180 | |
| 1181 | Example: |
| 1182 | |
| 1183 | $ makedevs /dev/ttyS c 4 66 2 63 |
| 1184 | [creates ttyS2-ttyS63] |
| 1185 | $ makedevs /dev/hda b 3 0 0 8 s |
| 1186 | [creates hda,hda1-hda8] |
| 1187 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1188 | ------------------------------- |
| 1189 | |
Eric Andersen | 2b6ab3c | 2000-06-13 06:54:53 +0000 | [diff] [blame] | 1190 | =item md5sum |
| 1191 | |
| 1192 | Usage: md5sum [OPTION] [file ...] |
| 1193 | |
| 1194 | Print or check MD5 checksums. |
| 1195 | |
| 1196 | Options: |
| 1197 | |
| 1198 | -b read files in binary mode |
| 1199 | -c check MD5 sums against given list |
| 1200 | -t read files in text mode (default) |
| 1201 | -g read a string |
| 1202 | |
| 1203 | The following two options are useful only when verifying checksums: |
| 1204 | |
| 1205 | -s don't output anything, status code shows success |
| 1206 | -w warn about improperly formated MD5 checksum lines |
| 1207 | |
| 1208 | Example: |
| 1209 | |
| 1210 | $ md5sum busybox |
| 1211 | 6fd11e98b98a58f64ff3398d7b324003 busybox |
| 1212 | $ md5sum -c - |
| 1213 | 6fd11e98b98a58f64ff3398d7b324003 busybox |
| 1214 | busybox: OK |
| 1215 | ^D |
| 1216 | |
| 1217 | ------------------------------- |
| 1218 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 1219 | =item mkdir |
| 1220 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1221 | Usage: mkdir [OPTION] DIRECTORY... |
| 1222 | |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1223 | Create the DIRECTORY(ies), if they do not already exist |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1224 | |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1225 | Options: |
| 1226 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1227 | -m set permission mode (as in chmod), not rwxrwxrwx - umask |
Eric Andersen | 98cd53e | 2000-06-16 19:56:44 +0000 | [diff] [blame] | 1228 | -p no error if directory exists, make parent directories as needed |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1229 | |
| 1230 | Example: |
| 1231 | |
| 1232 | $ mkdir /tmp/foo |
| 1233 | $ mkdir /tmp/foo |
| 1234 | /tmp/foo: File exists |
| 1235 | $ mkdir /tmp/foo/bar/baz |
| 1236 | /tmp/foo/bar/baz: No such file or directory |
| 1237 | $ mkdir -p /tmp/foo/bar/baz |
| 1238 | |
| 1239 | ------------------------------- |
| 1240 | |
| 1241 | =item mkfifo |
| 1242 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1243 | Usage: mkfifo [OPTIONS] name |
| 1244 | |
| 1245 | Creates a named pipe (identical to 'mknod name p') |
| 1246 | |
| 1247 | Options: |
John Beppu | 9057b6a | 2000-04-16 10:22:28 +0000 | [diff] [blame] | 1248 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1249 | -m create the pipe using the specified mode (default a=rw) |
| 1250 | |
| 1251 | ------------------------------- |
| 1252 | |
| 1253 | =item mkfs.minix |
| 1254 | |
| 1255 | Usage: mkfs.minix [B<-c> | B<-l> filename] [B<-nXX>] [B<-iXX>] /dev/name [blocks] |
| 1256 | |
| 1257 | Make a MINIX filesystem. |
| 1258 | |
Eric Andersen | 2086e3d | 2000-07-04 22:17:01 +0000 | [diff] [blame] | 1259 | Options: |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1260 | |
| 1261 | -c Check the device for bad blocks |
| 1262 | -n [14|30] Specify the maximum length of filenames |
| 1263 | -i Specify the number of inodes for the filesystem |
| 1264 | -l FILENAME Read the bad blocks list from FILENAME |
| 1265 | -v Make a Minix version 2 filesystem |
| 1266 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1267 | ------------------------------- |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1268 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 1269 | =item mknod |
| 1270 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1271 | Usage: mknod [OPTIONS] NAME TYPE MAJOR MINOR |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1272 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1273 | Create a special file (block, character, or pipe). |
| 1274 | |
| 1275 | Options: |
John Beppu | 9057b6a | 2000-04-16 10:22:28 +0000 | [diff] [blame] | 1276 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1277 | -m create the special file using the specified mode (default a=rw) |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1278 | |
| 1279 | TYPEs include: |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1280 | b: Make a block (buffered) device. |
| 1281 | c or u: Make a character (un-buffered) device. |
| 1282 | p: Make a named pipe. MAJOR and MINOR are ignored for named pipes. |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1283 | |
| 1284 | Example: |
| 1285 | |
| 1286 | $ mknod /dev/fd0 b 2 0 |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1287 | $ mknod -m 644 /tmp/pipe p |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1288 | |
| 1289 | ------------------------------- |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1290 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 1291 | =item mkswap |
| 1292 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1293 | Usage: mkswap [B<-c>] [B<-v0>|B<-v1>] device [block-count] |
| 1294 | |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1295 | Prepare a disk partition to be used as a swap partition. |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1296 | |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1297 | Options: |
| 1298 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1299 | -c Check for read-ability. |
| 1300 | -v0 Make version 0 swap [max 128 Megs]. |
| 1301 | -v1 Make version 1 swap [big!] (default for kernels > 2.1.117). |
| 1302 | block-count Number of block to use (default is entire partition). |
John Beppu | 50ed067 | 2000-04-13 23:44:04 +0000 | [diff] [blame] | 1303 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1304 | ------------------------------- |
| 1305 | |
Erik Andersen | 227a59b | 2000-04-25 23:24:55 +0000 | [diff] [blame] | 1306 | =item mktemp |
| 1307 | |
Erik Andersen | e31c066 | 2000-05-02 05:32:07 +0000 | [diff] [blame] | 1308 | Usage: mktemp [B<-q>] TEMPLATE |
Erik Andersen | 227a59b | 2000-04-25 23:24:55 +0000 | [diff] [blame] | 1309 | |
| 1310 | Creates a temporary file with its name based on TEMPLATE. |
| 1311 | TEMPLATE is any name with six `Xs' (i.e. /tmp/temp.XXXXXX). |
| 1312 | |
| 1313 | Example: |
Erik Andersen | a19bc64 | 2000-05-02 06:40:02 +0000 | [diff] [blame] | 1314 | |
Erik Andersen | 227a59b | 2000-04-25 23:24:55 +0000 | [diff] [blame] | 1315 | $ mktemp /tmp/temp.XXXXXX |
| 1316 | /tmp/temp.mWiLjM |
| 1317 | $ ls -la /tmp/temp.mWiLjM |
| 1318 | -rw------- 1 andersen andersen 0 Apr 25 17:10 /tmp/temp.mWiLjM |
| 1319 | |
| 1320 | ------------------------------- |
| 1321 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 1322 | =item more |
| 1323 | |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1324 | Usage: more [file ...] |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1325 | |
| 1326 | More is a filter for paging through text one screenful at a time. |
| 1327 | |
| 1328 | Example: |
| 1329 | |
| 1330 | $ dmesg | more |
John Beppu | 50ed067 | 2000-04-13 23:44:04 +0000 | [diff] [blame] | 1331 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1332 | ------------------------------- |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1333 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 1334 | =item mount |
| 1335 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1336 | Usage: mount [flags] |
| 1337 | mount [flags] device directory [B<-o> options,more-options] |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1338 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1339 | Flags: |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1340 | |
Erik Andersen | 6c5f2c6 | 2000-05-05 19:49:33 +0000 | [diff] [blame] | 1341 | -a: Mount all file systems in fstab. |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1342 | -o option: One of many filesystem options, listed below. |
Erik Andersen | 6c5f2c6 | 2000-05-05 19:49:33 +0000 | [diff] [blame] | 1343 | -r: Mount the filesystem read-only. |
| 1344 | -t fs-type: Specify the filesystem type. |
| 1345 | -w: Mount for reading and writing (default). |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1346 | |
Erik Andersen | 7ab9c7e | 2000-05-12 19:41:47 +0000 | [diff] [blame] | 1347 | Options for use with the "B<-o>" flag: |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1348 | |
Erik Andersen | 6c5f2c6 | 2000-05-05 19:49:33 +0000 | [diff] [blame] | 1349 | async/sync: Writes are asynchronous / synchronous. |
| 1350 | atime/noatime: Enable / disable updates to inode access times. |
| 1351 | dev/nodev: Allow use of special device files / disallow them. |
| 1352 | exec/noexec: Allow use of executable files / disallow them. |
| 1353 | loop: Mounts a file via loop device. |
| 1354 | suid/nosuid: Allow set-user-id-root programs / disallow them. |
| 1355 | remount: Re-mount a currently-mounted filesystem, changing its flags. |
| 1356 | ro/rw: Mount for read-only / read-write. |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1357 | There are EVEN MORE flags that are specific to each filesystem. |
| 1358 | You'll have to see the written documentation for those. |
| 1359 | |
| 1360 | Example: |
| 1361 | |
| 1362 | $ mount |
| 1363 | /dev/hda3 on / type minix (rw) |
| 1364 | proc on /proc type proc (rw) |
| 1365 | devpts on /dev/pts type devpts (rw) |
| 1366 | $ mount /dev/fd0 /mnt -t msdos -o ro |
| 1367 | $ mount /tmp/diskimage /opt -t ext2 -o loop |
John Beppu | 50ed067 | 2000-04-13 23:44:04 +0000 | [diff] [blame] | 1368 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1369 | ------------------------------- |
| 1370 | |
| 1371 | =item mt |
| 1372 | |
John Beppu | 9057b6a | 2000-04-16 10:22:28 +0000 | [diff] [blame] | 1373 | Usage: mt [B<-f> device] opcode value |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1374 | |
| 1375 | Control magnetic tape drive operation |
| 1376 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1377 | ------------------------------- |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1378 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 1379 | =item mv |
| 1380 | |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1381 | Usage: mv SOURCE DEST |
| 1382 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1383 | or: mv SOURCE... DIRECTORY |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1384 | |
| 1385 | Rename SOURCE to DEST, or move SOURCE(s) to DIRECTORY. |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1386 | |
| 1387 | Example: |
| 1388 | |
| 1389 | $ mv /tmp/foo /bin/bar |
John Beppu | 50ed067 | 2000-04-13 23:44:04 +0000 | [diff] [blame] | 1390 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1391 | ------------------------------- |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1392 | |
Eric Andersen | 028fb62 | 2000-07-04 20:07:13 +0000 | [diff] [blame] | 1393 | =item nc |
| 1394 | |
| 1395 | Usage: nc [IP] [port] |
| 1396 | |
| 1397 | Netcat opens a pipe to IP:port |
| 1398 | |
| 1399 | Example: |
| 1400 | |
| 1401 | $ nc foobar.somedomain.com 25 |
| 1402 | 220 foobar ESMTP Exim 3.12 #1 Sat, 15 Apr 2000 00:03:02 -0600 |
| 1403 | help |
| 1404 | 214-Commands supported: |
| 1405 | 214- HELO EHLO MAIL RCPT DATA AUTH |
| 1406 | 214 NOOP QUIT RSET HELP |
| 1407 | quit |
| 1408 | 221 foobar closing connection |
| 1409 | |
| 1410 | ------------------------------- |
| 1411 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1412 | =item nslookup |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 1413 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1414 | Usage: nslookup [HOST] |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1415 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1416 | Queries the nameserver for the IP address of the given HOST |
| 1417 | |
| 1418 | Example: |
| 1419 | |
| 1420 | $ nslookup localhost |
| 1421 | Server: default |
| 1422 | Address: default |
| 1423 | |
| 1424 | Name: debian |
| 1425 | Address: 127.0.0.1 |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 1426 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1427 | ------------------------------- |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1428 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1429 | =item ping |
| 1430 | |
| 1431 | Usage: ping [OPTION]... host |
| 1432 | |
| 1433 | Send ICMP ECHO_REQUEST packets to network hosts. |
| 1434 | |
| 1435 | Options: |
| 1436 | |
| 1437 | -c COUNT Send only COUNT pings. |
Pavel Roskin | 0024abc | 2000-06-07 20:38:15 +0000 | [diff] [blame] | 1438 | -s SIZE Send SIZE data bytes in packets (default=56). |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1439 | -q Quiet mode, only displays output at start |
| 1440 | and when finished. |
| 1441 | Example: |
| 1442 | |
| 1443 | $ ping localhost |
| 1444 | PING slag (127.0.0.1): 56 data bytes |
| 1445 | 64 bytes from 127.0.0.1: icmp_seq=0 ttl=255 time=20.1 ms |
| 1446 | |
| 1447 | --- debian ping statistics --- |
| 1448 | 1 packets transmitted, 1 packets received, 0% packet loss |
| 1449 | round-trip min/avg/max = 20.1/20.1/20.1 ms |
| 1450 | |
| 1451 | ------------------------------- |
| 1452 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1453 | =item poweroff |
| 1454 | |
| 1455 | Shuts down the system, and requests that the kernel turn off power upon halting. |
| 1456 | |
| 1457 | ------------------------------- |
| 1458 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1459 | =item printf |
| 1460 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1461 | Usage: printf format [argument...] |
| 1462 | |
| 1463 | Formats and prints the given data in a manner similar to the C printf command. |
| 1464 | |
| 1465 | Example: |
| 1466 | |
| 1467 | $ printf "Val=%d\n" 5 |
| 1468 | Val=5 |
| 1469 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1470 | ------------------------------- |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1471 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 1472 | =item ps |
| 1473 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1474 | Usage: ps |
| 1475 | |
| 1476 | Report process status |
| 1477 | |
| 1478 | This version of ps accepts no options. |
| 1479 | |
| 1480 | Example: |
| 1481 | |
| 1482 | $ ps |
| 1483 | PID Uid Gid State Command |
| 1484 | 1 root root S init |
| 1485 | 2 root root S [kflushd] |
| 1486 | 3 root root S [kupdate] |
| 1487 | 4 root root S [kpiod] |
| 1488 | 5 root root S [kswapd] |
| 1489 | 742 andersen andersen S [bash] |
| 1490 | 743 andersen andersen S -bash |
| 1491 | 745 root root S [getty] |
| 1492 | 2990 andersen andersen R ps |
| 1493 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1494 | ------------------------------- |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1495 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 1496 | =item pwd |
| 1497 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1498 | Prints the full filename of the current working directory. |
| 1499 | |
| 1500 | Example: |
| 1501 | |
| 1502 | $ pwd |
| 1503 | /root |
| 1504 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1505 | ------------------------------- |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1506 | |
Eric Andersen | 918507e | 2000-08-21 22:46:33 +0000 | [diff] [blame] | 1507 | =item rdate |
| 1508 | |
| 1509 | Usage: rdate [OPTION] HOST |
| 1510 | |
| 1511 | Get and possibly set the system date and time from a remote HOST. |
| 1512 | |
| 1513 | Options: |
| 1514 | |
| 1515 | -s Set the system date and time (default). |
| 1516 | -p Print the date and time. |
| 1517 | |
| 1518 | ------------------------------- |
| 1519 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 1520 | =item reboot |
| 1521 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1522 | Instructs the kernel to reboot the system. |
| 1523 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1524 | ------------------------------- |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1525 | |
Eric Andersen | bf960f5 | 2000-07-21 21:32:12 +0000 | [diff] [blame] | 1526 | =item renice |
| 1527 | |
| 1528 | Usage: renice priority pid [pid ...] |
| 1529 | |
| 1530 | Changes priority of running processes. Allowed priorities range |
| 1531 | from 20 (the process runs only when nothing else is running) to 0 |
| 1532 | (default priority) to -20 (almost nothing else ever gets to run). |
| 1533 | |
| 1534 | ------------------------------- |
| 1535 | |
Eric Andersen | fa405d0 | 2000-08-21 21:18:52 +0000 | [diff] [blame] | 1536 | =item reset |
| 1537 | |
| 1538 | Usage: reset |
| 1539 | |
| 1540 | Resets the screen. |
| 1541 | |
| 1542 | ------------------------------- |
| 1543 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 1544 | =item rm |
| 1545 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1546 | Usage: rm [OPTION]... FILE... |
| 1547 | |
Eric Andersen | 815e904 | 2000-06-06 16:15:23 +0000 | [diff] [blame] | 1548 | Remove (unlink) the FILE(s). You may use '--' to |
| 1549 | indicate that all following arguments are non-options. |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1550 | |
| 1551 | Options: |
| 1552 | |
| 1553 | -f remove existing destinations, never prompt |
| 1554 | -r or -R remove the contents of directories recursively |
| 1555 | |
| 1556 | Example: |
| 1557 | |
| 1558 | $ rm -rf /tmp/foo |
| 1559 | |
| 1560 | ------------------------------- |
| 1561 | |
| 1562 | =item rmdir |
| 1563 | |
| 1564 | Usage: rmdir [OPTION]... DIRECTORY... |
| 1565 | |
| 1566 | Remove the DIRECTORY(ies), if they are empty. |
| 1567 | |
| 1568 | Example: |
| 1569 | |
| 1570 | # rmdir /tmp/foo |
| 1571 | |
| 1572 | ------------------------------- |
| 1573 | |
| 1574 | =item rmmod |
| 1575 | |
| 1576 | Usage: rmmod [OPTION]... [MODULE]... |
| 1577 | |
| 1578 | Unloads the specified kernel modules from the kernel. |
| 1579 | |
| 1580 | Options: |
| 1581 | |
| 1582 | -a Try to remove all unused kernel modules. |
| 1583 | |
| 1584 | Example: |
| 1585 | |
| 1586 | $ rmmod tulip |
| 1587 | |
| 1588 | ------------------------------- |
| 1589 | |
| 1590 | =item sed |
| 1591 | |
John Beppu | 9057b6a | 2000-04-16 10:22:28 +0000 | [diff] [blame] | 1592 | Usage: sed [B<-n>] B<-e> script [file...] |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1593 | |
| 1594 | Allowed sed scripts come in the following form: |
| 1595 | |
| 1596 | 'ADDR [!] COMMAND' |
| 1597 | |
| 1598 | where address ADDR can be: |
| 1599 | NUMBER Match specified line number |
| 1600 | $ Match last line |
| 1601 | /REGEXP/ Match specified regexp |
| 1602 | (! inverts the meaning of the match) |
| 1603 | |
| 1604 | and COMMAND can be: |
| 1605 | s/regexp/replacement/[igp] |
| 1606 | which attempt to match regexp against the pattern space |
| 1607 | and if successful replaces the matched portion with replacement. |
| 1608 | |
| 1609 | aTEXT |
| 1610 | which appends TEXT after the pattern space |
| 1611 | |
| 1612 | Options: |
| 1613 | |
| 1614 | -e add the script to the commands to be executed |
| 1615 | -n suppress automatic printing of pattern space |
| 1616 | |
Eric Andersen | 98cd53e | 2000-06-16 19:56:44 +0000 | [diff] [blame] | 1617 | This version of sed matches full regular expressions. |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1618 | |
| 1619 | Example: |
| 1620 | |
| 1621 | $ echo "foo" | sed -e 's/f[a-zA-Z]o/bar/g' |
| 1622 | bar |
| 1623 | |
| 1624 | ------------------------------- |
| 1625 | |
Erik Andersen | 4f3f757 | 2000-04-28 00:18:56 +0000 | [diff] [blame] | 1626 | =item setkeycodes |
| 1627 | |
| 1628 | Usage: setkeycodes SCANCODE KEYCODE ... |
| 1629 | |
| 1630 | Set entries into the kernel's scancode-to-keycode map, |
| 1631 | allowing unusual keyboards to generate usable keycodes. |
| 1632 | |
| 1633 | SCANCODE may be either xx or e0xx (hexadecimal), |
| 1634 | and KEYCODE is given in decimal |
| 1635 | |
| 1636 | Example: |
| 1637 | |
| 1638 | # setkeycodes e030 127 |
| 1639 | |
| 1640 | ------------------------------- |
| 1641 | |
Eric Andersen | 028fb62 | 2000-07-04 20:07:13 +0000 | [diff] [blame] | 1642 | =item sh |
| 1643 | |
| 1644 | Usage: sh |
| 1645 | |
| 1646 | lash -- the BusyBox LAme SHell (command interpreter) |
| 1647 | |
| 1648 | This command does not yet have proper documentation. |
| 1649 | |
| 1650 | Use lash just as you would use any other shell. It properly handles pipes, |
| 1651 | redirects, job control, can be used as the shell for scripts (#!/bin/sh), and |
| 1652 | has a sufficient set of builtins to do what is needed. It does not (yet) |
| 1653 | support Bourne Shell syntax. If you need things like "if-then-else", "while", |
| 1654 | and such, use ash or bash. If you just need a very simple and extremely small |
| 1655 | shell, this will do the job. |
| 1656 | |
| 1657 | ------------------------------- |
| 1658 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1659 | =item sleep |
| 1660 | |
| 1661 | Usage: sleep N |
| 1662 | |
| 1663 | Pause for N seconds. |
| 1664 | |
| 1665 | Example: |
| 1666 | |
| 1667 | $ sleep 2 |
| 1668 | [2 second delay results] |
| 1669 | |
| 1670 | ------------------------------- |
| 1671 | |
| 1672 | =item sort |
| 1673 | |
John Beppu | 9057b6a | 2000-04-16 10:22:28 +0000 | [diff] [blame] | 1674 | Usage: sort [B<-n>] [B<-r>] [FILE]... |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1675 | |
| 1676 | Sorts lines of text in the specified files |
| 1677 | |
| 1678 | Example: |
| 1679 | |
| 1680 | $ echo -e "e\nf\nb\nd\nc\na" | sort |
| 1681 | a |
| 1682 | b |
| 1683 | c |
| 1684 | d |
| 1685 | e |
| 1686 | f |
| 1687 | |
| 1688 | ------------------------------- |
| 1689 | |
Eric Andersen | 028fb62 | 2000-07-04 20:07:13 +0000 | [diff] [blame] | 1690 | =item swapoff |
| 1691 | |
| 1692 | Usage: swapoff [OPTION] [device] |
| 1693 | |
| 1694 | Stop swapping virtual memory pages on the given device. |
| 1695 | |
| 1696 | Options: |
| 1697 | |
| 1698 | -a Stop swapping on all swap devices |
| 1699 | |
| 1700 | ------------------------------- |
| 1701 | |
| 1702 | =item swapon |
| 1703 | |
| 1704 | Usage: swapon [OPTION] [device] |
| 1705 | |
| 1706 | Start swapping virtual memory pages on the given device. |
| 1707 | |
| 1708 | Options: |
| 1709 | |
| 1710 | -a Start swapping on all swap devices |
| 1711 | |
| 1712 | ------------------------------- |
| 1713 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1714 | =item sync |
| 1715 | |
| 1716 | Usage: sync |
| 1717 | |
| 1718 | Write all buffered filesystem blocks to disk. |
| 1719 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1720 | ------------------------------- |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1721 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 1722 | =item syslogd |
| 1723 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1724 | Usage: syslogd [OPTION]... |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1725 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1726 | Linux system and kernel (provides klogd) logging utility. |
| 1727 | Note that this version of syslogd/klogd ignores /etc/syslog.conf. |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1728 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1729 | Options: |
Pavel Roskin | 049b706 | 2000-06-07 21:19:49 +0000 | [diff] [blame] | 1730 | |
Eric Andersen | bf2b8ae | 2000-12-08 19:52:01 +0000 | [diff] [blame] | 1731 | -m NUM Interval between MARK lines (default=20min, 0=off) |
Pavel Roskin | da10ec0 | 2000-06-07 21:08:25 +0000 | [diff] [blame] | 1732 | -n Run as a foreground process |
| 1733 | -K Do not start up the klogd process |
Eric Andersen | bf2b8ae | 2000-12-08 19:52:01 +0000 | [diff] [blame] | 1734 | -O FILE Use an alternate log file (default=/var/log/messages) |
Eric Andersen | 70d09ed | 2000-12-11 16:24:16 +0000 | [diff] [blame] | 1735 | -R HOST[:PORT] Log remotely to IP or hostname on PORT (default PORT=514/UDP) |
Eric Andersen | 20c2bdd | 2000-12-11 19:39:25 +0000 | [diff] [blame] | 1736 | -L Log locally as well as network logging (default is network only) |
Eric Andersen | ced2cef | 2000-07-20 23:41:24 +0000 | [diff] [blame] | 1737 | |
| 1738 | Example: |
| 1739 | |
| 1740 | $ syslogd -R masterlog:514 |
| 1741 | $ syslogd -R 192.168.1.1:601 |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1742 | |
| 1743 | ------------------------------- |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1744 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 1745 | =item tail |
| 1746 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1747 | Usage: tail [OPTION] [FILE]... |
| 1748 | |
| 1749 | Print last 10 lines of each FILE to standard output. |
| 1750 | With more than one FILE, precede each with a header giving the |
| 1751 | file name. With no FILE, or when FILE is -, read standard input. |
| 1752 | |
| 1753 | Options: |
| 1754 | |
| 1755 | -n NUM Print last NUM lines instead of first 10 |
| 1756 | -f Output data as the file grows. This version |
| 1757 | of 'tail -f' supports only one file at a time. |
| 1758 | |
| 1759 | Example: |
| 1760 | |
| 1761 | $ tail -n 1 /etc/resolv.conf |
| 1762 | nameserver 10.0.0.1 |
| 1763 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1764 | ------------------------------- |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1765 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 1766 | =item tar |
| 1767 | |
John Beppu | 9057b6a | 2000-04-16 10:22:28 +0000 | [diff] [blame] | 1768 | Usage: tar -[cxtvO] [B<--exclude> File] [B<-f> tarFile] [FILE] ... |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1769 | |
| 1770 | Create, extract, or list files from a tar file. Note that |
| 1771 | this version of tar treats hard links as separate files. |
| 1772 | |
| 1773 | Main operation mode: |
| 1774 | |
| 1775 | c create |
| 1776 | x extract |
| 1777 | t list |
| 1778 | |
| 1779 | File selection: |
| 1780 | |
| 1781 | f name of tarfile or "-" for stdin |
| 1782 | O extract to stdout |
Eric Andersen | fdd5103 | 2000-08-02 18:48:26 +0000 | [diff] [blame] | 1783 | exclude file to exclude |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1784 | |
| 1785 | Informative output: |
| 1786 | |
| 1787 | v verbosely list files processed |
| 1788 | |
| 1789 | Example: |
| 1790 | |
| 1791 | $ zcat /tmp/tarball.tar.gz | tar -xf - |
| 1792 | $ tar -cf /tmp/tarball.tar /usr/local |
| 1793 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1794 | ------------------------------- |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1795 | |
Eric Andersen | 028fb62 | 2000-07-04 20:07:13 +0000 | [diff] [blame] | 1796 | =item tee |
| 1797 | |
| 1798 | Usage: tee [OPTION]... [FILE]... |
| 1799 | |
| 1800 | Copy standard input to each FILE, and also to standard output. |
| 1801 | |
| 1802 | Options: |
| 1803 | |
| 1804 | -a append to the given FILEs, do not overwrite |
| 1805 | |
| 1806 | Example: |
| 1807 | |
| 1808 | $ echo "Hello" | tee /tmp/foo |
| 1809 | $ cat /tmp/foo |
| 1810 | Hello |
| 1811 | |
| 1812 | ------------------------------- |
| 1813 | |
| 1814 | =item telnet |
| 1815 | |
| 1816 | Usage: telnet host [port] |
| 1817 | |
| 1818 | Telnet is used to establish interactive communication with another |
| 1819 | computer over a network using the TELNET protocol. |
| 1820 | |
| 1821 | ------------------------------- |
| 1822 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1823 | =item test, [ |
| 1824 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1825 | Usage: test EXPRESSION |
| 1826 | or [ EXPRESSION ] |
| 1827 | |
| 1828 | Checks file types and compares values returning an exit |
| 1829 | code determined by the value of EXPRESSION. |
| 1830 | |
| 1831 | Example: |
| 1832 | |
| 1833 | $ test 1 -eq 2 |
| 1834 | $ echo $? |
| 1835 | 1 |
| 1836 | $ test 1 -eq 1 |
| 1837 | $ echo $? |
| 1838 | 0 |
| 1839 | $ [ -d /etc ] |
| 1840 | $ echo $? |
| 1841 | 0 |
| 1842 | $ [ -d /junk ] |
| 1843 | $ echo $? |
| 1844 | 1 |
| 1845 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1846 | ------------------------------- |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1847 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 1848 | =item touch |
| 1849 | |
John Beppu | 9057b6a | 2000-04-16 10:22:28 +0000 | [diff] [blame] | 1850 | Usage: touch [B<-c>] file [file ...] |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1851 | |
| 1852 | Update the last-modified date on (or create) the selected file[s]. |
| 1853 | |
| 1854 | Example: |
| 1855 | |
| 1856 | $ ls -l /tmp/foo |
| 1857 | /bin/ls: /tmp/foo: No such file or directory |
| 1858 | $ touch /tmp/foo |
| 1859 | $ ls -l /tmp/foo |
| 1860 | -rw-rw-r-- 1 andersen andersen 0 Apr 15 01:11 /tmp/foo |
| 1861 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1862 | ------------------------------- |
| 1863 | |
| 1864 | =item tr |
Erik Andersen | a19bc64 | 2000-05-02 06:40:02 +0000 | [diff] [blame] | 1865 | |
Erik Andersen | 3c1217c | 2000-05-01 22:34:24 +0000 | [diff] [blame] | 1866 | Usage: tr [-cds] STRING1 [STRING2] |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1867 | |
Erik Andersen | 3c1217c | 2000-05-01 22:34:24 +0000 | [diff] [blame] | 1868 | Translate, squeeze, and/or delete characters from |
| 1869 | standard input, writing to standard output. |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1870 | |
Erik Andersen | 3c1217c | 2000-05-01 22:34:24 +0000 | [diff] [blame] | 1871 | Options: |
| 1872 | |
| 1873 | -c take complement of STRING1 |
| 1874 | -d delete input characters coded STRING1 |
| 1875 | -s squeeze multiple output characters of STRING2 into one character |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1876 | |
| 1877 | Example: |
| 1878 | |
| 1879 | $ echo "gdkkn vnqkc" | tr [a-y] [b-z] |
| 1880 | hello world |
| 1881 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1882 | ------------------------------- |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1883 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 1884 | =item true |
| 1885 | |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1886 | Returns an exit code of TRUE (0) |
| 1887 | |
| 1888 | Example: |
| 1889 | |
| 1890 | $ true |
| 1891 | $ echo $? |
| 1892 | 0 |
| 1893 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1894 | ------------------------------- |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1895 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1896 | =item tty |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1897 | |
Erik Andersen | e5b6c7d | 2000-04-17 16:16:10 +0000 | [diff] [blame] | 1898 | Usage: tty |
| 1899 | |
| 1900 | Print the file name of the terminal connected to standard input. |
| 1901 | |
| 1902 | Options: |
| 1903 | |
| 1904 | -s print nothing, only return an exit status |
| 1905 | |
| 1906 | Example: |
| 1907 | |
| 1908 | $ tty |
| 1909 | /dev/tty2 |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1910 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1911 | ------------------------------- |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1912 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 1913 | =item umount |
| 1914 | |
Erik Andersen | e5b6c7d | 2000-04-17 16:16:10 +0000 | [diff] [blame] | 1915 | Usage: umount [flags] filesystem|directory |
| 1916 | |
| 1917 | Flags: |
| 1918 | |
Erik Andersen | 6c5f2c6 | 2000-05-05 19:49:33 +0000 | [diff] [blame] | 1919 | -a: Unmount all file systems |
| 1920 | -r: Try to remount devices as read-only if mount is busy |
| 1921 | -f: Force filesystem umount (i.e. unreachable NFS server) |
| 1922 | -l: Do not free loop device (if a loop device has been used) |
Erik Andersen | e5b6c7d | 2000-04-17 16:16:10 +0000 | [diff] [blame] | 1923 | |
| 1924 | Example: |
| 1925 | |
| 1926 | $ umount /dev/hdc1 |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1927 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1928 | ------------------------------- |
John Beppu | f17792c | 2000-04-13 03:16:01 +0000 | [diff] [blame] | 1929 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1930 | =item uname |
John Beppu | f17792c | 2000-04-13 03:16:01 +0000 | [diff] [blame] | 1931 | |
Erik Andersen | e5b6c7d | 2000-04-17 16:16:10 +0000 | [diff] [blame] | 1932 | Usage: uname [OPTION]... |
| 1933 | |
Erik Andersen | 26702fe | 2000-04-17 16:44:46 +0000 | [diff] [blame] | 1934 | Print certain system information. With no OPTION, same as B<-s>. |
Erik Andersen | e5b6c7d | 2000-04-17 16:16:10 +0000 | [diff] [blame] | 1935 | |
| 1936 | Options: |
| 1937 | |
| 1938 | -a print all information |
| 1939 | -m the machine (hardware) type |
| 1940 | -n print the machine's network node hostname |
| 1941 | -r print the operating system release |
| 1942 | -s print the operating system name |
| 1943 | -p print the host processor type |
| 1944 | -v print the operating system version |
| 1945 | |
| 1946 | Example: |
| 1947 | |
| 1948 | $ uname -a |
| 1949 | Linux debian 2.2.15pre13 #5 Tue Mar 14 16:03:50 MST 2000 i686 unknown |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1950 | |
| 1951 | ------------------------------- |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1952 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 1953 | =item uniq |
| 1954 | |
Erik Andersen | e5b6c7d | 2000-04-17 16:16:10 +0000 | [diff] [blame] | 1955 | Usage: uniq [OPTION]... [INPUT [OUTPUT]] |
| 1956 | |
| 1957 | Discard all but one of successive identical lines from INPUT |
| 1958 | (or standard input), writing to OUTPUT (or standard output). |
Eric Andersen | 5b5db38 | 2000-12-09 16:37:53 +0000 | [diff] [blame] | 1959 | |
| 1960 | Options: |
| 1961 | |
| 1962 | -c prefix lines by the number of occurrences |
| 1963 | -d only print duplicate lines |
| 1964 | -u only print unique lines |
Erik Andersen | e5b6c7d | 2000-04-17 16:16:10 +0000 | [diff] [blame] | 1965 | |
| 1966 | Example: |
| 1967 | |
| 1968 | $ echo -e "a\na\nb\nc\nc\na" | sort | uniq |
| 1969 | a |
| 1970 | b |
| 1971 | c |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 1972 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1973 | ------------------------------- |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1974 | |
Eric Andersen | cff3fe3 | 2000-09-20 19:22:26 +0000 | [diff] [blame] | 1975 | =item unix2dos |
| 1976 | |
| 1977 | Usage: unix2dos < unixfile > dosfile |
| 1978 | |
| 1979 | Converts a text file from unix format to dos format. |
| 1980 | |
| 1981 | ------------------------------- |
| 1982 | |
| 1983 | =item unrpm |
| 1984 | |
Eric Andersen | 350b3f9 | 2000-09-21 02:06:35 +0000 | [diff] [blame] | 1985 | Usage: unrpm < package.rpm | gzip B<-d> | cpio -idmuv |
Eric Andersen | cff3fe3 | 2000-09-20 19:22:26 +0000 | [diff] [blame] | 1986 | |
| 1987 | Extracts an rpm archive. |
| 1988 | |
| 1989 | ------------------------------- |
| 1990 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 1991 | =item update |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 1992 | |
Erik Andersen | e5b6c7d | 2000-04-17 16:16:10 +0000 | [diff] [blame] | 1993 | Usage: update [options] |
| 1994 | |
| 1995 | Periodically flushes filesystem buffers. |
| 1996 | |
| 1997 | Options: |
| 1998 | |
| 1999 | -S force use of sync(2) instead of flushing |
| 2000 | -s SECS call sync this often (default 30) |
| 2001 | -f SECS flush some buffers this often (default 5) |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 2002 | |
| 2003 | ------------------------------- |
| 2004 | |
| 2005 | =item uptime |
| 2006 | |
Erik Andersen | e5b6c7d | 2000-04-17 16:16:10 +0000 | [diff] [blame] | 2007 | Usage: uptime |
| 2008 | |
| 2009 | Tells how long the system has been running since boot. |
| 2010 | |
| 2011 | Example: |
| 2012 | |
| 2013 | $ uptime |
| 2014 | 1:55pm up 2:30, load average: 0.09, 0.04, 0.00 |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 2015 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 2016 | ------------------------------- |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 2017 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 2018 | =item usleep |
| 2019 | |
Erik Andersen | e5b6c7d | 2000-04-17 16:16:10 +0000 | [diff] [blame] | 2020 | Usage: usleep N |
| 2021 | |
| 2022 | Pauses for N microseconds. |
| 2023 | |
| 2024 | Example: |
| 2025 | |
| 2026 | $ usleep 1000000 |
| 2027 | [pauses for 1 second] |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 2028 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 2029 | ------------------------------- |
| 2030 | |
Eric Andersen | 028fb62 | 2000-07-04 20:07:13 +0000 | [diff] [blame] | 2031 | =item uuencode |
| 2032 | |
| 2033 | Usage: uuencode [OPTION] [INFILE] REMOTEFILE |
| 2034 | |
| 2035 | Uuencode a file. |
| 2036 | |
| 2037 | Options: |
| 2038 | |
| 2039 | -m use base64 encoding as of RFC1521 |
| 2040 | |
| 2041 | Example: |
| 2042 | |
| 2043 | $ uuencode busybox busybox |
| 2044 | begin 755 busybox |
| 2045 | M?T5,1@$!`0````````````(``P`!````L+@$"#0```!0N@,``````#0`(``& |
| 2046 | ..... |
| 2047 | $ uudecode busybox busybox > busybox.uu |
| 2048 | $ |
| 2049 | |
| 2050 | ------------------------------- |
| 2051 | |
| 2052 | =item uudecode |
| 2053 | |
| 2054 | Usage: uudecode [OPTION] [FILE] |
| 2055 | |
| 2056 | Uudecode a uuencoded file |
| 2057 | |
| 2058 | Options: |
| 2059 | |
| 2060 | -o FILE direct output to FILE |
| 2061 | |
| 2062 | Example: |
| 2063 | |
| 2064 | $ uudecode -o busybox busybox.uu |
| 2065 | $ ls -l busybox |
| 2066 | -rwxr-xr-x 1 ams ams 245264 Jun 7 21:35 busybox |
| 2067 | |
| 2068 | ------------------------------- |
| 2069 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 2070 | =item wc |
| 2071 | |
Erik Andersen | e5b6c7d | 2000-04-17 16:16:10 +0000 | [diff] [blame] | 2072 | Usage: wc [OPTION]... [FILE]... |
| 2073 | |
| 2074 | Print line, word, and byte counts for each FILE, and a total line if |
| 2075 | more than one FILE is specified. With no FILE, read standard input. |
| 2076 | |
| 2077 | Options: |
| 2078 | |
| 2079 | -c print the byte counts |
| 2080 | -l print the newline counts |
| 2081 | -L print the length of the longest line |
| 2082 | -w print the word counts |
| 2083 | |
| 2084 | Example: |
| 2085 | |
| 2086 | $ wc /etc/passwd |
| 2087 | 31 46 1365 /etc/passwd |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 2088 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 2089 | ------------------------------- |
| 2090 | |
Pavel Roskin | afa0662 | 2000-06-21 21:43:24 +0000 | [diff] [blame] | 2091 | =item which |
| 2092 | |
| 2093 | Usage: which [COMMAND ...] |
| 2094 | |
| 2095 | Locates a COMMAND. |
| 2096 | |
| 2097 | Example: |
| 2098 | |
| 2099 | $ which login |
| 2100 | /bin/login |
| 2101 | |
| 2102 | ------------------------------- |
| 2103 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 2104 | =item whoami |
| 2105 | |
Erik Andersen | e5b6c7d | 2000-04-17 16:16:10 +0000 | [diff] [blame] | 2106 | Usage: whoami |
| 2107 | |
| 2108 | Prints the user name associated with the current effective user id. |
| 2109 | |
| 2110 | Example: |
| 2111 | |
| 2112 | $ whoami |
| 2113 | andersen |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 2114 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 2115 | ------------------------------- |
| 2116 | |
Eric Andersen | 5b17693 | 2000-09-22 20:22:28 +0000 | [diff] [blame] | 2117 | =item xargs |
| 2118 | |
| 2119 | Usage: xargs [OPTIONS] [COMMAND] [ARGS...] |
| 2120 | |
| 2121 | Executes COMMAND on every item given by standard input. |
| 2122 | |
| 2123 | Options: |
| 2124 | |
| 2125 | -t Print the command just before it is run |
Eric Andersen | 5b17693 | 2000-09-22 20:22:28 +0000 | [diff] [blame] | 2126 | |
| 2127 | Example: |
| 2128 | |
| 2129 | $ ls | xargs gzip |
| 2130 | $ find . -name '*.c' -print | xargs rm |
| 2131 | |
| 2132 | ------------------------------- |
| 2133 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 2134 | =item yes |
| 2135 | |
Erik Andersen | e5b6c7d | 2000-04-17 16:16:10 +0000 | [diff] [blame] | 2136 | Usage: yes [OPTION]... [STRING]... |
| 2137 | |
| 2138 | Repeatedly outputs a line with all specified STRING(s), or `y'. |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 2139 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 2140 | ------------------------------- |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 2141 | |
| 2142 | =item zcat |
| 2143 | |
Erik Andersen | 26702fe | 2000-04-17 16:44:46 +0000 | [diff] [blame] | 2144 | This is essentially an alias for invoking "gunzip B<-c>", where |
Eric Andersen | 98cd53e | 2000-06-16 19:56:44 +0000 | [diff] [blame] | 2145 | it decompresses the file in question and send the output to stdout. |
Erik Andersen | 5e1189e | 2000-04-15 16:34:54 +0000 | [diff] [blame] | 2146 | |
Erik Andersen | 9cf3bfa | 2000-04-13 18:49:43 +0000 | [diff] [blame] | 2147 | ------------------------------- |
John Beppu | 4581b4c | 2000-01-19 15:04:41 +0000 | [diff] [blame] | 2148 | |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 2149 | =back |
John Beppu | 3a1b6be | 2000-01-18 15:45:59 +0000 | [diff] [blame] | 2150 | |
Erik Andersen | a19bc64 | 2000-05-02 06:40:02 +0000 | [diff] [blame] | 2151 | =head1 LIBC NSS |
| 2152 | |
| 2153 | GNU Libc uses the Name Service Switch (NSS) to configure the behavior of the C |
| 2154 | library for the local environment, and to configure how it reads system data, |
| 2155 | such as passwords and group information. BusyBox has made it Policy that it |
| 2156 | will never use NSS, and will never use and libc calls that make use of NSS. |
| 2157 | This allows you to run an embedded system without the need for installing an |
| 2158 | /etc/nsswitch.conf file and without and /lib/libnss_* libraries installed. |
| 2159 | |
| 2160 | If you are using a system that is using a remote LDAP server for authentication |
| 2161 | via GNU libc NSS, and you want to use BusyBox, then you will need to adjust the |
| 2162 | BusyBox source. Chances are though, that if you have enough space to install |
| 2163 | of that stuff on your system, then you probably want the full GNU utilities. |
| 2164 | |
John Beppu | 3a1b6be | 2000-01-18 15:45:59 +0000 | [diff] [blame] | 2165 | =head1 SEE ALSO |
| 2166 | |
| 2167 | textutils(1), shellutils(1), etc... |
| 2168 | |
| 2169 | =head1 MAINTAINER |
| 2170 | |
Erik Andersen | 1101d23 | 2000-04-19 05:15:12 +0000 | [diff] [blame] | 2171 | Erik Andersen <andersee@debian.org> <andersen@lineo.com> |
John Beppu | 3a1b6be | 2000-01-18 15:45:59 +0000 | [diff] [blame] | 2172 | |
| 2173 | =head1 AUTHORS |
| 2174 | |
John Beppu | 08fe43d | 2000-01-19 12:39:16 +0000 | [diff] [blame] | 2175 | The following people have contributed code to BusyBox whether |
| 2176 | they know it or not. |
John Beppu | 3a1b6be | 2000-01-18 15:45:59 +0000 | [diff] [blame] | 2177 | |
John Beppu | 3a1b6be | 2000-01-18 15:45:59 +0000 | [diff] [blame] | 2178 | |
John Beppu | 08fe43d | 2000-01-19 12:39:16 +0000 | [diff] [blame] | 2179 | =for html <br> |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 2180 | |
Eric Andersen | 57f83ff | 2000-09-24 02:41:44 +0000 | [diff] [blame] | 2181 | Erik Andersen <andersen@lineo.com>, <andersee@debian.org> |
| 2182 | |
| 2183 | Tons of new stuff, major rewrite of most of the |
| 2184 | core apps, tons of new apps as noted in header files. |
| 2185 | |
| 2186 | =for html <br> |
| 2187 | |
| 2188 | Edward Betts <edward@debian.org> |
| 2189 | |
| 2190 | expr, hostid, logname, tty, wc, whoami, yes |
| 2191 | |
| 2192 | =for html <br> |
| 2193 | |
John Beppu | 08fe43d | 2000-01-19 12:39:16 +0000 | [diff] [blame] | 2194 | John Beppu <beppu@lineo.com> |
John Beppu | 3a1b6be | 2000-01-18 15:45:59 +0000 | [diff] [blame] | 2195 | |
Eric Andersen | 57f83ff | 2000-09-24 02:41:44 +0000 | [diff] [blame] | 2196 | du, head, nslookup, sort, tee, uniq |
| 2197 | |
John Beppu | 08fe43d | 2000-01-19 12:39:16 +0000 | [diff] [blame] | 2198 | =for html <br> |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 2199 | |
John Beppu | 08fe43d | 2000-01-19 12:39:16 +0000 | [diff] [blame] | 2200 | Brian Candler <B.Candler@pobox.com> |
John Beppu | 3a1b6be | 2000-01-18 15:45:59 +0000 | [diff] [blame] | 2201 | |
Eric Andersen | 57f83ff | 2000-09-24 02:41:44 +0000 | [diff] [blame] | 2202 | tiny-ls(ls) |
| 2203 | |
John Beppu | 08fe43d | 2000-01-19 12:39:16 +0000 | [diff] [blame] | 2204 | =for html <br> |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 2205 | |
John Beppu | 08fe43d | 2000-01-19 12:39:16 +0000 | [diff] [blame] | 2206 | Randolph Chung <tausq@debian.org> |
John Beppu | 3a1b6be | 2000-01-18 15:45:59 +0000 | [diff] [blame] | 2207 | |
Eric Andersen | 57f83ff | 2000-09-24 02:41:44 +0000 | [diff] [blame] | 2208 | fbset, ping, hostname, and mkfifo |
| 2209 | |
John Beppu | 08fe43d | 2000-01-19 12:39:16 +0000 | [diff] [blame] | 2210 | =for html <br> |
John Beppu | 46a4e76 | 2000-01-18 22:33:11 +0000 | [diff] [blame] | 2211 | |
John Beppu | 08fe43d | 2000-01-19 12:39:16 +0000 | [diff] [blame] | 2212 | Dave Cinege <dcinege@psychosis.com> |
| 2213 | |
Eric Andersen | 57f83ff | 2000-09-24 02:41:44 +0000 | [diff] [blame] | 2214 | more(v2), makedevs, dutmp, modularization, auto links file, |
| 2215 | various fixes, Linux Router Project maintenance |
| 2216 | |
John Beppu | 08fe43d | 2000-01-19 12:39:16 +0000 | [diff] [blame] | 2217 | =for html <br> |
| 2218 | |
John Beppu | 50ed067 | 2000-04-13 23:44:04 +0000 | [diff] [blame] | 2219 | Karl M. Hegbloom <karlheg@debian.org> |
| 2220 | |
Eric Andersen | 57f83ff | 2000-09-24 02:41:44 +0000 | [diff] [blame] | 2221 | cp_mv.c, the test suite, various fixes to utility.c, &c. |
| 2222 | |
| 2223 | =for html <br> |
| 2224 | |
| 2225 | Daniel Jacobowitz <dan@debian.org> |
| 2226 | |
| 2227 | mktemp.c |
| 2228 | |
| 2229 | =for html <br> |
| 2230 | |
| 2231 | Matt Kraai <kraai@alumni.carnegiemellon.edu> |
| 2232 | |
| 2233 | documentation, bugfixes |
| 2234 | |
John Beppu | 50ed067 | 2000-04-13 23:44:04 +0000 | [diff] [blame] | 2235 | =for html <br> |
| 2236 | |
John Beppu | 4fd10fc | 2000-04-17 05:13:59 +0000 | [diff] [blame] | 2237 | John Lombardo <john@deltanet.com> |
| 2238 | |
Eric Andersen | 57f83ff | 2000-09-24 02:41:44 +0000 | [diff] [blame] | 2239 | dirname, tr |
| 2240 | |
John Beppu | 4fd10fc | 2000-04-17 05:13:59 +0000 | [diff] [blame] | 2241 | =for html <br> |
| 2242 | |
Eric Andersen | 86ab8a3 | 2000-06-02 03:21:42 +0000 | [diff] [blame] | 2243 | Glenn McGrath <bug1@netconnect.com.au> |
| 2244 | |
Eric Andersen | 57f83ff | 2000-09-24 02:41:44 +0000 | [diff] [blame] | 2245 | ar.c |
| 2246 | |
Eric Andersen | 86ab8a3 | 2000-06-02 03:21:42 +0000 | [diff] [blame] | 2247 | =for html <br> |
| 2248 | |
Eric Andersen | 57f83ff | 2000-09-24 02:41:44 +0000 | [diff] [blame] | 2249 | Bruce Perens <bruce@pixar.com> |
| 2250 | |
| 2251 | Original author of BusyBox. His code is still in many apps. |
| 2252 | |
| 2253 | =for html <br> |
| 2254 | |
| 2255 | Chip Rosenthal <chip@unicom.com>, <crosenth@covad.com> |
| 2256 | |
| 2257 | wget - Contributed by permission of Covad Communications |
John Beppu | 08fe43d | 2000-01-19 12:39:16 +0000 | [diff] [blame] | 2258 | |
| 2259 | =for html <br> |
| 2260 | |
Pavel Roskin | 339b892 | 2000-06-20 00:11:07 +0000 | [diff] [blame] | 2261 | Pavel Roskin <proski@gnu.org> |
Eric Andersen | 08e9289 | 2000-06-02 03:21:36 +0000 | [diff] [blame] | 2262 | |
Eric Andersen | 57f83ff | 2000-09-24 02:41:44 +0000 | [diff] [blame] | 2263 | Lots of bugs fixes and patches. |
| 2264 | |
| 2265 | =for html <br> |
| 2266 | |
| 2267 | Gyepi Sam <gyepi@praxis-sw.com> |
| 2268 | |
| 2269 | Remote logging feature for syslogd |
| 2270 | |
Eric Andersen | 08e9289 | 2000-06-02 03:21:36 +0000 | [diff] [blame] | 2271 | =for html <br> |
| 2272 | |
John Beppu | 08fe43d | 2000-01-19 12:39:16 +0000 | [diff] [blame] | 2273 | Linus Torvalds <torvalds@transmeta.com> |
| 2274 | |
Eric Andersen | 57f83ff | 2000-09-24 02:41:44 +0000 | [diff] [blame] | 2275 | mkswap, fsck.minix, mkfs.minix |
| 2276 | |
John Beppu | 08fe43d | 2000-01-19 12:39:16 +0000 | [diff] [blame] | 2277 | =for html <br> |
| 2278 | |
John Beppu | 2aee993 | 2000-09-15 08:04:42 +0000 | [diff] [blame] | 2279 | Mark Whitley <markw@lineo.com> |
| 2280 | |
Eric Andersen | 57f83ff | 2000-09-24 02:41:44 +0000 | [diff] [blame] | 2281 | sed remix, bug fixes, style-guide, etc. |
| 2282 | |
John Beppu | 2aee993 | 2000-09-15 08:04:42 +0000 | [diff] [blame] | 2283 | =for html <br> |
| 2284 | |
John Beppu | 08fe43d | 2000-01-19 12:39:16 +0000 | [diff] [blame] | 2285 | Charles P. Wright <cpwright@villagenet.com> |
| 2286 | |
Eric Andersen | 57f83ff | 2000-09-24 02:41:44 +0000 | [diff] [blame] | 2287 | gzip, mini-netcat(nc) |
| 2288 | |
John Beppu | 08fe43d | 2000-01-19 12:39:16 +0000 | [diff] [blame] | 2289 | =for html <br> |
| 2290 | |
| 2291 | Enrique Zanardi <ezanardi@ull.es> |
| 2292 | |
Eric Andersen | 57f83ff | 2000-09-24 02:41:44 +0000 | [diff] [blame] | 2293 | tarcat (since removed), loadkmap, various fixes, Debian maintenance |
John Beppu | 3a1b6be | 2000-01-18 15:45:59 +0000 | [diff] [blame] | 2294 | |
| 2295 | =cut |
John Beppu | 08fe43d | 2000-01-19 12:39:16 +0000 | [diff] [blame] | 2296 | |
Matt Kraai | 004827d | 2001-01-02 22:54:12 +0000 | [diff] [blame^] | 2297 | # $Id: busybox.pod,v 1.85 2001/01/02 22:54:12 kraai Exp $ |