aboutsummaryrefslogtreecommitdiff
path: root/src/liblzma/api
diff options
context:
space:
mode:
authorLasse Collin <lasse.collin@tukaani.org>2008-01-26 00:25:34 +0200
committerLasse Collin <lasse.collin@tukaani.org>2008-01-26 00:25:34 +0200
commitf9842f712732c482f2def9f24437851e57dd83f8 (patch)
tree3429da96813e5d0d40d7cf5ee7527c6b35a1acd0 /src/liblzma/api
parentAdded more Multi-Block test files. Improved some (diff)
downloadxz-f9842f712732c482f2def9f24437851e57dd83f8.tar.xz
Return LZMA_HEADER_ERROR if LZMA_SYNC_FLUSH is used with any
of the so called simple filters. If there is demand, limited support for LZMA_SYNC_FLUSH may be added in future. After this commit, using LZMA_SYNC_FLUSH shouldn't cause undefined behavior in any situation.
Diffstat (limited to 'src/liblzma/api')
-rw-r--r--src/liblzma/api/lzma/simple.h9
1 files changed, 9 insertions, 0 deletions
diff --git a/src/liblzma/api/lzma/simple.h b/src/liblzma/api/lzma/simple.h
index fb78d01f..807a4c46 100644
--- a/src/liblzma/api/lzma/simple.h
+++ b/src/liblzma/api/lzma/simple.h
@@ -64,6 +64,15 @@
*
* If options with non-default values have been specified when encoding,
* the same options must also be specified when decoding.
+ *
+ * \note At the moment, none of the simple filters support
+ * LZMA_SYNC_FLUSH. If LZMA_SYNC_FLUSH is specified,
+ * LZMA_HEADER_ERROR will be returned. If there is need,
+ * partial support for LZMA_SYNC_FLUSH can be added in future.
+ * Partial means that flushing would be possible only at
+ * offsets that are multiple of 2, 4, or 16 depending on
+ * the filter, except x86 which cannot be made to support
+ * LZMA_SYNC_FLUSH predictably.
*/
typedef struct {
/**