NAME

       archive_entry_atime,   archive_entry_atime_nsec,   archive_entry_atime_is_set,   archive_entry_set_atime,
       archive_entry_unset_atime,             archive_entry_birthtime,             archive_entry_birthtime_nsec,
       archive_entry_birthtime_is_set,        archive_entry_set_birthtime,        archive_entry_unset_birthtime,
       archive_entry_ctime,   archive_entry_ctime_nsec,   archive_entry_ctime_is_set,   archive_entry_set_ctime,
       archive_entry_unset_ctime,   archive_entry_mtime,  archive_entry_mtime_nsec,  archive_entry_mtime_is_set,
       archive_entry_set_mtime, archive_entry_unset_mtime — functions for manipulating times  in  archive  entry
       descriptions

LIBRARY

       Streaming Archive Library (libarchive, -larchive)

SYNOPSIS

       #include <archive_entry.h>

       time_t
       archive_entry_atime(struct archive_entry *a);

       long
       archive_entry_atime_nsec(struct archive_entry *a);

       int
       archive_entry_atime_is_set(struct archive_entry *a);

       void
       archive_entry_set_atime(struct archive_entry *a, time_t sec, long nanosec);

       void
       archive_entry_unset_atime(struct archive_entry *a);

       time_t
       archive_entry_birthtime(struct archive_entry *a);

       long
       archive_entry_birthtime_nsec(struct archive_entry *a);

       int
       archive_entry_birthtime_is_set(struct archive_entry *a);

       void
       archive_entry_set_birthtime(struct archive_entry *a, time_t sec, long nanosec);

       void
       archive_entry_unset_birthtime(struct archive_entry *a);

       time_t
       archive_entry_ctime(struct archive_entry *a);

       long
       archive_entry_ctime_nsec(struct archive_entry *a);

       int
       archive_entry_ctime_is_set(struct archive_entry *a);

       void
       archive_entry_set_ctime(struct archive_entry *a, time_t sec, long nanosec);

       void
       archive_entry_unset_ctime(struct archive_entry *a);

       time_t
       archive_entry_mtime(struct archive_entry *a);

       long
       archive_entry_mtime_nsec(struct archive_entry *a);

       int
       archive_entry_mtime_is_set(struct archive_entry *a);

       void
       archive_entry_set_mtime(struct archive_entry *a, time_t sec, long nanosec);

       void
       archive_entry_unset_mtime(struct archive_entry *a);

DESCRIPTION

       These  functions  create  and  manipulate the time fields in an archive_entry.  Supported time fields are
       atime (access time), birthtime (creation time), ctime (last time an inode property was changed) and mtime
       (modification time).

       libarchive(3) provides a high-resolution interface.  The timestamps are truncated automatically depending
       on the archive format (for archiving) or the filesystem capabilities (for restoring).

       All timestamp fields are optional.  The XXX_unset() functions can be used to mark the corresponding field
       as missing.  The current state can be queried using XXX_is_set().  Unset time fields have  a  second  and
       nanosecond field of 0.

SEE ALSO

       archive_entry(3), libarchive(3)

HISTORY

       The libarchive library first appeared in FreeBSD 5.3.

AUTHORS

       The libarchive library was written by Tim Kientzle <kientzle@acm.org>.

Debian                                          February 2, 2012                           ARCHIVE_ENTRY_TIME(3)