ZIP_FILE_SET_MTIME
Section: C Library Functions (3)
Index
Return to Main Contents
BSD mandoc
NAME
zip_file_set_dostime
zip_file_set_mtime
- set last modification time (mtime) for file in zip
LIBRARY
libzip (-lzip)
SYNOPSIS
In zip.h
Ft int
Fn zip_file_set_dostime zip_t *archive zip_uint64_t index zip_uint16_t dostime zip_uint16_t dosdate zip_flags_t flags
Ft int
Fn zip_file_set_mtime zip_t *archive zip_uint64_t index time_t mtime zip_flags_t flags
DESCRIPTION
The
Fn 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
Fn 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
Fn zip_file_set_dostime
and
Fn zip_file_set_mtime
fail if:
- Bq Er ZIP_ER_INVAL
-
index
is not a valid file index in
archive
- Bq Er ZIP_ER_MEMORY
-
Required memory could not be allocated.
- Bq Er ZIP_ER_RDONLY
-
The
archive
was opened in read-only mode.
SEE ALSO
libzip(3),
zip_stat3
HISTORY
Fn zip_file_set_mtime
was added in libzip 1.0.
Fn zip_file_set_dostime
was added in libzip 1.6.
AUTHORS
An -nosplit
An Dieter Baron Aq Mt dillo@nih.at
and
An Thomas Klausner Aq Mt tk@giga.or.at
CAVEATS
Following historical practice, the
Fn zip_file_set_mtime
function translates the time from the zip archive into the local time
zone.
If you want to avoid this, use the
Fn zip_file_set_dostime
function instead.
Index
- NAME
-
- LIBRARY
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURN VALUES
-
- ERRORS
-
- SEE ALSO
-
- HISTORY
-
- AUTHORS
-
- CAVEATS
-
This document was created by
man2html,
using the manual pages.
Time: 04:06:51 GMT, May 18, 2024