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

FreeBSD Manual Pages

  
 
  

home | help
ZIP_FILE_SET_MTIME(3)  FreeBSD Library Functions Manual	 ZIP_FILE_SET_MTIME(3)

NAME
     zip_file_set_dostime, zip_file_set_mtime -- set last modification time
     (mtime) for file in zip

LIBRARY
     libzip (-lzip)

SYNOPSIS
     #include <zip.h>

     int
     zip_file_set_dostime(zip_t	*archive, zip_uint64_t index,
	 zip_uint16_t dostime, zip_uint16_t dosdate, zip_flags_t flags);

     int
     zip_file_set_mtime(zip_t *archive,	zip_uint64_t index, time_t mtime,
	 zip_flags_t flags);

DESCRIPTION
     The zip_file_set_mtime() function sets the	last modification time (mtime)
     for the file at position index in the zip archive to mtime.  Currently,
     no	support	for any	flags is implemented.

     In	the zip	archive, the time and date are saved as	two 16-bit integers.
     To	set the	values directly, call the zip_file_set_dostime() function.
     The values	of the time bytes are defined as follows:

	   0-4	  day of the month (1-31)

	   5-8	  month	(January = 1, February = 2, ...)

	   9-15	  year offset from 1980	(1980 =	0, 1981	= 1, ...)

     The values	of the date bytes are defined as follows:

	   0-4	  seconds divided by two (1-2 =	1, 3-4 = 2, ...)

	   5-10	  minute (0-59)

	   11-15  hour (0-23)

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_dostime() and	zip_file_set_mtime() fail if:

     [ZIP_ER_INVAL]	index is not a valid file index	in archive.

     [ZIP_ER_MEMORY]	Required memory	could not be allocated.

     [ZIP_ER_RDONLY]	The archive was	opened in read-only mode.

SEE ALSO
     libzip(3),	zip_stat(3)

HISTORY
     zip_file_set_mtime() was added in libzip 1.0.  zip_file_set_dostime() was
     added in libzip 1.6.

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

CAVEATS
     Following historical practice, the	zip_file_set_mtime() function trans-
     lates the time from the zip archive into the local	time zone.  If you
     want to avoid this, use the zip_file_set_dostime()	function instead.

FreeBSD	13.0			January	7, 2020			  FreeBSD 13.0

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

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

home | help