qemu-devel
[Top][All Lists]
Advanced

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

[Qemu-devel] [PATCH 3/3] doc: Document driver-specific -blockdev options


From: Kevin Wolf
Subject: [Qemu-devel] [PATCH 3/3] doc: Document driver-specific -blockdev options
Date: Thu, 22 Sep 2016 17:42:11 +0200

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 <address@hidden>
---
 qemu-options.hx | 62 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 62 insertions(+)

diff --git a/qemu-options.hx b/qemu-options.hx
index 8766589..bbe0d52 100644
--- a/qemu-options.hx
+++ b/qemu-options.hx
@@ -558,6 +558,68 @@ zero write commands. You may even choose "unmap" if 
@var{discard} is set
 to "unmap" to allow a zero write to be converted to an UNMAP operation.
 @end table
 
address@hidden Driver-specific options for @code{file}
address@hidden @code
address@hidden filename
+The path to the image file in the local filesystem
address@hidden aio
+Specifies the AIO backend (threads/native, default: threads)
address@hidden table
+
address@hidden Driver-specific options for @code{raw}
address@hidden @code
address@hidden file
+Reference to or definition of the data source block device
address@hidden table
+
address@hidden Driver-specific options for @code{qcow2}
address@hidden @code
address@hidden file
+Reference to or definition of the data source block device
+
address@hidden backing
+Reference to or definition of the backing file block device (if missing, taken
+from the image file content). It is allowed to pass an empty string here in
+order to disable the default backing file.
+
address@hidden lazy-refcounts
+Whether to enable the lazy refcounts feature (on/off, default is taken from the
+image file)
+
address@hidden cache-size
+The maximum total size of the L2 table and refcount block caches in bytes
+
address@hidden l2-cache-size
+The maximum size of the L2 table cache in bytes
+
address@hidden refcount-cache-size
+The maximum size of the refcount block cache in bytes
+
address@hidden 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.
+
address@hidden pass-discard-request
+Whether discard requests to the qcow2 device should be forwarded to the data
+source (on/off)
+
address@hidden 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)
+
address@hidden pass-discard-other
+Whether discard requests for the data source should be issued on other
+occasions where a cluster gets freed (on/off)
+
address@hidden overlap-check
+Which overlap checks to perform for writes to the image
+(none/constant/cache/all, defaults to 'cached'). For details or finer
+granularity control refer to the QAPI documentation of @code{blockdev-add}.
address@hidden table
+
address@hidden Driver-specific options for other drivers
+Please refer to the QAPI documentation of the @code{blockdev-add} QMP command.
+
 @end table
 
 ETEXI
-- 
1.8.3.1




reply via email to

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