Add two new convenience functions to query the uid/gid from an
archive_entry. Update the Makefile MLINKS and manpage to bring it up-to-date with the current status of archive_entry. At least the manpage actually lists all of the functions now, even if it doesn't really yet explain them all.
This commit is contained in:
parent
6324e64978
commit
4660ecd1dc
@ -55,6 +55,14 @@ MAN= archive_entry.3 \
|
||||
libarchive-formats.5 \
|
||||
tar.5
|
||||
|
||||
MLINKS+= archive_entry.3 archive_entry_acl_add_entry.3
|
||||
MLINKS+= archive_entry.3 archive_entry_acl_add_entry_w.3
|
||||
MLINKS+= archive_entry.3 archive_entry_acl_clear.3
|
||||
MLINKS+= archive_entry.3 archive_entry_acl_count.3
|
||||
MLINKS+= archive_entry.3 archive_entry_acl_next.3
|
||||
MLINKS+= archive_entry.3 archive_entry_acl_next_w.3
|
||||
MLINKS+= archive_entry.3 archive_entry_acl_reset.3
|
||||
MLINKS+= archive_entry.3 archive_entry_acl_text_w.3
|
||||
MLINKS+= archive_entry.3 archive_entry_clear.3
|
||||
MLINKS+= archive_entry.3 archive_entry_clone.3
|
||||
MLINKS+= archive_entry.3 archive_entry_copy_fflags_text_w.3
|
||||
@ -67,28 +75,37 @@ MLINKS+= archive_entry.3 archive_entry_copy_uname_w.3
|
||||
MLINKS+= archive_entry.3 archive_entry_fflags.3
|
||||
MLINKS+= archive_entry.3 archive_entry_fflags_text.3
|
||||
MLINKS+= archive_entry.3 archive_entry_free.3
|
||||
MLINKS+= archive_entry.3 archive_entry_gid.3
|
||||
MLINKS+= archive_entry.3 archive_entry_gname.3
|
||||
MLINKS+= archive_entry.3 archive_entry_gname_w.3
|
||||
MLINKS+= archive_entry.3 archive_entry_hardlink.3
|
||||
MLINKS+= archive_entry.3 archive_entry_hardlink_w.3
|
||||
MLINKS+= archive_entry.3 archive_entry_ino.3
|
||||
MLINKS+= archive_entry.3 archive_entry_mode.3
|
||||
MLINKS+= archive_entry.3 archive_entry_mtime.3
|
||||
MLINKS+= archive_entry.3 archive_entry_mtime_nsec.3
|
||||
MLINKS+= archive_entry.3 archive_entry_new.3
|
||||
MLINKS+= archive_entry.3 archive_entry_pathname.3
|
||||
MLINKS+= archive_entry.3 archive_entry_pathname_w.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_devmajor.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_devminor.3
|
||||
MLINKS+= archive_entry.3 archive_entry_rdev.3
|
||||
MLINKS+= archive_entry.3 archive_entry_rdevmajor.3
|
||||
MLINKS+= archive_entry.3 archive_entry_rdevminor.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_fflags.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_gid.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_gname.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_hardlink.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_link.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_mode.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_pathname.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_rdevmajor.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_rdevminor.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_size.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_symlink.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_uid.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_uname.3
|
||||
MLINKS+= archive_entry.3 archive_entry_size.3
|
||||
MLINKS+= archive_entry.3 archive_entry_stat.3
|
||||
MLINKS+= archive_entry.3 archive_entry_symlink.3
|
||||
MLINKS+= archive_entry.3 archive_entry_symlink_w.3
|
||||
MLINKS+= archive_entry.3 archive_entry_uid.3
|
||||
MLINKS+= archive_entry.3 archive_entry_uname.3
|
||||
MLINKS+= archive_entry.3 archive_entry_uname_w.3
|
||||
MLINKS+= archive_read.3 archive_read_data.3
|
||||
|
@ -55,6 +55,14 @@ MAN= archive_entry.3 \
|
||||
libarchive-formats.5 \
|
||||
tar.5
|
||||
|
||||
MLINKS+= archive_entry.3 archive_entry_acl_add_entry.3
|
||||
MLINKS+= archive_entry.3 archive_entry_acl_add_entry_w.3
|
||||
MLINKS+= archive_entry.3 archive_entry_acl_clear.3
|
||||
MLINKS+= archive_entry.3 archive_entry_acl_count.3
|
||||
MLINKS+= archive_entry.3 archive_entry_acl_next.3
|
||||
MLINKS+= archive_entry.3 archive_entry_acl_next_w.3
|
||||
MLINKS+= archive_entry.3 archive_entry_acl_reset.3
|
||||
MLINKS+= archive_entry.3 archive_entry_acl_text_w.3
|
||||
MLINKS+= archive_entry.3 archive_entry_clear.3
|
||||
MLINKS+= archive_entry.3 archive_entry_clone.3
|
||||
MLINKS+= archive_entry.3 archive_entry_copy_fflags_text_w.3
|
||||
@ -67,28 +75,37 @@ MLINKS+= archive_entry.3 archive_entry_copy_uname_w.3
|
||||
MLINKS+= archive_entry.3 archive_entry_fflags.3
|
||||
MLINKS+= archive_entry.3 archive_entry_fflags_text.3
|
||||
MLINKS+= archive_entry.3 archive_entry_free.3
|
||||
MLINKS+= archive_entry.3 archive_entry_gid.3
|
||||
MLINKS+= archive_entry.3 archive_entry_gname.3
|
||||
MLINKS+= archive_entry.3 archive_entry_gname_w.3
|
||||
MLINKS+= archive_entry.3 archive_entry_hardlink.3
|
||||
MLINKS+= archive_entry.3 archive_entry_hardlink_w.3
|
||||
MLINKS+= archive_entry.3 archive_entry_ino.3
|
||||
MLINKS+= archive_entry.3 archive_entry_mode.3
|
||||
MLINKS+= archive_entry.3 archive_entry_mtime.3
|
||||
MLINKS+= archive_entry.3 archive_entry_mtime_nsec.3
|
||||
MLINKS+= archive_entry.3 archive_entry_new.3
|
||||
MLINKS+= archive_entry.3 archive_entry_pathname.3
|
||||
MLINKS+= archive_entry.3 archive_entry_pathname_w.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_devmajor.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_devminor.3
|
||||
MLINKS+= archive_entry.3 archive_entry_rdev.3
|
||||
MLINKS+= archive_entry.3 archive_entry_rdevmajor.3
|
||||
MLINKS+= archive_entry.3 archive_entry_rdevminor.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_fflags.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_gid.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_gname.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_hardlink.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_link.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_mode.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_pathname.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_rdevmajor.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_rdevminor.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_size.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_symlink.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_uid.3
|
||||
MLINKS+= archive_entry.3 archive_entry_set_uname.3
|
||||
MLINKS+= archive_entry.3 archive_entry_size.3
|
||||
MLINKS+= archive_entry.3 archive_entry_stat.3
|
||||
MLINKS+= archive_entry.3 archive_entry_symlink.3
|
||||
MLINKS+= archive_entry.3 archive_entry_symlink_w.3
|
||||
MLINKS+= archive_entry.3 archive_entry_uid.3
|
||||
MLINKS+= archive_entry.3 archive_entry_uname.3
|
||||
MLINKS+= archive_entry.3 archive_entry_uname_w.3
|
||||
MLINKS+= archive_read.3 archive_read_data.3
|
||||
|
@ -28,27 +28,41 @@
|
||||
.Dt archive_entry 3
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm archive_entry_acl_add_entry
|
||||
.Nm archive_entry_acl_add_entry_w
|
||||
.Nm archive_entry_acl_clear
|
||||
.Nm archive_entry_acl_count
|
||||
.Nm archive_entry_acl_next
|
||||
.Nm archive_entry_acl_next_w
|
||||
.Nm archive_entry_acl_reset
|
||||
.Nm archive_entry_acl_text_w
|
||||
.Nm archive_entry_clear
|
||||
.Nm archive_entry_clone
|
||||
.Nm archive_entry_copy_fflags_text_w
|
||||
.Nm archive_entry_copy_gname_w
|
||||
.Nm archive_entry_copy_hardlink
|
||||
.Nm archive_entry_copy_hardlink_w
|
||||
.Nm archive_entry_copy_pathname_w
|
||||
.Nm archive_entry_copy_stat
|
||||
.Nm archive_entry_copy_symlink_w
|
||||
.Nm archive_entry_copy_uname_w
|
||||
.Nm archive_entry_dev
|
||||
.Nm archive_entry_fflags
|
||||
.Nm archive_entry_fflags_text
|
||||
.Nm archive_entry_free
|
||||
.Nm archive_entry_gid
|
||||
.Nm archive_entry_gname
|
||||
.Nm archive_entry_gname_w
|
||||
.Nm archive_entry_hardlink
|
||||
.Nm archive_entry_hardlink_w
|
||||
.Nm archive_entry_ino
|
||||
.Nm archive_entry_mode
|
||||
.Nm archive_entry_mtime
|
||||
.Nm archive_entry_mtime_nsec
|
||||
.Nm archive_entry_new
|
||||
.Nm archive_entry_pathname
|
||||
.Nm archive_entry_pathname_w
|
||||
.Nm archive_entry_set_devmajor
|
||||
.Nm archive_entry_set_devminor
|
||||
.Nm archive_entry_rdev
|
||||
.Nm archive_entry_rdevmajor
|
||||
.Nm archive_entry_rdevminor
|
||||
.Nm archive_entry_set_fflags
|
||||
.Nm archive_entry_set_gid
|
||||
.Nm archive_entry_set_gname
|
||||
@ -56,19 +70,37 @@
|
||||
.Nm archive_entry_set_link
|
||||
.Nm archive_entry_set_mode
|
||||
.Nm archive_entry_set_pathname
|
||||
.Nm archive_entry_set_rdevmajor
|
||||
.Nm archive_entry_set_rdevminor
|
||||
.Nm archive_entry_set_size
|
||||
.Nm archive_entry_set_symlink
|
||||
.Nm archive_entry_set_uid
|
||||
.Nm archive_entry_set_uname
|
||||
.Nm archive_entry_size
|
||||
.Nm archive_entry_stat
|
||||
.Nm archive_entry_symlink
|
||||
.Nm archive_entry_symlink_w
|
||||
.Nm archive_entry_uid
|
||||
.Nm archive_entry_uname
|
||||
.Nm archive_entry_uname_w
|
||||
.Nd functions for manipulating archive entry descriptions
|
||||
.Sh SYNOPSIS
|
||||
.In archive_entry.h
|
||||
.Ft void
|
||||
.Fn archive_entry_acl_add_entry "struct archive_entry *" "int type" "int permset" "int tag" "int qual" "const char *name"
|
||||
.Ft void
|
||||
.Fn archive_entry_acl_add_entry_w "struct archive_entry *" "int type" "int permset" "int tag" "int qual" "const wchar_t *name"
|
||||
.Ft void
|
||||
.Fn archive_entry_acl_clear "struct archive_entry *"
|
||||
.Ft int
|
||||
.Fn archive_entry_acl_count "struct archive_entry *" "int type"
|
||||
.Ft int
|
||||
.Fn archive_entry_acl_next "struct archive_entry *" "int want_type" "int *type" "int *permset" "int *tag" "int *qual" "const char **name"
|
||||
.Ft int
|
||||
.Fn archive_entry_acl_next_w "struct archive_entry *" "int want_type" "int *type" "int *permset" "int *tag" "int *qual" "const wchar_t **name"
|
||||
.Ft void
|
||||
.Fn archive_entry_acl_reset "struct archive_entry *"
|
||||
.Ft const wchar_t *
|
||||
.Fn archive_entry_acl_text_w "struct archive_entry *" "int flags"
|
||||
.Ft void
|
||||
.Fn archive_entry_clear "struct archive_entry *"
|
||||
.Ft struct archive_entry *
|
||||
.Fn archive_entry_clone "struct archive_entry *"
|
||||
@ -77,6 +109,8 @@
|
||||
.Ft void
|
||||
.Fn archive_entry_copy_gname_w "struct archive_entry *" "const wchar_t *"
|
||||
.Ft void
|
||||
.Fn archive_entry_copy_hardlink "struct archive_entry *" "const char *"
|
||||
.Ft void
|
||||
.Fn archive_entry_copy_hardlink_w "struct archive_entry *" "const wchar_t *"
|
||||
.Ft void
|
||||
.Fn archive_entry_copy_pathname_w "struct archive_entry *" "const wchar_t *"
|
||||
@ -86,6 +120,8 @@
|
||||
.Fn archive_entry_copy_symlink_w "struct archive_entry *" "const wchar_t *"
|
||||
.Ft void
|
||||
.Fn archive_entry_copy_uname_w "struct archive_entry *" "const wchar_t *"
|
||||
.Ft dev_t
|
||||
.Fn archive_entry_dev "struct archive_entry *"
|
||||
.Ft void
|
||||
.Fn archive_entry_fflags "struct archive_entry *" "unsigned long *set" "unsigned long *clear"
|
||||
.Ft const char *
|
||||
@ -94,22 +130,28 @@
|
||||
.Fn archive_entry_free "struct archive_entry *"
|
||||
.Ft const char *
|
||||
.Fn archive_entry_gname "struct archive_entry *"
|
||||
.Ft const wchar_t *
|
||||
.Fn archive_entry_gname_w "struct archive_entry *"
|
||||
.Ft const char *
|
||||
.Fn archive_entry_hardlink "struct archive_entry *"
|
||||
.Ft const wchar_t *
|
||||
.Fn archive_entry_hardlink_w "struct archive_entry *"
|
||||
.Ft ino_t
|
||||
.Fn archive_entry_ino "struct archive_entry *"
|
||||
.Ft mode_t
|
||||
.Fn archive_entry_mode "struct archive_entry *"
|
||||
.Ft time_t
|
||||
.Fn archive_entry_mtime "struct archive_entry *"
|
||||
.Ft long
|
||||
.Fn archive_entry_mtime_nsec "struct archive_entry *"
|
||||
.Ft struct archive_entry *
|
||||
.Fn archive_entry_new "void"
|
||||
.Ft const char *
|
||||
.Fn archive_entry_pathname "struct archive_entry *"
|
||||
.Ft const wchar_t *
|
||||
.Fn archive_entry_pathname_w "struct archive_entry *"
|
||||
.Ft void
|
||||
.Fn archive_entry_set_devmajor "struct archive_entry *" "dev_t"
|
||||
.Ft void
|
||||
.Fn archive_entry_set_devminor "struct archive_entry *" "dev_t"
|
||||
.Ft dev_t
|
||||
.Fn archive_entry_rdev "struct archive_entry *"
|
||||
.Ft dev_t
|
||||
.Fn archive_entry_rdevmajor "struct archive_entry *"
|
||||
.Ft dev_t
|
||||
.Fn archive_entry_rdevminor "struct archive_entry *"
|
||||
.Ft void
|
||||
.Fn archive_entry_set_fflags "struct archive_entry *" "unsigned long set" "unsigned long clear"
|
||||
.Ft void
|
||||
@ -119,10 +161,18 @@
|
||||
.Ft void
|
||||
.Fn archive_entry_set_hardlink "struct archive_entry *" "const char *"
|
||||
.Ft void
|
||||
.Fn archive_entry_set_link "struct archive_entry *" "const char *"
|
||||
.Ft void
|
||||
.Fn archive_entry_set_mode "struct archive_entry *" "mode_t"
|
||||
.Ft void
|
||||
.Fn archive_entry_set_pathname "struct archive_entry *" "const char *"
|
||||
.Ft void
|
||||
.Fn archive_entry_set_rdevmajor "struct archive_entry *" "dev_t"
|
||||
.Ft void
|
||||
.Fn archive_entry_set_rdevminor "struct archive_entry *" "dev_t"
|
||||
.Ft void
|
||||
.Fn archive_entry_set_size "struct archive_entry *" "int64_t"
|
||||
.Ft void
|
||||
.Fn archive_entry_set_symlink "struct archive_entry *" "const char *"
|
||||
.Ft void
|
||||
.Fn archive_entry_set_uid "struct archive_entry *" "uid_t"
|
||||
@ -134,12 +184,8 @@
|
||||
.Fn archive_entry_stat "struct archive_entry *"
|
||||
.Ft const char *
|
||||
.Fn archive_entry_symlink "struct archive_entry *"
|
||||
.Ft const wchar_t *
|
||||
.Fn archive_entry_symlink_w "struct archive_entry *"
|
||||
.Ft const char *
|
||||
.Fn archive_entry_uname "struct archive_entry *"
|
||||
.Ft const wchar_t *
|
||||
.Fn archive_entry_uname_w "struct archive_entry *"
|
||||
.Sh DESCRIPTION
|
||||
These functions create and manipulate data objects that
|
||||
represent entries within an archive.
|
||||
|
@ -384,6 +384,12 @@ archive_entry_fflags_text(struct archive_entry *entry)
|
||||
return (f);
|
||||
}
|
||||
|
||||
gid_t
|
||||
archive_entry_gid(struct archive_entry *entry)
|
||||
{
|
||||
return (entry->ae_stat.st_gid);
|
||||
}
|
||||
|
||||
const char *
|
||||
archive_entry_gname(struct archive_entry *entry)
|
||||
{
|
||||
@ -468,6 +474,12 @@ archive_entry_symlink(struct archive_entry *entry)
|
||||
return (aes_get_mbs(&entry->ae_symlink));
|
||||
}
|
||||
|
||||
uid_t
|
||||
archive_entry_uid(struct archive_entry *entry)
|
||||
{
|
||||
return (entry->ae_stat.st_uid);
|
||||
}
|
||||
|
||||
const char *
|
||||
archive_entry_uname(struct archive_entry *entry)
|
||||
{
|
||||
|
@ -47,8 +47,6 @@
|
||||
* such extensions may make this library useful for special
|
||||
* applications (e.g., a package manager could attach special
|
||||
* package-management attributes to each entry).
|
||||
*
|
||||
* TODO: Design a good API for handling sparse files.
|
||||
*/
|
||||
struct archive_entry;
|
||||
|
||||
@ -67,9 +65,10 @@ struct archive_entry *archive_entry_new(void);
|
||||
*/
|
||||
|
||||
dev_t archive_entry_dev(struct archive_entry *);
|
||||
const char *archive_entry_fflags_text(struct archive_entry *);
|
||||
void archive_entry_fflags(struct archive_entry *,
|
||||
unsigned long *set, unsigned long *clear);
|
||||
const char *archive_entry_fflags_text(struct archive_entry *);
|
||||
gid_t archive_entry_gid(struct archive_entry *);
|
||||
const char *archive_entry_gname(struct archive_entry *);
|
||||
const char *archive_entry_hardlink(struct archive_entry *);
|
||||
ino_t archive_entry_ino(struct archive_entry *);
|
||||
@ -84,6 +83,7 @@ dev_t archive_entry_rdevminor(struct archive_entry *);
|
||||
int64_t archive_entry_size(struct archive_entry *);
|
||||
const struct stat *archive_entry_stat(struct archive_entry *);
|
||||
const char *archive_entry_symlink(struct archive_entry *);
|
||||
uid_t archive_entry_uid(struct archive_entry *);
|
||||
const char *archive_entry_uname(struct archive_entry *);
|
||||
|
||||
/*
|
||||
|
Loading…
Reference in New Issue
Block a user