Mercurial > repos > rliterman > csp2

comparison CSP2/CSP2_env/env-d9b9114564458d9d-741b3de822f2aaca6c6caa4325c4afce/include/lzma/bcj.h @ 69:33d812a61356

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