include/bb_archive.h

   1 /* vi: set sw=4 ts=4: */
   2 #ifndef UNARCHIVE_H
   3 #define UNARCHIVE_H 1
   4
   5 PUSH_AND_SET_FUNCTION_VISIBILITY_TO_HIDDEN
   6
   7 enum {
   8 #if BB_BIG_ENDIAN
   9         COMPRESS_MAGIC = 0x1f9d,
  10         GZIP_MAGIC  = 0x1f8b,
  11         BZIP2_MAGIC = 256 * 'B' + 'Z',
  12         /* .xz signature: 0xfd, '7', 'z', 'X', 'Z', 0x00 */
  13         /* More info at: http://tukaani.org/xz/xz-file-format.txt */
  14         XZ_MAGIC1   = 256 * 0xfd + '7',
  15         XZ_MAGIC2   = 256 * (unsigned)(256 * (256 * 'z' + 'X') + 'Z') + 0,
  16         /* Different form: 32 bits, then 16 bits: */
  17         /* (unsigned) cast suppresses "integer overflow in expression" warning */
  18         XZ_MAGIC1a  = 256 * (unsigned)(256 * (256 * 0xfd + '7') + 'z') + 'X',
  19         XZ_MAGIC2a  = 256 * 'Z' + 0,
  20 #else
  21         COMPRESS_MAGIC = 0x9d1f,
  22         GZIP_MAGIC  = 0x8b1f,
  23         BZIP2_MAGIC = 'B' + 'Z' * 256,
  24         XZ_MAGIC1   = 0xfd + '7' * 256,
  25         XZ_MAGIC2   = 'z' + ('X' + ('Z' + 0 * 256) * 256) * 256,
  26         XZ_MAGIC1a  = 0xfd + ('7' + ('z' + 'X' * 256) * 256) * 256,
  27         XZ_MAGIC2a  = 'Z' + 0 * 256,
  28 #endif
  29 };
  30
  31 typedef struct file_header_t {
  32         char *name;
  33         char *link_target;
  34 #if ENABLE_FEATURE_TAR_UNAME_GNAME
  35         char *tar__uname;
  36         char *tar__gname;
  37 #endif
  38         off_t size;
  39         uid_t uid;
  40         gid_t gid;
  41         mode_t mode;
  42         time_t mtime;
  43         dev_t device;
  44 } file_header_t;
  45
  46 struct hardlinks_t;
  47
  48 typedef struct archive_handle_t {
  49         /* Flags. 1st since it is most used member */
  50         unsigned ah_flags;
  51
  52         /* The raw stream as read from disk or stdin */
  53         int src_fd;
  54
  55         /* Define if the header and data component should be processed */
  56         char FAST_FUNC (*filter)(struct archive_handle_t *);
  57         /* List of files that have been accepted */
  58         llist_t *accept;
  59         /* List of files that have been rejected */
  60         llist_t *reject;
  61         /* List of files that have successfully been worked on */
  62         llist_t *passed;
  63
  64         /* Currently processed file's header */
  65         file_header_t *file_header;
  66
  67         /* List of symlink placeholders */
  68         llist_t *symlink_placeholders;
  69
  70         /* Process the header component, e.g. tar -t */
  71         void FAST_FUNC (*action_header)(const file_header_t *);
  72
  73         /* Process the data component, e.g. extract to filesystem */
  74         void FAST_FUNC (*action_data)(struct archive_handle_t *);
  75
  76         /* Function that skips data */
  77         void FAST_FUNC (*seek)(int fd, off_t amount);
  78
  79         /* Count processed bytes */
  80         off_t offset;
  81
  82         /* Archiver specific. Can make it a union if it ever gets big */
  83 #if ENABLE_FEATURE_TAR_LONG_OPTIONS
  84         unsigned tar__strip_components;
  85 #endif
  86 #define PAX_NEXT_FILE 0
  87 #define PAX_GLOBAL    1
  88 #if ENABLE_TAR || ENABLE_DPKG || ENABLE_DPKG_DEB
  89         smallint tar__end;
  90 # if ENABLE_FEATURE_TAR_GNU_EXTENSIONS
  91         char* tar__longname;
  92         char* tar__linkname;
  93 # endif
  94 # if ENABLE_FEATURE_TAR_TO_COMMAND
  95         char* tar__to_command;
  96         const char* tar__to_command_shell;
  97 # endif
  98 # if ENABLE_FEATURE_TAR_SELINUX
  99         char* tar__sctx[2];
 100 # endif
 101 #endif
 102 #if ENABLE_CPIO || ENABLE_RPM2CPIO || ENABLE_RPM
 103         uoff_t cpio__blocks;
 104         struct bb_uidgid_t cpio__owner;
 105         struct hardlinks_t *cpio__hardlinks_to_create;
 106         struct hardlinks_t *cpio__created_hardlinks;
 107 #endif
 108 #if ENABLE_DPKG || ENABLE_DPKG_DEB
 109         /* Temporary storage */
 110         char *dpkg__buffer;
 111         /* How to process any sub archive, e.g. get_header_tar_gz */
 112         char FAST_FUNC (*dpkg__action_data_subarchive)(struct archive_handle_t *);
 113         /* Contains the handle to a sub archive */
 114         struct archive_handle_t *dpkg__sub_archive;
 115 #endif
 116 #if ENABLE_FEATURE_AR_CREATE
 117         const char *ar__name;
 118         struct archive_handle_t *ar__out;
 119 #endif
 120 } archive_handle_t;
 121 /* bits in ah_flags */
 122 #define ARCHIVE_RESTORE_DATE        (1 << 0)
 123 #define ARCHIVE_CREATE_LEADING_DIRS (1 << 1)
 124 #define ARCHIVE_UNLINK_OLD          (1 << 2)
 125 #define ARCHIVE_EXTRACT_QUIET       (1 << 3)
 126 #define ARCHIVE_EXTRACT_NEWER       (1 << 4)
 127 #define ARCHIVE_DONT_RESTORE_OWNER  (1 << 5)
 128 #define ARCHIVE_DONT_RESTORE_PERM   (1 << 6)
 129 #define ARCHIVE_NUMERIC_OWNER       (1 << 7)
 130 #define ARCHIVE_O_TRUNC             (1 << 8)
 131 #define ARCHIVE_REMEMBER_NAMES      (1 << 9)
 132 #if ENABLE_RPM
 133 #define ARCHIVE_REPLACE_VIA_RENAME  (1 << 10)
 134 #endif
 135
 136
 137 /* POSIX tar Header Block, from POSIX 1003.1-1990  */
 138 #define TAR_BLOCK_SIZE 512
 139 #define NAME_SIZE      100
 140 #define NAME_SIZE_STR "100"
 141 typedef struct tar_header_t {     /* byte offset */
 142         char name[NAME_SIZE];     /*   0-99 */
 143         char mode[8];             /* 100-107 */
 144         char uid[8];              /* 108-115 */
 145         char gid[8];              /* 116-123 */
 146         char size[12];            /* 124-135 */
 147         char mtime[12];           /* 136-147 */
 148         char chksum[8];           /* 148-155 */
 149         char typeflag;            /* 156-156 */
 150         char linkname[NAME_SIZE]; /* 157-256 */
 151         /* POSIX:   "ustar" NUL "00" */
 152         /* GNU tar: "ustar  " NUL */
 153         /* Normally it's defined as magic[6] followed by
 154          * version[2], but we put them together to save code.
 155          */
 156         char magic[8];            /* 257-264 */
 157         char uname[32];           /* 265-296 */
 158         char gname[32];           /* 297-328 */
 159         char devmajor[8];         /* 329-336 */
 160         char devminor[8];         /* 337-344 */
 161         char prefix[155];         /* 345-499 */
 162         char padding[12];         /* 500-512 (pad to exactly TAR_BLOCK_SIZE) */
 163 } tar_header_t;
 164 struct BUG_tar_header {
 165         char c[sizeof(tar_header_t) == TAR_BLOCK_SIZE ? 1 : -1];
 166 };
 167
 168
 169 extern const char cpio_TRAILER[];
 170
 171
 172 archive_handle_t *init_handle(void) FAST_FUNC;
 173
 174 char filter_accept_all(archive_handle_t *archive_handle) FAST_FUNC;
 175 char filter_accept_list(archive_handle_t *archive_handle) FAST_FUNC;
 176 char filter_accept_list_reassign(archive_handle_t *archive_handle) FAST_FUNC;
 177 char filter_accept_reject_list(archive_handle_t *archive_handle) FAST_FUNC;
 178
 179 void unpack_ar_archive(archive_handle_t *ar_archive) FAST_FUNC;
 180
 181 void data_skip(archive_handle_t *archive_handle) FAST_FUNC;
 182 void data_extract_all(archive_handle_t *archive_handle) FAST_FUNC;
 183 void data_extract_to_stdout(archive_handle_t *archive_handle) FAST_FUNC;
 184 void data_extract_to_command(archive_handle_t *archive_handle) FAST_FUNC;
 185
 186 void header_skip(const file_header_t *file_header) FAST_FUNC;
 187 void header_list(const file_header_t *file_header) FAST_FUNC;
 188 void header_verbose_list(const file_header_t *file_header) FAST_FUNC;
 189
 190 char get_header_ar(archive_handle_t *archive_handle) FAST_FUNC;
 191 char get_header_cpio(archive_handle_t *archive_handle) FAST_FUNC;
 192 char get_header_tar(archive_handle_t *archive_handle) FAST_FUNC;
 193 char get_header_tar_gz(archive_handle_t *archive_handle) FAST_FUNC;
 194 char get_header_tar_xz(archive_handle_t *archive_handle) FAST_FUNC;
 195 char get_header_tar_bz2(archive_handle_t *archive_handle) FAST_FUNC;
 196 char get_header_tar_lzma(archive_handle_t *archive_handle) FAST_FUNC;
 197 char get_header_tar_xz(archive_handle_t *archive_handle) FAST_FUNC;
 198
 199 void seek_by_jump(int fd, off_t amount) FAST_FUNC;
 200 void seek_by_read(int fd, off_t amount) FAST_FUNC;
 201
 202 const char *strip_unsafe_prefix(const char *str) FAST_FUNC;
 203
 204 void data_align(archive_handle_t *archive_handle, unsigned boundary) FAST_FUNC;
 205 const llist_t *find_list_entry(const llist_t *list, const char *filename) FAST_FUNC;
 206 const llist_t *find_list_entry2(const llist_t *list, const char *filename) FAST_FUNC;
 207
 208 /* A bit of bunzip2 internals are exposed for compressed help support: */
 209 typedef struct bunzip_data bunzip_data;
 210 int start_bunzip(bunzip_data **bdp, int in_fd, const void *inbuf, int len) FAST_FUNC;
 211 /* NB: read_bunzip returns < 0 on error, or the number of *unfilled* bytes
 212  * in outbuf. IOW: on EOF returns len ("all bytes are not filled"), not 0: */
 213 int read_bunzip(bunzip_data *bd, char *outbuf, int len) FAST_FUNC;
 214 void dealloc_bunzip(bunzip_data *bd) FAST_FUNC;
 215
 216 /* Meaning and direction (input/output) of the fields are transformer-specific */
 217 typedef struct transformer_state_t {
 218         smallint signature_skipped; /* most often referenced member */
 219
 220         IF_DESKTOP(long long) int FAST_FUNC (*xformer)(struct transformer_state_t *xstate);
 221         USE_FOR_NOMMU(const char *xformer_prog;)
 222
 223         /* Source */
 224         int      src_fd;
 225         /* Output */
 226         int      dst_fd;
 227         size_t   mem_output_size_max; /* if non-zero, decompress to RAM instead of fd */
 228         size_t   mem_output_size;
 229         char     *mem_output_buf;
 230
 231         off_t    bytes_out;
 232         off_t    bytes_in;  /* used in unzip code only: needs to know packed size */
 233         uint32_t crc32;
 234         time_t   mtime;     /* gunzip code may set this on exit */
 235 } transformer_state_t;
 236
 237 void init_transformer_state(transformer_state_t *xstate) FAST_FUNC;
 238 ssize_t transformer_write(transformer_state_t *xstate, const void *buf, size_t bufsize) FAST_FUNC;
 239 ssize_t xtransformer_write(transformer_state_t *xstate, const void *buf, size_t bufsize) FAST_FUNC;
 240 int check_signature16(transformer_state_t *xstate, unsigned magic16) FAST_FUNC;
 241
 242 IF_DESKTOP(long long) int inflate_unzip(transformer_state_t *xstate) FAST_FUNC;
 243 IF_DESKTOP(long long) int unpack_Z_stream(transformer_state_t *xstate) FAST_FUNC;
 244 IF_DESKTOP(long long) int unpack_gz_stream(transformer_state_t *xstate) FAST_FUNC;
 245 IF_DESKTOP(long long) int unpack_bz2_stream(transformer_state_t *xstate) FAST_FUNC;
 246 IF_DESKTOP(long long) int unpack_lzma_stream(transformer_state_t *xstate) FAST_FUNC;
 247 IF_DESKTOP(long long) int unpack_xz_stream(transformer_state_t *xstate) FAST_FUNC;
 248
 249 char* append_ext(char *filename, const char *expected_ext) FAST_FUNC;
 250 int bbunpack(char **argv,
 251                 IF_DESKTOP(long long) int FAST_FUNC (*unpacker)(transformer_state_t *xstate),
 252                 char* FAST_FUNC (*make_new_name)(char *filename, const char *expected_ext),
 253                 const char *expected_ext
 254 ) FAST_FUNC;
 255
 256 void check_errors_in_children(int signo);
 257 #if BB_MMU
 258 void fork_transformer(int fd,
 259         int signature_skipped,
 260         IF_DESKTOP(long long) int FAST_FUNC (*transformer)(transformer_state_t *xstate)
 261 ) FAST_FUNC;
 262 #define fork_transformer_with_sig(fd, transformer, transform_prog) fork_transformer((fd), 0, (transformer))
 263 #define fork_transformer_with_no_sig(fd, transformer)              fork_transformer((fd), 1, (transformer))
 264 #else
 265 void fork_transformer(int fd, const char *transform_prog) FAST_FUNC;
 266 #define fork_transformer_with_sig(fd, transformer, transform_prog) fork_transformer((fd), (transform_prog))
 267 /* fork_transformer_with_no_sig() does not exist on NOMMU */
 268 #endif
 269
 270
 271 POP_SAVED_FUNCTION_VISIBILITY
 272
 273 #endif