NAME

zip_set_archive_flag — set zip archive flag

LIBRARY

libzip (-lzip)

SYNOPSIS

#include <zip.h>

int
zip_set_archive_flag(zip_t *archive, zip_flags_t flag, int value);

DESCRIPTION

The zip_set_archive_flag() function sets the flag flag for the archive archive to the value value.

Supported flags are:

ZIP_AFL_CREATE_OR_KEEP_FILE_FOR_EMPTY_ARCHIVE

If this flag is cleared, the archive file will be removed if the archive is empty. If it is set, an empty archive will be created, which is not recommended by the zip specification.

ZIP_AFL_RDONLY

If this flag is set, no modification to the archive are allowed. This flag can only be cleared if it was manually set with zip_set_archive_flag, not if the archive was opened read-only.

ZIP_AFL_WANT_TORRENTZIP

If this flag is set, the archive will be written in torrentzip format.

RETURN VALUES

Upon successful completion 0 is returned, and -1 if an error occurred.

SEE ALSO

libzip(3), zip_get_archive_flag(3)

HISTORY

zip_set_archive_flag() was added in libzip 0.9. In libzip 0.11 the type of flag was changed from int to zip_flags_t. ZIP_AFL_CREATE_OR_KEEP_FILE_FOR_EMPTY_ARCHIVE and ZIP_AFL_WANT_TORRENTZIP were added in libzip 1.10.0.

AUTHORS

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