This series makes the qcow2 L2 cache assignment aware of the image size,
with the intention for it to cover the entire image. The importance of
this change is in noticeable performance improvement, especially with
heavy random I/O. The memory overhead is not big in most cases, as only
1 MB of cache for every 8 GB of image size is used. For cases with very
large images and/or small cluster sizes, or systems with limited RAM
resources, there is an upper limit on the default L2 cache: 32 MB for
Linux systems, and 8 MB for non-Linux systems (the difference is caused
by the fact that it is currently impossible to perform scheduled cache
cleaning on non-Linux systems). To modify this upper limit one can use
the already existing 'l2-cache-size' and 'cache-size' options. Moreover,
this fixes the behavior of 'l2-cache-size', as it was documented as the
*maximum* L2 cache size, but in practice behaved as the absolute size.
To compensate the memory overhead which may (but not necesarily will) be
increased following this behavior, the default cache-clean-interval is set
to 10 minutes by default (was disabled by default before).
The L2 cache is also resized accordingly, by default, if the image is
resized.
Additionally, few minor changes are made (refactoring and documentation
fixes).
Differences from v1:
* .gitignore modification patch removed (unneeded).
* The grammar fix in conflicting cache sizing patch removed (merged).
* The update total_sectors when resizing patch squashed with the
resizing patch.
* L2 cache is now capped at 32 MB.
* The default cache-clean-interval is set to 30 seconds.
Differences from v2:
* Made it clear in the documentation that setting cache-clean-interval
to 0 disables this feature.
Differences from v3:
* The default cache-clean-interval is set to 10 minutes instead of 30
seconds before.
* Commit message changes to better explain the patches.
* Some refactoring.
Differences from v4:
* Refactoring.
* Documentation and commit message fixes.
Differences from v5:
* A patch with cosmetic changes is split from the main patch
* A patch for avoiding duplication in refcount cache size assignment is
split from the main patch.
* In the main patch the cap on the L2 cache size is set to only 1 MB (in
order to be close to the previous behavior) and a separate patch sets
it to 32 MB.
* Changes in the documentation fixes patch [1/8].
Differences from v6:
* A patch is added to make the defined sizes more humanly readable.
Differences from v7:
* Documentation and commit message changes.
* Fix: when cache-size is specified and is large enough, with the L2 and
refcount caches not set, the L2 cache will be as large as needed to
cover the entire image, and not as the default max. size. (Return to
the previous behavior in this part, which was correct).
* Cosmetic changes patch not used.
Differences from v8:
* Made a lookup table for power-of-two sizes. This will enable writing
pretty size values (most of the ones used are powers of two) while
allowing correct stringification of these values.
* Made the max. L2 cache size 8 MB on non-Linux systems.
* Returned the test for too large L2 cache size.
* Minor documentation fixes.
Differences from v9:
* DEFAULT_CACHE_CLEAN_INTERVAL is set to 0 for non-Linux platforms in
order to avoid an error, since the cache clean interval feature is
currently available only on Linux.
Differences from v10:
* Rewording documentation.
Differences from v11:
* Memory leak fixed in "Resize the cache upon image resizing".
Leonid Bloch (9):
qcow2: Options' documentation fixes
include: Add a lookup table of sizes
qcow2: Make sizes more humanly readable
qcow2: Avoid duplication in setting the refcount cache size
qcow2: Assign the L2 cache relatively to the image size
qcow2: Increase the default upper limit on the L2 cache size
qcow2: Resize the cache upon image resizing
qcow2: Set the default cache-clean-interval to 10 minutes
qcow2: Explicit number replaced by a constant
block/qcow2.c | 43 ++++++++++++++++-------------
block/qcow2.h | 19 ++++++++-----
docs/qcow2-cache.txt | 43 +++++++++++++++++++----------
include/qemu/units.h | 55 ++++++++++++++++++++++++++++++++++++++
qapi/block-core.json | 3 ++-
qemu-options.hx | 11 +++++---
tests/qemu-iotests/137 | 8 +++++-
tests/qemu-iotests/137.out | 4 ++-
8 files changed, 140 insertions(+), 46 deletions(-)
--
2.17.1