archive_entry_birthtime(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.

“	A typical Unix /bin or /usr/bin directory contains a hundred different kinds of programs, written by dozens of egotistical programmers, each with its own syntax, operating paradigm, rules of use ... strategies for specifying options, and different sets of constraints.	”
— The Unix Haters' handbook