ZIP_SET_ARCHIVE_FLAG(3)

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>