Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ZIP_SET_ARCHIVE_COMMENT(3)   Library Functions Manual ZIP_SET_ARCHIVE_COMMENT(3)

NAME
     zip_set_archive_comment -- set zip archive comment

LIBRARY
     libzip (-lzip)

SYNOPSIS
     #include <zip.h>

     int
     zip_set_archive_comment(zip_t *archive, const char *comment,
	 zip_uint16_t len);

DESCRIPTION
     The  zip_set_archive_comment() function sets the comment for the entire zip
     archive.  If comment is NULL and len is 0, the archive comment will be  re-
     moved.  comment must be encoded in ASCII or UTF-8.

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_archive_comment() fails if:

     [ZIP_ER_INVAL]	len is less than 0 or longer than  the	maximum  comment
			length	in a zip file (65535), or comment is not a valid
			UTF-8 encoded string.

     [ZIP_ER_MEMORY]	Required memory could not be allocated.

SEE ALSO
     libzip(3),        zip_file_get_comment(3), 	zip_file_set_comment(3),
     zip_get_archive_comment(3)

HISTORY
     zip_set_archive_comment() was added in libzip 0.7.  In libzip 0.11 the type
     of len was changed from int to zip_uint16_t.

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

FreeBSD ports 15.quarterly	December 18, 2017     ZIP_SET_ARCHIVE_COMMENT(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=zip_set_archive_comment&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help