From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([2001:4830:134:3::10]:59701) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bn9BC-00089X-JB for qemu-devel@nongnu.org; Thu, 22 Sep 2016 14:57:09 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bn9B5-0006CQ-TY for qemu-devel@nongnu.org; Thu, 22 Sep 2016 14:57:05 -0400 References: <1474558931-8968-1-git-send-email-kwolf@redhat.com> <1474558931-8968-3-git-send-email-kwolf@redhat.com> From: Eric Blake Message-ID: <9db37d0c-4fc8-55dc-82ba-07832ee45539@redhat.com> Date: Thu, 22 Sep 2016 13:56:52 -0500 MIME-Version: 1.0 In-Reply-To: <1474558931-8968-3-git-send-email-kwolf@redhat.com> Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="ivcaSClCa1NlfUvUIdL9DsnmgBpxRQa91" Subject: Re: [Qemu-devel] [PATCH 2/3] doc: Document generic -blockdev options List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Kevin Wolf , qemu-block@nongnu.org Cc: armbru@redhat.com, mreitz@redhat.com, berrange@redhat.com, qemu-devel@nongnu.org This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --ivcaSClCa1NlfUvUIdL9DsnmgBpxRQa91 From: Eric Blake To: Kevin Wolf , qemu-block@nongnu.org Cc: armbru@redhat.com, mreitz@redhat.com, berrange@redhat.com, qemu-devel@nongnu.org Message-ID: <9db37d0c-4fc8-55dc-82ba-07832ee45539@redhat.com> Subject: Re: [PATCH 2/3] doc: Document generic -blockdev options References: <1474558931-8968-1-git-send-email-kwolf@redhat.com> <1474558931-8968-3-git-send-email-kwolf@redhat.com> In-Reply-To: <1474558931-8968-3-git-send-email-kwolf@redhat.com> Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable 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. >=20 > All options that are shared by -blockdev and -drive are now explained i= n > the section for -blockdev. The documentation of -drive mentions that al= l > -blockdev options are accepted as well. >=20 > Signed-off-by: Kevin Wolf > --- > qemu-options.hx | 98 ++++++++++++++++++++++++++++++++++++++++---------= -------- > 1 file changed, 69 insertions(+), 29 deletions(-) >=20 > @item cache=3D@var{cache} > -@var{cache} is "none", "writeback", "unsafe", "directsync" or "writeth= rough" and controls how the host cache is used to access block data. > +@var{cache} is "none", "writeback", "unsafe", "directsync" or "writeth= rough" > +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-flus= h} > +options (as in @option{-blockdev}), and additionally @option{cache.wri= teback}, > +which provides a default for the @option{write-cache} option of block = guest > +devices (as in @option{-device}). The modes correspond to the followin= g > +settings: > + > +@c Our texi2pod.pl script doesn't support @multitable, so fall back to= using > +@c plain ASCII art (well, UTF-8 art really). This looks okay both in t= he manpage > +@c and the HTML output. > +@example > +@ =E2=94=82 cache.writeback cache.direct cache.no-flus= h > +=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=BC=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80 > +writeback =E2=94=82 on off off > +none =E2=94=82 on on off > +writethrough =E2=94=82 off off off > +directsync =E2=94=82 off on off > +unsafe =E2=94=82 on off on > +@end example Nice table. Reviewed-by: Eric Blake --=20 Eric Blake eblake redhat com +1-919-301-3266 Libvirt virtualization library http://libvirt.org --ivcaSClCa1NlfUvUIdL9DsnmgBpxRQa91 Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v2 Comment: Public key at http://people.redhat.com/eblake/eblake.gpg Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/ iQEcBAEBCAAGBQJX5Cl1AAoJEKeha0olJ0NqY9cIAI7dTh3pSZ8PzvWLi3IUnbNP Tc9jK/QeVp29TmxE5jYkrQVl3DD4ssTEOAGiXuXaV8qRYIARbMXtik/G/MpdrADE UVP4t2J3TngVduNM89nK8fVpwvekECKJrj87K7f9FIiGvQiXjOl+nC4/W9AoztCX wz+iKivPgsAbNuMU2DzYaXGdSjEWXQ8w26y31bXSvjeZMZOlbqkh96CR8H+w9t+i cX+aiAO7/oA3QTjGYAmSjsWNWRrIBv+8zlZmX9xZIKwRWQdro+2R6LM3hvkHA8uB p0P73xIx1a0fbNrcOWarIwLntHWEXwRA0q9uEvpVE9dV/5OXcC0eawW7XH/FEY0= =vrrI -----END PGP SIGNATURE----- --ivcaSClCa1NlfUvUIdL9DsnmgBpxRQa91--