← Back to branch summary

~ubuntu-branches/ubuntu/quantal/libarchive/quantal

« back to all changes in this revision

Viewing changes to doc/text/archive_entry_time.3.txt

  • Committer: Package Import Robot
  • Author(s): Andres Mejia
  • Date: 2012-02-23 19:29:24 UTC
  • mfrom: (8.1.10 sid)
  • Revision ID: package-import@ubuntu.com-20120223192924-73n4iedok5fwgsyr
Tags: 3.0.3-5
* Detect if locales or locales-all is installed for use with test suite.
* Bump Standards-Version to 3.9.3.

Show diffs side-by-side

added added

removed removed

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