mirror of
https://github.com/cirosantilli/linux-kernel-module-cheat.git
synced 2026-01-13 20:12:26 +00:00
9076c1d9bc
Get rid of br2_parsec, since there are just too many possible variations on that file. Blow up the gem5 vs qemu table to make it saner, add missing aarch64 entries. Make sections titles describing number of cores and memory size emulator agnostic.
48 lines
2.5 KiB
Plaintext
48 lines
2.5 KiB
Plaintext
= 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_lala=y'`
|
|
Mnenomic: comes after `-e`.
|
|
|`-G` | |Pass extra options to the gem5 executable.
|
|
Do not confuse with the arguments passed to config scripts,
|
|
like `fs.py`. Example: `./run -G '--debug-flags=Exec --debug' -g`
|
|
|`-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`.
|
|
The default is the minimum ammount that boots all archs without extra
|
|
options added. Anything lower will lead some arch to fail to boot.
|
|
Any
|
|
|`-T` | |Enable extra QEMU trace events.
|
|
`./configure --enable-trace-backends=simple` seems to enable
|
|
some by default, e.g. `pr_manager_run`, and I don't know how to
|
|
get rid of them. But those events are rare and should not impact
|
|
performance, so we just ignore them for now.
|
|
|`-x` | |Run in graphic mode. Mnemonic: X11.
|
|
|===
|