NAME

       zip_fopen_encrypted  ,  - .Nm zip_fopen_index_encrypted open encrypted file in zip archive
       for reading

LIBRARY

       libzip (-lzip)

SYNOPSIS

       #include <zip.h>

       struct zip_file * zip_fopen_encrypted(struct zip *archive, const char *fname,  int  flags,
       const char *password);

       struct  zip_file  * zip_fopen_index_encrypted(struct zip *archive, zip_uint64_t index, int
       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 for any of the errors specified for
       the routine zip_fopen(3).

       The  function  zip_fopen_index_encrypted  may  also  fail  and  set  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)

AUTHORS

       Dieter Baron <dillo@giga.or.at> and Thomas Klausner <tk@giga.or.at>