Archive Entry Time.3

Download as pdf or txt
Download as pdf or txt
You are on page 1of 2

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

NAME
archive_entry_atime, archive_entry_atime_nsec, archive_entry_atime_is_set,
archive_entry_set_atime, archive_entry_unset_atime,
archive_entry_birthtime, archive_entry_birthtime_nsec,
archive_entry_birthtime_is_set, archive_entry_set_birthtime,
archive_entry_unset_birthtime, archive_entry_ctime,
archive_entry_ctime_nsec, archive_entry_ctime_is_set,
archive_entry_set_ctime, archive_entry_unset_ctime, archive_entry_mtime,
archive_entry_mtime_nsec, archive_entry_mtime_is_set,
archive_entry_set_mtime, archive_entry_unset_mtime — functions for manipulating
times in archive entry descriptions

LIBRARY
Streaming Archive Library (libarchive, -larchive)

SYNOPSIS
#include <archive_entry.h>
time_t
archive_entry_atime(struct archive_entry ∗a);
long
archive_entry_atime_nsec(struct archive_entry ∗a);
int
archive_entry_atime_is_set(struct archive_entry ∗a);
void
archive_entry_set_atime(struct archive_entry ∗a , time_t sec , long nanosec);
void
archive_entry_unset_atime(struct archive_entry ∗a);
time_t
archive_entry_birthtime(struct archive_entry ∗a);
long
archive_entry_birthtime_nsec(struct archive_entry ∗a);
int
archive_entry_birthtime_is_set(struct archive_entry ∗a);
void
archive_entry_set_birthtime(struct archive_entry ∗a , time_t sec ,
long nanosec);
void
archive_entry_unset_birthtime(struct archive_entry ∗a);
time_t
archive_entry_ctime(struct archive_entry ∗a);
long
archive_entry_ctime_nsec(struct archive_entry ∗a);
int
archive_entry_ctime_is_set(struct archive_entry ∗a);

BSD February 2, 2012 1


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

void
archive_entry_set_ctime(struct archive_entry ∗a , time_t sec , long nanosec);
void
archive_entry_unset_ctime(struct archive_entry ∗a);
time_t
archive_entry_mtime(struct archive_entry ∗a);
long
archive_entry_mtime_nsec(struct archive_entry ∗a);
int
archive_entry_mtime_is_set(struct archive_entry ∗a);
void
archive_entry_set_mtime(struct archive_entry ∗a , time_t sec , long nanosec);
void
archive_entry_unset_mtime(struct archive_entry ∗a);

DESCRIPTION
These functions create and manipulate the time fields in an archive_entry. Supported time fields are
atime (access time), birthtime (creation time), ctime (last time an inode property was changed) and mtime
(modification time).
libarchive(3) provides a high-resolution interface. The timestamps are truncated automatically depend-
ing on the archive format (for archiving) or the filesystem capabilities (for restoring).
All timestamp fields are optional. The XXX_unset() functions can be used to mark the corresponding field
as missing. The current state can be queried using XXX_is_set(). Unset time fields have a second and
nanosecond field of 0.

SEE ALSO
archive_entry(3), libarchive(3)

HISTORY
The libarchive library first appeared in FreeBSD 5.3.

AUTHORS
The libarchive library was written by Tim Kientzle <[email protected]>.

BSD February 2, 2012 2

You might also like