From patchwork Fri Feb 5 22:52:04 2010 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stefan Weil X-Patchwork-Id: 44682 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (Client did not present a certificate) by ozlabs.org (Postfix) with ESMTPS id C0D5CB7D2A for ; Sat, 6 Feb 2010 09:59:38 +1100 (EST) Received: from localhost ([127.0.0.1]:56866 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NdX9D-0006yC-1h for incoming@patchwork.ozlabs.org; Fri, 05 Feb 2010 17:59:35 -0500 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1NdX2M-00057q-W0 for qemu-devel@nongnu.org; Fri, 05 Feb 2010 17:52:31 -0500 Received: from [199.232.76.173] (port=43894 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NdX2M-00057M-87 for qemu-devel@nongnu.org; Fri, 05 Feb 2010 17:52:30 -0500 Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1NdX2F-0003l5-0r for qemu-devel@nongnu.org; Fri, 05 Feb 2010 17:52:28 -0500 Received: from moutng.kundenserver.de ([212.227.126.187]:53056) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1NdX2D-0003kR-CA for qemu-devel@nongnu.org; Fri, 05 Feb 2010 17:52:21 -0500 Received: from flocke.weilnetz.de (p54ADF5AF.dip.t-dialin.net [84.173.245.175]) by mrelayeu.kundenserver.de (node=mreu0) with ESMTP (Nemesis) id 0LaYbD-1O1IWi2zux-00lhB3; Fri, 05 Feb 2010 23:52:20 +0100 Received: from stefan by flocke.weilnetz.de with local (Exim 4.71) (envelope-from ) id 1NdX2A-0004I5-SS; Fri, 05 Feb 2010 23:52:18 +0100 From: Stefan Weil To: QEMU Developers Date: Fri, 5 Feb 2010 23:52:04 +0100 Message-Id: <1265410325-16433-7-git-send-email-weil@mail.berlios.de> X-Mailer: git-send-email 1.6.5 In-Reply-To: <1265410325-16433-6-git-send-email-weil@mail.berlios.de> References: <4B6CA0A4.7090505@mail.berlios.de> <1265410325-16433-1-git-send-email-weil@mail.berlios.de> <1265410325-16433-2-git-send-email-weil@mail.berlios.de> <1265410325-16433-3-git-send-email-weil@mail.berlios.de> <1265410325-16433-4-git-send-email-weil@mail.berlios.de> <1265410325-16433-5-git-send-email-weil@mail.berlios.de> <1265410325-16433-6-git-send-email-weil@mail.berlios.de> X-Provags-ID: V01U2FsdGVkX18+S6YMdADK/ov8XFLbyR3zADjBJXmKJ5aXMwy RfK9TR/YFZu5cqMNCjLUeJNIeyrkibsQIdBrVwIRWt1crQq4Sa jCgs5wrd5ymNl4AuhfuinfL7FtKJViw7Lqex5AFUNce9TxTZQv 4bQ== X-detected-operating-system: by monty-python.gnu.org: Genre and OS details not recognized. Cc: Subject: [Qemu-devel] [PATCH 7/8] Documentation: Add monitor commands to function index X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: qemu-devel.nongnu.org List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org Errors-To: qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org * Add monitor commands to function index. * Fix description for acl_remove. Signed-off-by: Stefan Weil --- qemu-monitor.hx | 62 ++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 files changed, 61 insertions(+), 1 deletions(-) diff --git a/qemu-monitor.hx b/qemu-monitor.hx index e5bff8e..cf9e430 100644 --- a/qemu-monitor.hx +++ b/qemu-monitor.hx @@ -19,6 +19,7 @@ ETEXI STEXI @item help or ? [@var{cmd}] +@findex help Show the help for all commands or just for command @var{cmd}. ETEXI @@ -32,6 +33,7 @@ ETEXI STEXI @item commit +@findex commit Commit changes to the disk images (if -snapshot is used) or backing files. ETEXI @@ -46,6 +48,7 @@ ETEXI STEXI @item info @var{subcommand} +@findex info Show various information about the system state. @table @option @@ -125,6 +128,7 @@ ETEXI STEXI @item q or quit +@findex quit Quit the emulator. ETEXI @@ -139,6 +143,7 @@ ETEXI STEXI @item eject [-f] @var{device} +@findex eject Eject a removable medium (use -f to force it). ETEXI @@ -153,6 +158,7 @@ ETEXI STEXI @item change @var{device} @var{setting} +@findex change Change the configuration of a device. @@ -198,6 +204,7 @@ ETEXI STEXI @item screendump @var{filename} +@findex screendump Save screen into PPM image @var{filename}. ETEXI @@ -211,6 +218,7 @@ ETEXI STEXI @item logfile @var{filename} +@findex logfile Output logs to @var{filename}. ETEXI @@ -224,6 +232,7 @@ ETEXI STEXI @item log @var{item1}[,...] +@findex log Activate logging of the specified items to @file{/tmp/qemu.log}. ETEXI @@ -237,6 +246,7 @@ ETEXI STEXI @item savevm [@var{tag}|@var{id}] +@findex savevm 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 @@ -253,6 +263,7 @@ ETEXI STEXI @item loadvm @var{tag}|@var{id} +@findex loadvm Set the whole virtual machine to the snapshot identified by the tag @var{tag} or the unique snapshot ID @var{id}. ETEXI @@ -267,6 +278,7 @@ ETEXI STEXI @item delvm @var{tag}|@var{id} +@findex delvm Delete the snapshot identified by @var{tag} or @var{id}. ETEXI @@ -280,6 +292,7 @@ ETEXI STEXI @item singlestep [off] +@findex singlestep Run the emulation in single step mode. If called with option off, the emulation returns to normal mode. ETEXI @@ -295,6 +308,7 @@ ETEXI STEXI @item stop +@findex stop Stop emulation. ETEXI @@ -309,6 +323,7 @@ ETEXI STEXI @item c or cont +@findex cont Resume emulation. ETEXI @@ -322,6 +337,7 @@ ETEXI STEXI @item gdbserver [@var{port}] +@findex gdbserver Start gdbserver session (default @var{port}=1234) ETEXI @@ -335,6 +351,7 @@ ETEXI STEXI @item x/fmt @var{addr} +@findex x Virtual memory dump starting at @var{addr}. ETEXI @@ -348,6 +365,7 @@ ETEXI STEXI @item xp /@var{fmt} @var{addr} +@findex xp Physical memory dump starting at @var{addr}. @var{fmt} is a format which tells the command how to format the @@ -355,13 +373,16 @@ data. Its syntax is: @option{/@{count@}@{format@}@{size@}} @table @var @item count +@findex count is the number of items to be dumped. @item format +@findex format can be x (hex), d (signed decimal), u (unsigned decimal), o (octal), c (char) or i (asm instruction). @item size +@findex 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. @@ -414,6 +435,7 @@ ETEXI STEXI @item p or print/@var{fmt} @var{expr} +@findex print Print expression value. Only the @var{format} part of @var{fmt} is used. @@ -453,6 +475,7 @@ ETEXI STEXI @item sendkey @var{keys} +@findex sendkey 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 @@ -476,6 +499,7 @@ ETEXI STEXI @item system_reset +@findex system_reset Reset the system. ETEXI @@ -491,6 +515,7 @@ ETEXI STEXI @item system_powerdown +@findex system_powerdown Power down the system (if supported). ETEXI @@ -505,6 +530,7 @@ ETEXI STEXI @item sum @var{addr} @var{size} +@findex sum Compute the checksum of a memory region. ETEXI @@ -519,6 +545,7 @@ ETEXI STEXI @item usb_add @var{devname} +@findex usb_add Add the USB device @var{devname}. For details of available devices see @ref{usb_devices} @@ -534,6 +561,7 @@ ETEXI STEXI @item usb_del @var{devname} +@findex usb_del Remove the USB device @var{devname} from the QEMU virtual USB hub. @var{devname} has the syntax @code{bus.addr}. Use the monitor @@ -550,6 +578,7 @@ ETEXI STEXI @item device_add @var{config} +@findex device_add Add device. ETEXI @@ -564,6 +593,7 @@ ETEXI STEXI @item device_del @var{id} +@findex device_del Remove device @var{id}. ETEXI @@ -591,6 +621,7 @@ ETEXI STEXI @item mouse_move @var{dx} @var{dy} [@var{dz}] +@findex mouse_move Move the active mouse to the specified coordinates @var{dx} @var{dy} with optional scroll axis @var{dz}. ETEXI @@ -605,6 +636,7 @@ ETEXI STEXI @item mouse_button @var{val} +@findex mouse_button Change the active mouse button state @var{val} (1=L, 2=M, 4=R). ETEXI @@ -618,6 +650,7 @@ ETEXI STEXI @item mouse_set @var{index} +@findex mouse_set Set which mouse device receives events at given @var{index}, index can be obtained with @example @@ -636,6 +669,7 @@ ETEXI #endif STEXI @item wavcapture @var{filename} [@var{frequency} [@var{bits} [@var{channels}]]] +@findex wavcapture Capture audio into @var{filename}. Using sample rate @var{frequency} bits per sample @var{bits} and number of channels @var{channels}. @@ -658,6 +692,7 @@ ETEXI #endif STEXI @item stopcapture @var{index} +@findex stopcapture Stop capture with a given @var{index}, index can be obtained with @example info capture @@ -675,6 +710,7 @@ ETEXI STEXI @item memsave @var{addr} @var{size} @var{file} +@findex memsave save to disk virtual memory dump starting at @var{addr} of size @var{size}. ETEXI @@ -689,6 +725,7 @@ ETEXI STEXI @item pmemsave @var{addr} @var{size} @var{file} +@findex pmemsave save to disk physical memory dump starting at @var{addr} of size @var{size}. ETEXI @@ -702,6 +739,7 @@ ETEXI STEXI @item boot_set @var{bootdevicelist} +@findex boot_set Define new values for the boot device list. Those values will override the values specified on the command line through the @code{-boot} option. @@ -721,6 +759,7 @@ ETEXI #endif STEXI @item nmi @var{cpu} +@findex nmi Inject an NMI on the given CPU (x86 only). ETEXI @@ -740,6 +779,7 @@ ETEXI STEXI @item migrate [-d] [-b] [-i] @var{uri} +@findex migrate 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) @@ -756,6 +796,7 @@ ETEXI STEXI @item migrate_cancel +@findex migrate_cancel Cancel the current VM migration. ETEXI @@ -770,6 +811,7 @@ ETEXI STEXI @item migrate_set_speed @var{value} +@findex migrate_set_speed Set maximum speed to @var{value} (in bytes) for migrations. ETEXI @@ -784,6 +826,7 @@ ETEXI STEXI @item migrate_set_downtime @var{second} +@findex migrate_set_downtime Set maximum tolerated downtime (in seconds) for migration. ETEXI @@ -803,6 +846,7 @@ ETEXI STEXI @item drive_add +@findex drive_add Add drive to PCI storage controller. ETEXI @@ -819,6 +863,7 @@ ETEXI STEXI @item pci_add +@findex pci_add Hot-add PCI device. ETEXI @@ -835,6 +880,7 @@ ETEXI STEXI @item pci_del +@findex pci_del Hot remove PCI device. ETEXI @@ -848,6 +894,7 @@ ETEXI STEXI @item host_net_add +@findex host_net_add Add host VLAN client. ETEXI @@ -861,6 +908,7 @@ ETEXI STEXI @item host_net_remove +@findex host_net_remove Remove host VLAN client. ETEXI @@ -884,6 +932,7 @@ ETEXI #endif STEXI @item host_net_redir +@findex host_net_redir Redirect TCP or UDP connections from host to guest (requires -net user). ETEXI @@ -899,6 +948,7 @@ ETEXI STEXI @item balloon @var{value} +@findex balloon Request VM to change its memory allocation to @var{value} (in MB). ETEXI @@ -912,6 +962,7 @@ ETEXI STEXI @item set_link @var{name} [up|down] +@findex set_link Set link @var{name} up or down. ETEXI @@ -925,6 +976,7 @@ ETEXI STEXI @item watchdog_action +@findex watchdog_action Change watchdog action. ETEXI @@ -938,6 +990,7 @@ ETEXI STEXI @item acl_show @var{aclname} +@findex acl_show 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 @@ -954,6 +1007,7 @@ ETEXI STEXI @item acl_policy @var{aclname} @code{allow|deny} +@findex acl_policy 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}. @@ -969,6 +1023,7 @@ ETEXI STEXI @item acl_allow @var{aclname} @var{match} @code{allow|deny} [@var{index}] +@findex acl_allow 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 @@ -987,6 +1042,7 @@ ETEXI STEXI @item acl_remove @var{aclname} @var{match} +@findex acl_remove Remove the specified match rule from the access control list. ETEXI @@ -999,7 +1055,7 @@ ETEXI }, STEXI -@item acl_remove @var{aclname} @var{match} +@item acl_remove @var{aclname} Remove all matches from the access control list, and set the default policy back to @code{deny}. ETEXI @@ -1017,6 +1073,7 @@ ETEXI #endif STEXI @item mce @var{cpu} @var{bank} @var{status} @var{mcgstatus} @var{addr} @var{misc} +@findex mce (x86) Inject an MCE on the given CPU (x86 only). ETEXI @@ -1031,6 +1088,7 @@ ETEXI STEXI @item getfd @var{fdname} +@findex getfd 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. @@ -1047,6 +1105,7 @@ ETEXI STEXI @item closefd @var{fdname} +@findex closefd 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. @@ -1063,6 +1122,7 @@ ETEXI STEXI @item block_passwd @var{device} @var{password} +@findex block_passwd Set the encrypted device @var{device} password to @var{password} ETEXI