2020-03-04 16:55:40 +01:00
|
|
|
|
ARCHIVE_READ_EXTRACT(3) BSD Library Functions Manual ARCHIVE_READ_EXTRACT(3)
|
|
|
|
|
|
|
|
|
|
|
|
NAME
|
|
|
|
|
|
archive_read_extract, archive_read_extract2,
|
2021-12-09 12:22:14 +01:00
|
|
|
|
archive_read_extract_set_progress_callback — functions for reading
|
2020-03-04 16:55:40 +01:00
|
|
|
|
streaming archives
|
|
|
|
|
|
|
|
|
|
|
|
LIBRARY
|
|
|
|
|
|
Streaming Archive Library (libarchive, -larchive)
|
|
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
|
|
#include <archive.h>
|
|
|
|
|
|
|
|
|
|
|
|
int
|
|
|
|
|
|
archive_read_extract(struct archive *, struct archive_entry *,
|
|
|
|
|
|
int flags);
|
|
|
|
|
|
|
|
|
|
|
|
int
|
|
|
|
|
|
archive_read_extract2(struct archive *src, struct archive_entry *,
|
|
|
|
|
|
struct archive *dest);
|
|
|
|
|
|
|
|
|
|
|
|
void
|
|
|
|
|
|
archive_read_extract_set_progress_callback(struct archive *,
|
|
|
|
|
|
void (*func)(void *), void *user_data);
|
|
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
|
archive_read_extract(), archive_read_extract_set_skip_file()
|
|
|
|
|
|
A convenience function that wraps the corresponding
|
|
|
|
|
|
archive_write_disk(3) interfaces. The first call to
|
|
|
|
|
|
archive_read_extract() creates a restore object using
|
|
|
|
|
|
archive_write_disk_new(3) and
|
2021-12-09 12:22:14 +01:00
|
|
|
|
archive_write_disk_set_standard_lookup(3), then transparently in‐
|
|
|
|
|
|
vokes archive_write_disk_set_options(3), archive_write_header(3),
|
|
|
|
|
|
archive_write_data(3), and archive_write_finish_entry(3) to cre‐
|
|
|
|
|
|
ate the entry on disk and copy data into it. The flags argument
|
|
|
|
|
|
is passed unmodified to archive_write_disk_set_options(3).
|
2020-03-04 16:55:40 +01:00
|
|
|
|
archive_read_extract2()
|
|
|
|
|
|
This is another version of archive_read_extract() that allows you
|
|
|
|
|
|
to provide your own restore object. In particular, this allows
|
|
|
|
|
|
you to override the standard lookup functions using
|
|
|
|
|
|
archive_write_disk_set_group_lookup(3), and
|
|
|
|
|
|
archive_write_disk_set_user_lookup(3). Note that
|
|
|
|
|
|
archive_read_extract2() does not accept a flags argument; you
|
|
|
|
|
|
should use archive_write_disk_set_options() to set the restore
|
|
|
|
|
|
options yourself.
|
|
|
|
|
|
archive_read_extract_set_progress_callback()
|
|
|
|
|
|
Sets a pointer to a user-defined callback that can be used for
|
2021-12-09 12:22:14 +01:00
|
|
|
|
updating progress displays during extraction. The progress func‐
|
2020-03-04 16:55:40 +01:00
|
|
|
|
tion will be invoked during the extraction of large regular
|
|
|
|
|
|
files. The progress function will be invoked with the pointer
|
2021-12-09 12:22:14 +01:00
|
|
|
|
provided to this call. Generally, the data pointed to should in‐
|
|
|
|
|
|
clude a reference to the archive object and the archive_entry ob‐
|
|
|
|
|
|
ject so that various statistics can be retrieved for the progress
|
|
|
|
|
|
display.
|
2020-03-04 16:55:40 +01:00
|
|
|
|
|
|
|
|
|
|
RETURN VALUES
|
|
|
|
|
|
Most functions return zero on success, non-zero on error. The possible
|
|
|
|
|
|
return codes include: ARCHIVE_OK (the operation succeeded), ARCHIVE_WARN
|
|
|
|
|
|
(the operation succeeded but a non-critical error was encountered),
|
2021-12-09 12:22:14 +01:00
|
|
|
|
ARCHIVE_EOF (end-of-archive was encountered), ARCHIVE_RETRY (the opera‐
|
|
|
|
|
|
tion failed but can be retried), and ARCHIVE_FATAL (there was a fatal er‐
|
|
|
|
|
|
ror; the archive should be closed immediately).
|
2020-03-04 16:55:40 +01:00
|
|
|
|
|
|
|
|
|
|
ERRORS
|
|
|
|
|
|
Detailed error codes and textual descriptions are available from the
|
|
|
|
|
|
archive_errno() and archive_error_string() functions.
|
|
|
|
|
|
|
|
|
|
|
|
SEE ALSO
|
|
|
|
|
|
tar(1), archive_read(3), archive_read_data(3), archive_read_filter(3),
|
|
|
|
|
|
archive_read_format(3), archive_read_open(3),
|
|
|
|
|
|
archive_read_set_options(3), archive_util(3), libarchive(3), tar(5)
|
|
|
|
|
|
|
|
|
|
|
|
BSD February 2, 2012 BSD
|
