Archipelago » qemu

STEXI

@item help or ? [@var{cmd}]

Show the help for all commands or just for command @var{cmd}.

ETEXI

STEXI

@item commit

Commit changes to the disk images (if -snapshot is used) or backing files.

ETEXI

STEXI

@item info @var{subcommand}

Show various information about the system state.

@table @option

STEXI

@item q or quit

Quit the emulator.

ETEXI

STEXI

@item eject [-f] @var{device}

Eject a removable medium (use -f to force it).

ETEXI

STEXI

@item change @var{device} @var{setting}

Change the configuration of a device.

STEXI

@item screendump @var{filename}

Save screen into PPM image @var{filename}.

ETEXI

STEXI

@item logfile @var{filename}

Output logs to @var{filename}.

ETEXI

STEXI

@item log @var{item1}[,...]

Activate logging of the specified items to @file{/tmp/qemu.log}.

ETEXI

STEXI

@item savevm [@var{tag}|@var{id}]

Create a snapshot of the whole virtual machine. If @var{tag} is

provided, it is used as human readable identifier. If there is already

a snapshot with the same tag or ID, it is replaced. More info at

STEXI

@item loadvm @var{tag}|@var{id}

Set the whole virtual machine to the snapshot identified by the tag

@var{tag} or the unique snapshot ID @var{id}.

ETEXI

STEXI

@item delvm @var{tag}|@var{id}

Delete the snapshot identified by @var{tag} or @var{id}.

ETEXI

STEXI

@item singlestep [off]

Run the emulation in single step mode.

If called with option off, the emulation returns to normal mode.

ETEXI

STEXI

@item stop

Stop emulation.

ETEXI

STEXI

@item c or cont

Resume emulation.

ETEXI

STEXI

@item gdbserver [@var{port}]

Start gdbserver session (default @var{port}=1234)

ETEXI

STEXI

@item x/fmt @var{addr}

Virtual memory dump starting at @var{addr}.

ETEXI

STEXI

@item xp /@var{fmt} @var{addr}

Physical memory dump starting at @var{addr}.

@var{fmt} is a format which tells the command how to format the

@table @var

@item count

is the number of items to be dumped.

@item format

can be x (hex), d (signed decimal), u (unsigned decimal), o (octal),

c (char) or i (asm instruction).

@item size

can be b (8 bits), h (16 bits), w (32 bits) or g (64 bits). On x86,

@code{h} or @code{w} can be specified with the @code{i} format to

respectively select 16 or 32 bit code instruction size.

STEXI

@item p or print/@var{fmt} @var{expr}

Print expression value. Only the @var{format} part of @var{fmt} is

used.

STEXI

@item sendkey @var{keys}

Send @var{keys} to the emulator. @var{keys} could be the name of the

