From patchwork Wed Jun 30 14:52:58 2010 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Miguel Di Ciurcio Filho X-Patchwork-Id: 57416 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 45DADB6EED for ; Thu, 1 Jul 2010 00:57:15 +1000 (EST) Received: from localhost ([127.0.0.1]:36005 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OTyiu-0005oD-5O for incoming@patchwork.ozlabs.org; Wed, 30 Jun 2010 10:57:12 -0400 Received: from [140.186.70.92] (port=52458 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OTyfM-0004JD-Ml for qemu-devel@nongnu.org; Wed, 30 Jun 2010 10:53:44 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OTyfD-0007C7-Pj for qemu-devel@nongnu.org; Wed, 30 Jun 2010 10:53:31 -0400 Received: from mail-gw0-f45.google.com ([74.125.83.45]:33381) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OTyfD-0007Br-MY for qemu-devel@nongnu.org; Wed, 30 Jun 2010 10:53:23 -0400 Received: by gwj20 with SMTP id 20so471827gwj.4 for ; Wed, 30 Jun 2010 07:53:23 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:from:to:cc:subject:date :message-id:x-mailer:in-reply-to:references; bh=CfKMbET7qiWuOGZep4PgeY4jc9vqog4bZp1tzhYA3jc=; b=liQpC2SDzrxsQW4/Nxl4Sk69CfPaSwDw3cPShz+4+RPWOLsoeIOSWQBT199NCnFjWQ p89hPPoSg7waqRvdgCSqbWdzsPS8nzLi+UYhxz8PJXBgU+Jp2+mocDsjhSeh7e81CQ/e QTm25u4fJzHN0p2ATJp/ULo4s46ARXd7utROg= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=from:to:cc:subject:date:message-id:x-mailer:in-reply-to:references; b=GTxPF5fnQUUBjcHNxsb63MyH9NOQh33fiw3jsYaKq9UnW/Tl//UvpSMW+wwHfCuu/D D+uTjlLiTCp1hjp56KtjwsoilNlbR5NcjetmeG4cg0TrnyU372A9FGtJavRwfXPBsMCV lDi6qP3Lkq+9Q2yNhEAO0i3qHBSZD6MKNUlac= Received: by 10.100.54.29 with SMTP id c29mr10808428ana.189.1277909597514; Wed, 30 Jun 2010 07:53:17 -0700 (PDT) Received: from localhost.localdomain (curitiba.ic.unicamp.br [143.106.7.130]) by mx.google.com with ESMTPS id t5sm38169951ani.25.2010.06.30.07.53.15 (version=TLSv1/SSLv3 cipher=RC4-MD5); Wed, 30 Jun 2010 07:53:16 -0700 (PDT) From: Miguel Di Ciurcio Filho To: qemu-devel@nongnu.org Date: Wed, 30 Jun 2010 11:52:58 -0300 Message-Id: <1277909584-13012-2-git-send-email-miguel.filho@gmail.com> X-Mailer: git-send-email 1.7.1 In-Reply-To: <1277909584-13012-1-git-send-email-miguel.filho@gmail.com> References: <1277909584-13012-1-git-send-email-miguel.filho@gmail.com> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) Cc: avi@redhat.com, Miguel Di Ciurcio Filho , armbru@redhat.com, lcapitulino@redhat.com Subject: [Qemu-devel] [PATCH v2 1/7] QMP: Introduce the documentation for query-netdev and info netdev 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 These commands show the information about active backend network devices. Signed-off-by: Miguel Di Ciurcio Filho --- qemu-monitor.hx | 100 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 files changed, 100 insertions(+), 0 deletions(-) diff --git a/qemu-monitor.hx b/qemu-monitor.hx index 9f62b94..330d7a6 100644 --- a/qemu-monitor.hx +++ b/qemu-monitor.hx @@ -1674,6 +1674,106 @@ 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 contains the following: + +- "id": the device's ID, must be unique (json-string) +- "type": device type (json-string) + - Possible values: "tap", "user", "vde" +- "peer": ID of the frontend guest device, if not available means that this + netdev is not connected to a guest device yet (json-string, optional) +- "info": json-object containing the configuration information about the device. + - When "type" is "tap", the following values might be available: + - "fd": available if connected to an already opened TAP interface + (json-int, optional) + - "script": path to an script used to configure the interface, + available only if an script is used. (json-string, optional, only + present if "fd" is not present) + - "downscript": path to an script used to deconfigure the interface, + available only if an script is used. (json-string, optional, only + present if "fd" is not present) + - "ifname": name of the attached host interface (json-string, only + present if "fd" is not present) + - "vhost": vhost acceleration status, true if enabled, false + otherwise (json-boolean) + - "vnet_hdr": true if the IFF_VNET_HDR flag must be set and is in + use, false otherwise (json-boolean) + - "vhostfd": fd used to connect the device to an already opened + vhost net device (json-int, optional) + - When "type" is "vde", the following values might be available: + - "sock": path to the VDE listening socket (json-string) + - "port": port number connected to virtual switch (json-int) + - "mode": permission mode, in octal (json-int) + - "group": group name (json-string, optional) + - When "type" is "user", the following values might be available: + - "hostname": client hostname reported by the builtin DHCP server, + (json-string, optional) + - "restrict": true if guest is isolated from the host, + false otherwise (json-boolean) + - "net": network address (json-string) + - "netmask": netmask (json-string) + - "host": guest-visible address of the host (json-string) + - "tftp": root directory of the built-in TFTP server (json-string, + optional) + - "bootfile": BOOTP filename (json-string, optional) + - "dhcpstart": the first of the 16 IPs the built-in DHCP server can + assign (json-string) + - "dns": guest-visible address of the virtual nameserver + (json-string) + - "smb": root directory of the built-in SMB server (json-string, + optional) + - "smbserver": IP address of the built-in SMB server (json-string, + optional) + - "hostfwd": guest port number to forward incoming TCP or UDP + connections (json-int, optional) + - "guestfwd": IP address and port to forward guest TCP connections + (json-int, optional) + +Example: + +-> { "execute": "query-netdev" } +<- { + "return": [ + { + "id": "tap.0", + "type": "tap", + "peer": "virtio-net-pci.0", + "info": { + "script": "/etc/qemu-ifup", + "downscript": "/etc/qemu-ifdown", + "ifname": "tap0", + "vnet_hdr": false, + "vhost": true + }, + }, + { + "id": "user.0", + "type": "user", + "peer": "e1000.0", + "info": { + "restrict": false, + "net": "10.0.2.0", + "netmask": "255.255.255.0", + "host": 10.0.2.2", + "dhcpstart": "10.2.0.15", + "dns": "10.0.2.3" + }, + }, + ] + } + +EQMP + +STEXI @item info chardev show the character devices ETEXI