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

FreeBSD Manual Pages

  
 
  

home | help
ZIP_SET_ARCHIVE_COMMENT(3)  Library Functions ManualZIP_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 removed.  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  com-
			  ment 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 14.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+14.3.quarterly>

home | help