Introduction

Emulot is a tool suite including a command line interface as well for managing emulator instances and configurations, specifically focused on QEMU. The idea is to be able to easy store, share, and run instances without needing to remember all the details. The configurations are currently accepted as TOML represenations of the QEMU command line options.

Tips for emulation

Serial port geometry

If you use emulot run to connect to the virtual machine via the serial port, it will likely cause the default geometry of the shell to be 80x24. This may not be obvious until you run an application that uses these values like vim or other text editors which rely on curses. To fix this on Linux, you can run stty rows <rows> cols <cols> to set a new expected geometry.

Command Line Interface

The emulot command is the main entrypoint in from the program. After you've installed emulot, the following options are available:

  • emulot import <name> <config> - Imports a config to the database
  • emulot run <name> - Runs a configuration
  • emulot dump <name> - Dumps a configuration to a config file
  • emulot list - Lists a configuration
  • emulot remove <name> - Remove a configuration