ARCHIVE_ENTRY_STAT(3) manual page
== NAME ==
'''archive_entry_stat''',
'''archive_entry_copy_stat''',
'''archive_entry_filetype''',
'''archive_entry_set_filetype''',
'''archive_entry_mode''',
'''archive_entry_set_mode''',
'''archive_entry_size''',
'''archive_entry_size_is_set''',
'''archive_entry_set_size''',
'''archive_entry_unset_size''',
'''archive_entry_dev''',
'''archive_entry_set_dev''',
'''archive_entry_dev_is_set''',
'''archive_entry_devmajor''',
'''archive_entry_set_devmajor''',
'''archive_entry_devminor''',
'''archive_entry_set_devminor''',
'''archive_entry_ino''',
'''archive_entry_set_ino''',
'''archive_entry_ino_is_set''',
'''archive_entry_ino64''',
'''archive_entry_set_ino64''',
'''archive_entry_nlink''',
'''archive_entry_rdev''',
'''archive_entry_set_rdev''',
'''archive_entry_rdevmajor''',
'''archive_entry_set_rdevmajor''',
'''archive_entry_rdevminor''',
'''archive_entry_set_rdevminor''',
- accessor functions for manipulating archive entry descriptions
== LIBRARY ==
Streaming Archive Library (libarchive, -larchive)
== SYNOPSIS ==
'''
''const struct stat *''
'''archive_entry_stat'''(''struct archive_entry *a'');
''void''
'''archive_entry_copy_stat'''(''struct archive_entry *a'', ''const struct stat *sb'');
''mode_t''
'''archive_entry_filetype'''(''struct archive_entry *a'');
''void''
'''archive_entry_set_filetype'''(''struct archive_entry *a'', ''unsigned int type'');
''mode_t''
'''archive_entry_mode'''(''struct archive_entry *a'');
''void''
'''archive_entry_set_mode'''(''struct archive_entry *a'', ''mode_t mode'');
''int64_t''
'''archive_entry_size'''(''struct archive_entry *a'');
''int''
'''archive_entry_size_is_set'''(''struct archive_entry *a'');
''void''
'''archive_entry_set_size'''(''struct archive_entry *a'', ''int64_t size'');
''void''
'''archive_entry_unset_size'''(''struct archive_entry *a'');
''dev_t''
'''archive_entry_dev'''(''struct archive_entry *a'');
''void''
'''archive_entry_set_dev'''(''struct archive_entry *a'', ''dev_t dev'');
''int''
'''archive_entry_dev_is_set'''(''struct archive_entry *a'');
''dev_t''
'''archive_entry_devmajor'''(''struct archive_entry *a'');
''void''
'''archive_entry_set_devmajor'''(''struct archive_entry *a'', ''dev_t major'');
''dev_t''
'''archive_entry_devminor'''(''struct archive_entry *a'');
''void''
'''archive_entry_set_devminor'''(''struct archive_entry *a'', ''dev_t minor'');
''ino_t''
'''archive_entry_ino'''(''struct archive_entry *a'');
''void''
'''archive_entry_set_ino'''(''struct archive_entry *a'', ''unsigned long ino'');
''int''
'''archive_entry_ino_is_set'''(''struct archive_entry *a'');
''int64_t''
'''archive_entry_ino64'''(''struct archive_entry *a'');
''void''
'''archive_entry_set_ino64'''(''struct archive_entry *a'', ''int64_t ino'');
''unsigned int''
'''archive_entry_nlink'''(''struct archive_entry *a'');
''void''
'''archive_entry_set_nlink'''(''struct archive_entry *a'', ''unsigned int count'');
''dev_t''
'''archive_entry_rdev'''(''struct archive_entry *a'');
''dev_t''
'''archive_entry_rdevmajor'''(''struct archive_entry *a'');
''dev_t''
'''archive_entry_rdevminor'''(''struct archive_entry *a'');
''void''
'''archive_entry_set_rdev'''(''struct archive_entry *a'', ''dev_t dev'');
''void''
'''archive_entry_set_rdevmajor'''(''struct archive_entry *a'', ''dev_t major'');
''void''
'''archive_entry_set_rdevminor'''(''struct archive_entry *a'', ''dev_t minor'');
== DESCRIPTION ==
=== Copying to and from ''struct'' stat===
The function
'''archive_entry_stat'''()
converts the various fields stored in the archive entry to the format
used by
[[stat(2)|http://www.freebsd.org/cgi/man.cgi?query=stat&sektion=2]].
The return value remains valid until either
'''archive_entry_clear'''()
or
'''archive_entry_free'''()
is called.
It is not affected by calls to the set accessor functions.
It currently sets the following values in
''struct'' stat:
''st_atime'',
''st_ctime'',
''st_dev'',
''st_gid'',
''st_ino'',
''st_mode'',
''st_mtime'',
''st_nlink'',
''st_rdev'',
''st_size'',
''st_uid''.
In addition,
''st_birthtime''
and high-precision information for time-related fields
will be included on platforms that support it.
The function
'''archive_entry_copy_stat'''()
copies fields from the platform's
''struct'' stat.
Fields not provided by
''struct'' stat
are unchanged.
=== General accessor functions===
The functions
'''archive_entry_filetype'''()
and
'''archive_entry_set_filetype'''()
get respectively set the filetype.
The file type is one of the following constants: