qemu-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [Qemu-devel] [PATCH 2/3] doc: Document generic -blockdev options


From: Eric Blake
Subject: Re: [Qemu-devel] [PATCH 2/3] doc: Document generic -blockdev options
Date: Thu, 22 Sep 2016 13:56:52 -0500
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101 Thunderbird/45.3.0

On 09/22/2016 10:42 AM, Kevin Wolf wrote:
> This adds documentation for the -blockdev options that apply to all
> nodes independent of the block driver used.
> 
> All options that are shared by -blockdev and -drive are now explained in
> the section for -blockdev. The documentation of -drive mentions that all
> -blockdev options are accepted as well.
> 
> Signed-off-by: Kevin Wolf <address@hidden>
> ---
>  qemu-options.hx | 98 
> ++++++++++++++++++++++++++++++++++++++++-----------------
>  1 file changed, 69 insertions(+), 29 deletions(-)
> 

>  @item address@hidden
> address@hidden is "none", "writeback", "unsafe", "directsync" or 
> "writethrough" and controls how the host cache is used to access block data.
> address@hidden is "none", "writeback", "unsafe", "directsync" or 
> "writethrough"
> +and controls how the host cache is used to access block data. This is a
> +shortcut that sets the @option{cache.direct} and @option{cache.no-flush}
> +options (as in @option{-blockdev}), and additionally 
> @option{cache.writeback},
> +which provides a default for the @option{write-cache} option of block guest
> +devices (as in @option{-device}). The modes correspond to the following
> +settings:
> +
> address@hidden Our texi2pod.pl script doesn't support @multitable, so fall 
> back to using
> address@hidden plain ASCII art (well, UTF-8 art really). This looks okay both 
> in the manpage
> address@hidden and the HTML output.
> address@hidden
> +@             │ cache.writeback   cache.direct   cache.no-flush
> +─────────────┼─────────────────────────────────────────────────
> +writeback    │ on                off            off
> +none         │ on                on             off
> +writethrough │ off               off            off
> +directsync   │ off               on             off
> +unsafe       │ on                off            on
> address@hidden example

Nice table.

Reviewed-by: Eric Blake <address@hidden>

-- 
Eric Blake   eblake redhat com    +1-919-301-3266
Libvirt virtualization library http://libvirt.org

Attachment: signature.asc
Description: OpenPGP digital signature


reply via email to

[Prev in Thread] Current Thread [Next in Thread]