summary refs log tree commit diff
path: root/doc/zlib/uncompress.3
blob: 1047ad910f129b329ee802784bde5d2cd777d392 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
.Dd January 15, 2017
.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.
.Po
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.
.Pc \&
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.
.
.Sh SEE ALSO
.Xr compress 3 ,
.Xr inflate 3
.
.Sh HISTORY
This manual page was converted from
.In zlib.h
to mdoc format by
.An June McEnroe Aq Mt june@causal.agency .
.
.Sh AUTHORS
.An Jean-loup Gailly Aq Mt jloup@gzip.org
.An Mark Adler Aq Mt madler@alumni.caltech.edu
e This simplifies some things, adds support for line number tag definitions, and should enable combining htagml with other preprocessors in the future. 2021-01-12Split fields by tab onlyJune McEnroe Also don't fail hard on non-forward-search definitions. 2021-01-12List both Makefile and html.sh under README.7June McEnroe 2021-01-12Add htagml exampleJune McEnroe 2021-01-12Use mandoc and htagml for bin htmlJune McEnroe 2021-01-12Add htagmlJune McEnroe 2021-01-12Replace causal.agency with a simple mdoc pageJune McEnroe 2021-01-11Publish "Using vi"June McEnroe 2021-01-11Enable diff.colorMovedJune McEnroe 2021-01-10Set less search case-insensitiveJune McEnroe 2021-01-10Set EXINITJune McEnroe neovim is laggy as hell in my OpenBSD VM, so I switched to vi so I could type without getting frustrated. 2021-01-09Add c -t flag to print expression typeJune McEnroe Also add missing float case. 2021-01-05Update taglineJune McEnroe