busybox/include/bb_archive.h
<<
>>
Prefs
   1/* vi: set sw=4 ts=4: */
   2#ifndef UNARCHIVE_H
   3#define UNARCHIVE_H 1
   4
   5PUSH_AND_SET_FUNCTION_VISIBILITY_TO_HIDDEN
   6
   7enum {
   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
  31typedef 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
  46struct hardlinks_t;
  47
  48typedef 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 link placeholders */
  68        llist_t *link_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#if ENABLE_FEATURE_AR_LONG_FILENAMES
 121        char *ar__long_names;
 122        unsigned ar__long_name_size;
 123#endif
 124} archive_handle_t;
 125/* bits in ah_flags */
 126#define ARCHIVE_RESTORE_DATE        (1 << 0)
 127#define ARCHIVE_CREATE_LEADING_DIRS (1 << 1)
 128#define ARCHIVE_UNLINK_OLD          (1 << 2)
 129#define ARCHIVE_EXTRACT_NEWER       (1 << 3)
 130#define ARCHIVE_DONT_RESTORE_OWNER  (1 << 4)
 131#define ARCHIVE_DONT_RESTORE_PERM   (1 << 5)
 132#define ARCHIVE_NUMERIC_OWNER       (1 << 6)
 133#define ARCHIVE_O_TRUNC             (1 << 7)
 134#define ARCHIVE_REMEMBER_NAMES      (1 << 8)
 135#if ENABLE_RPM
 136#define ARCHIVE_REPLACE_VIA_RENAME  (1 << 9)
 137#endif
 138
 139
 140/* POSIX tar Header Block, from POSIX 1003.1-1990  */
 141#define TAR_BLOCK_SIZE 512
 142#define NAME_SIZE      100
 143#define NAME_SIZE_STR "100"
 144typedef struct tar_header_t {     /* byte offset */
 145        char name[NAME_SIZE];     /*   0-99 */
 146        char mode[8];             /* 100-107 */
 147        char uid[8];              /* 108-115 */
 148        char gid[8];              /* 116-123 */
 149        char size[12];            /* 124-135 */
 150        char mtime[12];           /* 136-147 */
 151        char chksum[8];           /* 148-155 */
 152        char typeflag;            /* 156-156 */
 153        char linkname[NAME_SIZE]; /* 157-256 */
 154        /* POSIX:   "ustar" NUL "00" */
 155        /* GNU tar: "ustar  " NUL */
 156        /* Normally it's defined as magic[6] followed by
 157         * version[2], but we put them together to save code.
 158         */
 159        char magic[8];            /* 257-264 */
 160        char uname[32];           /* 265-296 */
 161        char gname[32];           /* 297-328 */
 162        char devmajor[8];         /* 329-336 */
 163        char devminor[8];         /* 337-344 */
 164        char prefix[155];         /* 345-499 */
 165        char padding[12];         /* 500-512 (pad to exactly TAR_BLOCK_SIZE) */
 166} tar_header_t;
 167struct BUG_tar_header {
 168        char c[sizeof(tar_header_t) == TAR_BLOCK_SIZE ? 1 : -1];
 169};
 170void chksum_and_xwrite_tar_header(int fd, struct tar_header_t *hp) FAST_FUNC;
 171
 172
 173extern const char cpio_TRAILER[];
 174
 175
 176archive_handle_t *init_handle(void) FAST_FUNC;
 177
 178char filter_accept_all(archive_handle_t *archive_handle) FAST_FUNC;
 179char filter_accept_list(archive_handle_t *archive_handle) FAST_FUNC;
 180char filter_accept_list_reassign(archive_handle_t *archive_handle) FAST_FUNC;
 181char filter_accept_reject_list(archive_handle_t *archive_handle) FAST_FUNC;
 182
 183void unpack_ar_archive(archive_handle_t *ar_archive) FAST_FUNC;
 184
 185void data_skip(archive_handle_t *archive_handle) FAST_FUNC;
 186void data_extract_all(archive_handle_t *archive_handle) FAST_FUNC;
 187void data_extract_to_stdout(archive_handle_t *archive_handle) FAST_FUNC;
 188void data_extract_to_command(archive_handle_t *archive_handle) FAST_FUNC;
 189
 190void header_skip(const file_header_t *file_header) FAST_FUNC;
 191void header_list(const file_header_t *file_header) FAST_FUNC;
 192void header_verbose_list(const file_header_t *file_header) FAST_FUNC;
 193
 194char get_header_ar(archive_handle_t *archive_handle) FAST_FUNC;
 195char get_header_cpio(archive_handle_t *archive_handle) FAST_FUNC;
 196char get_header_tar(archive_handle_t *archive_handle) FAST_FUNC;
 197char get_header_tar_gz(archive_handle_t *archive_handle) FAST_FUNC;
 198char get_header_tar_bz2(archive_handle_t *archive_handle) FAST_FUNC;
 199char get_header_tar_lzma(archive_handle_t *archive_handle) FAST_FUNC;
 200char get_header_tar_xz(archive_handle_t *archive_handle) FAST_FUNC;
 201
 202void seek_by_jump(int fd, off_t amount) FAST_FUNC;
 203void seek_by_read(int fd, off_t amount) FAST_FUNC;
 204
 205const char *strip_unsafe_prefix(const char *str) FAST_FUNC;
 206void create_or_remember_link(llist_t **link_placeholders,
 207                const char *target,
 208                const char *linkname,
 209                int hard_link) FAST_FUNC;
 210void create_links_from_list(llist_t *list) FAST_FUNC;
 211
 212void data_align(archive_handle_t *archive_handle, unsigned boundary) FAST_FUNC;
 213const llist_t *find_list_entry(const llist_t *list, const char *filename) FAST_FUNC;
 214const llist_t *find_list_entry2(const llist_t *list, const char *filename) FAST_FUNC;
 215
 216/* A bit of bunzip2 internals are exposed for compressed help support: */
 217char *unpack_bz2_data(const char *packed, int packed_len, int unpacked_len) FAST_FUNC;
 218
 219/* Meaning and direction (input/output) of the fields are transformer-specific */
 220typedef struct transformer_state_t {
 221        smallint signature_skipped; /* most often referenced member */
 222
 223        IF_DESKTOP(long long) int FAST_FUNC (*xformer)(struct transformer_state_t *xstate);
 224        USE_FOR_NOMMU(const char *xformer_prog;)
 225
 226        /* Source */
 227        int      src_fd;
 228        /* Output */
 229        int      dst_fd;
 230        size_t   mem_output_size_max; /* if non-zero, decompress to RAM instead of fd */
 231        size_t   mem_output_size;
 232        char     *mem_output_buf;
 233
 234        off_t    bytes_out;
 235        off_t    bytes_in;  /* used in unzip code only: needs to know packed size */
 236        uint32_t crc32;
 237        time_t   mtime;     /* gunzip code may set this on exit */
 238
 239        union {             /* if we read magic, it's saved here */
 240                uint8_t b[8];
 241                uint16_t b16[4];
 242                uint32_t b32[2];
 243        } magic;
 244} transformer_state_t;
 245
 246void init_transformer_state(transformer_state_t *xstate) FAST_FUNC;
 247ssize_t transformer_write(transformer_state_t *xstate, const void *buf, size_t bufsize) FAST_FUNC;
 248ssize_t xtransformer_write(transformer_state_t *xstate, const void *buf, size_t bufsize) FAST_FUNC;
 249int check_signature16(transformer_state_t *xstate, unsigned magic16) FAST_FUNC;
 250
 251IF_DESKTOP(long long) int inflate_unzip(transformer_state_t *xstate) FAST_FUNC;
 252IF_DESKTOP(long long) int unpack_Z_stream(transformer_state_t *xstate) FAST_FUNC;
 253IF_DESKTOP(long long) int unpack_gz_stream(transformer_state_t *xstate) FAST_FUNC;
 254IF_DESKTOP(long long) int unpack_bz2_stream(transformer_state_t *xstate) FAST_FUNC;
 255IF_DESKTOP(long long) int unpack_lzma_stream(transformer_state_t *xstate) FAST_FUNC;
 256IF_DESKTOP(long long) int unpack_xz_stream(transformer_state_t *xstate) FAST_FUNC;
 257
 258char* append_ext(char *filename, const char *expected_ext) FAST_FUNC;
 259int bbunpack(char **argv,
 260                IF_DESKTOP(long long) int FAST_FUNC (*unpacker)(transformer_state_t *xstate),
 261                char* FAST_FUNC (*make_new_name)(char *filename, const char *expected_ext),
 262                const char *expected_ext
 263) FAST_FUNC;
 264#define BBUNPK_OPTSTR "cfkvq"
 265#define BBUNPK_OPTSTRLEN  5
 266#define BBUNPK_OPTSTRMASK ((1 << BBUNPK_OPTSTRLEN) - 1)
 267enum {
 268        BBUNPK_OPT_STDOUT     = 1 << 0,
 269        BBUNPK_OPT_FORCE      = 1 << 1,
 270        /* only some decompressors: */
 271        BBUNPK_OPT_KEEP       = 1 << 2,
 272        BBUNPK_OPT_VERBOSE    = 1 << 3,
 273        BBUNPK_OPT_QUIET      = 1 << 4,
 274        /* not included in BBUNPK_OPTSTR: */
 275        BBUNPK_OPT_DECOMPRESS = 1 << 5,
 276        BBUNPK_OPT_TEST       = 1 << 6,
 277        BBUNPK_SEAMLESS_MAGIC = (1 << 31) * ENABLE_ZCAT * SEAMLESS_COMPRESSION,
 278};
 279
 280void check_errors_in_children(int signo);
 281#if BB_MMU
 282void fork_transformer(int fd,
 283        int signature_skipped,
 284        IF_DESKTOP(long long) int FAST_FUNC (*transformer)(transformer_state_t *xstate)
 285) FAST_FUNC;
 286#define fork_transformer_with_sig(fd, transformer, transform_prog) fork_transformer((fd), 0, (transformer))
 287#define fork_transformer_with_no_sig(fd, transformer)              fork_transformer((fd), 1, (transformer))
 288#else
 289void fork_transformer(int fd, const char *transform_prog) FAST_FUNC;
 290#define fork_transformer_with_sig(fd, transformer, transform_prog) fork_transformer((fd), (transform_prog))
 291/* fork_transformer_with_no_sig() does not exist on NOMMU */
 292#endif
 293
 294
 295POP_SAVED_FUNCTION_VISIBILITY
 296
 297#endif
 298