= run usage

....
./run [OPTIONS] [-- EXTRA_RUN_ARGS]
....

[options="header"]
|===
|Name |Argument name        | Description
|`-a` |`ARCH`               | Run architecture `ARCH`.
|`-c` |`NCPUS`              | Emulate `NCPUS` guest CPUs.
|`-D` |                     | Run GDB on the emulator itself.
|`-d` |                     | Run in debug mode, expect a GDB connection to guest.
|`-E` |`CMDSTR`             | Replace the normal init with a minimal init that just evals
                              with given `CMDSTR` bash command string. Example:
                              `-E 'insmod /hello.ko;'`
|`-e` |`CLI_OPTIONS`        | Pass an extra Linux kernel command line options,
                              and place them before the dash separator `-`.
                              Only options that come before the `-`, i.e. "standard"
                              options, should be passed with this option.
                              Example: `./run -a arm -e 'init=/poweroff.out'`
|`-f` |`CLI_OPTIONS`        | Pass an extra Linux kernel command line options,
                              add a dash `-` separator, and place the options after the dash.
                              Intended for custom options understood by our `init` scripts,
                              most of which are prefixed by `lkmc_`, e.g.:
                              `./run -f 'lkmc_eval="wget google.com" lkmc_nonet=y'`
                              Mnenomic: comes after `-e`.
|`-G` |                     | Pass extra options to the gem5 executable.
                              Only useful if `-g` is given.
                              Do not confuse with the arguments passed to the config scripts,
                              e.g. `fs.py`
|`-g` |                     | Use gem5 instead of QEMU.
|`-h` |                     | Show this help message.
|`-I` |                     | Run with initramfs.
|`-i` |                     | Run with initrd.
|`-K` |                     | Use KVM. Only works if guest arch == host arch.
|`-k` |                     | Enable KGDB.
|`-m` |                     | Set the memory size of the guest. E.g.: `-m 512M`. Default: `256M`.
|`-x` |                     | Run in graphic mode. Mnemonic: X11.
|===