1ARCHIVE_ENTRY_TIME(3) BSD Library Functions Manual ARCHIVE_ENTRY_TIME(3) 2 3NAME 4 archive_entry_atime, archive_entry_atime_nsec, 5 archive_entry_atime_is_set, archive_entry_set_atime, 6 archive_entry_unset_atime, archive_entry_birthtime, 7 archive_entry_birthtime_nsec, archive_entry_birthtime_is_set, 8 archive_entry_set_birthtime, archive_entry_unset_birthtime, 9 archive_entry_ctime, archive_entry_ctime_nsec, 10 archive_entry_ctime_is_set, archive_entry_set_ctime, 11 archive_entry_unset_ctime, archive_entry_mtime, archive_entry_mtime_nsec, 12 archive_entry_mtime_is_set, archive_entry_set_mtime, 13 archive_entry_unset_mtime — functions for manipulating times in archive 14 entry descriptions 15 16LIBRARY 17 Streaming Archive Library (libarchive, -larchive) 18 19SYNOPSIS 20 #include <archive_entry.h> 21 22 time_t 23 archive_entry_atime(struct archive_entry *a); 24 25 long 26 archive_entry_atime_nsec(struct archive_entry *a); 27 28 int 29 archive_entry_atime_is_set(struct archive_entry *a); 30 31 void 32 archive_entry_set_atime(struct archive_entry *a, time_t sec, 33 long nanosec); 34 35 void 36 archive_entry_unset_atime(struct archive_entry *a); 37 38 time_t 39 archive_entry_birthtime(struct archive_entry *a); 40 41 long 42 archive_entry_birthtime_nsec(struct archive_entry *a); 43 44 int 45 archive_entry_birthtime_is_set(struct archive_entry *a); 46 47 void 48 archive_entry_set_birthtime(struct archive_entry *a, time_t sec, 49 long nanosec); 50 51 void 52 archive_entry_unset_birthtime(struct archive_entry *a); 53 54 time_t 55 archive_entry_ctime(struct archive_entry *a); 56 57 long 58 archive_entry_ctime_nsec(struct archive_entry *a); 59 60 int 61 archive_entry_ctime_is_set(struct archive_entry *a); 62 63 void 64 archive_entry_set_ctime(struct archive_entry *a, time_t sec, 65 long nanosec); 66 67 void 68 archive_entry_unset_ctime(struct archive_entry *a); 69 70 time_t 71 archive_entry_mtime(struct archive_entry *a); 72 73 long 74 archive_entry_mtime_nsec(struct archive_entry *a); 75 76 int 77 archive_entry_mtime_is_set(struct archive_entry *a); 78 79 void 80 archive_entry_set_mtime(struct archive_entry *a, time_t sec, 81 long nanosec); 82 83 void 84 archive_entry_unset_mtime(struct archive_entry *a); 85 86DESCRIPTION 87 These functions create and manipulate the time fields in an 88 archive_entry. Supported time fields are atime (access time), birthtime 89 (creation time), ctime (last time an inode property was changed) and 90 mtime (modification time). 91 92 libarchive(3) provides a high-resolution interface. The timestamps are 93 truncated automatically depending on the archive format (for archiving) 94 or the filesystem capabilities (for restoring). 95 96 All timestamp fields are optional. The XXX_unset() functions can be used 97 to mark the corresponding field as missing. The current state can be 98 queried using XXX_is_set(). Unset time fields have a second and nanosec‐ 99 ond field of 0. 100 101SEE ALSO 102 archive_entry(3), libarchive(3) 103 104HISTORY 105 The libarchive library first appeared in FreeBSD 5.3. 106 107AUTHORS 108 The libarchive library was written by Tim Kientzle <kientzle@acm.org>. 109 110BSD February 2, 2012 BSD 111