Use hxtool to generate monitor documentation and C structures
Signed-off-by: Blue Swirl <blauwirbel@gmail.com>
This commit is contained in:
Blue Swirl
parent
25517f999f
commit
2313086add
7
Makefile
7
Makefile
@ -332,7 +332,10 @@ cscope:
|
|||||||
qemu-options.texi: $(SRC_PATH)/qemu-options.hx
|
qemu-options.texi: $(SRC_PATH)/qemu-options.hx
|
||||||
$(call quiet-command,sh $(SRC_PATH)/hxtool -t < $< > $@," GEN $@")
|
$(call quiet-command,sh $(SRC_PATH)/hxtool -t < $< > $@," GEN $@")
|
||||||
|
|
||||||
qemu.1: qemu-doc.texi qemu-options.texi
|
qemu-monitor.texi: $(SRC_PATH)/qemu-monitor.hx
|
||||||
|
$(call quiet-command,sh $(SRC_PATH)/hxtool -t < $< > $@," GEN $@")
|
||||||
|
|
||||||
|
qemu.1: qemu-doc.texi qemu-options.texi qemu-monitor.texi
|
||||||
$(call quiet-command, \
|
$(call quiet-command, \
|
||||||
perl -Ww -- $(SRC_PATH)/texi2pod.pl $< qemu.pod && \
|
perl -Ww -- $(SRC_PATH)/texi2pod.pl $< qemu.pod && \
|
||||||
pod2man --section=1 --center=" " --release=" " qemu.pod > $@, \
|
pod2man --section=1 --center=" " --release=" " qemu.pod > $@, \
|
||||||
@ -356,7 +359,7 @@ dvi: qemu-doc.dvi qemu-tech.dvi
|
|||||||
|
|
||||||
html: qemu-doc.html qemu-tech.html
|
html: qemu-doc.html qemu-tech.html
|
||||||
|
|
||||||
qemu-doc.dvi qemu-doc.html qemu-doc.info: qemu-img.texi qemu-nbd.texi qemu-options.texi
|
qemu-doc.dvi qemu-doc.html qemu-doc.info: qemu-img.texi qemu-nbd.texi qemu-options.texi qemu-monitor.texi
|
||||||
|
|
||||||
VERSION ?= $(shell cat VERSION)
|
VERSION ?= $(shell cat VERSION)
|
||||||
FILE = qemu-$(VERSION)
|
FILE = qemu-$(VERSION)
|
||||||
|
|||||||
@ -732,6 +732,8 @@ endif
|
|||||||
|
|
||||||
vl.o: qemu-options.h
|
vl.o: qemu-options.h
|
||||||
|
|
||||||
|
monitor.o: qemu-monitor.h
|
||||||
|
|
||||||
$(QEMU_PROG): LIBS += $(SDL_LIBS) $(COCOA_LIBS) $(CURSES_LIBS) $(BRLAPI_LIBS) $(VDE_LIBS) $(CURL_LIBS)
|
$(QEMU_PROG): LIBS += $(SDL_LIBS) $(COCOA_LIBS) $(CURSES_LIBS) $(BRLAPI_LIBS) $(VDE_LIBS) $(CURL_LIBS)
|
||||||
$(QEMU_PROG): ARLIBS=../libqemu_common.a libqemu.a $(HWLIB)
|
$(QEMU_PROG): ARLIBS=../libqemu_common.a libqemu.a $(HWLIB)
|
||||||
$(QEMU_PROG): $(OBJS) ../libqemu_common.a libqemu.a $(HWLIB)
|
$(QEMU_PROG): $(OBJS) ../libqemu_common.a libqemu.a $(HWLIB)
|
||||||
@ -749,9 +751,13 @@ endif
|
|||||||
qemu-options.h: $(SRC_PATH)/qemu-options.hx
|
qemu-options.h: $(SRC_PATH)/qemu-options.hx
|
||||||
$(call quiet-command,sh $(SRC_PATH)/hxtool -h < $< > $@," GEN $(TARGET_DIR)$@")
|
$(call quiet-command,sh $(SRC_PATH)/hxtool -h < $< > $@," GEN $(TARGET_DIR)$@")
|
||||||
|
|
||||||
|
qemu-monitor.h: $(SRC_PATH)/qemu-monitor.hx
|
||||||
|
$(call quiet-command,sh $(SRC_PATH)/hxtool -h < $< > $@," GEN $(TARGET_DIR)$@")
|
||||||
|
|
||||||
clean:
|
clean:
|
||||||
rm -f *.o *.a *~ $(PROGS) nwfpe/*.o fpu/*.o qemu-options.h gdbstub-xml.c
|
rm -f *.o *.a *~ $(PROGS) nwfpe/*.o fpu/*.o
|
||||||
rm -f *.d */*.d tcg/*.o
|
rm -f *.d */*.d tcg/*.o
|
||||||
|
rm -f qemu-options.h qemu-monitor.h gdbstub-xml.c
|
||||||
|
|
||||||
install: all
|
install: all
|
||||||
ifneq ($(PROGS),)
|
ifneq ($(PROGS),)
|
||||||
|
|||||||
122
monitor.c
122
monitor.c
@ -1496,6 +1496,7 @@ static void do_info_capture(Monitor *mon)
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#ifdef HAS_AUDIO
|
||||||
static void do_stop_capture(Monitor *mon, int n)
|
static void do_stop_capture(Monitor *mon, int n)
|
||||||
{
|
{
|
||||||
int i;
|
int i;
|
||||||
@ -1511,7 +1512,6 @@ static void do_stop_capture(Monitor *mon, int n)
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
#ifdef HAS_AUDIO
|
|
||||||
static void do_wav_capture(Monitor *mon, const char *path,
|
static void do_wav_capture(Monitor *mon, const char *path,
|
||||||
int has_freq, int freq,
|
int has_freq, int freq,
|
||||||
int has_bits, int bits,
|
int has_bits, int bits,
|
||||||
@ -1659,128 +1659,12 @@ static void do_acl(Monitor *mon,
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/* Please update qemu-doc.texi when adding or changing commands */
|
|
||||||
static const mon_cmd_t mon_cmds[] = {
|
static const mon_cmd_t mon_cmds[] = {
|
||||||
{ "help|?", "s?", help_cmd,
|
#include "qemu-monitor.h"
|
||||||
"[cmd]", "show the help" },
|
|
||||||
{ "commit", "s", do_commit,
|
|
||||||
"device|all", "commit changes to the disk images (if -snapshot is used) or backing files" },
|
|
||||||
{ "info", "s?", do_info,
|
|
||||||
"[subcommand]", "show various information about the system state" },
|
|
||||||
{ "q|quit", "", do_quit,
|
|
||||||
"", "quit the emulator" },
|
|
||||||
{ "eject", "-fB", do_eject,
|
|
||||||
"[-f] device", "eject a removable medium (use -f to force it)" },
|
|
||||||
{ "change", "BFs?", do_change,
|
|
||||||
"device filename [format]", "change a removable medium, optional format" },
|
|
||||||
{ "screendump", "F", do_screen_dump,
|
|
||||||
"filename", "save screen into PPM image 'filename'" },
|
|
||||||
{ "logfile", "F", do_logfile,
|
|
||||||
"filename", "output logs to 'filename'" },
|
|
||||||
{ "log", "s", do_log,
|
|
||||||
"item1[,...]", "activate logging of the specified items to '/tmp/qemu.log'" },
|
|
||||||
{ "savevm", "s?", do_savevm,
|
|
||||||
"[tag|id]", "save a VM snapshot. If no tag or id are provided, a new snapshot is created" },
|
|
||||||
{ "loadvm", "s", do_loadvm,
|
|
||||||
"tag|id", "restore a VM snapshot from its tag or id" },
|
|
||||||
{ "delvm", "s", do_delvm,
|
|
||||||
"tag|id", "delete a VM snapshot from its tag or id" },
|
|
||||||
{ "singlestep", "s?", do_singlestep,
|
|
||||||
"[on|off]", "run emulation in singlestep mode or switch to normal mode", },
|
|
||||||
{ "stop", "", do_stop,
|
|
||||||
"", "stop emulation", },
|
|
||||||
{ "c|cont", "", do_cont,
|
|
||||||
"", "resume emulation", },
|
|
||||||
{ "gdbserver", "s?", do_gdbserver,
|
|
||||||
"[device]", "start gdbserver on given device (default 'tcp::1234'), stop with 'none'", },
|
|
||||||
{ "x", "/l", do_memory_dump,
|
|
||||||
"/fmt addr", "virtual memory dump starting at 'addr'", },
|
|
||||||
{ "xp", "/l", do_physical_memory_dump,
|
|
||||||
"/fmt addr", "physical memory dump starting at 'addr'", },
|
|
||||||
{ "p|print", "/l", do_print,
|
|
||||||
"/fmt expr", "print expression value (use $reg for CPU register access)", },
|
|
||||||
{ "i", "/ii.", do_ioport_read,
|
|
||||||
"/fmt addr", "I/O port read" },
|
|
||||||
|
|
||||||
{ "sendkey", "si?", do_sendkey,
|
|
||||||
"keys [hold_ms]", "send keys to the VM (e.g. 'sendkey ctrl-alt-f1', default hold time=100 ms)" },
|
|
||||||
{ "system_reset", "", do_system_reset,
|
|
||||||
"", "reset the system" },
|
|
||||||
{ "system_powerdown", "", do_system_powerdown,
|
|
||||||
"", "send system power down event" },
|
|
||||||
{ "sum", "ii", do_sum,
|
|
||||||
"addr size", "compute the checksum of a memory region" },
|
|
||||||
{ "usb_add", "s", do_usb_add,
|
|
||||||
"device", "add USB device (e.g. 'host:bus.addr' or 'host:vendor_id:product_id')" },
|
|
||||||
{ "usb_del", "s", do_usb_del,
|
|
||||||
"device", "remove USB device 'bus.addr'" },
|
|
||||||
{ "cpu", "i", do_cpu_set,
|
|
||||||
"index", "set the default CPU" },
|
|
||||||
{ "mouse_move", "sss?", do_mouse_move,
|
|
||||||
"dx dy [dz]", "send mouse move events" },
|
|
||||||
{ "mouse_button", "i", do_mouse_button,
|
|
||||||
"state", "change mouse button state (1=L, 2=M, 4=R)" },
|
|
||||||
{ "mouse_set", "i", do_mouse_set,
|
|
||||||
"index", "set which mouse device receives events" },
|
|
||||||
#ifdef HAS_AUDIO
|
|
||||||
{ "wavcapture", "si?i?i?", do_wav_capture,
|
|
||||||
"path [frequency [bits [channels]]]",
|
|
||||||
"capture audio to a wave file (default frequency=44100 bits=16 channels=2)" },
|
|
||||||
#endif
|
|
||||||
{ "stopcapture", "i", do_stop_capture,
|
|
||||||
"capture index", "stop capture" },
|
|
||||||
{ "memsave", "lis", do_memory_save,
|
|
||||||
"addr size file", "save to disk virtual memory dump starting at 'addr' of size 'size'", },
|
|
||||||
{ "pmemsave", "lis", do_physical_memory_save,
|
|
||||||
"addr size file", "save to disk physical memory dump starting at 'addr' of size 'size'", },
|
|
||||||
{ "boot_set", "s", do_boot_set,
|
|
||||||
"bootdevice", "define new values for the boot device list" },
|
|
||||||
#if defined(TARGET_I386)
|
|
||||||
{ "nmi", "i", do_inject_nmi,
|
|
||||||
"cpu", "inject an NMI on the given CPU", },
|
|
||||||
#endif
|
|
||||||
{ "migrate", "-ds", do_migrate,
|
|
||||||
"[-d] uri", "migrate to URI (using -d to not wait for completion)" },
|
|
||||||
{ "migrate_cancel", "", do_migrate_cancel,
|
|
||||||
"", "cancel the current VM migration" },
|
|
||||||
{ "migrate_set_speed", "s", do_migrate_set_speed,
|
|
||||||
"value", "set maximum speed (in bytes) for migrations" },
|
|
||||||
#if defined(TARGET_I386)
|
|
||||||
{ "drive_add", "ss", drive_hot_add, "pci_addr=[[<domain>:]<bus>:]<slot>\n"
|
|
||||||
"[file=file][,if=type][,bus=n]\n"
|
|
||||||
"[,unit=m][,media=d][index=i]\n"
|
|
||||||
"[,cyls=c,heads=h,secs=s[,trans=t]]\n"
|
|
||||||
"[snapshot=on|off][,cache=on|off]",
|
|
||||||
"add drive to PCI storage controller" },
|
|
||||||
{ "pci_add", "sss", pci_device_hot_add, "pci_addr=auto|[[<domain>:]<bus>:]<slot> nic|storage [[vlan=n][,macaddr=addr][,model=type]] [file=file][,if=type][,bus=nr]...", "hot-add PCI device" },
|
|
||||||
{ "pci_del", "s", pci_device_hot_remove, "pci_addr=[[<domain>:]<bus>:]<slot>", "hot remove PCI device" },
|
|
||||||
#endif
|
|
||||||
{ "host_net_add", "ss?", net_host_device_add,
|
|
||||||
"tap|user|socket|vde|dump [options]", "add host VLAN client" },
|
|
||||||
{ "host_net_remove", "is", net_host_device_remove,
|
|
||||||
"vlan_id name", "remove host VLAN client" },
|
|
||||||
#ifdef CONFIG_SLIRP
|
|
||||||
{ "host_net_redir", "ss?", net_slirp_redir,
|
|
||||||
"[tcp|udp]:host-port:[guest-host]:guest-port", "redirect TCP or UDP connections from host to guest (requires -net user)\n"
|
|
||||||
"host_net_redir remove [tcp:|udp:]host-port -- remove redirection\n"
|
|
||||||
"host_net_redir list -- show all redirections" },
|
|
||||||
#endif
|
|
||||||
{ "balloon", "i", do_balloon,
|
|
||||||
"target", "request VM to change it's memory allocation (in MB)" },
|
|
||||||
{ "set_link", "ss", do_set_link,
|
|
||||||
"name up|down", "change the link status of a network adapter" },
|
|
||||||
{ "watchdog_action", "s", do_watchdog_action,
|
|
||||||
"[reset|shutdown|poweroff|pause|debug|none]", "change watchdog action" },
|
|
||||||
{ "acl", "sss?i?", do_acl, "<command> <aclname> [<match> [<index>]]\n",
|
|
||||||
"acl show vnc.username\n"
|
|
||||||
"acl policy vnc.username deny\n"
|
|
||||||
"acl allow vnc.username fred\n"
|
|
||||||
"acl deny vnc.username bob\n"
|
|
||||||
"acl reset vnc.username\n" },
|
|
||||||
{ NULL, NULL, },
|
{ NULL, NULL, },
|
||||||
};
|
};
|
||||||
|
|
||||||
/* Please update qemu-doc.texi when adding or changing commands */
|
/* Please update qemu-monitor.hx when adding or changing commands */
|
||||||
static const mon_cmd_t info_cmds[] = {
|
static const mon_cmd_t info_cmds[] = {
|
||||||
{ "version", "", do_info_version,
|
{ "version", "", do_info_version,
|
||||||
"", "show the version of QEMU" },
|
"", "show the version of QEMU" },
|
||||||
|
|||||||
352
qemu-doc.texi
352
qemu-doc.texi
@ -318,357 +318,7 @@ from a disk file.
|
|||||||
|
|
||||||
The following commands are available:
|
The following commands are available:
|
||||||
|
|
||||||
@table @option
|
@include qemu-monitor.texi
|
||||||
|
|
||||||
@item help or ? [@var{cmd}]
|
|
||||||
Show the help for all commands or just for command @var{cmd}.
|
|
||||||
|
|
||||||
@item commit
|
|
||||||
Commit changes to the disk images (if -snapshot is used).
|
|
||||||
|
|
||||||
@item info @var{subcommand}
|
|
||||||
Show various information about the system state.
|
|
||||||
|
|
||||||
@table @option
|
|
||||||
@item info version
|
|
||||||
show the version of QEMU
|
|
||||||
@item info network
|
|
||||||
show the various VLANs and the associated devices
|
|
||||||
@item info chardev
|
|
||||||
show the character devices
|
|
||||||
@item info block
|
|
||||||
show the block devices
|
|
||||||
@item info block
|
|
||||||
show block device statistics
|
|
||||||
@item info registers
|
|
||||||
show the cpu registers
|
|
||||||
@item info cpus
|
|
||||||
show infos for each CPU
|
|
||||||
@item info history
|
|
||||||
show the command line history
|
|
||||||
@item info irq
|
|
||||||
show the interrupts statistics (if available)
|
|
||||||
@item info pic
|
|
||||||
show i8259 (PIC) state
|
|
||||||
@item info pci
|
|
||||||
show emulated PCI device info
|
|
||||||
@item info tlb
|
|
||||||
show virtual to physical memory mappings (i386 only)
|
|
||||||
@item info mem
|
|
||||||
show the active virtual memory mappings (i386 only)
|
|
||||||
@item info hpet
|
|
||||||
show state of HPET (i386 only)
|
|
||||||
@item info kqemu
|
|
||||||
show KQEMU information
|
|
||||||
@item info kvm
|
|
||||||
show KVM information
|
|
||||||
@item info usb
|
|
||||||
show USB devices plugged on the virtual USB hub
|
|
||||||
@item info usbhost
|
|
||||||
show all USB host devices
|
|
||||||
@item info profile
|
|
||||||
show profiling information
|
|
||||||
@item info capture
|
|
||||||
show information about active capturing
|
|
||||||
@item info snapshots
|
|
||||||
show list of VM snapshots
|
|
||||||
@item info status
|
|
||||||
show the current VM status (running|paused)
|
|
||||||
@item info pcmcia
|
|
||||||
show guest PCMCIA status
|
|
||||||
@item info mice
|
|
||||||
show which guest mouse is receiving events
|
|
||||||
@item info vnc
|
|
||||||
show the vnc server status
|
|
||||||
@item info name
|
|
||||||
show the current VM name
|
|
||||||
@item info uuid
|
|
||||||
show the current VM UUID
|
|
||||||
@item info cpustats
|
|
||||||
show CPU statistics
|
|
||||||
@item info slirp
|
|
||||||
show SLIRP statistics (if available)
|
|
||||||
@item info migrate
|
|
||||||
show migration status
|
|
||||||
@item info balloon
|
|
||||||
show balloon information
|
|
||||||
@end table
|
|
||||||
|
|
||||||
@item q or quit
|
|
||||||
Quit the emulator.
|
|
||||||
|
|
||||||
@item eject [-f] @var{device}
|
|
||||||
Eject a removable medium (use -f to force it).
|
|
||||||
|
|
||||||
@item change @var{device} @var{setting}
|
|
||||||
|
|
||||||
Change the configuration of a device.
|
|
||||||
|
|
||||||
@table @option
|
|
||||||
@item change @var{diskdevice} @var{filename} [@var{format}]
|
|
||||||
Change the medium for a removable disk device to point to @var{filename}. eg
|
|
||||||
|
|
||||||
@example
|
|
||||||
(qemu) change ide1-cd0 /path/to/some.iso
|
|
||||||
@end example
|
|
||||||
|
|
||||||
@var{format} is optional.
|
|
||||||
|
|
||||||
@item change vnc @var{display},@var{options}
|
|
||||||
Change the configuration of the VNC server. The valid syntax for @var{display}
|
|
||||||
and @var{options} are described at @ref{sec_invocation}. eg
|
|
||||||
|
|
||||||
@example
|
|
||||||
(qemu) change vnc localhost:1
|
|
||||||
@end example
|
|
||||||
|
|
||||||
@item change vnc password [@var{password}]
|
|
||||||
|
|
||||||
Change the password associated with the VNC server. If the new password is not
|
|
||||||
supplied, the monitor will prompt for it to be entered. VNC passwords are only
|
|
||||||
significant up to 8 letters. eg
|
|
||||||
|
|
||||||
@example
|
|
||||||
(qemu) change vnc password
|
|
||||||
Password: ********
|
|
||||||
@end example
|
|
||||||
|
|
||||||
@end table
|
|
||||||
|
|
||||||
@item acl @var{subcommand} @var{aclname} @var{match} @var{index}
|
|
||||||
|
|
||||||
Manage access control lists for network services. There are currently
|
|
||||||
two named access control lists, @var{vnc.x509dname} and @var{vnc.username}
|
|
||||||
matching on the x509 client certificate distinguished name, and SASL
|
|
||||||
username respectively.
|
|
||||||
|
|
||||||
@table @option
|
|
||||||
@item acl show <aclname>
|
|
||||||
list all the match rules in the access control list, and the default
|
|
||||||
policy
|
|
||||||
@item acl policy <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}
|
|
||||||
@item acl allow <aclname> <match> [<index>]
|
|
||||||
add a match to the access control list, allowing access. The match will
|
|
||||||
normally be an exact username or x509 distinguished name, but can
|
|
||||||
optionally include wildcard globs. eg @code{*@@EXAMPLE.COM} to allow
|
|
||||||
all users in the @code{EXAMPLE.COM} kerberos realm. The match will
|
|
||||||
normally be appended to the end of the ACL, but can be inserted
|
|
||||||
earlier in the list if the optional @code{index} parameter is supplied.
|
|
||||||
@item acl deny <aclname> <match> [<index>]
|
|
||||||
add a match to the access control list, 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 allow
|
|
||||||
all users in the @code{EXAMPLE.COM} kerberos realm. The match will
|
|
||||||
normally be appended to the end of the ACL, but can be inserted
|
|
||||||
earlier in the list if the optional @code{index} parameter is supplied.
|
|
||||||
@item acl remove <aclname> <match>
|
|
||||||
remove the specified match rule from the access control list.
|
|
||||||
@item acl reset <aclname>
|
|
||||||
remove all matches from the access control list, and set the default
|
|
||||||
policy back to @code{deny}.
|
|
||||||
@end table
|
|
||||||
|
|
||||||
@item screendump @var{filename}
|
|
||||||
Save screen into PPM image @var{filename}.
|
|
||||||
|
|
||||||
@item logfile @var{filename}
|
|
||||||
Output logs to @var{filename}.
|
|
||||||
|
|
||||||
@item log @var{item1}[,...]
|
|
||||||
Activate logging of the specified items to @file{/tmp/qemu.log}.
|
|
||||||
|
|
||||||
@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
|
|
||||||
@ref{vm_snapshots}.
|
|
||||||
|
|
||||||
@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}.
|
|
||||||
|
|
||||||
@item delvm @var{tag}|@var{id}
|
|
||||||
Delete the snapshot identified by @var{tag} or @var{id}.
|
|
||||||
|
|
||||||
@item singlestep [off]
|
|
||||||
Run the emulation in single step mode.
|
|
||||||
If called with option off, the emulation returns to normal mode.
|
|
||||||
|
|
||||||
@item stop
|
|
||||||
Stop emulation.
|
|
||||||
|
|
||||||
@item c or cont
|
|
||||||
Resume emulation.
|
|
||||||
|
|
||||||
@item gdbserver [@var{port}]
|
|
||||||
Start gdbserver session (default @var{port}=1234)
|
|
||||||
|
|
||||||
@item x/fmt @var{addr}
|
|
||||||
Virtual memory dump starting at @var{addr}.
|
|
||||||
|
|
||||||
@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
|
|
||||||
data. Its syntax is: @option{/@{count@}@{format@}@{size@}}
|
|
||||||
|
|
||||||
@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.
|
|
||||||
|
|
||||||
@end table
|
|
||||||
|
|
||||||
Examples:
|
|
||||||
@itemize
|
|
||||||
@item
|
|
||||||
Dump 10 instructions at the current instruction pointer:
|
|
||||||
@example
|
|
||||||
(qemu) x/10i $eip
|
|
||||||
0x90107063: ret
|
|
||||||
0x90107064: sti
|
|
||||||
0x90107065: lea 0x0(%esi,1),%esi
|
|
||||||
0x90107069: lea 0x0(%edi,1),%edi
|
|
||||||
0x90107070: ret
|
|
||||||
0x90107071: jmp 0x90107080
|
|
||||||
0x90107073: nop
|
|
||||||
0x90107074: nop
|
|
||||||
0x90107075: nop
|
|
||||||
0x90107076: nop
|
|
||||||
@end example
|
|
||||||
|
|
||||||
@item
|
|
||||||
Dump 80 16 bit values at the start of the video memory.
|
|
||||||
@smallexample
|
|
||||||
(qemu) xp/80hx 0xb8000
|
|
||||||
0x000b8000: 0x0b50 0x0b6c 0x0b65 0x0b78 0x0b38 0x0b36 0x0b2f 0x0b42
|
|
||||||
0x000b8010: 0x0b6f 0x0b63 0x0b68 0x0b73 0x0b20 0x0b56 0x0b47 0x0b41
|
|
||||||
0x000b8020: 0x0b42 0x0b69 0x0b6f 0x0b73 0x0b20 0x0b63 0x0b75 0x0b72
|
|
||||||
0x000b8030: 0x0b72 0x0b65 0x0b6e 0x0b74 0x0b2d 0x0b63 0x0b76 0x0b73
|
|
||||||
0x000b8040: 0x0b20 0x0b30 0x0b35 0x0b20 0x0b4e 0x0b6f 0x0b76 0x0b20
|
|
||||||
0x000b8050: 0x0b32 0x0b30 0x0b30 0x0b33 0x0720 0x0720 0x0720 0x0720
|
|
||||||
0x000b8060: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
|
|
||||||
0x000b8070: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
|
|
||||||
0x000b8080: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
|
|
||||||
0x000b8090: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
|
|
||||||
@end smallexample
|
|
||||||
@end itemize
|
|
||||||
|
|
||||||
@item p or print/@var{fmt} @var{expr}
|
|
||||||
|
|
||||||
Print expression value. Only the @var{format} part of @var{fmt} is
|
|
||||||
used.
|
|
||||||
|
|
||||||
@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
|
|
||||||
format. Use @code{-} to press several keys simultaneously. Example:
|
|
||||||
@example
|
|
||||||
sendkey ctrl-alt-f1
|
|
||||||
@end example
|
|
||||||
|
|
||||||
This command is useful to send keys that your graphical user interface
|
|
||||||
intercepts at low level, such as @code{ctrl-alt-f1} in X Window.
|
|
||||||
|
|
||||||
@item system_reset
|
|
||||||
|
|
||||||
Reset the system.
|
|
||||||
|
|
||||||
@item system_powerdown
|
|
||||||
|
|
||||||
Power down the system (if supported).
|
|
||||||
|
|
||||||
@item sum @var{addr} @var{size}
|
|
||||||
|
|
||||||
Compute the checksum of a memory region.
|
|
||||||
|
|
||||||
@item usb_add @var{devname}
|
|
||||||
|
|
||||||
Add the USB device @var{devname}. For details of available devices see
|
|
||||||
@ref{usb_devices}
|
|
||||||
|
|
||||||
@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
|
|
||||||
command @code{info usb} to see the devices you can remove.
|
|
||||||
|
|
||||||
@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}.
|
|
||||||
|
|
||||||
@item mouse_button @var{val}
|
|
||||||
Change the active mouse button state @var{val} (1=L, 2=M, 4=R).
|
|
||||||
|
|
||||||
@item mouse_set @var{index}
|
|
||||||
Set which mouse device receives events at given @var{index}, index
|
|
||||||
can be obtained with
|
|
||||||
@example
|
|
||||||
info mice
|
|
||||||
@end example
|
|
||||||
|
|
||||||
@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}.
|
|
||||||
|
|
||||||
Defaults:
|
|
||||||
@itemize @minus
|
|
||||||
@item Sample rate = 44100 Hz - CD quality
|
|
||||||
@item Bits = 16
|
|
||||||
@item Number of channels = 2 - Stereo
|
|
||||||
@end itemize
|
|
||||||
|
|
||||||
@item stopcapture @var{index}
|
|
||||||
Stop capture with a given @var{index}, index can be obtained with
|
|
||||||
@example
|
|
||||||
info capture
|
|
||||||
@end example
|
|
||||||
|
|
||||||
@item memsave @var{addr} @var{size} @var{file}
|
|
||||||
save to disk virtual memory dump starting at @var{addr} of size @var{size}.
|
|
||||||
|
|
||||||
@item pmemsave @var{addr} @var{size} @var{file}
|
|
||||||
save to disk physical memory dump starting at @var{addr} of size @var{size}.
|
|
||||||
|
|
||||||
@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.
|
|
||||||
|
|
||||||
The values that can be specified here depend on the machine type, but are
|
|
||||||
the same that can be specified in the @code{-boot} command line option.
|
|
||||||
|
|
||||||
@item nmi @var{cpu}
|
|
||||||
Inject an NMI on the given CPU.
|
|
||||||
|
|
||||||
@item migrate [-d] @var{uri}
|
|
||||||
Migrate to @var{uri} (using -d to not wait for completion).
|
|
||||||
|
|
||||||
@item migrate_cancel
|
|
||||||
Cancel the current VM migration.
|
|
||||||
|
|
||||||
@item migrate_set_speed @var{value}
|
|
||||||
Set maximum speed to @var{value} (in bytes) for migrations.
|
|
||||||
|
|
||||||
@item balloon @var{value}
|
|
||||||
Request VM to change its memory allocation to @var{value} (in MB).
|
|
||||||
|
|
||||||
@item set_link @var{name} [up|down]
|
|
||||||
Set link @var{name} up or down.
|
|
||||||
|
|
||||||
@end table
|
|
||||||
|
|
||||||
@subsection Integer expressions
|
@subsection Integer expressions
|
||||||
|
|
||||||
|
|||||||
608
qemu-monitor.hx
Normal file
608
qemu-monitor.hx
Normal file
@ -0,0 +1,608 @@
|
|||||||
|
HXCOMM Use DEFHEADING() to define headings in both help text and texi
|
||||||
|
HXCOMM Text between STEXI and ETEXI are copied to texi version and
|
||||||
|
HXCOMM discarded from C version
|
||||||
|
HXCOMM DEF(command, args, callback, arg_string, help) is used to construct
|
||||||
|
HXCOMM monitor commands
|
||||||
|
HXCOMM HXCOMM can be used for comments, discarded from both texi and C
|
||||||
|
|
||||||
|
STEXI
|
||||||
|
@table @option
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "help|?", "s?", help_cmd, "[cmd]", "show the help" },
|
||||||
|
STEXI
|
||||||
|
@item help or ? [@var{cmd}]
|
||||||
|
Show the help for all commands or just for command @var{cmd}.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "commit", "s", do_commit,
|
||||||
|
"device|all", "commit changes to the disk images (if -snapshot is used) or backing files" },
|
||||||
|
STEXI
|
||||||
|
@item commit
|
||||||
|
Commit changes to the disk images (if -snapshot is used) or backing files.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "info", "s?", do_info,
|
||||||
|
"[subcommand]", "show various information about the system state" },
|
||||||
|
STEXI
|
||||||
|
@item info @var{subcommand}
|
||||||
|
Show various information about the system state.
|
||||||
|
|
||||||
|
@table @option
|
||||||
|
@item info version
|
||||||
|
show the version of QEMU
|
||||||
|
@item info network
|
||||||
|
show the various VLANs and the associated devices
|
||||||
|
@item info chardev
|
||||||
|
show the character devices
|
||||||
|
@item info block
|
||||||
|
show the block devices
|
||||||
|
@item info block
|
||||||
|
show block device statistics
|
||||||
|
@item info registers
|
||||||
|
show the cpu registers
|
||||||
|
@item info cpus
|
||||||
|
show infos for each CPU
|
||||||
|
@item info history
|
||||||
|
show the command line history
|
||||||
|
@item info irq
|
||||||
|
show the interrupts statistics (if available)
|
||||||
|
@item info pic
|
||||||
|
show i8259 (PIC) state
|
||||||
|
@item info pci
|
||||||
|
show emulated PCI device info
|
||||||
|
@item info tlb
|
||||||
|
show virtual to physical memory mappings (i386 only)
|
||||||
|
@item info mem
|
||||||
|
show the active virtual memory mappings (i386 only)
|
||||||
|
@item info hpet
|
||||||
|
show state of HPET (i386 only)
|
||||||
|
@item info kqemu
|
||||||
|
show KQEMU information
|
||||||
|
@item info kvm
|
||||||
|
show KVM information
|
||||||
|
@item info usb
|
||||||
|
show USB devices plugged on the virtual USB hub
|
||||||
|
@item info usbhost
|
||||||
|
show all USB host devices
|
||||||
|
@item info profile
|
||||||
|
show profiling information
|
||||||
|
@item info capture
|
||||||
|
show information about active capturing
|
||||||
|
@item info snapshots
|
||||||
|
show list of VM snapshots
|
||||||
|
@item info status
|
||||||
|
show the current VM status (running|paused)
|
||||||
|
@item info pcmcia
|
||||||
|
show guest PCMCIA status
|
||||||
|
@item info mice
|
||||||
|
show which guest mouse is receiving events
|
||||||
|
@item info vnc
|
||||||
|
show the vnc server status
|
||||||
|
@item info name
|
||||||
|
show the current VM name
|
||||||
|
@item info uuid
|
||||||
|
show the current VM UUID
|
||||||
|
@item info cpustats
|
||||||
|
show CPU statistics
|
||||||
|
@item info slirp
|
||||||
|
show SLIRP statistics (if available)
|
||||||
|
@item info migrate
|
||||||
|
show migration status
|
||||||
|
@item info balloon
|
||||||
|
show balloon information
|
||||||
|
@item info qtree
|
||||||
|
show device tree
|
||||||
|
@end table
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "q|quit", "", do_quit,
|
||||||
|
"", "quit the emulator" },
|
||||||
|
STEXI
|
||||||
|
@item q or quit
|
||||||
|
Quit the emulator.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "eject", "-fB", do_eject,
|
||||||
|
"[-f] device", "eject a removable medium (use -f to force it)" },
|
||||||
|
STEXI
|
||||||
|
@item eject [-f] @var{device}
|
||||||
|
Eject a removable medium (use -f to force it).
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "change", "BFs?", do_change,
|
||||||
|
"device filename [format]", "change a removable medium, optional format" },
|
||||||
|
STEXI
|
||||||
|
@item change @var{device} @var{setting}
|
||||||
|
|
||||||
|
Change the configuration of a device.
|
||||||
|
|
||||||
|
@table @option
|
||||||
|
@item change @var{diskdevice} @var{filename} [@var{format}]
|
||||||
|
Change the medium for a removable disk device to point to @var{filename}. eg
|
||||||
|
|
||||||
|
@example
|
||||||
|
(qemu) change ide1-cd0 /path/to/some.iso
|
||||||
|
@end example
|
||||||
|
|
||||||
|
@var{format} is optional.
|
||||||
|
|
||||||
|
@item change vnc @var{display},@var{options}
|
||||||
|
Change the configuration of the VNC server. The valid syntax for @var{display}
|
||||||
|
and @var{options} are described at @ref{sec_invocation}. eg
|
||||||
|
|
||||||
|
@example
|
||||||
|
(qemu) change vnc localhost:1
|
||||||
|
@end example
|
||||||
|
|
||||||
|
@item change vnc password [@var{password}]
|
||||||
|
|
||||||
|
Change the password associated with the VNC server. If the new password is not
|
||||||
|
supplied, the monitor will prompt for it to be entered. VNC passwords are only
|
||||||
|
significant up to 8 letters. eg
|
||||||
|
|
||||||
|
@example
|
||||||
|
(qemu) change vnc password
|
||||||
|
Password: ********
|
||||||
|
@end example
|
||||||
|
|
||||||
|
@end table
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "screendump", "F", do_screen_dump,
|
||||||
|
"filename", "save screen into PPM image 'filename'" },
|
||||||
|
STEXI
|
||||||
|
@item screendump @var{filename}
|
||||||
|
Save screen into PPM image @var{filename}.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "logfile", "F", do_logfile,
|
||||||
|
"filename", "output logs to 'filename'" },
|
||||||
|
STEXI
|
||||||
|
@item logfile @var{filename}
|
||||||
|
Output logs to @var{filename}.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "log", "s", do_log,
|
||||||
|
"item1[,...]", "activate logging of the specified items to '/tmp/qemu.log'" },
|
||||||
|
STEXI
|
||||||
|
@item log @var{item1}[,...]
|
||||||
|
Activate logging of the specified items to @file{/tmp/qemu.log}.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "savevm", "s?", do_savevm,
|
||||||
|
"[tag|id]", "save a VM snapshot. If no tag or id are provided, a new snapshot is created" },
|
||||||
|
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
|
||||||
|
@ref{vm_snapshots}.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "loadvm", "s", do_loadvm,
|
||||||
|
"tag|id", "restore a VM snapshot from its tag or id" },
|
||||||
|
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
|
||||||
|
|
||||||
|
{ "delvm", "s", do_delvm,
|
||||||
|
"tag|id", "delete a VM snapshot from its tag or id" },
|
||||||
|
STEXI
|
||||||
|
@item delvm @var{tag}|@var{id}
|
||||||
|
Delete the snapshot identified by @var{tag} or @var{id}.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "singlestep", "s?", do_singlestep,
|
||||||
|
"[on|off]", "run emulation in singlestep mode or switch to normal mode", },
|
||||||
|
STEXI
|
||||||
|
@item singlestep [off]
|
||||||
|
Run the emulation in single step mode.
|
||||||
|
If called with option off, the emulation returns to normal mode.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "stop", "", do_stop,
|
||||||
|
"", "stop emulation", },
|
||||||
|
STEXI
|
||||||
|
@item stop
|
||||||
|
Stop emulation.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "c|cont", "", do_cont,
|
||||||
|
"", "resume emulation", },
|
||||||
|
STEXI
|
||||||
|
@item c or cont
|
||||||
|
Resume emulation.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "gdbserver", "s?", do_gdbserver,
|
||||||
|
"[device]", "start gdbserver on given device (default 'tcp::1234'), stop with 'none'", },
|
||||||
|
STEXI
|
||||||
|
@item gdbserver [@var{port}]
|
||||||
|
Start gdbserver session (default @var{port}=1234)
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "x", "/l", do_memory_dump,
|
||||||
|
"/fmt addr", "virtual memory dump starting at 'addr'", },
|
||||||
|
STEXI
|
||||||
|
@item x/fmt @var{addr}
|
||||||
|
Virtual memory dump starting at @var{addr}.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "xp", "/l", do_physical_memory_dump,
|
||||||
|
"/fmt addr", "physical memory dump starting at 'addr'", },
|
||||||
|
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
|
||||||
|
data. Its syntax is: @option{/@{count@}@{format@}@{size@}}
|
||||||
|
|
||||||
|
@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.
|
||||||
|
|
||||||
|
@end table
|
||||||
|
|
||||||
|
Examples:
|
||||||
|
@itemize
|
||||||
|
@item
|
||||||
|
Dump 10 instructions at the current instruction pointer:
|
||||||
|
@example
|
||||||
|
(qemu) x/10i $eip
|
||||||
|
0x90107063: ret
|
||||||
|
0x90107064: sti
|
||||||
|
0x90107065: lea 0x0(%esi,1),%esi
|
||||||
|
0x90107069: lea 0x0(%edi,1),%edi
|
||||||
|
0x90107070: ret
|
||||||
|
0x90107071: jmp 0x90107080
|
||||||
|
0x90107073: nop
|
||||||
|
0x90107074: nop
|
||||||
|
0x90107075: nop
|
||||||
|
0x90107076: nop
|
||||||
|
@end example
|
||||||
|
|
||||||
|
@item
|
||||||
|
Dump 80 16 bit values at the start of the video memory.
|
||||||
|
@smallexample
|
||||||
|
(qemu) xp/80hx 0xb8000
|
||||||
|
0x000b8000: 0x0b50 0x0b6c 0x0b65 0x0b78 0x0b38 0x0b36 0x0b2f 0x0b42
|
||||||
|
0x000b8010: 0x0b6f 0x0b63 0x0b68 0x0b73 0x0b20 0x0b56 0x0b47 0x0b41
|
||||||
|
0x000b8020: 0x0b42 0x0b69 0x0b6f 0x0b73 0x0b20 0x0b63 0x0b75 0x0b72
|
||||||
|
0x000b8030: 0x0b72 0x0b65 0x0b6e 0x0b74 0x0b2d 0x0b63 0x0b76 0x0b73
|
||||||
|
0x000b8040: 0x0b20 0x0b30 0x0b35 0x0b20 0x0b4e 0x0b6f 0x0b76 0x0b20
|
||||||
|
0x000b8050: 0x0b32 0x0b30 0x0b30 0x0b33 0x0720 0x0720 0x0720 0x0720
|
||||||
|
0x000b8060: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
|
||||||
|
0x000b8070: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
|
||||||
|
0x000b8080: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
|
||||||
|
0x000b8090: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
|
||||||
|
@end smallexample
|
||||||
|
@end itemize
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "p|print", "/l", do_print,
|
||||||
|
"/fmt expr", "print expression value (use $reg for CPU register access)", },
|
||||||
|
STEXI
|
||||||
|
@item p or print/@var{fmt} @var{expr}
|
||||||
|
|
||||||
|
Print expression value. Only the @var{format} part of @var{fmt} is
|
||||||
|
used.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "i", "/ii.", do_ioport_read,
|
||||||
|
"/fmt addr", "I/O port read" },
|
||||||
|
STEXI
|
||||||
|
Read I/O port.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
|
||||||
|
{ "sendkey", "si?", do_sendkey,
|
||||||
|
"keys [hold_ms]", "send keys to the VM (e.g. 'sendkey ctrl-alt-f1', default hold time=100 ms)" },
|
||||||
|
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
|
||||||
|
format. Use @code{-} to press several keys simultaneously. Example:
|
||||||
|
@example
|
||||||
|
sendkey ctrl-alt-f1
|
||||||
|
@end example
|
||||||
|
|
||||||
|
This command is useful to send keys that your graphical user interface
|
||||||
|
intercepts at low level, such as @code{ctrl-alt-f1} in X Window.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "system_reset", "", do_system_reset,
|
||||||
|
"", "reset the system" },
|
||||||
|
STEXI
|
||||||
|
@item system_reset
|
||||||
|
|
||||||
|
Reset the system.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "system_powerdown", "", do_system_powerdown,
|
||||||
|
"", "send system power down event" },
|
||||||
|
STEXI
|
||||||
|
@item system_powerdown
|
||||||
|
|
||||||
|
Power down the system (if supported).
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "sum", "ii", do_sum,
|
||||||
|
"addr size", "compute the checksum of a memory region" },
|
||||||
|
STEXI
|
||||||
|
@item sum @var{addr} @var{size}
|
||||||
|
|
||||||
|
Compute the checksum of a memory region.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "usb_add", "s", do_usb_add,
|
||||||
|
"device", "add USB device (e.g. 'host:bus.addr' or 'host:vendor_id:product_id')" },
|
||||||
|
STEXI
|
||||||
|
@item usb_add @var{devname}
|
||||||
|
|
||||||
|
Add the USB device @var{devname}. For details of available devices see
|
||||||
|
@ref{usb_devices}
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "usb_del", "s", do_usb_del,
|
||||||
|
"device", "remove USB device 'bus.addr'" },
|
||||||
|
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
|
||||||
|
command @code{info usb} to see the devices you can remove.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "cpu", "i", do_cpu_set,
|
||||||
|
"index", "set the default CPU" },
|
||||||
|
STEXI
|
||||||
|
Set the default CPU.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "mouse_move", "sss?", do_mouse_move,
|
||||||
|
"dx dy [dz]", "send mouse move events" },
|
||||||
|
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
|
||||||
|
|
||||||
|
{ "mouse_button", "i", do_mouse_button,
|
||||||
|
"state", "change mouse button state (1=L, 2=M, 4=R)" },
|
||||||
|
STEXI
|
||||||
|
@item mouse_button @var{val}
|
||||||
|
Change the active mouse button state @var{val} (1=L, 2=M, 4=R).
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "mouse_set", "i", do_mouse_set,
|
||||||
|
"index", "set which mouse device receives events" },
|
||||||
|
STEXI
|
||||||
|
@item mouse_set @var{index}
|
||||||
|
Set which mouse device receives events at given @var{index}, index
|
||||||
|
can be obtained with
|
||||||
|
@example
|
||||||
|
info mice
|
||||||
|
@end example
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
#ifdef HAS_AUDIO
|
||||||
|
{ "wavcapture", "si?i?i?", do_wav_capture,
|
||||||
|
"path [frequency [bits [channels]]]",
|
||||||
|
"capture audio to a wave file (default frequency=44100 bits=16 channels=2)" },
|
||||||
|
#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}.
|
||||||
|
|
||||||
|
Defaults:
|
||||||
|
@itemize @minus
|
||||||
|
@item Sample rate = 44100 Hz - CD quality
|
||||||
|
@item Bits = 16
|
||||||
|
@item Number of channels = 2 - Stereo
|
||||||
|
@end itemize
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
#ifdef HAS_AUDIO
|
||||||
|
{ "stopcapture", "i", do_stop_capture,
|
||||||
|
"capture index", "stop capture" },
|
||||||
|
#endif
|
||||||
|
STEXI
|
||||||
|
@item stopcapture @var{index}
|
||||||
|
Stop capture with a given @var{index}, index can be obtained with
|
||||||
|
@example
|
||||||
|
info capture
|
||||||
|
@end example
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "memsave", "lis", do_memory_save,
|
||||||
|
"addr size file", "save to disk virtual memory dump starting at 'addr' of size 'size'", },
|
||||||
|
STEXI
|
||||||
|
@item memsave @var{addr} @var{size} @var{file}
|
||||||
|
save to disk virtual memory dump starting at @var{addr} of size @var{size}.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "pmemsave", "lis", do_physical_memory_save,
|
||||||
|
"addr size file", "save to disk physical memory dump starting at 'addr' of size 'size'", },
|
||||||
|
STEXI
|
||||||
|
@item pmemsave @var{addr} @var{size} @var{file}
|
||||||
|
save to disk physical memory dump starting at @var{addr} of size @var{size}.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "boot_set", "s", do_boot_set,
|
||||||
|
"bootdevice", "define new values for the boot device list" },
|
||||||
|
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.
|
||||||
|
|
||||||
|
The values that can be specified here depend on the machine type, but are
|
||||||
|
the same that can be specified in the @code{-boot} command line option.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
#if defined(TARGET_I386)
|
||||||
|
{ "nmi", "i", do_inject_nmi,
|
||||||
|
"cpu", "inject an NMI on the given CPU", },
|
||||||
|
#endif
|
||||||
|
STEXI
|
||||||
|
@item nmi @var{cpu}
|
||||||
|
Inject an NMI on the given CPU (x86 only).
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "migrate", "-ds", do_migrate,
|
||||||
|
"[-d] uri", "migrate to URI (using -d to not wait for completion)" },
|
||||||
|
STEXI
|
||||||
|
@item migrate [-d] @var{uri}
|
||||||
|
Migrate to @var{uri} (using -d to not wait for completion).
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "migrate_cancel", "", do_migrate_cancel,
|
||||||
|
"", "cancel the current VM migration" },
|
||||||
|
STEXI
|
||||||
|
@item migrate_cancel
|
||||||
|
Cancel the current VM migration.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "migrate_set_speed", "s", do_migrate_set_speed,
|
||||||
|
"value", "set maximum speed (in bytes) for migrations" },
|
||||||
|
STEXI
|
||||||
|
@item migrate_set_speed @var{value}
|
||||||
|
Set maximum speed to @var{value} (in bytes) for migrations.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
#if defined(TARGET_I386)
|
||||||
|
{ "drive_add", "ss", drive_hot_add, "pci_addr=[[<domain>:]<bus>:]<slot>\n"
|
||||||
|
"[file=file][,if=type][,bus=n]\n"
|
||||||
|
"[,unit=m][,media=d][index=i]\n"
|
||||||
|
"[,cyls=c,heads=h,secs=s[,trans=t]]\n"
|
||||||
|
"[snapshot=on|off][,cache=on|off]",
|
||||||
|
"add drive to PCI storage controller" },
|
||||||
|
#endif
|
||||||
|
STEXI
|
||||||
|
@item drive_add
|
||||||
|
Add drive to PCI storage controller.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
#if defined(TARGET_I386)
|
||||||
|
{ "pci_add", "sss", pci_device_hot_add, "pci_addr=auto|[[<domain>:]<bus>:]<slot> nic|storage [[vlan=n][,macaddr=addr][,model=type]] [file=file][,if=type][,bus=nr]...", "hot-add PCI device" },
|
||||||
|
#endif
|
||||||
|
STEXI
|
||||||
|
@item pci_add
|
||||||
|
Hot-add PCI device.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
#if defined(TARGET_I386)
|
||||||
|
{ "pci_del", "s", pci_device_hot_remove, "pci_addr=[[<domain>:]<bus>:]<slot>", "hot remove PCI device" },
|
||||||
|
#endif
|
||||||
|
STEXI
|
||||||
|
@item pci_del
|
||||||
|
Hot remove PCI device.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "host_net_add", "ss?", net_host_device_add,
|
||||||
|
"tap|user|socket|vde|dump [options]", "add host VLAN client" },
|
||||||
|
STEXI
|
||||||
|
@item host_net_add
|
||||||
|
Add host VLAN client.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "host_net_remove", "is", net_host_device_remove,
|
||||||
|
"vlan_id name", "remove host VLAN client" },
|
||||||
|
STEXI
|
||||||
|
@item host_net_remove
|
||||||
|
Remove host VLAN client.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
#ifdef CONFIG_SLIRP
|
||||||
|
{ "host_net_redir", "ss?", net_slirp_redir,
|
||||||
|
"[tcp|udp]:host-port:[guest-host]:guest-port", "redirect TCP or UDP connections from host to guest (requires -net user)\n"
|
||||||
|
"host_net_redir remove [tcp:|udp:]host-port -- remove redirection\n"
|
||||||
|
"host_net_redir list -- show all redirections" },
|
||||||
|
#endif
|
||||||
|
STEXI
|
||||||
|
@item host_net_redir
|
||||||
|
Redirect TCP or UDP connections from host to guest (requires -net user).
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "balloon", "i", do_balloon,
|
||||||
|
"target", "request VM to change it's memory allocation (in MB)" },
|
||||||
|
STEXI
|
||||||
|
@item balloon @var{value}
|
||||||
|
Request VM to change its memory allocation to @var{value} (in MB).
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "set_link", "ss", do_set_link,
|
||||||
|
"name up|down", "change the link status of a network adapter" },
|
||||||
|
STEXI
|
||||||
|
@item set_link @var{name} [up|down]
|
||||||
|
Set link @var{name} up or down.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "watchdog_action", "s", do_watchdog_action,
|
||||||
|
"[reset|shutdown|poweroff|pause|debug|none]", "change watchdog action" },
|
||||||
|
STEXI
|
||||||
|
@item watchdog_action
|
||||||
|
Change watchdog action.
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
{ "acl", "sss?i?", do_acl, "<command> <aclname> [<match> [<index>]]\n",
|
||||||
|
"acl show vnc.username\n"
|
||||||
|
"acl policy vnc.username deny\n"
|
||||||
|
"acl allow vnc.username fred\n"
|
||||||
|
"acl deny vnc.username bob\n"
|
||||||
|
"acl reset vnc.username\n" },
|
||||||
|
STEXI
|
||||||
|
@item acl @var{subcommand} @var{aclname} @var{match} @var{index}
|
||||||
|
|
||||||
|
Manage access control lists for network services. There are currently
|
||||||
|
two named access control lists, @var{vnc.x509dname} and @var{vnc.username}
|
||||||
|
matching on the x509 client certificate distinguished name, and SASL
|
||||||
|
username respectively.
|
||||||
|
|
||||||
|
@table @option
|
||||||
|
@item acl show <aclname>
|
||||||
|
list all the match rules in the access control list, and the default
|
||||||
|
policy
|
||||||
|
@item acl policy <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}
|
||||||
|
@item acl allow <aclname> <match> [<index>]
|
||||||
|
add a match to the access control list, allowing access. The match will
|
||||||
|
normally be an exact username or x509 distinguished name, but can
|
||||||
|
optionally include wildcard globs. eg @code{*@@EXAMPLE.COM} to allow
|
||||||
|
all users in the @code{EXAMPLE.COM} kerberos realm. The match will
|
||||||
|
normally be appended to the end of the ACL, but can be inserted
|
||||||
|
earlier in the list if the optional @code{index} parameter is supplied.
|
||||||
|
@item acl deny <aclname> <match> [<index>]
|
||||||
|
add a match to the access control list, 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 allow
|
||||||
|
all users in the @code{EXAMPLE.COM} kerberos realm. The match will
|
||||||
|
normally be appended to the end of the ACL, but can be inserted
|
||||||
|
earlier in the list if the optional @code{index} parameter is supplied.
|
||||||
|
@item acl remove <aclname> <match>
|
||||||
|
remove the specified match rule from the access control list.
|
||||||
|
@item acl reset <aclname>
|
||||||
|
remove all matches from the access control list, and set the default
|
||||||
|
policy back to @code{deny}.
|
||||||
|
@end table
|
||||||
|
ETEXI
|
||||||
|
|
||||||
|
STEXI
|
||||||
|
@end table
|
||||||
|
ETEXI
|
||||||
Loading…
Reference in New Issue
Block a user