From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from eggs.gnu.org ([208.118.235.92]:37652)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <anthony@codemonkey.ws>) id 1SCGCp-00082v-S3
	for qemu-devel@nongnu.org; Mon, 26 Mar 2012 16:07:57 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <anthony@codemonkey.ws>) id 1SCGCn-00048P-JY
	for qemu-devel@nongnu.org; Mon, 26 Mar 2012 16:07:55 -0400
Received: from mail-gx0-f173.google.com ([209.85.161.173]:37185)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <anthony@codemonkey.ws>) id 1SCGCn-000487-Ew
	for qemu-devel@nongnu.org; Mon, 26 Mar 2012 16:07:53 -0400
Received: by ggnp2 with SMTP id p2so858082ggn.4
	for <qemu-devel@nongnu.org>; Mon, 26 Mar 2012 13:07:52 -0700 (PDT)
Message-ID: <4F70CC95.2010102@codemonkey.ws>
Date: Mon, 26 Mar 2012 15:07:49 -0500
From: Anthony Liguori <anthony@codemonkey.ws>
MIME-Version: 1.0
References: <e75eb36d-b680-4cb5-bf90-f95c2273f47c@zmail17.collab.prod.int.phx2.redhat.com>
	<20585aca-cce1-4305-9ef8-69e51321930c@zmail17.collab.prod.int.phx2.redhat.com>
	<20120314085310.GA4042@lws.brq.redhat.com>
	<20120315155744.GA1529@lws.brq.redhat.com>
	<20120321124654.GA1146@lws.brq.redhat.com>
In-Reply-To: <20120321124654.GA1146@lws.brq.redhat.com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Subject: Re: [Qemu-devel] [PATCH v4] Man page: Add -global description
List-Id: <qemu-devel.nongnu.org>
List-Unsubscribe: <https://lists.nongnu.org/mailman/options/qemu-devel>,
	<mailto:qemu-devel-request@nongnu.org?subject=unsubscribe>
List-Archive: <http://lists.nongnu.org/archive/html/qemu-devel>
List-Post: <mailto:qemu-devel@nongnu.org>
List-Help: <mailto:qemu-devel-request@nongnu.org?subject=help>
List-Subscribe: <https://lists.nongnu.org/mailman/listinfo/qemu-devel>,
	<mailto:qemu-devel-request@nongnu.org?subject=subscribe>
To: Miroslav Rezanina <mrezanin@redhat.com>
Cc: qemu-devel@nongnu.org

On 03/21/2012 07:46 AM, Miroslav Rezanina wrote:
> 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<mrezanin@redhat.com>

Applied.  Thanks.

Regards,

Anthony Liguori

>
> 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,
>
>