www.LinuxHowtos.org

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 1-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:

-4: seconds divided by two (-2 = 1, -4 = 2, ...)
-10: minute (-59)
1-15: hour (-23)

The values of the date bytes are defined as follows:

-4: day of the month (-31)
-8: month (January = 1, February = 2, ...)
-15: year offset from 1980 (1980 = 0, 1981 = 1, ...)

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_OPNOTSUPP: Traditional PKWare encryption uses the file's mtime, therefore it cannot be changed without r-encrypting the data.
Bq Er ZIP_ER_RDONLY: The archive was opened in rea-only mode.

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 wiz@gatalith.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.