Am 22.09.2016 um 21:02 hat Eric Blake geschrieben:
> On 09/22/2016 10:42 AM, Kevin Wolf wrote:
> > This documents the driver-specific options for the raw, qcow2 and file
> > block drivers for the man page. For everything else, we refer to the
> > QAPI documentation.
> >
> > Signed-off-by: Kevin Wolf <kw...@redhat.com>
> > ---
> > qemu-options.hx | 62
> > +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > 1 file changed, 62 insertions(+)
> >
>
> >
> > +@item Driver-specific options for @code{file}
> > +@table @code
> > +@item filename
> > +The path to the image file in the local filesystem
> > +@item aio
> > +Specifies the AIO backend (threads/native, default: threads)
> > +@end table
> > +
> > +@item Driver-specific options for @code{raw}
> > +@table @code
> > +@item file
> > +Reference to or definition of the data source block device
> > +@end table
>
> Would an example command line make things any easier to read, for giving
> hints on how many dotted names are needed as you describe further
> nesting levels in relation to the top level?Hm, I guess I could add an example command line to each driver section. And probably the dotted syntax should be mentioned somewhere, too. > > +@item cache-clean-interval > > +Clean unused entries in the L2 and refcount caches. The interval is in > > seconds. > > +The default value is 0 and it disables this feature. > > + > > +@item pass-discard-request > > +Whether discard requests to the qcow2 device should be forwarded to the > > data > > +source (on/off) > > + > > +@item pass-discard-snapshot > > +Whether discard requests for the data source should be issued when a > > snapshot > > +operation (e.g. deleting a snapshot) frees clusters in the qcow2 file > > (on/off) > > + > > +@item pass-discard-other > > +Whether discard requests for the data source should be issued on other > > +occasions where a cluster gets freed (on/off) > > I like that cache-clean-interval mentioned a default; should these other > lines do likewise? Actually I took most of these descriptions straight from the QAPI schema comments, except that I added the allowed values sometimes. If the default is missing, we should probably add it in both places. Kevin
pgpmXCAjbMQQI.pgp
Description: PGP signature
