|
Packit Service |
1d0348 |
.TH ARCHIVE_ENTRY 3 "February 2, 2012" ""
|
|
Packit Service |
1d0348 |
.SH NAME
|
|
Packit Service |
1d0348 |
.ad l
|
|
Packit Service |
1d0348 |
\fB\%archive_entry_clear\fP,
|
|
Packit Service |
1d0348 |
\fB\%archive_entry_clone\fP,
|
|
Packit Service |
1d0348 |
\fB\%archive_entry_free\fP,
|
|
Packit Service |
1d0348 |
\fB\%archive_entry_new\fP,
|
|
Packit Service |
1d0348 |
\- functions for managing archive entry descriptions
|
|
Packit Service |
1d0348 |
.SH LIBRARY
|
|
Packit Service |
1d0348 |
.ad l
|
|
Packit Service |
1d0348 |
Streaming Archive Library (libarchive, -larchive)
|
|
Packit Service |
1d0348 |
.SH SYNOPSIS
|
|
Packit Service |
1d0348 |
.ad l
|
|
Packit Service |
1d0348 |
\fB#include <archive_entry.h>\fP
|
|
Packit Service |
1d0348 |
.br
|
|
Packit Service |
1d0348 |
\fIstruct archive_entry *\fP
|
|
Packit Service |
1d0348 |
.br
|
|
Packit Service |
1d0348 |
\fB\%archive_entry_clear\fP(\fI\%struct\ archive_entry\ *\fP);
|
|
Packit Service |
1d0348 |
.br
|
|
Packit Service |
1d0348 |
\fIstruct archive_entry *\fP
|
|
Packit Service |
1d0348 |
.br
|
|
Packit Service |
1d0348 |
\fB\%archive_entry_clone\fP(\fI\%struct\ archive_entry\ *\fP);
|
|
Packit Service |
1d0348 |
.br
|
|
Packit Service |
1d0348 |
\fIvoid\fP
|
|
Packit Service |
1d0348 |
.br
|
|
Packit Service |
1d0348 |
\fB\%archive_entry_free\fP(\fI\%struct\ archive_entry\ *\fP);
|
|
Packit Service |
1d0348 |
.br
|
|
Packit Service |
1d0348 |
\fIstruct archive_entry *\fP
|
|
Packit Service |
1d0348 |
.br
|
|
Packit Service |
1d0348 |
\fB\%archive_entry_new\fP(\fI\%void\fP);
|
|
Packit Service |
1d0348 |
.SH DESCRIPTION
|
|
Packit Service |
1d0348 |
.ad l
|
|
Packit Service |
1d0348 |
These functions create and manipulate data objects that
|
|
Packit Service |
1d0348 |
represent entries within an archive.
|
|
Packit Service |
1d0348 |
You can think of a
|
|
Packit Service |
1d0348 |
Tn struct archive_entry
|
|
Packit Service |
1d0348 |
as a heavy-duty version of
|
|
Packit Service |
1d0348 |
Tn struct stat:
|
|
Packit Service |
1d0348 |
it includes everything from
|
|
Packit Service |
1d0348 |
Tn struct stat
|
|
Packit Service |
1d0348 |
plus associated pathname, textual group and user names, etc.
|
|
Packit Service |
1d0348 |
These objects are used by
|
|
Packit Service |
1d0348 |
\fBlibarchive\fP(3)
|
|
Packit Service |
1d0348 |
to represent the metadata associated with a particular
|
|
Packit Service |
1d0348 |
entry in an archive.
|
|
Packit Service |
1d0348 |
.SS Create and Destroy
|
|
Packit Service |
1d0348 |
There are functions to allocate, destroy, clear, and copy
|
|
Packit Service |
1d0348 |
\fIarchive_entry\fP
|
|
Packit Service |
1d0348 |
objects:
|
|
Packit Service |
1d0348 |
.RS 5
|
|
Packit Service |
1d0348 |
.TP
|
|
Packit Service |
1d0348 |
\fB\%archive_entry_clear\fP()
|
|
Packit Service |
1d0348 |
Erases the object, resetting all internal fields to the
|
|
Packit Service |
1d0348 |
same state as a newly-created object.
|
|
Packit Service |
1d0348 |
This is provided to allow you to quickly recycle objects
|
|
Packit Service |
1d0348 |
without thrashing the heap.
|
|
Packit Service |
1d0348 |
.TP
|
|
Packit Service |
1d0348 |
\fB\%archive_entry_clone\fP()
|
|
Packit Service |
1d0348 |
A deep copy operation; all text fields are duplicated.
|
|
Packit Service |
1d0348 |
.TP
|
|
Packit Service |
1d0348 |
\fB\%archive_entry_free\fP()
|
|
Packit Service |
1d0348 |
Releases the
|
|
Packit Service |
1d0348 |
Tn struct archive_entry
|
|
Packit Service |
1d0348 |
object.
|
|
Packit Service |
1d0348 |
.TP
|
|
Packit Service |
1d0348 |
\fB\%archive_entry_new\fP()
|
|
Packit Service |
1d0348 |
Allocate and return a blank
|
|
Packit Service |
1d0348 |
Tn struct archive_entry
|
|
Packit Service |
1d0348 |
object.
|
|
Packit Service |
1d0348 |
.RE
|
|
Packit Service |
1d0348 |
.SS Function groups
|
|
Packit Service |
1d0348 |
Due to high number of functions, the accessor functions can be found in
|
|
Packit Service |
1d0348 |
man pages grouped by the purpose.
|
|
Packit Service |
1d0348 |
.RS 5
|
|
Packit Service |
1d0348 |
.TP
|
|
Packit Service |
1d0348 |
\fBarchive_entry_acl\fP(3)
|
|
Packit Service |
1d0348 |
Access Control List manipulation
|
|
Packit Service |
1d0348 |
.TP
|
|
Packit Service |
1d0348 |
\fBarchive_entry_paths\fP(3)
|
|
Packit Service |
1d0348 |
Path name manipulation
|
|
Packit Service |
1d0348 |
.TP
|
|
Packit Service |
1d0348 |
\fBarchive_entry_perms\fP(3)
|
|
Packit Service |
1d0348 |
User, group and mode manipulation
|
|
Packit Service |
1d0348 |
.TP
|
|
Packit Service |
1d0348 |
\fBarchive_entry_stat\fP(3)
|
|
Packit Service |
1d0348 |
Functions not in the other groups and copying to/from
|
|
Packit Service |
1d0348 |
Vt struct stat.
|
|
Packit Service |
1d0348 |
.TP
|
|
Packit Service |
1d0348 |
\fBarchive_entry_time\fP(3)
|
|
Packit Service |
1d0348 |
Time field manipulation
|
|
Packit Service |
1d0348 |
.RE
|
|
Packit Service |
1d0348 |
.PP
|
|
Packit Service |
1d0348 |
Most of the functions set or read entries in an object.
|
|
Packit Service |
1d0348 |
Such functions have one of the following forms:
|
|
Packit Service |
1d0348 |
.RS 5
|
|
Packit Service |
1d0348 |
.TP
|
|
Packit Service |
1d0348 |
\fB\%archive_entry_set_XXXX\fP()
|
|
Packit Service |
1d0348 |
Stores the provided data in the object.
|
|
Packit Service |
1d0348 |
In particular, for strings, the pointer is stored,
|
|
Packit Service |
1d0348 |
not the referenced string.
|
|
Packit Service |
1d0348 |
.TP
|
|
Packit Service |
1d0348 |
\fB\%archive_entry_copy_XXXX\fP()
|
|
Packit Service |
1d0348 |
As above, except that the referenced data is copied
|
|
Packit Service |
1d0348 |
into the object.
|
|
Packit Service |
1d0348 |
.TP
|
|
Packit Service |
1d0348 |
\fB\%archive_entry_XXXX\fP()
|
|
Packit Service |
1d0348 |
Returns the specified data.
|
|
Packit Service |
1d0348 |
In the case of strings, a const-qualified pointer to
|
|
Packit Service |
1d0348 |
the string is returned.
|
|
Packit Service |
1d0348 |
.RE
|
|
Packit Service |
1d0348 |
String data can be set or accessed as wide character strings
|
|
Packit Service |
1d0348 |
or normal
|
|
Packit Service |
1d0348 |
\fIchar\fP
|
|
Packit Service |
1d0348 |
strings.
|
|
Packit Service |
1d0348 |
The functions that use wide character strings are suffixed with
|
|
Packit Service |
1d0348 |
\fB_w\fP.
|
|
Packit Service |
1d0348 |
Note that these are different representations of the same data:
|
|
Packit Service |
1d0348 |
For example, if you store a narrow string and read the corresponding
|
|
Packit Service |
1d0348 |
wide string, the object will transparently convert formats
|
|
Packit Service |
1d0348 |
using the current locale.
|
|
Packit Service |
1d0348 |
Similarly, if you store a wide string and then store a
|
|
Packit Service |
1d0348 |
narrow string for the same data, the previously-set wide string will
|
|
Packit Service |
1d0348 |
be discarded in favor of the new data.
|
|
Packit Service |
1d0348 |
.PP
|
|
Packit Service |
1d0348 |
.SH SEE ALSO
|
|
Packit Service |
1d0348 |
.ad l
|
|
Packit Service |
1d0348 |
\fBarchive_entry_acl\fP(3),
|
|
Packit Service |
1d0348 |
\fBarchive_entry_paths\fP(3),
|
|
Packit Service |
1d0348 |
\fBarchive_entry_perms\fP(3),
|
|
Packit Service |
1d0348 |
\fBarchive_entry_time\fP(3)
|
|
Packit Service |
1d0348 |
\fBlibarchive\fP(3),
|
|
Packit Service |
1d0348 |
.SH HISTORY
|
|
Packit Service |
1d0348 |
.ad l
|
|
Packit Service |
1d0348 |
The
|
|
Packit Service |
1d0348 |
\fB\%libarchive\fP
|
|
Packit Service |
1d0348 |
library first appeared in
|
|
Packit Service |
1d0348 |
FreeBSD 5.3.
|
|
Packit Service |
1d0348 |
.SH AUTHORS
|
|
Packit Service |
1d0348 |
.ad l
|
|
Packit Service |
1d0348 |
-nosplit
|
|
Packit Service |
1d0348 |
The
|
|
Packit Service |
1d0348 |
\fB\%libarchive\fP
|
|
Packit Service |
1d0348 |
library was written by
|
|
Packit Service |
1d0348 |
Tim Kientzle \%<kientzle@acm.org.>
|