1<!-- Creator : groff version 1.22.4 --> 2<!-- CreationDate: Sun Aug 22 23:03:25 2021 --> 3<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 4"http://www.w3.org/TR/html4/loose.dtd"> 5<html> 6<head> 7<meta name="generator" content="groff -Thtml, see www.gnu.org"> 8<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"> 9<meta name="Content-Style" content="text/css"> 10<style type="text/css"> 11 p { margin-top: 0; margin-bottom: 0; vertical-align: top } 12 pre { margin-top: 0; margin-bottom: 0; vertical-align: top } 13 table { margin-top: 0; margin-bottom: 0; vertical-align: top } 14 h1 { text-align: center } 15</style> 16<title></title> 17</head> 18<body> 19 20<hr> 21 22 23<p>ARCHIVE_ENTRY_TIME(3) BSD Library Functions Manual 24ARCHIVE_ENTRY_TIME(3)</p> 25 26<p style="margin-top: 1em"><b>NAME</b></p> 27 28<p style="margin-left:6%;"><b>archive_entry_atime</b>, 29<b>archive_entry_atime_nsec</b>, 30<b>archive_entry_atime_is_set</b>, 31<b>archive_entry_set_atime</b>, 32<b>archive_entry_unset_atime</b>, 33<b>archive_entry_birthtime</b>, 34<b>archive_entry_birthtime_nsec</b>, 35<b>archive_entry_birthtime_is_set</b>, 36<b>archive_entry_set_birthtime</b>, 37<b>archive_entry_unset_birthtime</b>, 38<b>archive_entry_ctime</b>, <b>archive_entry_ctime_nsec</b>, 39<b>archive_entry_ctime_is_set</b>, 40<b>archive_entry_set_ctime</b>, 41<b>archive_entry_unset_ctime</b>, 42<b>archive_entry_mtime</b>, <b>archive_entry_mtime_nsec</b>, 43<b>archive_entry_mtime_is_set</b>, 44<b>archive_entry_set_mtime</b>, 45<b>archive_entry_unset_mtime</b> — functions for 46manipulating times in archive entry descriptions</p> 47 48<p style="margin-top: 1em"><b>LIBRARY</b></p> 49 50<p style="margin-left:6%;">Streaming Archive Library 51(libarchive, -larchive)</p> 52 53<p style="margin-top: 1em"><b>SYNOPSIS</b></p> 54 55<p style="margin-left:6%;"><b>#include 56<archive_entry.h></b></p> 57 58 59<p style="margin-left:6%; margin-top: 1em"><i>time_t</i></p> 60 61 62<p style="margin-left:12%;"><b>archive_entry_atime</b>(<i>struct archive_entry *a</i>);</p> 63 64<p style="margin-left:6%; margin-top: 1em"><i>long</i></p> 65 66 67<p style="margin-left:12%;"><b>archive_entry_atime_nsec</b>(<i>struct archive_entry *a</i>);</p> 68 69<p style="margin-left:6%; margin-top: 1em"><i>int</i></p> 70 71 72<p style="margin-left:12%;"><b>archive_entry_atime_is_set</b>(<i>struct archive_entry *a</i>);</p> 73 74<p style="margin-left:6%; margin-top: 1em"><i>void</i></p> 75 76 77<p style="margin-left:12%;"><b>archive_entry_set_atime</b>(<i>struct archive_entry *a</i>, 78<i>time_t sec</i>, <i>long nanosec</i>);</p> 79 80<p style="margin-left:6%; margin-top: 1em"><i>void</i></p> 81 82 83<p style="margin-left:12%;"><b>archive_entry_unset_atime</b>(<i>struct archive_entry *a</i>);</p> 84 85 86<p style="margin-left:6%; margin-top: 1em"><i>time_t</i></p> 87 88 89<p style="margin-left:12%;"><b>archive_entry_birthtime</b>(<i>struct archive_entry *a</i>);</p> 90 91<p style="margin-left:6%; margin-top: 1em"><i>long</i></p> 92 93 94<p style="margin-left:12%;"><b>archive_entry_birthtime_nsec</b>(<i>struct archive_entry *a</i>);</p> 95 96<p style="margin-left:6%; margin-top: 1em"><i>int</i></p> 97 98 99<p style="margin-left:12%;"><b>archive_entry_birthtime_is_set</b>(<i>struct archive_entry *a</i>);</p> 100 101<p style="margin-left:6%; margin-top: 1em"><i>void</i></p> 102 103 104<p style="margin-left:12%;"><b>archive_entry_set_birthtime</b>(<i>struct archive_entry *a</i>, 105<i>time_t sec</i>, <i>long nanosec</i>);</p> 106 107<p style="margin-left:6%; margin-top: 1em"><i>void</i></p> 108 109 110<p style="margin-left:12%;"><b>archive_entry_unset_birthtime</b>(<i>struct archive_entry *a</i>);</p> 111 112 113<p style="margin-left:6%; margin-top: 1em"><i>time_t</i></p> 114 115 116<p style="margin-left:12%;"><b>archive_entry_ctime</b>(<i>struct archive_entry *a</i>);</p> 117 118<p style="margin-left:6%; margin-top: 1em"><i>long</i></p> 119 120 121<p style="margin-left:12%;"><b>archive_entry_ctime_nsec</b>(<i>struct archive_entry *a</i>);</p> 122 123<p style="margin-left:6%; margin-top: 1em"><i>int</i></p> 124 125 126<p style="margin-left:12%;"><b>archive_entry_ctime_is_set</b>(<i>struct archive_entry *a</i>);</p> 127 128<p style="margin-left:6%; margin-top: 1em"><i>void</i></p> 129 130 131<p style="margin-left:12%;"><b>archive_entry_set_ctime</b>(<i>struct archive_entry *a</i>, 132<i>time_t sec</i>, <i>long nanosec</i>);</p> 133 134<p style="margin-left:6%; margin-top: 1em"><i>void</i></p> 135 136 137<p style="margin-left:12%;"><b>archive_entry_unset_ctime</b>(<i>struct archive_entry *a</i>);</p> 138 139 140<p style="margin-left:6%; margin-top: 1em"><i>time_t</i></p> 141 142 143<p style="margin-left:12%;"><b>archive_entry_mtime</b>(<i>struct archive_entry *a</i>);</p> 144 145<p style="margin-left:6%; margin-top: 1em"><i>long</i></p> 146 147 148<p style="margin-left:12%;"><b>archive_entry_mtime_nsec</b>(<i>struct archive_entry *a</i>);</p> 149 150<p style="margin-left:6%; margin-top: 1em"><i>int</i></p> 151 152 153<p style="margin-left:12%;"><b>archive_entry_mtime_is_set</b>(<i>struct archive_entry *a</i>);</p> 154 155<p style="margin-left:6%; margin-top: 1em"><i>void</i></p> 156 157 158<p style="margin-left:12%;"><b>archive_entry_set_mtime</b>(<i>struct archive_entry *a</i>, 159<i>time_t sec</i>, <i>long nanosec</i>);</p> 160 161<p style="margin-left:6%; margin-top: 1em"><i>void</i></p> 162 163 164<p style="margin-left:12%;"><b>archive_entry_unset_mtime</b>(<i>struct archive_entry *a</i>);</p> 165 166<p style="margin-top: 1em"><b>DESCRIPTION</b></p> 167 168<p style="margin-left:6%;">These functions create and 169manipulate the time fields in an <i>archive_entry</i>. 170Supported time fields are atime (access time), birthtime 171(creation time), ctime (last time an inode property was 172changed) and mtime (modification time).</p> 173 174<p style="margin-left:6%; margin-top: 1em">libarchive(3) 175provides a high-resolution interface. The timestamps are 176truncated automatically depending on the archive format (for 177archiving) or the filesystem capabilities (for 178restoring).</p> 179 180<p style="margin-left:6%; margin-top: 1em">All timestamp 181fields are optional. The <b>XXX_unset</b>() functions can be 182used to mark the corresponding field as missing. The current 183state can be queried using <b>XXX_is_set</b>(). Unset time 184fields have a second and nanosecond field of 0.</p> 185 186<p style="margin-top: 1em"><b>SEE ALSO</b></p> 187 188<p style="margin-left:6%;">archive_entry(3), 189libarchive(3)</p> 190 191<p style="margin-top: 1em"><b>HISTORY</b></p> 192 193<p style="margin-left:6%;">The <b>libarchive</b> library 194first appeared in FreeBSD 5.3.</p> 195 196<p style="margin-top: 1em"><b>AUTHORS</b></p> 197 198<p style="margin-left:6%;">The <b>libarchive</b> library 199was written by Tim Kientzle <kientzle@acm.org>.</p> 200 201<p style="margin-left:6%; margin-top: 1em">BSD 202February 2, 2012 BSD</p> 203<hr> 204</body> 205</html> 206