doc/wiki/ManPageArchiveEntryTime3.wiki

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