blob: 0978881f6af14aa0f472a5e544ad98bd2b5a1ead [file] [log] [blame]
Rob Landley589f5cd2010-01-05 10:41:52 -06001<!--#include file="header.html" -->
2
Rob Landley5cab9942013-09-18 10:50:38 -05003<p>Toybox combines common Linux command line utilities together
Rob Landleye566f3a2013-06-16 20:02:38 -05004into a single BSD-licensed executable that's simple, small, fast,
5reasonably standards-compliant, and powerful enough to turn Android into
Rob Landley49f8d6f2013-07-26 13:04:21 -05006a development environment. See the links on the left for details.</p>
7
8<h2>News</h2>
Rob Landley5cab9942013-09-18 10:50:38 -05009<hr><b>September 17, 2013</b>
10<blockquote><p>"Think of a number," said the computer, "any number."
11Arthur told the computer the telephone number of King's Cross railway
12station passenger inquiries, on the grounds that it must have some function,
13and this might turn out to be it. - The Hitchhiker's Guide to the Galaxy</p>
14</blockquote>
15
16<p><a href=downloads/toybox-0.4.6.tar.bz2>Toybox 0.4.6</a> is based on
17<a href=http://landley.net/hg/toybox/shortlog/1068>commit 1068</a>.</p>
18
19<p>This release adds
20several new commands: Felix Janda wrote paste and fallocate, Kyungwan Han
21submitted eject, Strake contributed grep, Ashwini Sharma added pmap (and
22a testsuite entry for grep), Lukasz Skalski sent pwdx, Isaac Dunham posted
23acpi, and I did timeout and umount.</p>
24
25<p>The ls command now has a --color=auto option (suggested by Rich Felker).
26The multiplexer now has a --help option so you can say "./toybox --help blah"
27instead of using the built-in "help" command. (Which is a shell built-in.
28Try it on your command line, it's like man for shell builtins. But a certain
29other project has conditioned people to expect --help, so...) I forget who
30heehooman at gmail is but they pointed out unshare needed PID and UID
31namespace support.</p>
32
33<h3>Pending</h3>
34
35<p>A lot of new commands in toys/pending, to the point the next release should
36probably just focus on cleanup and review of this backlog. We've got klogd,
37dhcp, dhcpd, watch, route, and ps from
Rob Landleyd2774142013-10-04 14:32:39 -050038Ashwini Sharma (and an fsck wrapper but no fsck.fstype engines yet),
Rob Landley5cab9942013-09-18 10:50:38 -050039syslogd, pgrep, and pkill from Madhur Verma, netstat by Ranjan Kumar,
40test by Felix Janda, lspci by Isaac Dunham, nl, su, and renice by strake (I.E.
41M. Farkas-Dyck), and sysvinit by Kyungwan Han.</p>
42
43<p>Some cleanup work on existing pending commands that aren't
44ready to promote yet: I did a few more rounds on ifconfig
45and Isaac Dunham's did several cleanups to xzcat, Felix Janda cleaned up
46logger and syslogd...</p>
47
48<p>Also some cleanup work on commands that predate the pending directory,
49but weren't quite polished when they went in, most prominently du,
50expand, and touch.</p>
51
52<h3>Infrastructure</h3>
53
54<p>The new scripts/single.sh builds a standalone command without the
55multiplexer, although not all commands can be built that way yet (NEWTOY yes,
56OLDTOY no) and the space savings aren't anything to write home about. (If a
57command needs the option parsing logic at all, it needs all of it.) If
58you're curious, you can do:</p>
59
60<blockquote><pre>
61make defconfig
62make
63mkdir singles
64for i in $(./toybox)
65do
66 echo $i
67 PREFIX=singles/ scripts/single.sh $i || break
68done
69</pre>
70<p>(And then wait a long time and watch almost half the builds fail.)</p>
71</blockquote>
72
73<p>There is now libbuf analogous to toybuf, another global 4k buffer this
74time for use by lib/ code instead of command code.</p>
75
76<p>The lib directory got split up a bit, lib/pending.c contains functions
77not yet used by anything outside of toys/pending/*, and lib/xwrap.c contains
78functions that wrap other functions and handle failures (via error_exit).
79This leaves lib/lib.c containing actual new functions.</p>
80
81<p>General improvements and bug fixes to argument parsing. The [-abc] exclude
82logic should now clear arguments slots when disabling options. Bare --longopts
83should work now and be able to report errors using their name, the new ;
84option allows optional arguments to longopts only suppliable with = (I.E.
85--color and --color=auto but not --color auto).</p>
86
87<p>I'm gradually weaning the code off of itoa()/utoa() because sprintf
88does this already. In this case "simple" probably means "let libc do it
89for us".</p>
90
91<p>Rewrote for_each_pid_with_name_in() and renamed it to just names_to_pid().
92It shouldn't get confused trying to compare absolute and relative paths quite
93so much anymore.</p>
94
95<p>lib/llist.c grew a new dlist_pop() function for removing a doubly
96linked list entry while maintaining a circular list; tail and patch are
97using it now.</p>
98
99<p>The musl guys suggested a new optimization flag
100(-fno-asynchronous-unwind-tables)
101that shaves about 10% off the binary size by removing a C++ism that crept
102into gcc's idea of C. While I don't normally try to micromanage the compiler,
103"-fstop-being-stupid" is a thing you have to hit gcc with from time to time.</p>
104
105<h3>Bugfixes</h3>
106
107<p>Felix Janda and I did a largeish rewrite of tail to
108finally make it work right (we think). Still need to implement tail -f
109someday (the tricky bit is making -f follow multiple files at once).
110Felix also reported a bug in xpidfile.</p>
111
112<p>Juhani Haverinen pointed out that
113python 3 doesn't work with config2help.py, so the detection logic looks
114for python2 (until I get around to rewriting that in C). Elie De Brauwer
115then fixed our first attempt at this, and also fixed uname's help string.</p>
116
117<p>Ashwini Sharma
118pointed out the build was making a FLAG_ macro for " " which broke some
119configurations. (That's a control character, not a command line option.)</p>
120
121<p>Jacek Bukarewicz pointed out a bug in chdir permission handling, and
122a way to make env segfault. Both should be fixed now.</p>
123
124<p>The new function xexec_optargs()
125replaces calls to xexec(toys.optargs) to avoid freeing and reusing optargs
126during option parsing screwing stuff up (such as netcat's exec mode).</p>
127
128<p>The stat command's %a output was padded with leading zeroes, which
129didn't match anybody else's behavior and thus made the test suite hiccup
130between TEST_HOST and testing toybox. (If you go "TEST_HOST=1 scripts/test.sh
131command" it sanity checks the tests against the host implementation.)</p>
132
133<p>Last release, "mkdir sub/sub && chmod 007 sub/sub && rm -rf sub" didn't
134delete sub and didn't exit with an error either. Neither was correct, rm
135should now be fixed.</p>
136
137<p>
Rob Landley49f8d6f2013-07-26 13:04:21 -0500138<hr><b>July 26, 2013</b>
139<p>Georgi Chorbadzhiyski maintains a <a href=https://github.com/gfto/toybox>git
140mirror</a> of the repository on github, automatically updated from the
141mercurial every 6 hours. The mirror is read only, but you can generate patches
142against it and post them to the list.</p>
Rob Landleye566f3a2013-06-16 20:02:38 -0500143
Isaac Dunhamc810f9f2013-07-06 11:26:15 -0500144<hr><b>July 2, 2013</b>
145<blockquote><p>"Time is an illusion. Lunchtime doubly so." "Very deep. You
146should send that in to the Reader's Digest. They've got a page for people
147like you." -
148The Hitchhiker's Guide to the Galaxy.</p></blockquote>
149
150<p><a href=downloads/toybox-0.4.5.tar.bz2>Toybox 0.4.5</a> is based on
151<a href=http://landley.net/hg/toybox/shortlog/941>commit 941</a>. It adds
152uuencode and uudecode from Erich Plondke, and enables Luis Morales' "who" by
153default. Felix Janda and I cleaned up last year's "stat" submission and
154enabled it. Ivo van Poorten added "groups".
155Andre Renaud added "lsusb". I implemented "split", "pivot_root", and "mv".
156</p>
157
158<p>The "help" command is implemented differently now (lib/help.c) and
159each command can now understand --help (including both "toybox --help"
160and "toybox --help command" in the multiplexer).</p>
161
162<p>The "pending" directory has several commands (find, xzcat, nbd-client,
163logger, expr) which work but are not enabled by default pending further cleanup.
164Ifconfig is enabled, but still in pending because it's only 2/3 cleaned up.
165(It's an awkward halfway state but I'm not holding up the release for it.)</p>
166
167<p>I'm <a href=cleanup.html>documenting the cleanups</a> to teach
168more people to do it, but the writeups aren't caught up yet. The
169<a href=roadmap.html>roadmap</a> also got updated a bit with further analysis
170of other projects, and the README and about pages got updated.</p>
171
172<p>Fixed _another_ "ls -C" segfault when terminal size can't be detected,
173condensed the ls help text to fit on one page, implented --color, and taught
174-l to print the major, minor numbers when showing block/char devices.
175Argument parsing now handles "--" properly (to end option checking),
176and the infrastructure can now handle bare --longopts that have no
177corresponding short option (both were implemented before but didn't work).
178Fixed an old bug in "patch", chmod grew -f, who grew -a. Isaac Dunham
179fixed "-" vs "_" handling in modinfo, added a "firmware" output
180field, added -b and -k support, and taught it that the ".ko" extension means
181to look for the file at the specified path instead of under /lib. Felix Janda
182moved file permission display code to lib so ls and
183stat could share it. Ashwini Sharma spotted a bug in xabspath when the
184last path component exists but we haven't got permissions to open it
185(ala readlink -f /dev/sda as a normal user).
186</p>
187
188<p>In the build infrastructure, scripts/findglobals.sh finds leaked global
189variables. (Leaked means they aren't part of the global union: Other than glibc
190debris, toybox should define "this", "toy_list", "toybuf", and "toys", and
191that's it; the rest add memory footprint to every command for the benefit of
192just one command; use GLOBALS() to stick 'em in the union.) Static linking
193against libraries other than the host's libc now applies to feature probes
194for unshare and such. Neuter stupid internationalization support that makes
195various host "sort" commands put things in an order other than alphabetical
196(breaking the multiplexer's binary search on command names).
197
198<p>You should now be able to build from a source control snapshot on a build
199system that hasn't got python: if you disable CONFIG_TOYBOX_HELP. (The
200release tarballs ship generated/help.h, but it's not in source control.
201Eventually I should rewrite that python script in C.)</p>
202</p>
203
204<p><b>LICENSE TWEAK</b>: After <a href=http://lists.landley.net/pipermail/toybox-landley.net/2013-March/000794.html>discussion</a> on the mailing list the "2 clause
205BSD" <a href=license.html>license</a> got slightly simplified so the first
206paragraph now says:</p>
207
208<blockquote><p>Permission to use, copy, modify, and/or distribute this
209software for any purpose with or without fee is hereby granted.</p></blockquote>
210
211<p>It used to continue "provided that the above copyright notice and this
212permission notice appear in all copies", but A) what's the point? B) does "all
213copies" mean binaries, or just source code, or what? C) lots of projects
214that consider BSD and GPL compatible have <a href=https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/tree/crypto/aes_generic.c>files with
215both license notices</a> on them (sometimes at <a href=http://git.busybox.net/busybox/tree/shell/ash.c>opposite ends of the file</a> to make the conflict
216less obvious) because "all copies must include this function" would violate
217the GPL but "all copies must include this magic text blob" somehow don't?</p>
218
219<p>I don't want to have to care about this anymore. The tweaked version is more
220or less public domain with a liability disclaimer, but we're still calling it
221BSD (sometimes "0 clause BSD") to avoid explaining.</p>
222
Rob Landley6f5ef6f2013-03-21 20:21:12 -0500223<hr><b>March 21, 2013</b>
224<p>Video of my ELC talk
Rob Landleye566f3a2013-06-16 20:02:38 -0500225"<a href=http://youtu.be/SGmtP5Lg_t0>Why is Toybox?</a>"
Rob Landley6f5ef6f2013-03-21 20:21:12 -0500226is up on youtube. Related materials include the
227<a href=http://landley.net/talks/celf-2013.txt>talk outline</a> and an
228<a href=/aboriginal/about.html#selfhost>android self-hosting writeup</a>.</p>
229
Rob Landleye566f3a2013-06-16 20:02:38 -0500230<p>[Updated June 4] The following links jump to specific topics in the video. (Sorry about
231the ads, it's The Linux Foundation.)</p>
232
233<ul>
234<li>0m29s <a href=http://www.youtube.com/watch?v=SGmtP5Lg_t0#t=0m29s>The smartphone is replacing the PC</a></li>
235 <ul>
236 <li>4m22s <a href=http://www.youtube.com/watch?v=SGmtP5Lg_t0#t=4m22s>Software needed to become self-hosting</a></li>
237 <li>6m20s <a href=http://www.youtube.com/watch?v=SGmtP5Lg_t0#t=6m20s>Do we care if android or iphone wins?</a></li>
238 </ul>
239<li>9m45s <a href=http://www.youtube.com/watch?v=SGmtP5Lg_t0#t=9m45s>Android not vanilla: oppose or accept?</a></li>
240 <ul>
241 <li>11m30s <a href=http://www.youtube.com/watch?v=SGmtP5Lg_t0#t=11m30s>Open source can't do User Interfaces</a></li>
242 </ul>
243<li>15m09s <a href=http://www.youtube.com/watch?v=SGmtP5Lg_t0#t=15m09s>Android is not copyleft: oppose or accept?</a></li>
244<li>18m23s <a href=http://www.youtube.com/watch?v=SGmtP5Lg_t0#t=18m23s>Security issues</a></li>
245<li>21m15s <a href=http://www.youtube.com/watch?v=SGmtP5Lg_t0#t=21m15s>Solutions to the software problems</a></li>
246 <ul>
247 <li>22m55s <a href=http://www.youtube.com/watch?v=SGmtP5Lg_t0#t=22m55s>What toybox needs to be/do</a></li>
248 <li>28m17s <a href=http://www.youtube.com/watch?v=SGmtP5Lg_t0#t=28m17s>What is toybox?</a></li>
249 <ul>
250 <li>28m58s <a href=http://www.youtube.com/watch?v=SGmtP5Lg_t0#t=28m58s>Why toybox started...</a></li>
251 <li>37m50s <a href=http://www.youtube.com/watch?v=SGmtP5Lg_t0#t=37m50s>What does toybox actually implement?</a></li>
252 </ul>
253 </ul>
254</ul>
255</span>
256
257
Rob Landley6f5ef6f2013-03-21 20:21:12 -0500258<hr><b>March 14, 2013</b>
259<blockquote><p>"Ford, you're turning into a penguin. Stop it." -
260The Hitchhiker's Guide to the Galaxy.</p></blockquote>
261
262<p><a href=downloads/toybox-0.4.4.tar.bz2>Toybox 0.4.4</a> is based on
263<a href=http://landley.net/hg/toybox/shortlog/813>commit 813</a>, adding
264the "time" and "readahead" commands, plus some bugfixes.</p>
265
266<p>The "cp" command now implements the -s symlink option, plus bugfixes
267getting various corner cases right as used in actual package builds.
268"id -Gn root" should now print root's groups
269instead of the current user's. Several build fixes so toybox builds under
270Ubuntu 8.04 again (which is about as old a build environment as you
271can expect to find posix-2008 features in).</p>
272
273<p>Unfinished commands have generally been moved to "toys/pending".
274Everything else should "default y" to participate in make defconfig.
275Several of those pending commands got some basic cleanup so allyesconfig
276should at least compile (although defconfig is still what's useful).</p>
277
278<p>Significant roadmap updates, checking several other multicall binaries
279(klibc, sash, sbase, s6...) to see what commands they include.</p>
280
Rob Landley9a69a922013-02-23 18:32:08 -0600281<hr><b>January 18, 2013</b>
282<blockquote><p>This must be Thursday. I never could get the hang of Thursdays. - The Hitchhiker's Guide to the Galaxy.</p></blockquote>
283
284<p><a href=downloads/toybox-0.4.3.tar.bz2>Toybox 0.4.3</a> is based on
285<a href=http://landley.net/hg/toybox/shortlog/793>commit 793</a>. There
286are now exactly 100 commands in defconfig (of a little over 220 on the
287<a href=roadmap.html>todo list</a>).</p>
288
289<p>Elie De Brauwer added the rev command, cleaned up tac, implemented the -s
290and -f flags for seq, added -v and -i to killall (and fixed killall not to
291kill itself before finishing its pid list), and added to the test suite.
292Felix Janda added -m to mkdir, pwd -L and -P, and more test suite entries.</p>
293
294<p>Rob Landley added the losetup command, and fixed the existing ls, cp, and
295readlink commands. The segfault in ls
296happened when it couldn't determine the screen size (last release changed the
297default to -C and a screen size of 0 made column view unhappy), and cp got an
298extensive rewrite bringing it up to date with the dirtree changes and fixing
299a number of things it never did right in the first place. The xabspath()
300code in the library now handles a symlink after ".." properly (and the test
301suite checks for it).</p>
302
303<p>Infrastructure-wise the code is better about automatically setting the
304error return code properly. Now error_msg() sets the exit code to 1 if it's
305still defaulting to 0, and the global exit path does a fflush(NULL) with error
306bit check rather than trying to be quite so granular about flushing. (That
307means if we use printf() instead of xprintf() it still exits with the right
308error code, it just doesn't end the program early on an output error.)
309Minor bugfix so TOYBOX_DEBUG
310doesn't always warn about the lack of suid bit when toybox is built with
311at least one STAYROOT command. Bugfix for the option [grouping] logic
312(and then further fixes to the error reporting pointed out by Ashwini Sharma).
313dirtree_handle_callback() now has a prefix like the rest of the dirtree
314functions. A lot of stuff doing manual path handling was switched to using
315libc basename() (including, embarassingly, the basename command), which means
316it now correctly detects "/trailing/slash/" which the previous code didn't.</p>
317
318<p>Also, last release included some accidentally checked in debug code that
319disabled compiler optimization, so the binary size bloated a bit. It's back
320to -Os by default now.</p>
321
Rob Landley8390c652012-12-19 09:16:45 -0600322<hr><b>December 15, 2012</b>
323<blockquote><p>"The major difference between a thing that might go wrong and a
324thing that cannot possibly go wrong is that when a thing that cannot possibly
325go wrong goes wrong it usually turns out to be impossible to get at or repair."
326</p><p>- The Hitchhiker's Guide to the Galaxy.</p></blockquote>
327
328<p><a href=downloads/toybox-0.4.2.tar.bz2>Toybox 0.4.2</a> is based on
329<a href=http://landley.net/hg/toybox/shortlog/749>commit 749</a> and is
330just a resync. Linux 3.7 came out, meaning it's time to do an Aboriginal
331Linux release, and that should use a stable version of toybox. So here's
332a new stable version.</p>
333
334<p>The new commands are cut (from Jason Kyungwan Han), touch
335(from Choubey Ji), expand (from Jonathan Clairembault, and he fixed a
336bug in login), and rm (from Rob Landley). Felix Janda added UTF-8
337support infrastructure (for non-ascii character sets) with a config option.
338Elie De Brauwer added tests for cat and sha1sum, and -so options to pidof.
339The "ls" command defaults to -C (column view) now, and "readlink" now supports
340-fenq.</p>
341
342<p>Portability work: toybox should now build against the musl C library,
343and against older glibc versions (circa 2008, much before that and kernel
344features we depend on start to drop out).</p>
345
346<p>The whole codebase got reindented from "one tab" to "two spaces" per
347level. The option parsing logic now understands [groups] of commands (when more
348than one in a group is selected it can switch the others off, or error out,
349or other things). The error_exit() infrastructure can now longjmp back to an
350earlier point instead of exiting. Each toys/* directory now has a README,
351the first line of which is the fancy name menuconfig uses for the directory
352(so no more hardwired directory list in scripts/genconfig.sh).</p>
353
354<p>Fixed a filehandle leak in getmountlist().
355Pass parent pointer to dirtree_add_node() so it can give error messages with
356full path. The yesno() function now always reads from stdin and writes to
357stderr (we can retry tty checking complexity once we've got commands needing
358it).</p>
359
360<p>The open group broke their website so the
361<a href=http://opengroup.org/onlinepubs/9699919799>old links</a> to POSIX 2008
362now <a href=http://pubs.opengroup.org/onlinepubs/9699919799>need to start with
363pubs</a>. Some of the links in the tree have been updated, others haven't while
364I wait to see if their webmaster notices and fixes it.</p>
365
366<p>(I note that the current rm implementation is not technically posix compliant
367because the standard requires infinite recursion depth and the current
368implementation uses one filehandle per level. I can add a config option
369to do it Posix's way, which is more brittle and needs extra security checks,
370but am waiting for somebody to complain first. The default "ulimit -n" is 1024
371filehandles, so drilling down over 1000 nested subdirectories).</p>
372
Rob Landley571b0702012-11-13 16:13:45 -0600373<hr><b>November 13, 2012</b>
374<blockquote><p>"Rule Six: The winning team shall be the first team that wins."
375- The Hitchhiker's Guide to the Galaxy.</p></blockquote>
376
377<p><a href=downloads/toybox-0.4.1.tar.bz2>Toybox 0.4.1</a> is based on
378<a href=http://landley.net/hg/toybox/shortlog/691>commit 691</a>.</p>
379
380<p>Elie De Brauwer contributed usleep, Ashwini Kumar contributed du, and
381Kyungwan Han contributed vconfig. Other new commands include switch_root and
382md5sum, and the remaining shell wrappers are now proper commands (dos2unix,
383unix2dos).</p>
384
385<p>The patch command now supports -l, and gethostname is now enabled by
386default. The df command follows symlinks to get the actual device name.
387Felix Janda added -m support to wc (for utf8).</p>
388
389<p>On the infrastructure side, the commands have now been grouped into
390"posix", "lsb", and "other" subdirectories (for things required by Posix-2008,
391the Linux Standard Base 4.1, and commands in neither). This affects menuconfig
392and the actual source layout (toys/cp.c is now toys/posix/cp.c, and so on).
393An android directory is planned (see the updated
394<a href=roadmap.html#android>android roadmap analysis</a>).</p>
395
396<p>The FLAG_ macros for command option parsing and TT alias for the command's
397global block are now automatically generated, commands should
398#define FOR_commandname before #including <toys.h> to get the macros for that
399command.</p>
400
401<p>An upgrade to the build infrastructure now allows commands with _ and -
402in them, such as switch_root.</p>
403
404<p>Bugfixes: Avery Pennarun spotted a case where ls showed uid twice instead of
405uid and gid, and that nice was using the wrong range of numbers.
406The ls command also recursed inappropriately last time (not quite
407properly converted for the dirtree changes last release), and now it's
408fixed. Roy Tam pointed out a glitch in sh, and fixed df's percentage
409calculation to match the POSIX spec. The kernel build didn't like our mktemp
410and it does now. The wc command wasn't quite posix compliant (trailing spaces
411break stuff). The ls command recursed inappropriately last time (not quite
412properly converted for the dirtree changes last release), and now it's
413fixed. The catv command wasn't displaying byte 255 correctly. Some lib
414fixes (thinko in xpidfile). Fixed uname -m when running a 32 bit x86 binary
415on an x86-64 host (it lies and says the system is i686, i586, or i486 depending
416on what the toolchain that built the binary supported. This makes builds in
417a 32 bit chroot on a 64 bit kernel break less.) The df command was checking
418partitions in the wrong order (displaying undermounts instead of overmounts:
419this used to work but some library code changed out from under it and it
420wasn't updated to match until now). Felix Janda filled out the test suite
421some more. The patch file creation logic got tweaked several times to
422successfully apply more patches. Support for older (pre 2.10) glibc
423versions was added to portability.h.</p>
424
425<p>Miscelaneous cleanups all around (mknod, sha1sum, logname), including a
426rewrite of taskset to be less dependent on libc getting the headers right. All
427the command headers should now point to the current relevant standards
428document, where applicable.</p>
429
430<p>This news page had old news entries from before the relaunch moved into
431a separate <a href=oldnews.html>oldnews</a> page.</p>
432
433<p>I forgot to create <a href=bin>static binaries</a> last time, but they're
434back now.</p>
435</span>
436
Rob Landley31103f92012-08-25 11:51:25 -0500437<hr><b>July 23, 2012</b>
438<blockquote><p>"Ford", Arthur said. "There's an infinite number of monkeys
439out here who want to talk to us about this script for Hamlet they've worked
440out." - The Hitchhiker's Guide to the Galaxy.</p></blockquote>
441
Rob Landley571b0702012-11-13 16:13:45 -0600442<p><a href=downloads/toybox-0.4.0.tar.bz2>Toybox 0.4.0</a> is based on
443<a href=http://landley.net/hg/toybox/shortlog/640>commit 640</a>.</p>
Rob Landley31103f92012-08-25 11:51:25 -0500444
445<p>The new <a href=status.html>status page</a> is calculated from
446the roadmap info, and should be easier to keep up to date in future.</p>
447
448<p>Andre Renaud contributed od and modinfo. Elie De Brauwer contributed
449taskset, bugfixes to cmp and tail, and tests for sort and tail. Kyungwan Han
450contributed passwd. Gaurang Shastri contributed w. Ashwini Sharma spotted a
451case where dirtree was adding extra slashes to a path.</p>
452
453<p>I rewrote od, cleaned up comm, documented the
454<a href=code.html#lib_llist>llist</a> and
455<a href=code.html#lib_dirtree>dirtree</a> infrastructure, added an -r option
456to date (and fixed a bug where -u wouldn't override /etc/localtime),
457fixed bugs in chmod +stw, fixed ls to show suid bits properly when the
458corresponding executable bit wasn't set, and worked around a longstanding
459glibc bug where static linking prevents stdout from automatically flushing
460pending output on exit.</p>
461
Rob Landleyb1cc1d12012-06-25 06:42:24 -0500462<hr><b>June 25, 2012</b>
463<blockquote><p>"For a moment, nothing happened. Then, after a second or so, nothing continued to happen." - The Hitchhiker's Guide to the Galaxy.</p></blockquote>
464
465<p><a href=downloads/toybox-0.3.1.tar.bz2>Toybox 0.3.1</a> is based on commit
466<a href=http://landley.net/hg/toybox/shortlog/607>commit 607</a>. It's
467mostly a bugfix release for ls -l (which was unhappy on targets other than
468x86-64), plus a new "date" from Andre Renaud and rewritten chgrp/chown which
469now support the full set of posix flags, plus a little work on the test
470suite and some more header tweaks towards eventual compatability with the
471musl libc.</p>
472
473<p>The todo list runneth over, but "release early, release often", so here
474it is. The roadmap and documentation are a bit behind, and I've got ~40
475pending submissions to review. I need to catch up...</p>
476</span>
477
478<hr><b>June 12, 2012</b>
479<blockquote><p>"For instance, on the planet Earth, man had always assumed that
480he was more intelligent than dolphins because he had achieved so much - the
481wheel, New York, wars and so on - whilst all the dolphins had ever done was
482muck about in the water having a good time. But conversely, the dolphins had
483always believed that they were far more intelligent than man - for precisely
484the same reasons." - The Hitchhiker's Guide to the Galaxy.</p></blockquote>
485
486<p>It's well past time for <a href=downloads/toybox-0.3.0.tar.bz2>toybox 0.3.0</a>,
487so here it is, based
488on <a href=http://landley.net/hg/toybox/shortlog/595>commit 595</a>, and the
489statically linked <a href=downloads/binaries>prebuilt binaries</a> should
490actually be statically linked this time (thanks Ashwini Sharma for spotting
491that).</p>
492
493<p>It's hard to figure out where to cut a release, because development
494doesn't stop. "Long before now" is the obviuos answer, of course.
495The project's maintainer also moved house during this development cycle, which
496threw things off for a bit (so many boxes). Releases should hopefully be a bit
497more frequent from here on.</p>
498
499<p>The big things Rob worked on this time were the new dirtree (directory
500tree traversal) infrastructure, and a complete rewrite of ls using that
501which should now implement all 26 posix options.</p>
502
503<p>Georgi Chorbadzhiyski added printenv, whoami, mkdir, mkfifo, chmod, chown,
504chgrp, and uniq. He also added fraction and extension support to sleep (so if
505you need a quarter-second sleep, it can do that now), and fixed a build bug
506on slackware.</p>
507
508<p>Daniel Walter contributed a string to mode_t parser (in use by chmod and
509mkdir -m). Ilya Kuzmich contributed comm. Elie De Brauwer added mountpoint,
510vmstat, logname, login, and mktemp. Kevin Chase did some portability cleanups.
511Pere Orga fixed some documentation.</p>
512
513<p>The "tac" and "clear" commands are now normal commands instead of shell
514wrappers, and the header #includes have been cleaned up a bit to remove
515deprecated functions and attempt to increase compatability with the bionic and
516musl C libraries, "tail" should now use lseek() for large files, and "id" got
517some cleanups and bugfixes.</p>
518
519<p>The new TOYBOX_FLOAT configuration option selects whether or not
520to include floating point support (for embedded targets where that's
521problematic).</p>
522
523<p>Several random bugfixes: unshare() might actually build portably now,
524yes 'n' | cp -i should no longer bypass stdin and prompt via the tty, the
525SUID support no longer drops permissions going through the toybox
526multiplexer command, and a bugfix to xargs -0 means it should no longer
527segfault. (I have a pending bug report about xargs not doing the full
528posix whitespace handling that -0 obsoleted, but I'll deal with that next
529release.)</p>
530
531<p>The build infrastructure is now automatically generating FLAG_ macros
532for the options, but currently with the wrong names. Some more macro glue
533is necessary, which I haven't quite figured out how to do yet.</p>
534
535<p>A defconfig toybox at the start of the $PATH has successfully built
536Linux From Scratch (in my Aboriginal Linux project). The commands that
537'default n' in the config are often still broken, cleanup is ongoing.
538(The new dirtree stuff broke several of them that haven't been converted
539yet, but if I wait until everything works we won't have a release before
5401.0, so here's a checkpoint.)</p>
541
542
Rob Landleyed6ed622012-03-06 20:49:03 -0600543<hr><b>March 3, 2012</b>
544
545<blockquote><p>"They went unnoticed at Goonhilly, passed over Cape Canaveral
546without a blip, and Woomera and Jodrell Bank looked straight through them.
547Which was a pity, because it was exactly the sort of thing they'd been looking
548for all these years."</p></p>- The Hitchhiker's Guide to the Galaxy.</p>
549</p></blockquote>
550
551<p>Here's <a href=downloads/toybox-0.2.1.tar.bz2>toybox 0.2.1</a> based
552on <a href=http://landley.net/hg/toybox/shortlog/512>commit 512</a>. This
553time around, there are statically linked <a href=downloads/binaries>prebuilt
554binaries</a> for various embedded targets.</p>
555
556<p>It's been a busy few weeks, almost entirely due to new contributors. (I
557have not quite been keeping up.)</p>
558
559<p>Elie De Brauwer contributed free, uptime, swapon, swapoff, lsmod, mknod,
560insmod, rmmod, and fixed a bug in basename. Andre Renaud contributed ls, ln,
561realpath, and hostname. Andres Heck contributed pidof and killall. Daniel
562Walter wrote kill and extended id. Timothy Elliott contributed tail and tests
563for cmp. Frank Bergmann sent a warning fix. Bryce Fricke added -i to cp.
564Nathan McSween pointed out an optimization. Georgi Chorbadzhiyski fixed
565cross compiling to work more reliably.</p>
566
567<p>(My own contribution this time around was just tightening up other people's
568code, a build fix to unshare, some random bugfixes, and so on. My only new
569code this time around was writing a bash replacement for the existing python
570bloat-o-meter.)</p>
571
572<p>Last time (the 0.2.0 release) included the first pass at an id command from
573Tim Bird, env and basename from Tryn Mirell, cmp and head from Timothy Elliott,
574more bugfixes from Nathan McSween and Elie De Brauwer, and Luis Felipe Strano
575Moraes did a first pass at the who command plus other bugfixes and
576optimizations.</p>
577
578<p>(For that release I did xargs, cal, truncate, unlink, nohup, tty, wc, link,
579dirname, unshare, and various infrastructure tweaks, but it took me 3 months
580and those guys did their stuff in a week or so.)</p>
581
Rob Landleye258af32008-01-05 18:09:49 -0600582
Rob Landleyd11ac702012-02-13 21:16:03 -0600583<hr><b>February 12, 2012</b>
584<blockquote><p>
585"for though it has many omissions and contains much that is apocryphal, or at
586least wildly inaccurate, it scores over the older, more pedestrian work in two
587important respects..."</p>
588<p> - The Hitchhiker's Guide to the Galaxy</p></blockquote>
589
590<p>Here's the first BSD licensed release,
591<a href=downloads/toybox-0.2.0.tar.bz2>toybox-0.2.0</a>, more a synchronization
592point than anything particularly useful. 47 commands in a reasonably
593ready-to-use state (what "make defconfig" builds), another ten or so partially
594finished stubs ("make allyesconfig"), and several
595patches pending on the mailing list I need to review and merge.</p>
596
597<p>More to come...</p>
598
Rob Landleyce8a2672012-02-02 07:27:05 -0600599<hr>
600<p><b>November 15, 2011</b> - Back from the dead, Toybox is now under a 2
601clause BSD license, and aiming to become the default command line
602implementation of Android systems everywhere.</p>
603
604<p>More to come...</p>
605
606<hr>
Rob Landley589f5cd2010-01-05 10:41:52 -0600607
Rob Landleyaba51702012-08-26 16:33:06 -0500608<p><a href=oldnews.html>Old news</a> from before the relaunch.</p>
Rob Landley589f5cd2010-01-05 10:41:52 -0600609
610<!--#include file="footer.html" -->