Name

zip_set_default_password — set default password for encrypted files in zip

Library

libzip (-lzip)

Synopsis

#include <zip.h>

int
zip_set_default_password(zip_t *archive, const char *password);

Description

The zip_set_default_password() function sets the default password used when accessing encrypted files. If password is NULL or the empty string, the default password is unset.

If you prefer a different password for single files, use zip_fopen_encrypted(3) instead of zip_fopen(3). Usually, however, the same password is used for every file in an zip archive.

The password is not verified when calling this function. See the CAVEATS section in zip_fopen_encrypted(3) for more details about password handling.

Return Values

Upon successful completion 0 is returned. Otherwise, -1 is returned and the error information in archive is set to indicate the error.

Errors

zip_set_default_password() fails if:

[ZIP_ER_MEMORY]

Required memory could not be allocated.

See Also

libzip(3), zip_fopen(3), zip_fopen_encrypted(3)

History

zip_set_default_password() was added in libzip 0.10.

Authors

Dieter Baron <dillo@nih.at> and Thomas Klausner <wiz@gatalith.at>