diff options
author | Robert P. J. Day <rpjday@crashcourse.ca> | 2014-06-28 10:13:55 -0400 |
---|---|---|
committer | Sascha Hauer <s.hauer@pengutronix.de> | 2014-07-02 07:50:49 +0200 |
commit | d12f62829e471912a9be3a58de187b574db780ec (patch) | |
tree | 5320a84193eb5d9a8194028334bfd8223f0e2b95 /Documentation | |
parent | 0bee49e72c18e94d2ea895e8fcc94bc95acaf4dc (diff) | |
download | barebox-d12f62829e471912a9be3a58de187b574db780ec.tar.gz barebox-d12f62829e471912a9be3a58de187b574db780ec.tar.xz |
Documentation: Clean up sandbox.rst, use definition list.
Some minor cleanup to the sandbox.rst documentation file, mostly
involving using a definition list for the options.
Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>
Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
Diffstat (limited to 'Documentation')
-rw-r--r-- | Documentation/boards/sandbox.rst | 66 |
1 files changed, 27 insertions, 39 deletions
diff --git a/Documentation/boards/sandbox.rst b/Documentation/boards/sandbox.rst index 4601aedbc0..558f111697 100644 --- a/Documentation/boards/sandbox.rst +++ b/Documentation/boards/sandbox.rst @@ -4,64 +4,52 @@ Sandbox barebox can be run as a simulator on your host to check and debug new non hardware related features. -Build barebox for simulation ----------------------------- +Building barebox for simulation +------------------------------- -the barebox sand box can be built with the host compiler:: +The barebox sandbox can be built with the host compiler:: ARCH=sandbox make sandbox_defconfig ARCH=sandbox make -Run sandbox ------------ +Running the sandbox +------------------- -:: +Once you compile barebox for the sandbox, you can run it with:: - $ barebox [\<OPTIONS\>] + $ barebox [<OPTIONS>] -Options can be:: +Available sandbox invocation options include: - -m, --malloc=\<size\> + ``-m``, ``--malloc=<size>`` -Start sandbox with a specified malloc-space \<size\> in bytes. + Start sandbox with a specified malloc-space <size> in bytes. -:: + ``-i <file>`` - -i \<file\> + Map a <file> to barebox. This option can be given multiple times. The <file>s + will show up as ``/dev/fd0`` ... ``/dev/fdX`` in the barebox simulator. -Map a \<file\> to barebox. This option can be given multiple times. The \<file\>s -will show up as /dev/fd0 ... /dev/fdx in the barebox simulator. + ``-e <file>`` -:: + Map <file> to barebox. With this option <file>s are mapped as + ``/dev/env0`` ... ``/dev/envX`` and thus are used as default environment. + A clean file generated with ``dd`` will do to get started with an empty environment. - -e \<file\> + ``-O <file>`` -Map \<file\> to barebox. With this option \<file\>s are mapped as /dev/env0 ... -/dev/envx and thus are used as default environment. A clean file generated -with dd will do to get started with an empty environment + Register <file> as a console capable of doing stdout. <file> can be a + regular file or a FIFO. -:: + ``-I <file>`` - -O \<file\> + Register <file> as a console capable of doing stdin. <file> can be a regular + file or a FIFO. -Register \<file\> as a console capable of doing stdout. \<file\> can be a -regular file or a fifo. + ``-x``, ``--xres <res>`` -:: + Specify SDL width. - -I \<file\> + ``-y``, ``--yres <res>`` -Register \<file\> as a console capable of doing stdin. \<file\> can be a regular -file or a fifo. - -:: - - -x, --xres \<res\> - -Specify SDL width - -:: - - -y, --yres \<res\> - -Specify SDL height + Specify SDL height. |