2
@item help or ? [@var{cmd}]
4
Show the help for all commands or just for command @var{cmd}.
7
Commit changes to the disk images (if -snapshot is used) or backing files.
13
Resize a block image while a guest is running. Usually requires guest
14
action to see the updated size. Resize to a lower size is supported,
15
but should be used with extreme caution. Note that this command only
16
resizes image files, it can not resize block devices like LVM volumes.
17
@item eject [-f] @var{device}
19
Eject a removable medium (use -f to force it).
20
@item drive_del @var{device}
22
Remove host block device. The result is that guest generated IO is no longer
23
submitted against the host device underlying the disk. Once a drive has
24
been deleted, the QEMU Block layer returns -EIO which results in IO
25
errors in the guest for applications that are reading/writing to the device.
26
@item change @var{device} @var{setting}
29
Change the configuration of a device.
32
@item change @var{diskdevice} @var{filename} [@var{format}]
33
Change the medium for a removable disk device to point to @var{filename}. eg
36
(qemu) change ide1-cd0 /path/to/some.iso
39
@var{format} is optional.
41
@item change vnc @var{display},@var{options}
42
Change the configuration of the VNC server. The valid syntax for @var{display}
43
and @var{options} are described at @ref{sec_invocation}. eg
46
(qemu) change vnc localhost:1
49
@item change vnc password [@var{password}]
51
Change the password associated with the VNC server. If the new password is not
52
supplied, the monitor will prompt for it to be entered. VNC passwords are only
53
significant up to 8 letters. eg
56
(qemu) change vnc password
61
@item screendump @var{filename}
63
Save screen into PPM image @var{filename}.
64
@item logfile @var{filename}
66
Output logs to @var{filename}.
69
changes status of a trace event
70
@item trace-file on|off|flush
72
Open, close, or flush the trace file. If no argument is given, the status of the trace file is displayed.
73
@item log @var{item1}[,...]
75
Activate logging of the specified items to @file{/tmp/qemu.log}.
76
@item savevm [@var{tag}|@var{id}]
78
Create a snapshot of the whole virtual machine. If @var{tag} is
79
provided, it is used as human readable identifier. If there is already
80
a snapshot with the same tag or ID, it is replaced. More info at
82
@item loadvm @var{tag}|@var{id}
84
Set the whole virtual machine to the snapshot identified by the tag
85
@var{tag} or the unique snapshot ID @var{id}.
86
@item delvm @var{tag}|@var{id}
88
Delete the snapshot identified by @var{tag} or @var{id}.
89
@item singlestep [off]
91
Run the emulation in single step mode.
92
If called with option off, the emulation returns to normal mode.
99
@item gdbserver [@var{port}]
101
Start gdbserver session (default @var{port}=1234)
102
@item x/fmt @var{addr}
104
Virtual memory dump starting at @var{addr}.
105
@item xp /@var{fmt} @var{addr}
107
Physical memory dump starting at @var{addr}.
109
@var{fmt} is a format which tells the command how to format the
110
data. Its syntax is: @option{/@{count@}@{format@}@{size@}}
114
is the number of items to be dumped.
117
can be x (hex), d (signed decimal), u (unsigned decimal), o (octal),
118
c (char) or i (asm instruction).
121
can be b (8 bits), h (16 bits), w (32 bits) or g (64 bits). On x86,
122
@code{h} or @code{w} can be specified with the @code{i} format to
123
respectively select 16 or 32 bit code instruction size.
130
Dump 10 instructions at the current instruction pointer:
135
0x90107065: lea 0x0(%esi,1),%esi
136
0x90107069: lea 0x0(%edi,1),%edi
138
0x90107071: jmp 0x90107080
146
Dump 80 16 bit values at the start of the video memory.
148
(qemu) xp/80hx 0xb8000
149
0x000b8000: 0x0b50 0x0b6c 0x0b65 0x0b78 0x0b38 0x0b36 0x0b2f 0x0b42
150
0x000b8010: 0x0b6f 0x0b63 0x0b68 0x0b73 0x0b20 0x0b56 0x0b47 0x0b41
151
0x000b8020: 0x0b42 0x0b69 0x0b6f 0x0b73 0x0b20 0x0b63 0x0b75 0x0b72
152
0x000b8030: 0x0b72 0x0b65 0x0b6e 0x0b74 0x0b2d 0x0b63 0x0b76 0x0b73
153
0x000b8040: 0x0b20 0x0b30 0x0b35 0x0b20 0x0b4e 0x0b6f 0x0b76 0x0b20
154
0x000b8050: 0x0b32 0x0b30 0x0b30 0x0b33 0x0720 0x0720 0x0720 0x0720
155
0x000b8060: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
156
0x000b8070: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
157
0x000b8080: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
158
0x000b8090: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
161
@item p or print/@var{fmt} @var{expr}
164
Print expression value. Only the @var{format} part of @var{fmt} is
168
@item sendkey @var{keys}
171
Send @var{keys} to the emulator. @var{keys} could be the name of the
172
key or @code{#} followed by the raw value in either decimal or hexadecimal
173
format. Use @code{-} to press several keys simultaneously. Example:
178
This command is useful to send keys that your graphical user interface
179
intercepts at low level, such as @code{ctrl-alt-f1} in X Window.
184
@item system_powerdown
185
@findex system_powerdown
187
Power down the system (if supported).
188
@item sum @var{addr} @var{size}
191
Compute the checksum of a memory region.
192
@item usb_add @var{devname}
195
Add the USB device @var{devname}. For details of available devices see
197
@item usb_del @var{devname}
200
Remove the USB device @var{devname} from the QEMU virtual USB
201
hub. @var{devname} has the syntax @code{bus.addr}. Use the monitor
202
command @code{info usb} to see the devices you can remove.
203
@item device_add @var{config}
207
@item device_del @var{id}
210
Remove device @var{id}.
211
@item cpu @var{index}
214
@item mouse_move @var{dx} @var{dy} [@var{dz}]
216
Move the active mouse to the specified coordinates @var{dx} @var{dy}
217
with optional scroll axis @var{dz}.
218
@item mouse_button @var{val}
220
Change the active mouse button state @var{val} (1=L, 2=M, 4=R).
221
@item mouse_set @var{index}
223
Set which mouse device receives events at given @var{index}, index
228
@item wavcapture @var{filename} [@var{frequency} [@var{bits} [@var{channels}]]]
230
Capture audio into @var{filename}. Using sample rate @var{frequency}
231
bits per sample @var{bits} and number of channels @var{channels}.
235
@item Sample rate = 44100 Hz - CD quality
237
@item Number of channels = 2 - Stereo
239
@item stopcapture @var{index}
241
Stop capture with a given @var{index}, index can be obtained with
245
@item memsave @var{addr} @var{size} @var{file}
247
save to disk virtual memory dump starting at @var{addr} of size @var{size}.
248
@item pmemsave @var{addr} @var{size} @var{file}
250
save to disk physical memory dump starting at @var{addr} of size @var{size}.
251
@item boot_set @var{bootdevicelist}
254
Define new values for the boot device list. Those values will override
255
the values specified on the command line through the @code{-boot} option.
257
The values that can be specified here depend on the machine type, but are
258
the same that can be specified in the @code{-boot} command line option.
261
Inject an NMI on the given CPU (x86 only).
262
@item migrate [-d] [-b] [-i] @var{uri}
264
Migrate to @var{uri} (using -d to not wait for completion).
265
-b for migration with full copy of disk
266
-i for migration with incremental copy of disk (base image is shared)
268
@findex migrate_cancel
269
Cancel the current VM migration.
270
@item migrate_set_speed @var{value}
271
@findex migrate_set_speed
272
Set maximum speed to @var{value} (in bytes) for migrations.
273
@item migrate_set_downtime @var{second}
274
@findex migrate_set_downtime
275
Set maximum tolerated downtime (in seconds) for migration.
276
@item client_migrate_info @var{protocol} @var{hostname} @var{port} @var{tls-port} @var{cert-subject}
277
@findex client_migrate_info
278
Set the spice/vnc connection info for the migration target. The spice/vnc
279
server will ask the spice/vnc client to automatically reconnect using the
280
new parameters (if specified) once the vm migration finished successfully.
281
@item snapshot_blkdev
282
@findex snapshot_blkdev
283
Snapshot device, using snapshot file as target if provided
286
Add drive to PCI storage controller.
292
Hot remove PCI device.
293
@item pcie_aer_inject_error
294
@findex pcie_aer_inject_error
295
Inject PCIe AER error
298
Add host VLAN client.
299
@item host_net_remove
300
@findex host_net_remove
301
Remove host VLAN client.
304
Add host network device.
307
Remove host network device.
310
Redirect TCP or UDP connections from host to guest (requires -net user).
312
@findex hostfwd_remove
313
Remove host-to-guest TCP or UDP redirection.
314
@item balloon @var{value}
316
Request VM to change its memory allocation to @var{value} (in MB).
317
@item set_link @var{name} [on|off]
319
Switch link @var{name} on (i.e. up) or off (i.e. down).
320
@item watchdog_action
321
@findex watchdog_action
322
Change watchdog action.
323
@item acl_show @var{aclname}
325
List all the matching rules in the access control list, and the default
326
policy. There are currently two named access control lists,
327
@var{vnc.x509dname} and @var{vnc.username} matching on the x509 client
328
certificate distinguished name, and SASL username respectively.
329
@item acl_policy @var{aclname} @code{allow|deny}
331
Set the default access control list policy, used in the event that
332
none of the explicit rules match. The default policy at startup is
334
@item acl_add @var{aclname} @var{match} @code{allow|deny} [@var{index}]
336
Add a match rule to the access control list, allowing or denying access.
337
The match will normally be an exact username or x509 distinguished name,
338
but can optionally include wildcard globs. eg @code{*@@EXAMPLE.COM} to
339
allow all users in the @code{EXAMPLE.COM} kerberos realm. The match will
340
normally be appended to the end of the ACL, but can be inserted
341
earlier in the list if the optional @var{index} parameter is supplied.
342
@item acl_remove @var{aclname} @var{match}
344
Remove the specified match rule from the access control list.
345
@item acl_reset @var{aclname}
347
Remove all matches from the access control list, and set the default
348
policy back to @code{deny}.
349
@item mce @var{cpu} @var{bank} @var{status} @var{mcgstatus} @var{addr} @var{misc}
351
Inject an MCE on the given CPU (x86 only).
352
@item getfd @var{fdname}
354
If a file descriptor is passed alongside this command using the SCM_RIGHTS
355
mechanism on unix sockets, it is stored using the name @var{fdname} for
356
later use by other monitor commands.
357
@item closefd @var{fdname}
359
Close the file descriptor previously assigned to @var{fdname} using the
360
@code{getfd} command. This is only needed if the file descriptor was never
361
used by another monitor command.
362
@item block_passwd @var{device} @var{password}
364
Set the encrypted device @var{device} password to @var{password}
365
@item set_password [ vnc | spice ] password [ action-if-connected ]
368
Change spice/vnc password. Use zero to make the password stay valid
369
forever. @var{action-if-connected} specifies what should happen in
370
case a connection is established: @var{fail} makes the password change
371
fail. @var{disconnect} changes the password and disconnects the
372
client. @var{keep} changes the password and keeps the connection up.
373
@var{keep} is the default.
374
@item expire_password [ vnc | spice ] expire-time
375
@findex expire_password
377
Specify when a password for spice/vnc becomes
378
invalid. @var{expire-time} accepts:
382
Invalidate password instantly.
385
Password stays valid forever.
388
Password stays valid for @var{nsec} seconds starting now.
391
Password is invalidated at the given time. @var{nsec} are the seconds
392
passed since 1970, i.e. unix epoch.
395
@item info @var{subcommand}
397
Show various information about the system state.
401
show the version of QEMU
403
show the various VLANs and the associated devices
405
show the character devices
407
show the block devices
408
@item info blockstats
409
show block device statistics
411
show the cpu registers
413
show infos for each CPU
415
show the command line history
417
show the interrupts statistics (if available)
419
show i8259 (PIC) state
421
show emulated PCI device info
423
show virtual to physical memory mappings (i386, SH4, SPARC, and PPC only)
425
show the active virtual memory mappings (i386 only)
427
show dynamic compiler info
429
show NUMA information
433
show USB devices plugged on the virtual USB hub
435
show all USB host devices
437
show profiling information
439
show information about active capturing
441
show list of VM snapshots
443
show the current VM status (running|paused)
445
show guest PCMCIA status
447
show which guest mouse is receiving events
449
show the vnc server status
451
show the current VM name
453
show the current VM UUID
457
show user network stack connection states
459
show migration status
461
show balloon information
465
show qdev device model list
470
show contents of trace buffer
471
@item info trace-events
472
show available trace events and their state
added
removed
qemu-monitor.texi
