1 /* vi: set sw=4 ts=4: */
2 #ifndef __UNARCHIVE_H__
3 #define __UNARCHIVE_H__
6 # pragma GCC visibility push(hidden)
9 #define ARCHIVE_PRESERVE_DATE 1
10 #define ARCHIVE_CREATE_LEADING_DIRS 2
11 #define ARCHIVE_EXTRACT_UNCONDITIONAL 4
12 #define ARCHIVE_EXTRACT_QUIET 8
13 #define ARCHIVE_EXTRACT_NEWER 16
14 #define ARCHIVE_NOPRESERVE_OWN 32
15 #define ARCHIVE_NOPRESERVE_PERM 64
17 typedef struct file_header_t {
20 #if ENABLE_FEATURE_TAR_UNAME_GNAME
32 typedef struct archive_handle_t {
33 /* Define if the header and data component should be processed */
34 char FAST_FUNC (*filter)(struct archive_handle_t *);
36 /* List of files that have been rejected */
38 /* List of files that have successfully been worked on */
41 /* Contains the processed header entry */
42 file_header_t *file_header;
44 /* Process the header component, e.g. tar -t */
45 void FAST_FUNC (*action_header)(const file_header_t *);
47 /* Process the data component, e.g. extract to filesystem */
48 void FAST_FUNC (*action_data)(struct archive_handle_t *);
50 #if ENABLE_DPKG || ENABLE_DPKG_DEB
51 /* "subarchive" is used only by dpkg[-deb] applets */
52 /* How to process any sub archive, e.g. get_header_tar_gz */
53 char FAST_FUNC (*action_data_subarchive)(struct archive_handle_t *);
54 /* Contains the handle to a sub archive */
55 struct archive_handle_t *sub_archive;
58 /* The raw stream as read from disk or stdin */
61 /* Count the number of bytes processed */
64 /* Function that skips data: read_by_char or read_by_skip */
65 void FAST_FUNC (*seek)(const struct archive_handle_t *archive_handle, const unsigned amount);
67 /* Temporary storage */
70 /* Flags and misc. stuff */
71 unsigned char ah_flags;
73 /* "Private" storage for archivers */
74 // unsigned char ah_priv_inited;
80 extern archive_handle_t *init_handle(void) FAST_FUNC;
82 extern char filter_accept_all(archive_handle_t *archive_handle) FAST_FUNC;
83 extern char filter_accept_list(archive_handle_t *archive_handle) FAST_FUNC;
84 extern char filter_accept_list_reassign(archive_handle_t *archive_handle) FAST_FUNC;
85 extern char filter_accept_reject_list(archive_handle_t *archive_handle) FAST_FUNC;
87 extern void unpack_ar_archive(archive_handle_t *ar_archive) FAST_FUNC;
89 extern void data_skip(archive_handle_t *archive_handle) FAST_FUNC;
90 extern void data_extract_all(archive_handle_t *archive_handle) FAST_FUNC;
91 extern void data_extract_to_stdout(archive_handle_t *archive_handle) FAST_FUNC;
92 extern void data_extract_to_buffer(archive_handle_t *archive_handle) FAST_FUNC;
94 extern void header_skip(const file_header_t *file_header) FAST_FUNC;
95 extern void header_list(const file_header_t *file_header) FAST_FUNC;
96 extern void header_verbose_list(const file_header_t *file_header) FAST_FUNC;
98 extern char get_header_ar(archive_handle_t *archive_handle) FAST_FUNC;
99 extern char get_header_cpio(archive_handle_t *archive_handle) FAST_FUNC;
100 extern char get_header_tar(archive_handle_t *archive_handle) FAST_FUNC;
101 extern char get_header_tar_gz(archive_handle_t *archive_handle) FAST_FUNC;
102 extern char get_header_tar_bz2(archive_handle_t *archive_handle) FAST_FUNC;
103 extern char get_header_tar_lzma(archive_handle_t *archive_handle) FAST_FUNC;
105 extern void seek_by_jump(const archive_handle_t *archive_handle, unsigned amount) FAST_FUNC;
106 extern void seek_by_read(const archive_handle_t *archive_handle, unsigned amount) FAST_FUNC;
108 extern void data_align(archive_handle_t *archive_handle, unsigned boundary) FAST_FUNC;
109 extern const llist_t *find_list_entry(const llist_t *list, const char *filename) FAST_FUNC;
110 extern const llist_t *find_list_entry2(const llist_t *list, const char *filename) FAST_FUNC;
112 /* A bit of bunzip2 internals are exposed for compressed help support: */
113 typedef struct bunzip_data bunzip_data;
114 int start_bunzip(bunzip_data **bdp, int in_fd, const unsigned char *inbuf, int len) FAST_FUNC;
115 int read_bunzip(bunzip_data *bd, char *outbuf, int len) FAST_FUNC;
116 void dealloc_bunzip(bunzip_data *bd) FAST_FUNC;
118 typedef struct inflate_unzip_result {
121 } inflate_unzip_result;
123 USE_DESKTOP(long long) int inflate_unzip(inflate_unzip_result *res, off_t compr_size, int src_fd, int dst_fd) FAST_FUNC;
124 /* lzma unpacker takes .lzma stream from offset 0 */
125 USE_DESKTOP(long long) int unpack_lzma_stream(int src_fd, int dst_fd) FAST_FUNC;
126 /* the rest wants 2 first bytes already skipped by the caller */
127 USE_DESKTOP(long long) int unpack_bz2_stream(int src_fd, int dst_fd) FAST_FUNC;
128 USE_DESKTOP(long long) int unpack_gz_stream(int src_fd, int dst_fd) FAST_FUNC;
129 USE_DESKTOP(long long) int unpack_Z_stream(int fd_in, int fd_out) FAST_FUNC;
130 /* wrapper which checks first two bytes to be "BZ" */
131 USE_DESKTOP(long long) int unpack_bz2_stream_prime(int src_fd, int dst_fd) FAST_FUNC;
134 void open_transformer(int fd,
135 USE_DESKTOP(long long) int FAST_FUNC (*transformer)(int src_fd, int dst_fd)) FAST_FUNC;
136 #define open_transformer(fd, transformer, transform_prog) open_transformer(fd, transformer)
138 void open_transformer(int src_fd, const char *transform_prog) FAST_FUNC;
139 #define open_transformer(fd, transformer, transform_prog) open_transformer(fd, transform_prog)
142 #if __GNUC_PREREQ(4,1)
143 # pragma GCC visibility pop