about summary refs log tree commit diff homepage
diff options
context:
space:
mode:
authorJune McEnroe <june@causal.agency>2018-11-09 00:48:39 -0500
committerJune McEnroe <june@causal.agency>2018-11-09 00:48:39 -0500
commitdb94fc984d1ea8693c6274c54c0568d38ad367b8 (patch)
tree4403f2717aea61a621f9ae0016d588a7788110ee
parentAdd cross-references between crc32(3) and adler32(3) (diff)
downloadzlib-man-pages-db94fc984d1ea8693c6274c54c0568d38ad367b8.tar.gz
zlib-man-pages-db94fc984d1ea8693c6274c54c0568d38ad367b8.zip
Add uncompress.3
Diffstat (limited to '')
-rw-r--r--uncompress.376
l---------uncompress2.31
2 files changed, 77 insertions, 0 deletions
diff --git a/uncompress.3 b/uncompress.3
new file mode 100644
index 0000000..04a082a
--- /dev/null
+++ b/uncompress.3
@@ -0,0 +1,76 @@
+.Dd November 9, 2018
+.Dt UNCOMPRESS 3
+.Os
+.
+.Sh NAME
+.Nm uncompress ,
+.Nm uncompress2
+.Nd decompress source buffer into destination buffer
+.
+.Sh LIBRARY
+.Lb libz
+.
+.Sh SYNOPSIS
+.In zlib.h
+.
+.Ft int
+.Fo uncompress
+.Fa "Bytef *dest"
+.Fa "uLongf *destLen"
+.Fa "const Bytef *source"
+.Fa "uLong sourceLen"
+.Fc
+.
+.Ft int
+.Fo uncompress2
+.Fa "Bytef *dest"
+.Fa "uLongf *destLen"
+.Fa "const Bytef *source"
+.Fa "uLong *sourceLen"
+.Fc
+.
+.Sh DESCRIPTION
+Decompresses the source buffer into the destination buffer.
+.Fa sourceLen
+is the byte length of the source buffer.
+Upon entry,
+.Fa destLen
+is the total size of the destination buffer,
+which must be large enough to hold the entire uncompressed data.
+(The size of the uncompressed data
+must have been saved previously by the compressor
+and transmitted to the decompressor
+by some mechanism outside the scope of this compression library.)
+Upon exit,
+.Fa destLen
+is the actual size of the uncompressed data.
+.
+.Pp
+.Fn uncompress2
+is the same as
+.Fn uncompress ,
+except that
+.Fa sourceLen
+is a pointer,
+where the length of the source is
+.Fa *sourceLen .
+On return,
+.Fa *sourceLen
+is the number of source bytes consumed.
+.
+.Sh RETURN VALUES
+.Fn uncompress
+returns
+.Dv Z_OK
+if success,
+.Dv Z_MEM_ERROR
+if there was not enough memory,
+.Dv Z_BUF_ERROR
+if there was not enough room in the output buffer,
+or
+.Dv Z_DATA_ERROR
+if the input data was corrupted or incomplete.
+In the case where there is not enough room,
+.Fn uncompress
+will fill the output buffer
+with the uncompressed data up to that point.
diff --git a/uncompress2.3 b/uncompress2.3
new file mode 120000
index 0000000..163d16c
--- /dev/null
+++ b/uncompress2.3
@@ -0,0 +1 @@
+uncompress.3
\ No newline at end of file