ZIP_SET_ARCHIVE_FLAG(3)	     Library Functions Manual	 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  re-
			 moved	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 manu-
			 ally  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>

GNU				  July 19, 2023		 ZIP_SET_ARCHIVE_FLAG(3)