Re: [Qemu-devel] [PATCH v4] Man page: Add -global description

[Markus Armbruster]

Miroslav Rezanina <address@hidden> writes:

> 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 <address@hidden>
>
> 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
> address@hidden -global
> address@hidden -global @address@hidden@var{value}
>  @findex -global
> -TODO
> +Set default value of @var{driver}'s property @var{prop} to @var{value}, e.g.:
> +
> address@hidden
> +qemu -global ide-drive.physical_block_size=4096 -drive 
> file=file,if=ide,index=0,media=disk
> address@hidden 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 address@hidden
>  ETEXI
>  
>  DEF("mtdblock", HAS_ARG, QEMU_OPTION_mtdblock,

This is a clear improvement.  Cc'ing Anthony, the qdev maintainer in all
but name ;)