aboutsummaryrefslogtreecommitdiff
path: root/www/index.html
blob: a201bd8e9a7358e003f9895c980a6420bd725c78 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
<!--#include file="header.html" -->

<p><b>June 18, 2007</b> - Put out
<a href=downloads/toybox-0.0.3.tar.bz2>toybox-0.0.3.tar.bz2</a> since it's
been too long since I did something like that.  This one implements
catv, count, df, echo, false, oneit, pwd, sleep, sync, toysh, true, which,
and yes (which is what "make defconfig" enables).  There are several other
commands not enabled by defconfig, because they don't really work yet.</p>

<p>Most of the general infrastructure's there now, although lots of tweaking
and optimizing is still needed.  The test suite is skeletal and not entirely
checked in yet, but I'm working on that.</p>

<p>I don't have nearly as much time to work on this as I'd like, but I'm making
a little progress.</p>

<p>Jan 31: Screwing up the web page a bit, adding an index bar along the side
which doesn't properly connect up to anything yet.  (Busy implementing
mke2fs and gene2fs.)</p>

<p>Warning: lots of this page is about what I plan to do, not what I've
already done.  See <a href="#status>status</a> or <a href="/notes.html>my
development blog</a>, or <a href="/hg/toybox">browse the mercurial
archive</a>.</p>

<h2><a name="what" />What is ToyBox?</h2>

<p>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 <a href="design.html">more about the design goals</a></p>

<p>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
<a href=/code/firmware>Firmware Linux</a> project is trying to get a complete
Linux system to rebuild itself from source code using toybox.</p>

<p>Toybox is <a href=license.html>Licensed under GPL version 2</a>.</p>

<p>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.</p>

<h2><a name="commands" />Which commands are planned?</h2>

<b><h3>Relevant Standards</h3></b>

<p>Most commands are implemented according to
<a href=http://www.opengroup.org/onlinepubs/009695399/idx/utilities.html>The
Single Unix Specification version 3</a>.  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.  And
some things (like $CDPATH support in "cd") await a good explanation of why
to bother with them.</p>

<p>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).</p>

<b><h3>Command Shell</h3></b>
<p>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,
<a href="http://www.opengroup.org/onlinepubs/009695399/utilities/alias.html">alias</a>,
export, set, unset, read, trap, and exec.</p>

<b><h3>General Purpose Commands:</h3></b>

<p>[TODO]</p>

<b><h3>Development tools:</h3></b>

<p>Commands: ar, make [TODO]</p>

<b><h2><a name="status />What commands are implemented?</h2></b>

<p>Toybox is a work in progress, and nowhere near a 1.0 release.  The first
commit was September 27, 2006, and work is ongoing.</p>

<p>Partial (in progress): sh/toysh (cd, exit), df, which.</p>

<p>Complete: hello, pwd.</p>

<p>Infrastructure:</p>

<ul>
<li>main: toy_list[], toy_find(), toy_exec(), main/toybox_main().</li>
<ul>lib: llist, getmountlist(), error_msg/error_exit, xmalloc(),
strlcpy(), xexec(), xopen()/xread(), xgetcwd(), xabspath(), find_in_path(),
itoa().</li>

<b><h2><a name="downloads" />Download</h2></b>

<p>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 <a href=/hg/toybox>mercurial archive browser</a> page to get
an archive of the appropriate version.  Click
<a href="/hg/toybox?cmd=tags">tags</a> to the tagged release versions ("tip"
is the current development version).</p>


<p>My <a href=/notes.html>development log</a> is currently the best way to
track what's going on with this project.  There's also a
<a href=http://www2.them.com:8080/cgi-bin/mailman/listinfo/toybox>mailing list</a> for toybox development.</p>

<!--#include file="footer.html" -->