Skip to content

Custom command line arguments

vintagepc edited this page May 31, 2021 · 5 revisions

There are a few special command line arguments that can be passed through to the simulator.

Unfortunately, there isn't a clean way to add them to the raw qemu command line options, so instead, Mini404 (ab)uses the -append command line option normally used to supply kernel arguments for this purpose.

The syntax is a comma separated list of key-value pairs or keywords, in the same style as how other qemu devices take arguments.

For example,

./qemu-system-buddy -machine prusabuddy -kernel mini_debug_noboot.bin -append arg1,arg=value2,arg3=value3,...

Currently, the only supported arguments are:

  • scripthelp - Prints script syntax options to the terminal and quits.
  • script=[file] - Executes [file] as a script in the scripting engine.
  • appendix - sets a simulated appendix as present on the simulator (Only works if using bootloader/.bbf)

Visualization options (see Advanced Visuals for details)

  • gfx-2d - Enable lite 2D status dashboard (requires CONFIG_OPENGL)
  • gfx-lite - Enable lite 3D visuals and status dashboard (requires CONFIG_OPENGL)
  • gfx-full - Enable full 3D visuals and status dashboard (requires CONFIG_OPENGL)
  • colour-extrusion - Colour simulated extrusions by line width.
  • extrusion=[value] - Specify rendering mode of simulated extrusions.

Unrecognized options are ignored as opposed to generating an error.

Clone this wiki locally