key or @code{#} followed by the raw value in either decimal or hexadecimal

STEXI

@item system_reset

Reset the system.

ETEXI

STEXI

@item system_powerdown

Power down the system (if supported).

ETEXI

STEXI

@item sum @var{addr} @var{size}

Compute the checksum of a memory region.

ETEXI

STEXI

@item usb_add @var{devname}

Add the USB device @var{devname}.  For details of available devices see

@ref{usb_devices}

STEXI

@item usb_del @var{devname}

Remove the USB device @var{devname} from the QEMU virtual USB

hub. @var{devname} has the syntax @code{bus.addr}. Use the monitor

STEXI

@item device_add @var{config}

Add device.

ETEXI

STEXI

@item device_del @var{id}

Remove device @var{id}.

ETEXI

STEXI

@item mouse_move @var{dx} @var{dy} [@var{dz}]

Move the active mouse to the specified coordinates @var{dx} @var{dy}

with optional scroll axis @var{dz}.

ETEXI

STEXI

@item mouse_button @var{val}

Change the active mouse button state @var{val} (1=L, 2=M, 4=R).

ETEXI

STEXI

@item mouse_set @var{index}

Set which mouse device receives events at given @var{index}, index

can be obtained with

@example

#endif

STEXI

@item wavcapture @var{filename} [@var{frequency} [@var{bits} [@var{channels}]]]

Capture audio into @var{filename}. Using sample rate @var{frequency}

bits per sample @var{bits} and number of channels @var{channels}.

#endif

STEXI

@item stopcapture @var{index}

Stop capture with a given @var{index}, index can be obtained with

@example

info capture

STEXI

@item memsave @var{addr} @var{size} @var{file}

save to disk virtual memory dump starting at @var{addr} of size @var{size}.

ETEXI

STEXI

@item pmemsave @var{addr} @var{size} @var{file}

save to disk physical memory dump starting at @var{addr} of size @var{size}.

ETEXI

STEXI

@item boot_set @var{bootdevicelist}

Define new values for the boot device list. Those values will override

the values specified on the command line through the @code{-boot} option.

#endif

STEXI

@item nmi @var{cpu}

Inject an NMI on the given CPU (x86 only).

ETEXI

STEXI

@item migrate [-d] [-b] [-i] @var{uri}

Migrate to @var{uri} (using -d to not wait for completion).

	-b for migration with full copy of disk

	-i for migration with incremental copy of disk (base image is shared)

STEXI

@item migrate_cancel

Cancel the current VM migration.

ETEXI

STEXI

@item migrate_set_speed @var{value}

Set maximum speed to @var{value} (in bytes) for migrations.

ETEXI

STEXI

@item migrate_set_downtime @var{second}

Set maximum tolerated downtime (in seconds) for migration.

ETEXI

STEXI

@item drive_add

Add drive to PCI storage controller.

ETEXI

STEXI

@item pci_add

Hot-add PCI device.

ETEXI

STEXI

@item pci_del

Hot remove PCI device.

ETEXI

STEXI

@item host_net_add

Add host VLAN client.

ETEXI

STEXI

@item host_net_remove

Remove host VLAN client.

ETEXI

#endif

STEXI

@item host_net_redir

Redirect TCP or UDP connections from host to guest (requires -net user).

ETEXI

STEXI

@item balloon @var{value}

Request VM to change its memory allocation to @var{value} (in MB).

ETEXI

STEXI

@item set_link @var{name} [up|down]

Set link @var{name} up or down.

ETEXI

STEXI

@item watchdog_action

Change watchdog action.

ETEXI

STEXI

@item acl_show @var{aclname}

List all the matching rules in the access control list, and the default

policy. There are currently two named access control lists,

@var{vnc.x509dname} and @var{vnc.username} matching on the x509 client

STEXI

@item acl_policy @var{aclname} @code{allow|deny}

Set the default access control list policy, used in the event that

none of the explicit rules match. The default policy at startup is

always @code{deny}.

STEXI

@item acl_allow @var{aclname} @var{match} @code{allow|deny} [@var{index}]

Add a match rule to the access control list, allowing or denying access.

The match will normally be an exact username or x509 distinguished name,

but can optionally include wildcard globs. eg @code{*@@EXAMPLE.COM} to

STEXI

@item acl_remove @var{aclname} @var{match}

Remove the specified match rule from the access control list.

ETEXI

    },

STEXI

Remove all matches from the access control list, and set the default

policy back to @code{deny}.

ETEXI

#endif

STEXI

@item mce @var{cpu} @var{bank} @var{status} @var{mcgstatus} @var{addr} @var{misc}

Inject an MCE on the given CPU (x86 only).

ETEXI

STEXI

@item getfd @var{fdname}

If a file descriptor is passed alongside this command using the SCM_RIGHTS

mechanism on unix sockets, it is stored using the name @var{fdname} for

later use by other monitor commands.

STEXI

@item closefd @var{fdname}

Close the file descriptor previously assigned to @var{fdname} using the

@code{getfd} command. This is only needed if the file descriptor was never

used by another monitor command.

STEXI

@item block_passwd @var{device} @var{password}

Set the encrypted device @var{device} password to @var{password}

ETEXI