diff options
| author | Kartik K. Agaram <vc@akkartik.com> | 2021-06-27 08:05:11 -0700 |
|---|---|---|
| committer | Kartik K. Agaram <vc@akkartik.com> | 2021-06-27 08:05:18 -0700 |
| commit | efecaa99d5b6223ea89af21597666bdb309d1234 (patch) | |
| tree | 2f21154e3e2b2245bd3a80c287ee7155a5a6035f | |
| parent | c7e1fed2b921fb09fa55cf82ccec8535e0bd4caf (diff) | |
| download | mu-efecaa99d5b6223ea89af21597666bdb309d1234.tar.gz | |
simplify Qemu instructions
Turns out we don't need a special case for KVM. https://qemu.readthedocs.io/en/latest/system/invocation.html
| -rw-r--r-- | shell/README.md | 22 |
1 files changed, 10 insertions, 12 deletions
diff --git a/shell/README.md b/shell/README.md index 7720fdaf..d48c5d85 100644 --- a/shell/README.md +++ b/shell/README.md @@ -41,25 +41,23 @@ Currently runs a tiny dialect of Lisp. Steps to run it from the top-level: results. Hit `ctrl-m` to focus on the `...` after a run, and browse how the _trace_ of how the results were computed. [Here's a 2-minute demo](https://archive.org/details/akkartik-mu-2021-05-31). -3. If your Qemu installation supports them, one of these commandline arguments - may speed up emulation: +3. If your Qemu installation supports them, an `-accel` arguments + will speed up emulation. Try `-accel help` to list your options. - - `-enable-kvm` - - `-accel ___` (run with `-accel help` for a list of available options) + Once you select an accelerator, I recommend also adjusting the `responsiveness` + mask in shell/evaluate.mu, which controls how frequently the fake screen + updates within the REPL. Smaller values will seem more responsive, larger + values will leave more time to run your programs. I like to see the screen + update about once a second. Some suggested values depending on how fast your + Qemu is running: - If you do this, I recommend also adjusting the `responsiveness` mask in - shell/evaluate.mu, which controls how frequently the fake screen updates. - Smaller values will seem more responsive, larger values will leave more time - to run your programs. I like to see the screen update about once a second. - Some suggested values depending on how fast your Qemu is running: - - - `-enable-kvm` on a T420s running Linux: `0xffff/responsiveness=64k` + - `-accel kvm` on a T420s running Linux: `0xffff/responsiveness=64k` - `-accel tcg` on a 2019 Mac: `0xfff/responsiveness=4k` Putting it all together, here's the command I typically use on Linux: ``` - qemu-system-i386 -m 2G -enable-kvm -hda code.img -hdb data.img + qemu-system-i386 -m 2G -accel kvm -hda code.img -hdb data.img ``` ### Indent-sensitivity |