]> git.ipfire.org Git - thirdparty/zstd.git/commitdiff
updated manual
authorYann Collet <cyan@fb.com>
Thu, 15 Nov 2018 18:52:24 +0000 (10:52 -0800)
committerYann Collet <cyan@fb.com>
Thu, 15 Nov 2018 18:52:24 +0000 (10:52 -0800)
doc/zstd_manual.html

index 83f4c45569fce55d5867c311c7a7b5762566089b..be9385fa893502bf7d06956177d0aa1c4054048f 100644 (file)
@@ -510,6 +510,28 @@ size_t ZSTD_sizeof_DDict(const ZSTD_DDict* ddict);
                               * enum. See the comments on that enum for an
                               * explanation of the feature.
                               */
+    </b>/* Question : should rsyncable be categorized as experimental, or be candidate for stable ? */<b>
+    ZSTD_p_rsyncable,        </b>/* Enables rsyncable mode, which makes compressed<b>
+                              * files more rsync friendly by adding periodic
+                              * synchronization points to the compressed data.
+                              * The target average block size is
+                              * ZSTD_p_jobSize / 2. You can modify the job size
+                              * to increase or decrease the granularity of the
+                              * synchronization point. Once the jobSize is
+                              * smaller than the window size, you will start to
+                              * see degraded compression ratio.
+                              * NOTE: This only works when multithreading is
+                              * enabled.
+                              * NOTE: You probably don't want to use this with
+                              * long range mode, since that will decrease the
+                              * effectiveness of the synchronization points,
+                              * but your milage may vary.
+                              * NOTE: Rsyncable mode will limit the maximum
+                              * compression speed to approximately 400 MB/s.
+                              * If your compression level is already running
+                              * significantly slower than that (< 200 MB/s),
+                              * the speed won't be significantly impacted.
+                              */
 } ZSTD_cParameter;
 </b></pre><BR>
 <pre><b>size_t ZSTD_CCtx_setParameter(ZSTD_CCtx* cctx, ZSTD_cParameter param, unsigned value);