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

FreeBSD Manual Pages

  
 
  

home | help
ZIP_FILE_SET_ENCRYP... FreeBSD Library Functions Manual	ZIP_FILE_SET_ENCRYP...

NAME
     zip_file_set_encryption --	set encryption method for file in zip

LIBRARY
     libzip (-lzip)

SYNOPSIS
     #include <zip.h>

     int
     zip_file_set_encryption(zip_t *archive, zip_uint64_t index,
	 zip_uint16_t method, const char *password);

DESCRIPTION
     The zip_file_set_encryption() function sets the encryption	method for the
     file at position index in the zip archive to method using the password
     password.	The method is the same as returned by zip_stat(3).  For	the
     method argument, currently	only the following values are supported:

     ZIP_EM_NONE	No encryption.

     ZIP_EM_AES_128	Winzip AES-128 encryption.

     ZIP_EM_AES_192	Winzip AES-192 encryption.

     ZIP_EM_AES_256	Winzip AES-256 encryption.

     ZIP_EM_TRAD_PKWARE
			Traditional PKWare encryption.	Do not use this
			method,	it is not secure.  It is only provided for
			backwards compatibility.

     If	password is NULL, the default password provided	by
     zip_set_default_password(3) is used.

     The current encryption method for a file in a zip archive can be deter-
     mined using zip_stat(3).

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

     [ZIP_ER_ENCRNOTSUPP]
			Unsupported compression	method requested.

     [ZIP_ER_INVAL]	index is not a valid file index	in archive, or the ar-
			gument combination is invalid.

     [ZIP_ER_MEMORY]	Required memory	could not be allocated.

     [ZIP_ER_RDONLY]	Read-only zip file, no changes allowed.

SEE ALSO
     libzip(3),	zip_encryption_method_supported(3), zip_fopen_encrypted(3),
     zip_fopen_index_encrypted(3), zip_set_default_password(3),	zip_stat(3)

HISTORY
     zip_file_set_encryption() was added in libzip 1.2.0.

AUTHORS
     Dieter Baron <dillo@nih.at> and Thomas Klausner <tk@giga.or.at>

FreeBSD	13.0			 April 2, 2020			  FreeBSD 13.0

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO | HISTORY | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=zip_file_set_encryption&sektion=3&manpath=FreeBSD+13.1-RELEASE+and+Ports>

home | help