1 .\" zip_set_file_compression.mdoc -- set compression method and its flags
2 .\" Copyright (C) 2012-2016 Dieter Baron and Thomas Klausner
4 .\" This file is part of libzip, a library to manipulate ZIP files.
5 .\" The authors can be contacted at <libzip@nih.at>
7 .\" Redistribution and use in source and binary forms, with or without
8 .\" modification, are permitted provided that the following conditions
10 .\" 1. Redistributions of source code must retain the above copyright
11 .\" notice, this list of conditions and the following disclaimer.
12 .\" 2. Redistributions in binary form must reproduce the above copyright
13 .\" notice, this list of conditions and the following disclaimer in
14 .\" the documentation and/or other materials provided with the
16 .\" 3. The names of the authors may not be used to endorse or promote
17 .\" products derived from this software without specific prior
18 .\" written permission.
20 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
21 .\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
22 .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
24 .\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
26 .\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
28 .\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
29 .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
30 .\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
33 .Dt ZIP_SET_FILE_COMPRESSION 3
36 .Nm zip_set_file_compression
37 .Nd set compression method for file in zip
43 .Fn zip_set_file_compression "zip_t *archive" "zip_uint64_t index" "zip_int32_t comp" "zip_uint32_t comp_flags"
46 .Fn zip_set_file_compression
47 function sets the compression method for the file at position
51 with the compression method specific
55 is the same as returned by
59 argument, currently only the following values are supported:
60 .Bl -tag -width ZIP_CM_DEFLATE_XX
62 default compression; currently the same as
65 Store the file uncompressed.
67 Deflate the file with the
69 algorithm and default options
74 argument is currently ignored.
75 .\" For the comp_flags argument, the lower 4 bits define the compression
77 .\" 0 is fastest compression, 15 is highest compression
78 .\" .Dv ZIP_COMP_FL_DEFAULT
79 .\" can be used to specify that the default shall be used.
80 .\" Further compression method specific flags will be added over time.
82 The current compression method for a file in a zip archive can be
86 Upon successful completion 0 is returned.
87 Otherwise, \-1 is returned and the error information in
89 is set to indicate the error.
91 .Fn zip_set_file_compression
94 .It Bq Er ZIP_ER_INVAL
96 is not a valid file index in
98 or the argument combination is invalid.
99 .It Bq Er ZIP_ER_COMPNOTSUPP
100 Unsupported compression method requested.
101 .It Bq Er ZIP_ER_RDONLY
102 Read-only zip file, no changes allowed.
109 .An Dieter Baron Aq Mt dillo@nih.at
111 .An Thomas Klausner Aq Mt tk@giga.or.at