Warning: lots of this page is about what I plan to do, not what I've already done. See my development blog, or browse the mercurial archive.

What is ToyBox?

The Toybox project is creating simple implementations of all the Linux command line utilities. Other goals are small size (the produced binaries should total less than a megabyte, uncompressed), speed of execution, and correctness of implementation (which is related to standards compliance, but isn't quite the same thing). Click for more about the design goals

Toybox has configurable levels of functionality, and should scale from tiny embedded systems up to full general purpose desktop and development environments. The author plans to run it on his laptop, and the Firmware Linux project is trying to get a complete Linux system to rebuild itself from source code using toybox.

Toybox is Licensed under GPL version 2.

Toybox can be built as a single "swiss army knife" executable (ala BusyBox or Red Hat's Nash), or each command can be built as a traditional independent executable.

Which commands are planned?

Relevant Standards

Most commands are implemented according to The Single Unix Specification version 3. This does not mean that Toybox is implementing every SUSv3 utility: some such as SCCS and ed are obsolete, while others such as c99 are outside the scope of the project. Toybox also isn't implementing full internationalization support: it should be 8-bit clean and handle UTF-8, but otherwise we leave this to X11 and higher layers.

The other major sources of commands are the Linux man pages, and testing the behavior of existing commands (although not generally looking at their source code).

Command Shell

The Toybox Shell aims to be a reasonable bash replacement. It implements the "sh" and "toysh" commands, plus the built-in commands "cd" and "exit". The following additional commands may be built into the shell (but not as separate executables): cd, exit, if, while, for, function, fg, bg, jobs, source, alias, export, set, unset, read, trap, and exec.

General Purpose Commands:

[TODO]

Development tools:

Commands: ar, make [TODO]

Download

This project is maintained as a mercurial archive. To get a copy of the current development version, either use mercurial (hg clone http://landley.net/toybox) or click on one of the zip/gz/bz2 links at the top of the mercurial archive browser page to get an archive of the appropriate version. Click tags to the tagged release versions ("tip" is the current development version).

My development log is currently the best way to track what's going on with this project. When I get this moved to my new server, I need to put up a mailing list and add toybox.landley.net as a virtual domain.