NAME
zip_fopen_encrypted,
zip_fopen_index_encrypted —
open
encrypted file in zip archive for reading
LIBRARY
libzip (-lzip)
SYNOPSIS
#include <zip.h>
zip_file_t *
zip_fopen_encrypted(
zip_t
*archive,
const char
*fname,
zip_flags_t
flags,
const char
*password);
zip_file_t *
zip_fopen_index_encrypted(
zip_t
*archive,
zip_uint64_t
index,
zip_flags_t
flags,
const char
*password);
DESCRIPTION
The
zip_fopen_encrypted() function opens the encrypted file
name
fname in
archive using the
password given in the
password argument. The
flags argument are the same as for
zip_fopen(3).
The
zip_fopen_index_encrypted() function opens the file at
position
index, see
zip_fopen_index(3). These
functions are called automatically by
zip_fopen(3); you only need to call
them if you want to specify a non-default password (see
zip_set_default_password(3)).
RETURN VALUES
Upon successful completion, a
struct zip_file pointer is
returned. Otherwise,
NULL
is returned and the error
code in
archive is set to indicate the error.
ERRORS
-
-
- [
ZIP_ER_NOPASSWD
]
- No password was provided.
The function
zip_fopen_encrypted() may also fail and set
zip_err for any of the errors specified for the routine
zip_fopen(3).
The function
zip_fopen_index_encrypted() may also fail and set
zip_err for any of the errors specified for the routine
zip_fopen_index(3).
SEE ALSO
libzip(3),
zip_fclose(3),
zip_fopen(3),
zip_fread(3),
zip_get_num_entries(3),
zip_name_locate(3)
HISTORY
zip_fopen_encrypted() and
zip_fopen_index_encrypted() were added in libzip 1.0.
AUTHORS
Dieter Baron
<
dillo@nih.at> and
Thomas Klausner
<
tk@giga.or.at>