Andreas Butti
7 years ago
parent
b74a3b973d
commit
5fbf7af67d
5 changed files with 201 additions and 8 deletions
@ -0,0 +1,14 @@ |
||||
export PATH="$HOME/.local/bin:$PATH" |
||||
|
||||
curl -L https://libzip.org/download/libzip-1.5.2.tar.gz -o libzip.tar.gz |
||||
tar xf libzip.tar.gz |
||||
cd libzip-* |
||||
mkdir build |
||||
cd build |
||||
echo "Build LibZip" |
||||
pwd |
||||
$HOME/gtk/inst/bin/cmake -DCMAKE_INSTALL_PREFIX:PATH=$HOME/gtk/inst .. |
||||
make -j8 |
||||
make install |
||||
cd .. |
||||
cd .. |
||||
@ -0,0 +1,12 @@ |
||||
BasedOnStyle: LLVM |
||||
IndentWidth: 4 |
||||
ColumnLimit: 2000 |
||||
AlwaysBreakAfterReturnType: TopLevelDefinitions |
||||
KeepEmptyLinesAtTheStartOfBlocks: false |
||||
MaxEmptyLinesToKeep: 2 |
||||
BreakBeforeBraces: Custom |
||||
BraceWrapping: |
||||
BeforeElse: true |
||||
AlignEscapedNewlines: Left |
||||
UseTab: ForContinuationAndIndentation |
||||
#PPDirectiveIndentStyle: AfterHash |
||||
@ -0,0 +1,162 @@ |
||||
# libzip API changes |
||||
|
||||
This file describes changes in the libzip API and how to adapt your |
||||
code for them. |
||||
|
||||
You can define `ZIP_DISABLE_DEPRECATED` before including `<zip.h>` to hide |
||||
prototypes for deprecated functions, to find out about functions that |
||||
might be removed at some point. |
||||
|
||||
## Changed in libzip-1.0 |
||||
|
||||
### new type `zip_error_t` |
||||
|
||||
Error information is stored in the newly public type `zip_error_t`. Use |
||||
this to access information about an error, instead of the deprecated |
||||
functions that operated on two ints. |
||||
|
||||
deprecated functions: |
||||
- `zip_error_get_sys_type()` |
||||
- `zip_error_get()` |
||||
- `zip_error_to_str()` |
||||
- `zip_file_error_get()` |
||||
|
||||
See their man pages for instructions on how to replace them. |
||||
|
||||
The most common affected use is `zip_open`. The new recommended usage |
||||
is: |
||||
|
||||
```c |
||||
int err; |
||||
if ((za = zip_open(archive, flags, &err)) == NULL) { |
||||
zip_error_t error; |
||||
zip_error_init_with_code(&error, err); |
||||
fprintf(stderr, "can't open zip archive '%s': %s\n", archive, zip_error_strerror(&error)); |
||||
zip_error_fini(&error); |
||||
} |
||||
``` |
||||
|
||||
### more typedefs |
||||
|
||||
The following typedefs have been added for better readability: |
||||
|
||||
```c |
||||
typedef struct zip zip_t; |
||||
typedef struct zip_file zip_file_t; |
||||
typedef struct zip_source zip_source_t; |
||||
typedef struct zip_stat zip_stat_t; |
||||
``` |
||||
|
||||
This means you can use "`zip_t`" instead of "`struct zip`", etc. |
||||
|
||||
|
||||
### torrentzip support removed |
||||
|
||||
torrentzip depends on a particular zlib version which is by now quite |
||||
old. |
||||
|
||||
## Changed in libzip-0.11 |
||||
|
||||
### new type `zip_flags_t` |
||||
|
||||
The functions which have flags now use the `zip_flags_t` type for this. |
||||
All old flags fit; you need only to adapt code if you were saving flags in a |
||||
local variable. Use `zip_flags_t` for such a variable. |
||||
This affects: |
||||
- `zip_fopen()` |
||||
- `zip_fopen_encrypted()` |
||||
- `zip_fopen_index()` |
||||
- `zip_fopen_index_encrypted()` |
||||
- `zip_get_archive_comment()` |
||||
- `zip_get_archive_flag()` |
||||
- `zip_get_num_entries()` |
||||
- `zip_get_name()` |
||||
- `zip_name_locate()` |
||||
- `zip_set_archive_flag()` |
||||
- `zip_source_zip()` |
||||
- `zip_stat()` |
||||
- `zip_stat_index()` |
||||
|
||||
#### `ZIP_FL_*`, `ZIP_AFL_*`, `ZIP_STAT_*` are now unsigned constants |
||||
|
||||
To match the new `zip_flags_t` type. |
||||
|
||||
#### `zip_add()`, `zip_add_dir()` |
||||
|
||||
These functions were replaced with `zip_file_add()` and `zip_dir_add()`, respectively, |
||||
to add a flags argument. |
||||
|
||||
#### `zip_rename()`, `zip_replace()` |
||||
|
||||
These functions were replaced with `zip_file_rename()` and `zip_file_replace()`, |
||||
respectively, to add a flags argument. |
||||
|
||||
#### `zip_get_file_comment()` |
||||
|
||||
This function was replaced with `zip_file_get_comment()`; one argument was promoted from |
||||
`int` to `zip_uint32_t`, the other is now a `zip_flags_t`. |
||||
|
||||
#### `zip_set_file_comment()` |
||||
|
||||
This function was replaced with `zip_file_set_comment()`; an argument was promoted from |
||||
`int` to `zip_uint16_t`, and a `zip_flags_t` argument was added. |
||||
|
||||
### integer type size changes |
||||
|
||||
Some argument and return values were not the right size or sign. |
||||
|
||||
#### `zip_name_locate()` |
||||
|
||||
The return value was `int`, which can be too small. The function now returns `zip_int64_t`. |
||||
|
||||
|
||||
#### `zip_get_num_entries()` |
||||
|
||||
The return type is now signed, to allow signaling errors. |
||||
|
||||
#### `zip_set_archive_comment()` |
||||
|
||||
The last argument changed from `int` to `zip_uint16_t`. |
||||
|
||||
### extra field handling rewritten |
||||
|
||||
The `zip_get_file_extra()` and `zip_set_file_extra()` functions were removed. |
||||
They only worked on the whole extra field set. |
||||
|
||||
Instead, you can now set, get, count, and delete each extra field separately, |
||||
using the functions: |
||||
- `zip_file_extra_field_delete()` |
||||
- `zip_file_extra_field_delete_by_id()` |
||||
- `zip_file_extra_field_get()` |
||||
- `zip_file_extra_field_get_by_id()` |
||||
- `zip_file_extra_fields_count()` |
||||
- `zip_file_extra_fields_count_by_id()` |
||||
- `zip_file_extra_field_set()` |
||||
|
||||
Please read the corresponding man pages for details. |
||||
|
||||
### new functions |
||||
|
||||
#### `zip_discard()` |
||||
|
||||
The new `zip_discard()` function closes an archive without committing the |
||||
scheduled changes. |
||||
|
||||
#### `zip_set_file_compression()` |
||||
|
||||
The new `zip_set_file_compression()` function allows setting compression |
||||
levels for files. |
||||
|
||||
### argument changes |
||||
|
||||
#### file names |
||||
|
||||
File names arguments are now allowed to be `NULL` to have an empty file name. |
||||
This mostly affects `zip_file_add()`, `zip_dir_add()`, and `zip_file_rename()`. |
||||
|
||||
For `zip_get_name()`, `zip_file_get_comment()`, and `zip_get_archive_comment()`, if |
||||
the file name or comment is empty, a string of length 0 is returned. |
||||
`NULL` is returned for errors only. |
||||
|
||||
Previously, `NULL` was returned for empty/unset file names and comments and |
||||
errors, leaving no way to differentiate between the two. |
||||
Loading…
Reference in new issue