archive_entry_atime_is_set(3) manual page

Manual Pages — ARCHIVE_ENTRY_TIME

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);

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 depending 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.

HISTORY

The libarchive library first appeared in FreeBSD 5.3 .

AUTHORS

The libarchive library was written by Tim Kientzle <kientzle@acm.org>.

ARCHIVE_ENTRY_TIME (3)

February 2, 2012

Please direct any comments about this manual page service to Ben Bullock. Privacy policy.

“	Never write it in C if you can do it in `awk'; Never do it in `awk' if `sed' can handle it; Never use `sed' when `tr' can do the job; Never invoke `tr' when `cat' is sufficient; Avoid using `cat' whenever possible.	”
— Taylor's Laws of Programming