|
Packit |
08bd4c |
ARCHIVE_READ_EXTRACT(3) manual page
|
|
Packit |
08bd4c |
== NAME ==
|
|
Packit |
08bd4c |
'''archive_read_extract''',
|
|
Packit |
08bd4c |
'''archive_read_extract2''',
|
|
Packit |
08bd4c |
'''archive_read_extract_set_progress_callback'''
|
|
Packit |
08bd4c |
- functions for reading streaming archives
|
|
Packit |
08bd4c |
== LIBRARY ==
|
|
Packit |
08bd4c |
Streaming Archive Library (libarchive, -larchive)
|
|
Packit |
08bd4c |
== SYNOPSIS ==
|
|
Packit |
08bd4c |
'''<nowiki>#include <archive.h></nowiki>'''
|
|
Packit |
08bd4c |
|
|
Packit |
08bd4c |
''int''
|
|
Packit |
08bd4c |
|
|
Packit |
08bd4c |
'''archive_read_extract'''(''struct archive *'', ''struct archive_entry *'', ''int flags'');
|
|
Packit |
08bd4c |
|
|
Packit |
08bd4c |
''int''
|
|
Packit |
08bd4c |
|
|
Packit |
08bd4c |
'''archive_read_extract2'''(''struct archive *src'', ''struct archive_entry *'', ''struct archive *dest'');
|
|
Packit |
08bd4c |
|
|
Packit |
08bd4c |
''void''
|
|
Packit |
08bd4c |
|
|
Packit |
08bd4c |
'''archive_read_extract_set_progress_callback'''(''struct archive *'', ''void (*func)(void *)'', ''void *user_data'');
|
|
Packit |
08bd4c |
== DESCRIPTION ==
|
|
Packit |
08bd4c |
|
|
Packit |
08bd4c |
'''archive_read_extract'''(), '''archive_read_extract_set_skip_file'''()
|
|
Packit |
08bd4c |
A convenience function that wraps the corresponding
|
|
Packit |
08bd4c |
[[ManPagerchiveriteisk3]]
|
|
Packit |
08bd4c |
interfaces.
|
|
Packit |
08bd4c |
The first call to
|
|
Packit |
08bd4c |
'''archive_read_extract'''()
|
|
Packit |
08bd4c |
creates a restore object using
|
|
Packit |
08bd4c |
[[ManPagerchiveriteiskew3]]
|
|
Packit |
08bd4c |
and
|
|
Packit |
08bd4c |
[[ManPagerchiveriteiskettandardookup3]],
|
|
Packit |
08bd4c |
then transparently invokes
|
|
Packit |
08bd4c |
[[ManPagerchiveriteisketptions3]],
|
|
Packit |
08bd4c |
[[ManPagerchiveriteeader3]],
|
|
Packit |
08bd4c |
[[ManPagerchiveriteata3]],
|
|
Packit |
08bd4c |
and
|
|
Packit |
08bd4c |
[[ManPagerchiveriteinishntry3]]
|
|
Packit |
08bd4c |
to create the entry on disk and copy data into it.
|
|
Packit |
08bd4c |
The
|
|
Packit |
08bd4c |
''flags''
|
|
Packit |
08bd4c |
argument is passed unmodified to
|
|
Packit |
08bd4c |
[[ManPagerchiveriteisketptions3]].
|
|
Packit |
08bd4c |
'''archive_read_extract2'''()
|
|
Packit |
08bd4c |
This is another version of
|
|
Packit |
08bd4c |
'''archive_read_extract'''()
|
|
Packit |
08bd4c |
that allows you to provide your own restore object.
|
|
Packit |
08bd4c |
In particular, this allows you to override the standard lookup functions
|
|
Packit |
08bd4c |
using
|
|
Packit |
08bd4c |
[[ManPagerchiveriteisketroupookup3]],
|
|
Packit |
08bd4c |
and
|
|
Packit |
08bd4c |
[[ManPagerchiveriteisketserookup3]].
|
|
Packit |
08bd4c |
Note that
|
|
Packit |
08bd4c |
'''archive_read_extract2'''()
|
|
Packit |
08bd4c |
does not accept a
|
|
Packit |
08bd4c |
''flags''
|
|
Packit |
08bd4c |
argument; you should use
|
|
Packit |
08bd4c |
'''archive_write_disk_set_options'''()
|
|
Packit |
08bd4c |
to set the restore options yourself.
|
|
Packit |
08bd4c |
'''archive_read_extract_set_progress_callback'''()
|
|
Packit |
08bd4c |
Sets a pointer to a user-defined callback that can be used
|
|
Packit |
08bd4c |
for updating progress displays during extraction.
|
|
Packit |
08bd4c |
The progress function will be invoked during the extraction of large
|
|
Packit |
08bd4c |
regular files.
|
|
Packit |
08bd4c |
The progress function will be invoked with the pointer provided to this call.
|
|
Packit |
08bd4c |
Generally, the data pointed to should include a reference to the archive
|
|
Packit |
08bd4c |
object and the archive_entry object so that various statistics
|
|
Packit |
08bd4c |
can be retrieved for the progress display.
|
|
Packit |
08bd4c |
|
|
Packit |
08bd4c |
== RETURN VALUES ==
|
|
Packit |
08bd4c |
Most functions return zero on success, non-zero on error.
|
|
Packit |
08bd4c |
The possible return codes include:
|
|
Packit |
08bd4c |
'''ARCHIVE_OK'''
|
|
Packit |
08bd4c |
(the operation succeeded),
|
|
Packit |
08bd4c |
'''ARCHIVE_WARN'''
|
|
Packit |
08bd4c |
(the operation succeeded but a non-critical error was encountered),
|
|
Packit |
08bd4c |
'''ARCHIVE_EOF'''
|
|
Packit |
08bd4c |
(end-of-archive was encountered),
|
|
Packit |
08bd4c |
'''ARCHIVE_RETRY'''
|
|
Packit |
08bd4c |
(the operation failed but can be retried),
|
|
Packit |
08bd4c |
and
|
|
Packit |
08bd4c |
'''ARCHIVE_FATAL'''
|
|
Packit |
08bd4c |
(there was a fatal error; the archive should be closed immediately).
|
|
Packit |
08bd4c |
== ERRORS ==
|
|
Packit |
08bd4c |
Detailed error codes and textual descriptions are available from the
|
|
Packit |
08bd4c |
'''archive_errno'''()
|
|
Packit |
08bd4c |
and
|
|
Packit |
08bd4c |
'''archive_error_string'''()
|
|
Packit |
08bd4c |
functions.
|
|
Packit |
08bd4c |
== SEE ALSO ==
|
|
Packit |
08bd4c |
[[ManPageBsdtar1]],
|
|
Packit |
08bd4c |
[[ManPageibarchive3]],
|
|
Packit |
08bd4c |
[[ManPagerchiveead3]],
|
|
Packit |
08bd4c |
[[ManPagerchiveeadata3]],
|
|
Packit |
08bd4c |
[[ManPagerchiveeadilter3]],
|
|
Packit |
08bd4c |
[[ManPagerchiveeadormat3]],
|
|
Packit |
08bd4c |
[[ManPagerchiveeadpen3]],
|
|
Packit |
08bd4c |
[[ManPagerchiveeadetptions3]],
|
|
Packit |
08bd4c |
[[ManPagerchivetil3]],
|
|
Packit |
08bd4c |
[[ManPageTar5]]
|