From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from [140.186.70.92] (port=59335 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OMpSR-0000OP-Fe for qemu-devel@nongnu.org; Thu, 10 Jun 2010 17:38:40 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OMpSQ-0004eP-3t for qemu-devel@nongnu.org; Thu, 10 Jun 2010 17:38:39 -0400 Received: from mail-gy0-f173.google.com ([209.85.160.173]:57937) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OMpSQ-0004eH-1M for qemu-devel@nongnu.org; Thu, 10 Jun 2010 17:38:38 -0400 Received: by gyd5 with SMTP id 5so335726gyd.4 for ; Thu, 10 Jun 2010 14:38:37 -0700 (PDT) From: Miguel Di Ciurcio Filho Date: Thu, 10 Jun 2010 18:36:59 -0300 Message-Id: <1276205825-1922-3-git-send-email-miguel.filho@gmail.com> In-Reply-To: <1276205825-1922-1-git-send-email-miguel.filho@gmail.com> References: <1276205825-1922-1-git-send-email-miguel.filho@gmail.com> Subject: [Qemu-devel] [PATCH 2/8] QMP: Introduce the documentation for query-netdev and info netdev List-Id: qemu-devel.nongnu.org List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: qemu-devel@nongnu.org Cc: armbru@redhat.com, lcapitulino@redhat.com, Miguel Di Ciurcio Filho , avi@redhat.com These commands show the information about active backend network devices. Signed-off-by: Miguel Di Ciurcio Filho --- qemu-monitor.hx | 53 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 files changed, 53 insertions(+), 0 deletions(-) diff --git a/qemu-monitor.hx b/qemu-monitor.hx index f6a94f2..14a0ba1 100644 --- a/qemu-monitor.hx +++ b/qemu-monitor.hx @@ -1674,6 +1674,59 @@ show the various VLANs and the associated devices ETEXI STEXI +@item info netdev +show information about the current backend network devices +ETEXI +SQMP +query-netdev +---------------- + +Each device is represented by a json-object. The returned value is a json-array +of all devices. + +Each json-object contain the following: + +- "id": the device's ID, must be unique (json-string) +- "vlan": QEMU's internal vlan identification. Only present if the device is + attached to a VLAN (json-int, optional) +- "peer": ID of the frontend device when on a 1:1 relationship (json-string, + optional) +- "info": json-object containing the configuration information about the device. + +Note: The supported device information is the same one supported by the '-net' +command-line argument, which are listed in the '-help' output or QEMU's manual. + +Example: + +-> { "execute": "query-netdev" } +<- { + "return": [ + { + "id": "tap.0", + "type": "tap", + "vlan": 0, + "info": { + "script": "/etc/qemu-ifup", + "downscript": "/etc/qemu-ifdown", + "ifname": "tap0", + "vhost": true + }, + }, + { + "id": "user.0", + "type": "user", + "peer": "e1000.0", + "info": { + "net": "10.0.2.0", + "netmask": "255.255.255.0" + }, + }, + ] + } + +EQMP + +STEXI @item info chardev show the character devices ETEXI -- 1.7.1