ARCHIVE_ENTRY_PATHS 3 "February 2, 2012" ""
NAME
\%archive_entry_hardlink, \%archive_entry_hardlink_w, \%archive_entry_set_hardlink, \%archive_entry_copy_hardlink, \%archive_entry_copy_hardlink_w, \%archive_entry_update_hardlink_utf8, \%archive_entry_set_link, \%archive_entry_copy_link, \%archive_entry_copy_link_w, \%archive_entry_update_link_utf8, \%archive_entry_pathname, \%archive_entry_pathname_w, \%archive_entry_set_pathname, \%archive_entry_copy_pathname, \%archive_entry_copy_pathname_w, \%archive_entry_update_pathname_utf8, \%archive_entry_sourcepath, \%archive_entry_copy_sourcepath, \%archive_entry_symlink, \%archive_entry_symlink_w, \%archive_entry_set_symlink, \%archive_entry_copy_symlink, \%archive_entry_copy_symlink_w, \%archive_entry_update_symlink_utf8 - functions for manipulating path names in archive entry descriptions
LIBRARY
Streaming Archive Library (libarchive, -larchive)
SYNOPSIS
#include <archive_entry.h>

const char *

\%archive_entry_hardlink(\%struct archive_entry *a);

const wchar_t *

\%archive_entry_hardlink_w(\%struct archive_entry *a);

void

\%archive_entry_set_hardlink(\%struct archive_entry *a, \%const char *path);

void

\%archive_entry_copy_hardlink(\%struct archive_entry *a, \%const char *path);

void

\%archive_entry_copy_hardlink_w(\%struct archive_entry *a , \%const, \%wchar_t, \%*path");

int

\%archive_entry_update_hardlink_utf8(\%struct archive_entry *a, \%const char *path);

void

\%archive_entry_set_link(\%struct archive_entry *a, \%const char *path);

void

\%archive_entry_copy_link(\%struct archive_entry *a, \% const char *path);

void

\%archive_entry_copy_link_w(\%struct archive_entry *a, \% const wchar_t *path);

int

\%archive_entry_update_link_utf8(\%struct archive_entry *a, \% const char *path);

const char *

\%archive_entry_pathname(\%struct archive_entry *a);

const wchar_t *

\%archive_entry_pathname_w(\%struct archive_entry *a);

void

\%archive_entry_set_pathname(\%struct archive_entry *a, \%const char *path);

void

\%archive_entry_copy_pathname(\%struct archive_entry *a, \%const char *path);

void

\%archive_entry_copy_pathname_w(\%struct archive_entry *a, \%const wchar_t *path);

int

\%archive_entry_update_pathname_utf8(\%struct archive_entry *a, \%const char *path);

const char *

\%archive_entry_sourcepath(\%struct archive_entry *a);

void

\%archive_entry_copy_sourcepath(\%struct archive_entry *a, \%const char *path);

const char *

\%archive_entry_symlink(\%struct archive_entry *a);

const wchar_t *

\%archive_entry_symlink_w(\%struct archive_entry *a);

void

\%archive_entry_set_symlink(\%struct archive_entry *a, \%const char *path);

void

\%archive_entry_copy_symlink(\%struct archive_entry *a, \%const char *path);

void

\%archive_entry_copy_symlink_w(\%struct archive_entry *a, \%const wchar_t *path);

int

\%archive_entry_update_symlink_utf8(\%struct archive_entry *a, \%const char *path);

DESCRIPTION
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().

SEE ALSO
archive_entry(3), libarchive(3)