zip_file_set_dostime - set last modification time (mtime) for file in zip
#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);
ZIP_FILE_SET_MTIME(3) BSD 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.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------+
|Availability | compress/libzip |
+---------------+------------------+
|Stability | Volatile |
+---------------+------------------+
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.
NOTES
Source code for open source software components in Oracle Solaris can be
found at https://www.oracle.com/downloads/opensource/solaris-source-code-
downloads.html.
This software was built from source available at https://github.com/ora-
cle/solaris-userland. The original community source was downloaded from
https://libzip.org/download/libzip-1.7.3.tar.gz.
Further information about this software can be found on the open source
community website at https://libzip.org/.
BSD January 7, 2020 BSD