| 1 | /**
|
|---|
| 2 | * \file lzma/bcj.h
|
|---|
| 3 | * \brief Branch/Call/Jump conversion filters
|
|---|
| 4 | */
|
|---|
| 5 |
|
|---|
| 6 | /*
|
|---|
| 7 | * Author: Lasse Collin
|
|---|
| 8 | *
|
|---|
| 9 | * This file has been put into the public domain.
|
|---|
| 10 | * You can do whatever you want with this file.
|
|---|
| 11 | *
|
|---|
| 12 | * See ../lzma.h for information about liblzma as a whole.
|
|---|
| 13 | */
|
|---|
| 14 |
|
|---|
| 15 | #ifndef LZMA_H_INTERNAL
|
|---|
| 16 | # error Never include this file directly. Use <lzma.h> instead.
|
|---|
| 17 | #endif
|
|---|
| 18 |
|
|---|
| 19 |
|
|---|
| 20 | /* Filter IDs for lzma_filter.id */
|
|---|
| 21 |
|
|---|
| 22 | #define LZMA_FILTER_X86 LZMA_VLI_C(0x04)
|
|---|
| 23 | /**<
|
|---|
| 24 | * Filter for x86 binaries
|
|---|
| 25 | */
|
|---|
| 26 |
|
|---|
| 27 | #define LZMA_FILTER_POWERPC LZMA_VLI_C(0x05)
|
|---|
| 28 | /**<
|
|---|
| 29 | * Filter for Big endian PowerPC binaries
|
|---|
| 30 | */
|
|---|
| 31 |
|
|---|
| 32 | #define LZMA_FILTER_IA64 LZMA_VLI_C(0x06)
|
|---|
| 33 | /**<
|
|---|
| 34 | * Filter for IA-64 (Itanium) binaries.
|
|---|
| 35 | */
|
|---|
| 36 |
|
|---|
| 37 | #define LZMA_FILTER_ARM LZMA_VLI_C(0x07)
|
|---|
| 38 | /**<
|
|---|
| 39 | * Filter for ARM binaries.
|
|---|
| 40 | */
|
|---|
| 41 |
|
|---|
| 42 | #define LZMA_FILTER_ARMTHUMB LZMA_VLI_C(0x08)
|
|---|
| 43 | /**<
|
|---|
| 44 | * Filter for ARM-Thumb binaries.
|
|---|
| 45 | */
|
|---|
| 46 |
|
|---|
| 47 | #define LZMA_FILTER_SPARC LZMA_VLI_C(0x09)
|
|---|
| 48 | /**<
|
|---|
| 49 | * Filter for SPARC binaries.
|
|---|
| 50 | */
|
|---|
| 51 |
|
|---|
| 52 | #define LZMA_FILTER_ARM64 LZMA_VLI_C(0x0A)
|
|---|
| 53 | /**<
|
|---|
| 54 | * Filter for ARM64 binaries.
|
|---|
| 55 | */
|
|---|
| 56 |
|
|---|
| 57 | /**
|
|---|
| 58 | * \brief Options for BCJ filters (except ARM64)
|
|---|
| 59 | *
|
|---|
| 60 | * The BCJ filters never change the size of the data. Specifying options
|
|---|
| 61 | * for them is optional: if pointer to options is NULL, default value is
|
|---|
| 62 | * used. You probably never need to specify options to BCJ filters, so just
|
|---|
| 63 | * set the options pointer to NULL and be happy.
|
|---|
| 64 | *
|
|---|
| 65 | * If options with non-default values have been specified when encoding,
|
|---|
| 66 | * the same options must also be specified when decoding.
|
|---|
| 67 | *
|
|---|
| 68 | * \note At the moment, none of the BCJ filters support
|
|---|
| 69 | * LZMA_SYNC_FLUSH. If LZMA_SYNC_FLUSH is specified,
|
|---|
| 70 | * LZMA_OPTIONS_ERROR will be returned. If there is need,
|
|---|
| 71 | * partial support for LZMA_SYNC_FLUSH can be added in future.
|
|---|
| 72 | * Partial means that flushing would be possible only at
|
|---|
| 73 | * offsets that are multiple of 2, 4, or 16 depending on
|
|---|
| 74 | * the filter, except x86 which cannot be made to support
|
|---|
| 75 | * LZMA_SYNC_FLUSH predictably.
|
|---|
| 76 | */
|
|---|
| 77 | typedef struct {
|
|---|
| 78 | /**
|
|---|
| 79 | * \brief Start offset for conversions
|
|---|
| 80 | *
|
|---|
| 81 | * This setting is useful only when the same filter is used
|
|---|
| 82 | * _separately_ for multiple sections of the same executable file,
|
|---|
| 83 | * and the sections contain cross-section branch/call/jump
|
|---|
| 84 | * instructions. In that case it is beneficial to set the start
|
|---|
| 85 | * offset of the non-first sections so that the relative addresses
|
|---|
| 86 | * of the cross-section branch/call/jump instructions will use the
|
|---|
| 87 | * same absolute addresses as in the first section.
|
|---|
| 88 | *
|
|---|
| 89 | * When the pointer to options is NULL, the default value (zero)
|
|---|
| 90 | * is used.
|
|---|
| 91 | */
|
|---|
| 92 | uint32_t start_offset;
|
|---|
| 93 |
|
|---|
| 94 | } lzma_options_bcj;
|
|---|
