mirror of
https://github.com/cmclark00/retro-imager.git
synced 2025-05-19 08:25:21 +01:00
67618a2eac
- Update bunlded libarchive version used on Windows/Mac - Enable requested zstd support while we are at it. Closes #211
146 lines
3.7 KiB
Groff
146 lines
3.7 KiB
Groff
.TH ARCHIVE_ENTRY_TIME 3 "February 2, 2012" ""
|
|
.SH NAME
|
|
.ad l
|
|
\fB\%archive_entry_atime\fP,
|
|
\fB\%archive_entry_atime_nsec\fP,
|
|
\fB\%archive_entry_atime_is_set\fP,
|
|
\fB\%archive_entry_set_atime\fP,
|
|
\fB\%archive_entry_unset_atime\fP,
|
|
\fB\%archive_entry_birthtime\fP,
|
|
\fB\%archive_entry_birthtime_nsec\fP,
|
|
\fB\%archive_entry_birthtime_is_set\fP,
|
|
\fB\%archive_entry_set_birthtime\fP,
|
|
\fB\%archive_entry_unset_birthtime\fP,
|
|
\fB\%archive_entry_ctime\fP,
|
|
\fB\%archive_entry_ctime_nsec\fP,
|
|
\fB\%archive_entry_ctime_is_set\fP,
|
|
\fB\%archive_entry_set_ctime\fP,
|
|
\fB\%archive_entry_unset_ctime\fP,
|
|
\fB\%archive_entry_mtime\fP,
|
|
\fB\%archive_entry_mtime_nsec\fP,
|
|
\fB\%archive_entry_mtime_is_set\fP,
|
|
\fB\%archive_entry_set_mtime\fP,
|
|
\fB\%archive_entry_unset_mtime\fP
|
|
\- functions for manipulating times in archive entry descriptions
|
|
.SH LIBRARY
|
|
.ad l
|
|
Streaming Archive Library (libarchive, -larchive)
|
|
.SH SYNOPSIS
|
|
.ad l
|
|
\fB#include <archive_entry.h>\fP
|
|
.br
|
|
\fItime_t\fP
|
|
.br
|
|
\fB\%archive_entry_atime\fP(\fI\%struct\ archive_entry\ *a\fP);
|
|
.br
|
|
\fIlong\fP
|
|
.br
|
|
\fB\%archive_entry_atime_nsec\fP(\fI\%struct\ archive_entry\ *a\fP);
|
|
.br
|
|
\fIint\fP
|
|
.br
|
|
\fB\%archive_entry_atime_is_set\fP(\fI\%struct\ archive_entry\ *a\fP);
|
|
.br
|
|
\fIvoid\fP
|
|
.br
|
|
\fB\%archive_entry_set_atime\fP(\fI\%struct\ archive_entry\ *a\fP, \fI\%time_t\ sec\fP, \fI\%long\ nanosec\fP);
|
|
.br
|
|
\fIvoid\fP
|
|
.br
|
|
\fB\%archive_entry_unset_atime\fP(\fI\%struct\ archive_entry\ *a\fP);
|
|
.br
|
|
\fItime_t\fP
|
|
.br
|
|
\fB\%archive_entry_birthtime\fP(\fI\%struct\ archive_entry\ *a\fP);
|
|
.br
|
|
\fIlong\fP
|
|
.br
|
|
\fB\%archive_entry_birthtime_nsec\fP(\fI\%struct\ archive_entry\ *a\fP);
|
|
.br
|
|
\fIint\fP
|
|
.br
|
|
\fB\%archive_entry_birthtime_is_set\fP(\fI\%struct\ archive_entry\ *a\fP);
|
|
.br
|
|
\fIvoid\fP
|
|
.br
|
|
\fB\%archive_entry_set_birthtime\fP(\fI\%struct\ archive_entry\ *a\fP, \fI\%time_t\ sec\fP, \fI\%long\ nanosec\fP);
|
|
.br
|
|
\fIvoid\fP
|
|
.br
|
|
\fB\%archive_entry_unset_birthtime\fP(\fI\%struct\ archive_entry\ *a\fP);
|
|
.br
|
|
\fItime_t\fP
|
|
.br
|
|
\fB\%archive_entry_ctime\fP(\fI\%struct\ archive_entry\ *a\fP);
|
|
.br
|
|
\fIlong\fP
|
|
.br
|
|
\fB\%archive_entry_ctime_nsec\fP(\fI\%struct\ archive_entry\ *a\fP);
|
|
.br
|
|
\fIint\fP
|
|
.br
|
|
\fB\%archive_entry_ctime_is_set\fP(\fI\%struct\ archive_entry\ *a\fP);
|
|
.br
|
|
\fIvoid\fP
|
|
.br
|
|
\fB\%archive_entry_set_ctime\fP(\fI\%struct\ archive_entry\ *a\fP, \fI\%time_t\ sec\fP, \fI\%long\ nanosec\fP);
|
|
.br
|
|
\fIvoid\fP
|
|
.br
|
|
\fB\%archive_entry_unset_ctime\fP(\fI\%struct\ archive_entry\ *a\fP);
|
|
.br
|
|
\fItime_t\fP
|
|
.br
|
|
\fB\%archive_entry_mtime\fP(\fI\%struct\ archive_entry\ *a\fP);
|
|
.br
|
|
\fIlong\fP
|
|
.br
|
|
\fB\%archive_entry_mtime_nsec\fP(\fI\%struct\ archive_entry\ *a\fP);
|
|
.br
|
|
\fIint\fP
|
|
.br
|
|
\fB\%archive_entry_mtime_is_set\fP(\fI\%struct\ archive_entry\ *a\fP);
|
|
.br
|
|
\fIvoid\fP
|
|
.br
|
|
\fB\%archive_entry_set_mtime\fP(\fI\%struct\ archive_entry\ *a\fP, \fI\%time_t\ sec\fP, \fI\%long\ nanosec\fP);
|
|
.br
|
|
\fIvoid\fP
|
|
.br
|
|
\fB\%archive_entry_unset_mtime\fP(\fI\%struct\ archive_entry\ *a\fP);
|
|
.SH DESCRIPTION
|
|
.ad l
|
|
These functions create and manipulate the time fields in an
|
|
Vt archive_entry.
|
|
Supported time fields are atime (access time), birthtime (creation time),
|
|
ctime (last time an inode property was changed) and mtime (modification time).
|
|
.PP
|
|
\fBlibarchive\fP(3)
|
|
provides a high-resolution interface.
|
|
The timestamps are truncated automatically depending on the archive format
|
|
(for archiving) or the filesystem capabilities (for restoring).
|
|
.PP
|
|
All timestamp fields are optional.
|
|
The
|
|
\fB\%XXX_unset\fP()
|
|
functions can be used to mark the corresponding field as missing.
|
|
The current state can be queried using
|
|
\fB\%XXX_is_set\fP().
|
|
Unset time fields have a second and nanosecond field of 0.
|
|
.SH SEE ALSO
|
|
.ad l
|
|
\fBarchive_entry\fP(3),
|
|
\fBlibarchive\fP(3)
|
|
.SH HISTORY
|
|
.ad l
|
|
The
|
|
\fB\%libarchive\fP
|
|
library first appeared in
|
|
FreeBSD 5.3.
|
|
.SH AUTHORS
|
|
.ad l
|
|
-nosplit
|
|
The
|
|
\fB\%libarchive\fP
|
|
library was written by
|
|
Tim Kientzle \%<kientzle@acm.org.>
|