diff options
author | joerg <joerg@pkgsrc.org> | 2017-08-01 22:21:09 +0000 |
---|---|---|
committer | joerg <joerg@pkgsrc.org> | 2017-08-01 22:21:09 +0000 |
commit | 8ebf4e7079542370a0dd5eba7eed1790d20c7f96 (patch) | |
tree | 3c71484d8e555935fd266acfd45eff3b04d0f139 /archivers/libarchive/files/doc/text/archive_entry.3.txt | |
parent | c8fcd52665c6781876ed54832bd7f6ea46348688 (diff) | |
download | pkgsrc-8ebf4e7079542370a0dd5eba7eed1790d20c7f96.tar.gz |
Import libarchive-3.3.2 + 9de5f3 + f9dacbf:
- Support NFS4 ACLs on Linux
- Bugfixes
Diffstat (limited to 'archivers/libarchive/files/doc/text/archive_entry.3.txt')
-rw-r--r-- | archivers/libarchive/files/doc/text/archive_entry.3.txt | 68 |
1 files changed, 34 insertions, 34 deletions
diff --git a/archivers/libarchive/files/doc/text/archive_entry.3.txt b/archivers/libarchive/files/doc/text/archive_entry.3.txt index e2ef91952f4..d9dd1c0ed39 100644 --- a/archivers/libarchive/files/doc/text/archive_entry.3.txt +++ b/archivers/libarchive/files/doc/text/archive_entry.3.txt @@ -1,28 +1,28 @@ ARCHIVE_ENTRY(3) BSD Library Functions Manual ARCHIVE_ENTRY(3) -1mNAME0m - 1marchive_entry_clear22m, 1marchive_entry_clone22m, 1marchive_entry_free22m, - 1marchive_entry_new22m, — functions for managing archive entry descriptions +NAME + archive_entry_clear, archive_entry_clone, archive_entry_free, + archive_entry_new, — functions for managing archive entry descriptions -1mLIBRARY0m +LIBRARY Streaming Archive Library (libarchive, -larchive) -1mSYNOPSIS0m - 1m#include <archive_entry.h>0m +SYNOPSIS + #include <archive_entry.h> - 4mstruct24m 4marchive_entry24m 4m*0m - 1marchive_entry_clear22m(4mstruct24m 4marchive_entry24m 4m*24m); + struct archive_entry * + archive_entry_clear(struct archive_entry *); - 4mstruct24m 4marchive_entry24m 4m*0m - 1marchive_entry_clone22m(4mstruct24m 4marchive_entry24m 4m*24m); + struct archive_entry * + archive_entry_clone(struct archive_entry *); - 4mvoid0m - 1marchive_entry_free22m(4mstruct24m 4marchive_entry24m 4m*24m); + void + archive_entry_free(struct archive_entry *); - 4mstruct24m 4marchive_entry24m 4m*0m - 1marchive_entry_new22m(4mvoid24m); + struct archive_entry * + archive_entry_new(void); -1mDESCRIPTION0m +DESCRIPTION These functions create and manipulate data objects that represent entries within an archive. You can think of a struct archive_entry as a heavy- duty version of struct stat: it includes everything from struct stat plus @@ -30,21 +30,21 @@ ARCHIVE_ENTRY(3) BSD Library Functions Manual ARCHIVE_ENTRY(3) are used by libarchive(3) to represent the metadata associated with a particular entry in an archive. - 1mCreate and Destroy0m - There are functions to allocate, destroy, clear, and copy 4marchive_entry0m + Create and Destroy + There are functions to allocate, destroy, clear, and copy archive_entry objects: - 1marchive_entry_clear22m() + archive_entry_clear() Erases the object, resetting all internal fields to the same state as a newly-created object. This is provided to allow you to quickly recycle objects without thrashing the heap. - 1marchive_entry_clone22m() + archive_entry_clone() A deep copy operation; all text fields are duplicated. - 1marchive_entry_free22m() + archive_entry_free() Releases the struct archive_entry object. - 1marchive_entry_new22m() + archive_entry_new() Allocate and return a blank struct archive_entry object. - 1mFunction groups0m + Function groups Due to high number of functions, the accessor functions can be found in man pages grouped by the purpose. @@ -55,38 +55,38 @@ ARCHIVE_ENTRY(3) BSD Library Functions Manual ARCHIVE_ENTRY(3) archive_entry_perms(3) User, group and mode manipulation archive_entry_stat(3) Functions not in the other groups and copying - to/from 4mstruct24m 4mstat24m. + to/from struct stat. archive_entry_time(3) Time field manipulation Most of the functions set or read entries in an object. Such functions have one of the following forms: - 1marchive_entry_set_XXXX22m() + archive_entry_set_XXXX() Stores the provided data in the object. In particular, for strings, the pointer is stored, not the referenced string. - 1marchive_entry_copy_XXXX22m() + archive_entry_copy_XXXX() As above, except that the referenced data is copied into the object. - 1marchive_entry_XXXX22m() + archive_entry_XXXX() Returns the specified data. In the case of strings, a const- qualified pointer to the string is returned. String data can be set or accessed as wide character strings or normal - 4mchar24m strings. The functions that use wide character strings are suffixed - with 1m_w22m. Note that these are different representations of the same data: + char strings. The functions that use wide character strings are suffixed + with _w. Note that these are different representations of the same data: For example, if you store a narrow string and read the corresponding wide string, the object will transparently convert formats using the current locale. Similarly, if you store a wide string and then store a narrow string for the same data, the previously-set wide string will be dis‐ carded in favor of the new data. -1mSEE ALSO0m +SEE ALSO archive_entry_acl(3), archive_entry_paths(3), archive_entry_perms(3), archive_entry_time(3) libarchive(3), -1mHISTORY0m - The 1mlibarchive 22mlibrary first appeared in FreeBSD 5.3. +HISTORY + The libarchive library first appeared in FreeBSD 5.3. -1mAUTHORS0m - The 1mlibarchive 22mlibrary was written by Tim Kientzle <kientzle@acm.org>. +AUTHORS + The libarchive library was written by Tim Kientzle <kientzle@acm.org>. -BSD Feburary 2, 2012 BSD +BSD February 2, 2012 BSD |