archive_entry_time (3)

Leading comments

Copyright (c) 2003-2007 Tim Kientzle
Copyright (c) 2010 Joerg Sonnenberger
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
   notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
   notice, this list of conditions and the following disc...

(The comments found at the beginning of the groff file "man3/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

In archive_entry.h Ft time_t Fn archive_entry_atime struct archive_entry *a Ft long Fn archive_entry_atime_nsec struct archive_entry *a Ft int Fn archive_entry_atime_is_set struct archive_entry *a Ft void Fn archive_entry_set_atime struct archive_entry *a time_t sec long nanosec Ft void Fn archive_entry_unset_atime struct archive_entry *a Ft time_t Fn archive_entry_birthtime struct archive_entry *a Ft long Fn archive_entry_birthtime_nsec struct archive_entry *a Ft int Fn archive_entry_birthtime_is_set struct archive_entry *a Ft void Fn archive_entry_set_birthtime struct archive_entry *a time_t sec long nanosec Ft void Fn archive_entry_unset_birthtime struct archive_entry *a Ft time_t Fn archive_entry_ctime struct archive_entry *a Ft long Fn archive_entry_ctime_nsec struct archive_entry *a Ft int Fn archive_entry_ctime_is_set struct archive_entry *a Ft void Fn archive_entry_set_ctime struct archive_entry *a time_t sec long nanosec Ft void Fn archive_entry_unset_ctime struct archive_entry *a Ft time_t Fn archive_entry_mtime struct archive_entry *a Ft long Fn archive_entry_mtime_nsec struct archive_entry *a Ft int Fn archive_entry_mtime_is_set struct archive_entry *a Ft void Fn archive_entry_set_mtime struct archive_entry *a time_t sec long nanosec Ft void Fn archive_entry_unset_mtime struct archive_entry *a

DESCRIPTION

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

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 Fn XXX_unset functions can be used to mark the corresponding field as missing. The current state can be queried using Fn XXX_is_set . Unset time fields have a second and nanosecond field of 0.

SEE ALSO

archive_entry3 libarchive(3),

HISTORY

The libarchive library first appeared in Fx 5.3 .

AUTHORS

An -nosplit The libarchive library was written by An Tim Kientzle Aq kientzle@acm.org .