Re: [PATCH 2/2] Documentation: device-mapper: document VDO zstd
Matthew Sakai <[email protected]> Thu, 23 Jul 2026 12:21:01 -0400
| Newsgroups | dev.linux.lists.dm-devel |
|---|---|
| Message-ID | <[email protected]> |
Sorry, ignore this, I missed the first patch. I'll write a longer reply to that one. Matt On 7/23/26 12:18 PM, Matthew Sakai wrote: > This is attempting to document a feature that does not exist in dm-vdo. > We cannot accept this. > > Matt > > On 7/23/26 12:13 PM, Rhajune Park wrote: >> document zstd compression with dm-vdo >> >> Assisted-by: opencode:gpt-5.6-sol >> Signed-off-by: Rhajune Park <[email protected]> >> --- >> .../admin-guide/device-mapper/vdo.rst | 21 ++++++++++++++++++- >> 1 file changed, 20 insertions(+), 1 deletion(-) >> >> diff --git a/Documentation/admin-guide/device-mapper/vdo.rst b/ >> Documentation/admin-guide/device-mapper/vdo.rst >> index 8a67b320a97b..24a6b26bb990 100644 >> --- a/Documentation/admin-guide/device-mapper/vdo.rst >> +++ b/Documentation/admin-guide/device-mapper/vdo.rst >> @@ -171,6 +171,20 @@ Miscellaneous parameters: >> Whether compression is enabled. The default is 'off'; the >> acceptable values are 'on' and 'off'. >> + compressionAlgorithm: >> + The algorithm used to compress data. The acceptable values are >> + 'lz4' and 'zstd'; the default for a new volume is 'lz4'. The >> + algorithm is recorded when the volume is formatted and cannot be >> + changed afterward. If specified when loading an existing volume, >> + it must match the recorded algorithm. >> + >> + compressionLevel: >> + The Zstd compression level. The default is 1; negative levels >> are >> + accepted when supported by the kernel Zstd implementation. This >> + option is invalid with LZ4. The level may be changed after fully >> + deactivating the volume, but not by reloading an active VDO >> table. >> + It does not affect the readability of data written at another >> level. >> + >> Device modification >> ------------------- >> @@ -178,6 +192,8 @@ A modified table may be loaded into a running, >> non-suspended vdo volume. >> The modifications will take effect when the device is next resumed. The >> modifiable parameters are <logical device size>, <physical device >> size>, >> <maxDiscard>, <compression>, and <deduplication>. >> +The <compressionAlgorithm> parameter is a format-time property and is >> not >> +modifiable. >> If the logical device size or physical device size are changed, upon >> successful resume vdo will store the new values and require them on >> future >> @@ -255,7 +271,10 @@ The messages are: >> config: >> Outputs useful vdo configuration information. Mostly used >> by users who want to recreate a similar VDO volume and >> - want to know the creation configuration used. >> + want to know the creation configuration used. Output version >> + 3 contains physicalSize, logicalSize, slabSize, >> + compressionAlgorithm, the Zstd compressionLevel when applicable, >> + and index configuration fields. >> dump: >> Dumps many internal structures to the system log. This is >