From patchwork Wed Mar 21 12:46:54 2012 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Miroslav Rezanina X-Patchwork-Id: 147976 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.gnu.org (lists.gnu.org [208.118.235.17]) (using TLSv1 with cipher AES256-SHA (256/256 bits)) (Client did not present a certificate) by ozlabs.org (Postfix) with ESMTPS id E47A9B6F13 for ; Wed, 21 Mar 2012 23:47:22 +1100 (EST) Received: from localhost ([::1]:49603 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SAKwi-0006xf-QE for incoming@patchwork.ozlabs.org; Wed, 21 Mar 2012 08:47:20 -0400 Received: from eggs.gnu.org ([208.118.235.92]:34400) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SAKwW-0006x2-4h for qemu-devel@nongnu.org; Wed, 21 Mar 2012 08:47:13 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SAKwP-0002Qt-V0 for qemu-devel@nongnu.org; Wed, 21 Mar 2012 08:47:07 -0400 Received: from mx1.redhat.com ([209.132.183.28]:65250) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SAKwP-0002Qg-Mj for qemu-devel@nongnu.org; Wed, 21 Mar 2012 08:47:01 -0400 Received: from int-mx12.intmail.prod.int.phx2.redhat.com (int-mx12.intmail.prod.int.phx2.redhat.com [10.5.11.25]) by mx1.redhat.com (8.14.4/8.14.4) with ESMTP id q2LCkx6P023554 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Wed, 21 Mar 2012 08:46:59 -0400 Received: from mailreader.lws.brq.redhat.com (ovpn-112-30.ams2.redhat.com [10.36.112.30]) by int-mx12.intmail.prod.int.phx2.redhat.com (8.14.4/8.14.4) with ESMTP id q2LCkvmg013442 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Wed, 21 Mar 2012 08:46:59 -0400 Received: from mailreader.lws.brq.redhat.com (localhost [127.0.0.1]) by mailreader.lws.brq.redhat.com (8.14.5/8.14.5) with ESMTP id q2LCkt8W001358 for ; Wed, 21 Mar 2012 13:46:55 +0100 Received: (from mrezanin@localhost) by mailreader.lws.brq.redhat.com (8.14.5/8.14.5/Submit) id q2LCks5f001357 for qemu-devel@nongnu.org; Wed, 21 Mar 2012 13:46:54 +0100 X-Authentication-Warning: mailreader.lws.brq.redhat.com: mrezanin set sender to mrezanin@redhat.com using -f Date: Wed, 21 Mar 2012 13:46:54 +0100 From: Miroslav Rezanina To: qemu-devel@nongnu.org Message-ID: <20120321124654.GA1146@lws.brq.redhat.com> References: <20585aca-cce1-4305-9ef8-69e51321930c@zmail17.collab.prod.int.phx2.redhat.com> <20120314085310.GA4042@lws.brq.redhat.com> <20120315155744.GA1529@lws.brq.redhat.com> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: <20120315155744.GA1529@lws.brq.redhat.com> User-Agent: Mutt/1.5.19 (2009-01-05) X-Scanned-By: MIMEDefang 2.68 on 10.5.11.25 X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 209.132.183.28 Subject: [Qemu-devel] [PATCH v4] Man page: Add -global description X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org Sender: qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org There's only TODO information in qemu man page for -global option. This is a basic description of this option with simple example. Signed-off-by: Miroslav Rezanina v4: - break long line v3: - add use case description - use prop instead of property v2: - Use better value in example Patch: diff --git a/qemu-options.hx b/qemu-options.hx index daefce3..662f571 100644 --- a/qemu-options.hx +++ b/qemu-options.hx @@ -288,13 +288,21 @@ TODO ETEXI DEF("global", HAS_ARG, QEMU_OPTION_global, - "-global driver.property=value\n" + "-global driver.prop=value\n" " set a global default for a driver property\n", QEMU_ARCH_ALL) STEXI -@item -global +@item -global @var{driver}.@var{prop}=@var{value} @findex -global -TODO +Set default value of @var{driver}'s property @var{prop} to @var{value}, e.g.: + +@example +qemu -global ide-drive.physical_block_size=4096 -drive file=file,if=ide,index=0,media=disk +@end example + +In particular, you can use this to set driver properties for devices which are +created automatically by the machine model. To create a device which is not +created automatically and set properties on it, use -@option{device}. ETEXI DEF("mtdblock", HAS_ARG, QEMU_OPTION_mtdblock,