[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
signature.asc
Description: OpenPGP digital signature