4.25. Sandbox

barebox can be run as a simulator on your host to check and debug new non hardware related features.

4.25.1. Building barebox for simulation

The barebox sandbox can be built with the host compiler:

ARCH=sandbox make sandbox_defconfig
ARCH=sandbox make

4.25.2. Running the sandbox

Once you compile barebox for the sandbox, you can run it with:

.. code-block:: console

$ barebox [<OPTIONS>]

Available sandbox invocation options include:

-m, --malloc=<size>

Start sandbox with a specified malloc-space <size> in bytes.

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

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

-O <file>

Register <file> as a console capable of doing stdout. <file> can be a regular file or a FIFO.

-I <file>

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.

To terminate barebox and return to the calling shell, the poweroff command is suitable.