archive_entry_set_pathname(3) manual page

Manual Pages — ARCHIVE_ENTRY_PATHS

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

“	One of the advantages of using UNIX to teach an operating systems course is the sources and documentation will easily fit into a student's briefcase.	”
— John Lions

Manual Pages — ARCHIVE_ENTRY_PATHS

NAME

CONTENTS

LIBRARY

SYNOPSIS

DESCRIPTION

SEE ALSO

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.