1ARCHIVE_ENTRY_TIME(3)    BSD Library Functions Manual    ARCHIVE_ENTRY_TIME(3)
2

NAME

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

LIBRARY

17     Streaming Archive Library (libarchive, -larchive)
18

SYNOPSIS

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

DESCRIPTION

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

SEE ALSO

102     archive_entry(3), libarchive(3)
103

HISTORY

105     The libarchive library first appeared in FreeBSD 5.3.
106

AUTHORS

108     The libarchive library was written by Tim Kientzle <kientzle@acm.org>.
109
110BSD                            February 2, 2012                            BSD