vws script is main workhorse of the first stage of project.

It allows to send commands to the vm

Starting and stopping

vws start [--no-gui] [--cdrom isofile] vmname

Starts machine. By default, immediately after machine starts, launches [vmgui] to connect it. If no DISPLAY environment variable is set or if --no-gui is specified, doesn't launch GUI. If --cdrom is specified, connects specified ISO to machine CDROM and boots it from it

If machine is running in the background, just launches vmgui, unless not asked to. If machine is running and gui is not needed, just exits immedieately with zero exit code.

If machine is not running and saved state exists, load saved state.

Semantic: "make this machine running*

vws stop vmname

Sends system_shutdown command to machine.

vmws save vmname

Saves machine state and terminates emulation.

vws reset vmname

Sends system_reset command to machine

Removable devices management

vws cdrom machine [id] [iso-file|--eject]

Connects given iso file (CDROM special device) to the machine or disconnects one. If there is more than one cdrom drive in the virtual machine, id should be specified.

vws usb insert machine [pattern|--address=bus:device]

Connects USB device which matches pattern or have specifed address

vws usb list 

List host devices available to connect to the machine

vws usb machine remove [pattern|id]

Removes device which matches pattern. Pattern is reqular expression which is matches against lsusb output, so vendorid:productid is perfectly valid pattern.

If there is more than one device which matches pattern, complains vws usb complans and exits with non-zero code.

Snapshots

vws snapshot machine

Creates a snapshot of machine.

vws revert machine

Reverts machine to previous snapshot, deleting current

vws commit machine

Commits snapshot into its backing file.

vws snapshots machine

List existing snapshots.

Screenshots and recording

vms screenshot machine filename.png

Makes a screenshot

vms record machine filename.wav

Start recording of machine sound output

vms stoprecord machine

Stop recording