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

FreeBSD Manual Pages

  
 
  

home | help 
ZIP_FILE_SET_ENCRYPTION(3)  Library Functions ManualZIP_FILE_SET_ENCRYPTION(3)

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 pass-
       word 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
			  argument 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 <wiz@gatalith.at>

FreeBSD	Ports 14.quarterly	 April 2, 2020	    ZIP_FILE_SET_ENCRYPTION(3)

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

home | help