archive_entry_copy_symlink3
Functions for manipulating path names in archive entry descriptions
Part of archive_entry_copy_hardlink(3).
Usage
const char
*
const wchar_t
*
void
void
void
int
void
void
void
int
const char
*
const wchar_t
*
void
void
void
int
const char
*
void
const char
*
const wchar_t
*
void
void
void
int
Library
Streaming Archive Library (libarchive, -larchive)
Overview
Path names supported by archive_entry(3):
- hardlink
-
Destination of the hardlink.
- link
-
Update only. For a symlink, update the destination. Otherwise, make the entry a hardlink and alter the destination for that.
- pathname
-
Path in the archive
- sourcepath
-
Path on the disk for use by archive_read_disk(3).
- symlink
-
Destination of the symbolic link.
Path names can be provided in one of three different ways:
- char *
-
Multibyte strings in the current locale.
- wchar_t *
-
Wide character strings in the current locale. The accessor functions are named
XXX_w(). - UTF-8
-
Unicode strings encoded as UTF-8. These are convenience functions to update both the multibyte and wide character strings at the same time.
The sourcepath is a pure filesystem concept and never stored in an archive directly.
For that reason, it is only available as multibyte string. The link path is a convenience function for conditionally setting hardlink or symlink destination. It doesn't have a corresponding get accessor function.
archive_entry_set_XXX() is an alias for archive_entry_copy_XXX().
Releases
30 releases since FreeBSD 10.0-RELEASE; the text changed 7 times.