blob: 68e83f01c7e683eb5f662212e1f45041d29fec35 [file] [log] [blame]
Bernhard Reutner-Fischer9457e702006-04-02 20:12:31 +00001/* vi: set sw=4 ts=4: */
Denis Vlasenkof81e8db2009-04-09 12:35:13 +00002#ifndef UNARCHIVE_H
3#define UNARCHIVE_H 1
Glenn L McGrathe9fc7812001-10-25 14:57:14 +00004
Denis Vlasenkof81e8db2009-04-09 12:35:13 +00005PUSH_AND_SET_FUNCTION_VISIBILITY_TO_HIDDEN
Denis Vlasenko98636eb2008-05-09 17:59:34 +00006
Denis Vlasenko75103842007-06-20 14:49:47 +00007typedef struct file_header_t {
Glenn L McGrathe9fc7812001-10-25 14:57:14 +00008 char *name;
Denis Vlasenko75103842007-06-20 14:49:47 +00009 char *link_target;
Denis Vlasenkoe00e5022008-02-14 20:37:54 +000010#if ENABLE_FEATURE_TAR_UNAME_GNAME
Denis Vlasenko42cc3042008-03-24 02:05:58 +000011 char *uname;
Denis Vlasenkoe00e5022008-02-14 20:37:54 +000012 char *gname;
13#endif
Glenn L McGrathe9fc7812001-10-25 14:57:14 +000014 off_t size;
15 uid_t uid;
16 gid_t gid;
17 mode_t mode;
18 time_t mtime;
19 dev_t device;
20} file_header_t;
21
Denis Vlasenko75103842007-06-20 14:49:47 +000022typedef struct archive_handle_t {
Denis Vlasenkoa60936d2008-06-28 05:04:09 +000023 /* Define if the header and data component should be processed */
Denis Vlasenkodefc1ea2008-06-27 02:52:20 +000024 char FAST_FUNC (*filter)(struct archive_handle_t *);
Glenn L McGrath66125c82002-12-08 00:54:33 +000025 llist_t *accept;
Bernhard Reutner-Fischer9457e702006-04-02 20:12:31 +000026 /* List of files that have been rejected */
Glenn L McGrath66125c82002-12-08 00:54:33 +000027 llist_t *reject;
Bernhard Reutner-Fischer9457e702006-04-02 20:12:31 +000028 /* List of files that have successfully been worked on */
29 llist_t *passed;
Glenn L McGrathe9fc7812001-10-25 14:57:14 +000030
Glenn L McGrath7ca04f32002-09-25 02:47:48 +000031 /* Contains the processed header entry */
32 file_header_t *file_header;
Glenn L McGrathe9fc7812001-10-25 14:57:14 +000033
Denis Vlasenkoa60936d2008-06-28 05:04:09 +000034 /* Process the header component, e.g. tar -t */
Denis Vlasenkodefc1ea2008-06-27 02:52:20 +000035 void FAST_FUNC (*action_header)(const file_header_t *);
Glenn L McGrathe9fc7812001-10-25 14:57:14 +000036
Denis Vlasenkoa60936d2008-06-28 05:04:09 +000037 /* Process the data component, e.g. extract to filesystem */
Denis Vlasenkodefc1ea2008-06-27 02:52:20 +000038 void FAST_FUNC (*action_data)(struct archive_handle_t *);
Eric Andersenc7bda1c2004-03-15 08:29:22 +000039
Denis Vlasenko0381d422008-07-10 23:06:00 +000040#if ENABLE_DPKG || ENABLE_DPKG_DEB
41 /* "subarchive" is used only by dpkg[-deb] applets */
Glenn L McGrath18bbca12002-11-05 01:52:23 +000042 /* How to process any sub archive, e.g. get_header_tar_gz */
Denis Vlasenkodefc1ea2008-06-27 02:52:20 +000043 char FAST_FUNC (*action_data_subarchive)(struct archive_handle_t *);
Glenn L McGrath7ca04f32002-09-25 02:47:48 +000044 /* Contains the handle to a sub archive */
Denis Vlasenko75103842007-06-20 14:49:47 +000045 struct archive_handle_t *sub_archive;
Denis Vlasenko0381d422008-07-10 23:06:00 +000046#endif
Glenn L McGrath7ca04f32002-09-25 02:47:48 +000047
48 /* The raw stream as read from disk or stdin */
49 int src_fd;
50
51 /* Count the number of bytes processed */
52 off_t offset;
53
Denys Vlasenko0a130d52009-08-28 21:09:51 +020054 /* Function that skips data */
55 void FAST_FUNC (*seek)(int fd, off_t amount);
Glenn L McGrath237ae422002-11-03 14:05:15 +000056
Glenn L McGrathf235d052003-10-29 03:37:54 +000057 /* Temporary storage */
Denys Vlasenko425ad9c2009-12-16 22:46:01 +010058 char *ah_buffer;
Glenn L McGrath61b79042002-10-19 10:40:55 +000059
Bernhard Reutner-Fischer9457e702006-04-02 20:12:31 +000060 /* Flags and misc. stuff */
Denys Vlasenko8a936cf2009-12-16 23:18:59 +010061 unsigned ah_flags;
Denis Vlasenkoa60936d2008-06-28 05:04:09 +000062
63 /* "Private" storage for archivers */
64// unsigned char ah_priv_inited;
65 void *ah_priv[8];
Glenn L McGrath7ca04f32002-09-25 02:47:48 +000066
67} archive_handle_t;
Denys Vlasenko425ad9c2009-12-16 22:46:01 +010068/* bits in ah_flags */
69#define ARCHIVE_RESTORE_DATE (1 << 0)
70#define ARCHIVE_CREATE_LEADING_DIRS (1 << 1)
71#define ARCHIVE_UNLINK_OLD (1 << 2)
72#define ARCHIVE_EXTRACT_QUIET (1 << 3)
73#define ARCHIVE_EXTRACT_NEWER (1 << 4)
74#define ARCHIVE_DONT_RESTORE_OWNER (1 << 5)
75#define ARCHIVE_DONT_RESTORE_PERM (1 << 6)
76#define ARCHIVE_NUMERIC_OWNER (1 << 7)
Denys Vlasenko8a936cf2009-12-16 23:18:59 +010077#define ARCHIVE_O_TRUNC (1 << 8)
Glenn L McGrath7ca04f32002-09-25 02:47:48 +000078
Denis Vlasenkobb3d0fa2007-01-03 01:57:25 +000079
Denis Vlasenko1a9e9bd2008-11-01 12:54:56 +000080/* Info struct unpackers can fill out to inform users of thing like
81 * timestamps of unpacked files */
82typedef struct unpack_info_t {
83 time_t mtime;
84} unpack_info_t;
85
Denis Vlasenkodefc1ea2008-06-27 02:52:20 +000086extern archive_handle_t *init_handle(void) FAST_FUNC;
Glenn L McGrath7ca04f32002-09-25 02:47:48 +000087
Denis Vlasenkodefc1ea2008-06-27 02:52:20 +000088extern char filter_accept_all(archive_handle_t *archive_handle) FAST_FUNC;
89extern char filter_accept_list(archive_handle_t *archive_handle) FAST_FUNC;
90extern char filter_accept_list_reassign(archive_handle_t *archive_handle) FAST_FUNC;
91extern char filter_accept_reject_list(archive_handle_t *archive_handle) FAST_FUNC;
Glenn L McGrath7ca04f32002-09-25 02:47:48 +000092
Denis Vlasenkodefc1ea2008-06-27 02:52:20 +000093extern void unpack_ar_archive(archive_handle_t *ar_archive) FAST_FUNC;
Glenn L McGrath7ca04f32002-09-25 02:47:48 +000094
Denis Vlasenkodefc1ea2008-06-27 02:52:20 +000095extern void data_skip(archive_handle_t *archive_handle) FAST_FUNC;
96extern void data_extract_all(archive_handle_t *archive_handle) FAST_FUNC;
97extern void data_extract_to_stdout(archive_handle_t *archive_handle) FAST_FUNC;
Glenn L McGrath7ca04f32002-09-25 02:47:48 +000098
Denis Vlasenkodefc1ea2008-06-27 02:52:20 +000099extern void header_skip(const file_header_t *file_header) FAST_FUNC;
100extern void header_list(const file_header_t *file_header) FAST_FUNC;
101extern void header_verbose_list(const file_header_t *file_header) FAST_FUNC;
Glenn L McGrath7ca04f32002-09-25 02:47:48 +0000102
Denis Vlasenkodefc1ea2008-06-27 02:52:20 +0000103extern char get_header_ar(archive_handle_t *archive_handle) FAST_FUNC;
104extern char get_header_cpio(archive_handle_t *archive_handle) FAST_FUNC;
105extern char get_header_tar(archive_handle_t *archive_handle) FAST_FUNC;
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +0000106extern char get_header_tar_gz(archive_handle_t *archive_handle) FAST_FUNC;
Denis Vlasenkodefc1ea2008-06-27 02:52:20 +0000107extern char get_header_tar_bz2(archive_handle_t *archive_handle) FAST_FUNC;
108extern char get_header_tar_lzma(archive_handle_t *archive_handle) FAST_FUNC;
Glenn L McGrath7ca04f32002-09-25 02:47:48 +0000109
Denys Vlasenko0a130d52009-08-28 21:09:51 +0200110extern void seek_by_jump(int fd, off_t amount) FAST_FUNC;
111extern void seek_by_read(int fd, off_t amount) FAST_FUNC;
Glenn L McGrath60bce492002-11-03 07:28:38 +0000112
Denis Vlasenkodefc1ea2008-06-27 02:52:20 +0000113extern void data_align(archive_handle_t *archive_handle, unsigned boundary) FAST_FUNC;
114extern const llist_t *find_list_entry(const llist_t *list, const char *filename) FAST_FUNC;
115extern const llist_t *find_list_entry2(const llist_t *list, const char *filename) FAST_FUNC;
Glenn L McGrath237ae422002-11-03 14:05:15 +0000116
Denis Vlasenkoc6758a02007-04-10 21:40:19 +0000117/* A bit of bunzip2 internals are exposed for compressed help support: */
118typedef struct bunzip_data bunzip_data;
Denis Vlasenkodefc1ea2008-06-27 02:52:20 +0000119int start_bunzip(bunzip_data **bdp, int in_fd, const unsigned char *inbuf, int len) FAST_FUNC;
120int read_bunzip(bunzip_data *bd, char *outbuf, int len) FAST_FUNC;
121void dealloc_bunzip(bunzip_data *bd) FAST_FUNC;
Denis Vlasenkocd42cb82007-01-05 23:56:53 +0000122
123typedef struct inflate_unzip_result {
124 off_t bytes_out;
125 uint32_t crc;
126} inflate_unzip_result;
127
Denis Vlasenko5e34ff22009-04-21 11:09:40 +0000128IF_DESKTOP(long long) int inflate_unzip(inflate_unzip_result *res, off_t compr_size, int src_fd, int dst_fd) FAST_FUNC;
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +0000129/* lzma unpacker takes .lzma stream from offset 0 */
Denis Vlasenko5e34ff22009-04-21 11:09:40 +0000130IF_DESKTOP(long long) int unpack_lzma_stream(int src_fd, int dst_fd) FAST_FUNC;
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +0000131/* the rest wants 2 first bytes already skipped by the caller */
Denis Vlasenko5e34ff22009-04-21 11:09:40 +0000132IF_DESKTOP(long long) int unpack_bz2_stream(int src_fd, int dst_fd) FAST_FUNC;
133IF_DESKTOP(long long) int unpack_gz_stream(int src_fd, int dst_fd) FAST_FUNC;
134IF_DESKTOP(long long) int unpack_gz_stream_with_info(int src_fd, int dst_fd, unpack_info_t *info) FAST_FUNC;
135IF_DESKTOP(long long) int unpack_Z_stream(int fd_in, int fd_out) FAST_FUNC;
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +0000136/* wrapper which checks first two bytes to be "BZ" */
Denis Vlasenko5e34ff22009-04-21 11:09:40 +0000137IF_DESKTOP(long long) int unpack_bz2_stream_prime(int src_fd, int dst_fd) FAST_FUNC;
Glenn L McGrath237ae422002-11-03 14:05:15 +0000138
Denis Vlasenko1a9e9bd2008-11-01 12:54:56 +0000139int bbunpack(char **argv,
140 char* (*make_new_name)(char *filename),
Denis Vlasenko5e34ff22009-04-21 11:09:40 +0000141 IF_DESKTOP(long long) int (*unpacker)(unpack_info_t *info)) FAST_FUNC;
Denis Vlasenko1a9e9bd2008-11-01 12:54:56 +0000142
Denis Vlasenko211f7f82007-09-05 11:48:32 +0000143#if BB_MMU
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +0000144void open_transformer(int fd,
Denis Vlasenko5e34ff22009-04-21 11:09:40 +0000145 IF_DESKTOP(long long) int FAST_FUNC (*transformer)(int src_fd, int dst_fd)) FAST_FUNC;
Denis Vlasenkob6052722008-07-10 17:43:01 +0000146#define open_transformer(fd, transformer, transform_prog) open_transformer(fd, transformer)
Denis Vlasenko211f7f82007-09-05 11:48:32 +0000147#else
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +0000148void open_transformer(int src_fd, const char *transform_prog) FAST_FUNC;
Denis Vlasenkob6052722008-07-10 17:43:01 +0000149#define open_transformer(fd, transformer, transform_prog) open_transformer(fd, transform_prog)
Denis Vlasenko211f7f82007-09-05 11:48:32 +0000150#endif
Glenn L McGrath5699b852003-11-15 23:19:05 +0000151
Denis Vlasenkof81e8db2009-04-09 12:35:13 +0000152POP_SAVED_FUNCTION_VISIBILITY
Denis Vlasenko98636eb2008-05-09 17:59:34 +0000153
Glenn L McGrath7ca04f32002-09-25 02:47:48 +0000154#endif