xref: /openbmc/qemu/include/tcg/tcg.h (revision f4063f9c)
1 /*
2  * Tiny Code Generator for QEMU
3  *
4  * Copyright (c) 2008 Fabrice Bellard
5  *
6  * Permission is hereby granted, free of charge, to any person obtaining a copy
7  * of this software and associated documentation files (the "Software"), to deal
8  * in the Software without restriction, including without limitation the rights
9  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10  * copies of the Software, and to permit persons to whom the Software is
11  * furnished to do so, subject to the following conditions:
12  *
13  * The above copyright notice and this permission notice shall be included in
14  * all copies or substantial portions of the Software.
15  *
16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
22  * THE SOFTWARE.
23  */
24 
25 #ifndef TCG_H
26 #define TCG_H
27 
28 #include "cpu.h"
29 #include "exec/memop.h"
30 #include "qemu/bitops.h"
31 #include "qemu/plugin.h"
32 #include "qemu/queue.h"
33 #include "tcg/tcg-mo.h"
34 #include "tcg-target.h"
35 #include "qemu/int128.h"
36 #include "tcg/tcg-cond.h"
37 
38 /* XXX: make safe guess about sizes */
39 #define MAX_OP_PER_INSTR 266
40 
41 #if HOST_LONG_BITS == 32
42 #define MAX_OPC_PARAM_PER_ARG 2
43 #else
44 #define MAX_OPC_PARAM_PER_ARG 1
45 #endif
46 #define MAX_OPC_PARAM_IARGS 6
47 #define MAX_OPC_PARAM_OARGS 1
48 #define MAX_OPC_PARAM_ARGS (MAX_OPC_PARAM_IARGS + MAX_OPC_PARAM_OARGS)
49 
50 /* A Call op needs up to 4 + 2N parameters on 32-bit archs,
51  * and up to 4 + N parameters on 64-bit archs
52  * (N = number of input arguments + output arguments).  */
53 #define MAX_OPC_PARAM (4 + (MAX_OPC_PARAM_PER_ARG * MAX_OPC_PARAM_ARGS))
54 
55 #define CPU_TEMP_BUF_NLONGS 128
56 #define TCG_STATIC_FRAME_SIZE  (CPU_TEMP_BUF_NLONGS * sizeof(long))
57 
58 /* Default target word size to pointer size.  */
59 #ifndef TCG_TARGET_REG_BITS
60 # if UINTPTR_MAX == UINT32_MAX
61 #  define TCG_TARGET_REG_BITS 32
62 # elif UINTPTR_MAX == UINT64_MAX
63 #  define TCG_TARGET_REG_BITS 64
64 # else
65 #  error Unknown pointer size for tcg target
66 # endif
67 #endif
68 
69 #if TCG_TARGET_REG_BITS == 32
70 typedef int32_t tcg_target_long;
71 typedef uint32_t tcg_target_ulong;
72 #define TCG_PRIlx PRIx32
73 #define TCG_PRIld PRId32
74 #elif TCG_TARGET_REG_BITS == 64
75 typedef int64_t tcg_target_long;
76 typedef uint64_t tcg_target_ulong;
77 #define TCG_PRIlx PRIx64
78 #define TCG_PRIld PRId64
79 #else
80 #error unsupported
81 #endif
82 
83 /* Oversized TCG guests make things like MTTCG hard
84  * as we can't use atomics for cputlb updates.
85  */
86 #if TARGET_LONG_BITS > TCG_TARGET_REG_BITS
87 #define TCG_OVERSIZED_GUEST 1
88 #else
89 #define TCG_OVERSIZED_GUEST 0
90 #endif
91 
92 #if TCG_TARGET_NB_REGS <= 32
93 typedef uint32_t TCGRegSet;
94 #elif TCG_TARGET_NB_REGS <= 64
95 typedef uint64_t TCGRegSet;
96 #else
97 #error unsupported
98 #endif
99 
100 #if TCG_TARGET_REG_BITS == 32
101 /* Turn some undef macros into false macros.  */
102 #define TCG_TARGET_HAS_extrl_i64_i32    0
103 #define TCG_TARGET_HAS_extrh_i64_i32    0
104 #define TCG_TARGET_HAS_div_i64          0
105 #define TCG_TARGET_HAS_rem_i64          0
106 #define TCG_TARGET_HAS_div2_i64         0
107 #define TCG_TARGET_HAS_rot_i64          0
108 #define TCG_TARGET_HAS_ext8s_i64        0
109 #define TCG_TARGET_HAS_ext16s_i64       0
110 #define TCG_TARGET_HAS_ext32s_i64       0
111 #define TCG_TARGET_HAS_ext8u_i64        0
112 #define TCG_TARGET_HAS_ext16u_i64       0
113 #define TCG_TARGET_HAS_ext32u_i64       0
114 #define TCG_TARGET_HAS_bswap16_i64      0
115 #define TCG_TARGET_HAS_bswap32_i64      0
116 #define TCG_TARGET_HAS_bswap64_i64      0
117 #define TCG_TARGET_HAS_neg_i64          0
118 #define TCG_TARGET_HAS_not_i64          0
119 #define TCG_TARGET_HAS_andc_i64         0
120 #define TCG_TARGET_HAS_orc_i64          0
121 #define TCG_TARGET_HAS_eqv_i64          0
122 #define TCG_TARGET_HAS_nand_i64         0
123 #define TCG_TARGET_HAS_nor_i64          0
124 #define TCG_TARGET_HAS_clz_i64          0
125 #define TCG_TARGET_HAS_ctz_i64          0
126 #define TCG_TARGET_HAS_ctpop_i64        0
127 #define TCG_TARGET_HAS_deposit_i64      0
128 #define TCG_TARGET_HAS_extract_i64      0
129 #define TCG_TARGET_HAS_sextract_i64     0
130 #define TCG_TARGET_HAS_extract2_i64     0
131 #define TCG_TARGET_HAS_movcond_i64      0
132 #define TCG_TARGET_HAS_add2_i64         0
133 #define TCG_TARGET_HAS_sub2_i64         0
134 #define TCG_TARGET_HAS_mulu2_i64        0
135 #define TCG_TARGET_HAS_muls2_i64        0
136 #define TCG_TARGET_HAS_muluh_i64        0
137 #define TCG_TARGET_HAS_mulsh_i64        0
138 /* Turn some undef macros into true macros.  */
139 #define TCG_TARGET_HAS_add2_i32         1
140 #define TCG_TARGET_HAS_sub2_i32         1
141 #endif
142 
143 #ifndef TCG_TARGET_deposit_i32_valid
144 #define TCG_TARGET_deposit_i32_valid(ofs, len) 1
145 #endif
146 #ifndef TCG_TARGET_deposit_i64_valid
147 #define TCG_TARGET_deposit_i64_valid(ofs, len) 1
148 #endif
149 #ifndef TCG_TARGET_extract_i32_valid
150 #define TCG_TARGET_extract_i32_valid(ofs, len) 1
151 #endif
152 #ifndef TCG_TARGET_extract_i64_valid
153 #define TCG_TARGET_extract_i64_valid(ofs, len) 1
154 #endif
155 
156 /* Only one of DIV or DIV2 should be defined.  */
157 #if defined(TCG_TARGET_HAS_div_i32)
158 #define TCG_TARGET_HAS_div2_i32         0
159 #elif defined(TCG_TARGET_HAS_div2_i32)
160 #define TCG_TARGET_HAS_div_i32          0
161 #define TCG_TARGET_HAS_rem_i32          0
162 #endif
163 #if defined(TCG_TARGET_HAS_div_i64)
164 #define TCG_TARGET_HAS_div2_i64         0
165 #elif defined(TCG_TARGET_HAS_div2_i64)
166 #define TCG_TARGET_HAS_div_i64          0
167 #define TCG_TARGET_HAS_rem_i64          0
168 #endif
169 
170 /* For 32-bit targets, some sort of unsigned widening multiply is required.  */
171 #if TCG_TARGET_REG_BITS == 32 \
172     && !(defined(TCG_TARGET_HAS_mulu2_i32) \
173          || defined(TCG_TARGET_HAS_muluh_i32))
174 # error "Missing unsigned widening multiply"
175 #endif
176 
177 #if !defined(TCG_TARGET_HAS_v64) \
178     && !defined(TCG_TARGET_HAS_v128) \
179     && !defined(TCG_TARGET_HAS_v256)
180 #define TCG_TARGET_MAYBE_vec            0
181 #define TCG_TARGET_HAS_abs_vec          0
182 #define TCG_TARGET_HAS_neg_vec          0
183 #define TCG_TARGET_HAS_not_vec          0
184 #define TCG_TARGET_HAS_andc_vec         0
185 #define TCG_TARGET_HAS_orc_vec          0
186 #define TCG_TARGET_HAS_roti_vec         0
187 #define TCG_TARGET_HAS_rots_vec         0
188 #define TCG_TARGET_HAS_rotv_vec         0
189 #define TCG_TARGET_HAS_shi_vec          0
190 #define TCG_TARGET_HAS_shs_vec          0
191 #define TCG_TARGET_HAS_shv_vec          0
192 #define TCG_TARGET_HAS_mul_vec          0
193 #define TCG_TARGET_HAS_sat_vec          0
194 #define TCG_TARGET_HAS_minmax_vec       0
195 #define TCG_TARGET_HAS_bitsel_vec       0
196 #define TCG_TARGET_HAS_cmpsel_vec       0
197 #else
198 #define TCG_TARGET_MAYBE_vec            1
199 #endif
200 #ifndef TCG_TARGET_HAS_v64
201 #define TCG_TARGET_HAS_v64              0
202 #endif
203 #ifndef TCG_TARGET_HAS_v128
204 #define TCG_TARGET_HAS_v128             0
205 #endif
206 #ifndef TCG_TARGET_HAS_v256
207 #define TCG_TARGET_HAS_v256             0
208 #endif
209 
210 #ifndef TARGET_INSN_START_EXTRA_WORDS
211 # define TARGET_INSN_START_WORDS 1
212 #else
213 # define TARGET_INSN_START_WORDS (1 + TARGET_INSN_START_EXTRA_WORDS)
214 #endif
215 
216 typedef enum TCGOpcode {
217 #define DEF(name, oargs, iargs, cargs, flags) INDEX_op_ ## name,
218 #include "tcg/tcg-opc.h"
219 #undef DEF
220     NB_OPS,
221 } TCGOpcode;
222 
223 #define tcg_regset_set_reg(d, r)   ((d) |= (TCGRegSet)1 << (r))
224 #define tcg_regset_reset_reg(d, r) ((d) &= ~((TCGRegSet)1 << (r)))
225 #define tcg_regset_test_reg(d, r)  (((d) >> (r)) & 1)
226 
227 #ifndef TCG_TARGET_INSN_UNIT_SIZE
228 # error "Missing TCG_TARGET_INSN_UNIT_SIZE"
229 #elif TCG_TARGET_INSN_UNIT_SIZE == 1
230 typedef uint8_t tcg_insn_unit;
231 #elif TCG_TARGET_INSN_UNIT_SIZE == 2
232 typedef uint16_t tcg_insn_unit;
233 #elif TCG_TARGET_INSN_UNIT_SIZE == 4
234 typedef uint32_t tcg_insn_unit;
235 #elif TCG_TARGET_INSN_UNIT_SIZE == 8
236 typedef uint64_t tcg_insn_unit;
237 #else
238 /* The port better have done this.  */
239 #endif
240 
241 
242 #if defined CONFIG_DEBUG_TCG || defined QEMU_STATIC_ANALYSIS
243 # define tcg_debug_assert(X) do { assert(X); } while (0)
244 #else
245 # define tcg_debug_assert(X) \
246     do { if (!(X)) { __builtin_unreachable(); } } while (0)
247 #endif
248 
249 typedef struct TCGRelocation TCGRelocation;
250 struct TCGRelocation {
251     QSIMPLEQ_ENTRY(TCGRelocation) next;
252     tcg_insn_unit *ptr;
253     intptr_t addend;
254     int type;
255 };
256 
257 typedef struct TCGLabel TCGLabel;
258 struct TCGLabel {
259     unsigned present : 1;
260     unsigned has_value : 1;
261     unsigned id : 14;
262     unsigned refs : 16;
263     union {
264         uintptr_t value;
265         const tcg_insn_unit *value_ptr;
266     } u;
267     QSIMPLEQ_HEAD(, TCGRelocation) relocs;
268     QSIMPLEQ_ENTRY(TCGLabel) next;
269 };
270 
271 typedef struct TCGPool {
272     struct TCGPool *next;
273     int size;
274     uint8_t data[] __attribute__ ((aligned));
275 } TCGPool;
276 
277 #define TCG_POOL_CHUNK_SIZE 32768
278 
279 #define TCG_MAX_TEMPS 512
280 #define TCG_MAX_INSNS 512
281 
282 /* when the size of the arguments of a called function is smaller than
283    this value, they are statically allocated in the TB stack frame */
284 #define TCG_STATIC_CALL_ARGS_SIZE 128
285 
286 typedef enum TCGType {
287     TCG_TYPE_I32,
288     TCG_TYPE_I64,
289 
290     TCG_TYPE_V64,
291     TCG_TYPE_V128,
292     TCG_TYPE_V256,
293 
294     TCG_TYPE_COUNT, /* number of different types */
295 
296     /* An alias for the size of the host register.  */
297 #if TCG_TARGET_REG_BITS == 32
298     TCG_TYPE_REG = TCG_TYPE_I32,
299 #else
300     TCG_TYPE_REG = TCG_TYPE_I64,
301 #endif
302 
303     /* An alias for the size of the native pointer.  */
304 #if UINTPTR_MAX == UINT32_MAX
305     TCG_TYPE_PTR = TCG_TYPE_I32,
306 #else
307     TCG_TYPE_PTR = TCG_TYPE_I64,
308 #endif
309 
310     /* An alias for the size of the target "long", aka register.  */
311 #if TARGET_LONG_BITS == 64
312     TCG_TYPE_TL = TCG_TYPE_I64,
313 #else
314     TCG_TYPE_TL = TCG_TYPE_I32,
315 #endif
316 } TCGType;
317 
318 /**
319  * get_alignment_bits
320  * @memop: MemOp value
321  *
322  * Extract the alignment size from the memop.
323  */
324 static inline unsigned get_alignment_bits(MemOp memop)
325 {
326     unsigned a = memop & MO_AMASK;
327 
328     if (a == MO_UNALN) {
329         /* No alignment required.  */
330         a = 0;
331     } else if (a == MO_ALIGN) {
332         /* A natural alignment requirement.  */
333         a = memop & MO_SIZE;
334     } else {
335         /* A specific alignment requirement.  */
336         a = a >> MO_ASHIFT;
337     }
338 #if defined(CONFIG_SOFTMMU)
339     /* The requested alignment cannot overlap the TLB flags.  */
340     tcg_debug_assert((TLB_FLAGS_MASK & ((1 << a) - 1)) == 0);
341 #endif
342     return a;
343 }
344 
345 typedef tcg_target_ulong TCGArg;
346 
347 /* Define type and accessor macros for TCG variables.
348 
349    TCG variables are the inputs and outputs of TCG ops, as described
350    in tcg/README. Target CPU front-end code uses these types to deal
351    with TCG variables as it emits TCG code via the tcg_gen_* functions.
352    They come in several flavours:
353     * TCGv_i32 : 32 bit integer type
354     * TCGv_i64 : 64 bit integer type
355     * TCGv_ptr : a host pointer type
356     * TCGv_vec : a host vector type; the exact size is not exposed
357                  to the CPU front-end code.
358     * TCGv : an integer type the same size as target_ulong
359              (an alias for either TCGv_i32 or TCGv_i64)
360    The compiler's type checking will complain if you mix them
361    up and pass the wrong sized TCGv to a function.
362 
363    Users of tcg_gen_* don't need to know about any of the internal
364    details of these, and should treat them as opaque types.
365    You won't be able to look inside them in a debugger either.
366 
367    Internal implementation details follow:
368 
369    Note that there is no definition of the structs TCGv_i32_d etc anywhere.
370    This is deliberate, because the values we store in variables of type
371    TCGv_i32 are not really pointers-to-structures. They're just small
372    integers, but keeping them in pointer types like this means that the
373    compiler will complain if you accidentally pass a TCGv_i32 to a
374    function which takes a TCGv_i64, and so on. Only the internals of
375    TCG need to care about the actual contents of the types.  */
376 
377 typedef struct TCGv_i32_d *TCGv_i32;
378 typedef struct TCGv_i64_d *TCGv_i64;
379 typedef struct TCGv_ptr_d *TCGv_ptr;
380 typedef struct TCGv_vec_d *TCGv_vec;
381 typedef TCGv_ptr TCGv_env;
382 #if TARGET_LONG_BITS == 32
383 #define TCGv TCGv_i32
384 #elif TARGET_LONG_BITS == 64
385 #define TCGv TCGv_i64
386 #else
387 #error Unhandled TARGET_LONG_BITS value
388 #endif
389 
390 /* call flags */
391 /* Helper does not read globals (either directly or through an exception). It
392    implies TCG_CALL_NO_WRITE_GLOBALS. */
393 #define TCG_CALL_NO_READ_GLOBALS    0x0001
394 /* Helper does not write globals */
395 #define TCG_CALL_NO_WRITE_GLOBALS   0x0002
396 /* Helper can be safely suppressed if the return value is not used. */
397 #define TCG_CALL_NO_SIDE_EFFECTS    0x0004
398 /* Helper is QEMU_NORETURN.  */
399 #define TCG_CALL_NO_RETURN          0x0008
400 
401 /* convenience version of most used call flags */
402 #define TCG_CALL_NO_RWG         TCG_CALL_NO_READ_GLOBALS
403 #define TCG_CALL_NO_WG          TCG_CALL_NO_WRITE_GLOBALS
404 #define TCG_CALL_NO_SE          TCG_CALL_NO_SIDE_EFFECTS
405 #define TCG_CALL_NO_RWG_SE      (TCG_CALL_NO_RWG | TCG_CALL_NO_SE)
406 #define TCG_CALL_NO_WG_SE       (TCG_CALL_NO_WG | TCG_CALL_NO_SE)
407 
408 /* Used to align parameters.  See the comment before tcgv_i32_temp.  */
409 #define TCG_CALL_DUMMY_ARG      ((TCGArg)0)
410 
411 /*
412  * Flags for the bswap opcodes.
413  * If IZ, the input is zero-extended, otherwise unknown.
414  * If OZ or OS, the output is zero- or sign-extended respectively,
415  * otherwise the high bits are undefined.
416  */
417 enum {
418     TCG_BSWAP_IZ = 1,
419     TCG_BSWAP_OZ = 2,
420     TCG_BSWAP_OS = 4,
421 };
422 
423 typedef enum TCGTempVal {
424     TEMP_VAL_DEAD,
425     TEMP_VAL_REG,
426     TEMP_VAL_MEM,
427     TEMP_VAL_CONST,
428 } TCGTempVal;
429 
430 typedef enum TCGTempKind {
431     /* Temp is dead at the end of all basic blocks. */
432     TEMP_NORMAL,
433     /* Temp is saved across basic blocks but dead at the end of TBs. */
434     TEMP_LOCAL,
435     /* Temp is saved across both basic blocks and translation blocks. */
436     TEMP_GLOBAL,
437     /* Temp is in a fixed register. */
438     TEMP_FIXED,
439     /* Temp is a fixed constant. */
440     TEMP_CONST,
441 } TCGTempKind;
442 
443 typedef struct TCGTemp {
444     TCGReg reg:8;
445     TCGTempVal val_type:8;
446     TCGType base_type:8;
447     TCGType type:8;
448     TCGTempKind kind:3;
449     unsigned int indirect_reg:1;
450     unsigned int indirect_base:1;
451     unsigned int mem_coherent:1;
452     unsigned int mem_allocated:1;
453     unsigned int temp_allocated:1;
454 
455     int64_t val;
456     struct TCGTemp *mem_base;
457     intptr_t mem_offset;
458     const char *name;
459 
460     /* Pass-specific information that can be stored for a temporary.
461        One word worth of integer data, and one pointer to data
462        allocated separately.  */
463     uintptr_t state;
464     void *state_ptr;
465 } TCGTemp;
466 
467 typedef struct TCGContext TCGContext;
468 
469 typedef struct TCGTempSet {
470     unsigned long l[BITS_TO_LONGS(TCG_MAX_TEMPS)];
471 } TCGTempSet;
472 
473 /* While we limit helpers to 6 arguments, for 32-bit hosts, with padding,
474    this imples a max of 6*2 (64-bit in) + 2 (64-bit out) = 14 operands.
475    There are never more than 2 outputs, which means that we can store all
476    dead + sync data within 16 bits.  */
477 #define DEAD_ARG  4
478 #define SYNC_ARG  1
479 typedef uint16_t TCGLifeData;
480 
481 /* The layout here is designed to avoid a bitfield crossing of
482    a 32-bit boundary, which would cause GCC to add extra padding.  */
483 typedef struct TCGOp {
484     TCGOpcode opc   : 8;        /*  8 */
485 
486     /* Parameters for this opcode.  See below.  */
487     unsigned param1 : 4;        /* 12 */
488     unsigned param2 : 4;        /* 16 */
489 
490     /* Lifetime data of the operands.  */
491     unsigned life   : 16;       /* 32 */
492 
493     /* Next and previous opcodes.  */
494     QTAILQ_ENTRY(TCGOp) link;
495 #ifdef CONFIG_PLUGIN
496     QSIMPLEQ_ENTRY(TCGOp) plugin_link;
497 #endif
498 
499     /* Arguments for the opcode.  */
500     TCGArg args[MAX_OPC_PARAM];
501 
502     /* Register preferences for the output(s).  */
503     TCGRegSet output_pref[2];
504 } TCGOp;
505 
506 #define TCGOP_CALLI(X)    (X)->param1
507 #define TCGOP_CALLO(X)    (X)->param2
508 
509 #define TCGOP_VECL(X)     (X)->param1
510 #define TCGOP_VECE(X)     (X)->param2
511 
512 /* Make sure operands fit in the bitfields above.  */
513 QEMU_BUILD_BUG_ON(NB_OPS > (1 << 8));
514 
515 typedef struct TCGProfile {
516     int64_t cpu_exec_time;
517     int64_t tb_count1;
518     int64_t tb_count;
519     int64_t op_count; /* total insn count */
520     int op_count_max; /* max insn per TB */
521     int temp_count_max;
522     int64_t temp_count;
523     int64_t del_op_count;
524     int64_t code_in_len;
525     int64_t code_out_len;
526     int64_t search_out_len;
527     int64_t interm_time;
528     int64_t code_time;
529     int64_t la_time;
530     int64_t opt_time;
531     int64_t restore_count;
532     int64_t restore_time;
533     int64_t table_op_count[NB_OPS];
534 } TCGProfile;
535 
536 struct TCGContext {
537     uint8_t *pool_cur, *pool_end;
538     TCGPool *pool_first, *pool_current, *pool_first_large;
539     int nb_labels;
540     int nb_globals;
541     int nb_temps;
542     int nb_indirects;
543     int nb_ops;
544 
545     /* goto_tb support */
546     tcg_insn_unit *code_buf;
547     uint16_t *tb_jmp_reset_offset; /* tb->jmp_reset_offset */
548     uintptr_t *tb_jmp_insn_offset; /* tb->jmp_target_arg if direct_jump */
549     uintptr_t *tb_jmp_target_addr; /* tb->jmp_target_arg if !direct_jump */
550 
551     TCGRegSet reserved_regs;
552     uint32_t tb_cflags; /* cflags of the current TB */
553     intptr_t current_frame_offset;
554     intptr_t frame_start;
555     intptr_t frame_end;
556     TCGTemp *frame_temp;
557 
558     tcg_insn_unit *code_ptr;
559 
560 #ifdef CONFIG_PROFILER
561     TCGProfile prof;
562 #endif
563 
564 #ifdef CONFIG_DEBUG_TCG
565     int temps_in_use;
566     int goto_tb_issue_mask;
567     const TCGOpcode *vecop_list;
568 #endif
569 
570     /* Code generation.  Note that we specifically do not use tcg_insn_unit
571        here, because there's too much arithmetic throughout that relies
572        on addition and subtraction working on bytes.  Rely on the GCC
573        extension that allows arithmetic on void*.  */
574     void *code_gen_buffer;
575     size_t code_gen_buffer_size;
576     void *code_gen_ptr;
577     void *data_gen_ptr;
578 
579     /* Threshold to flush the translated code buffer.  */
580     void *code_gen_highwater;
581 
582     size_t tb_phys_invalidate_count;
583 
584     /* Track which vCPU triggers events */
585     CPUState *cpu;                      /* *_trans */
586 
587     /* These structures are private to tcg-target.c.inc.  */
588 #ifdef TCG_TARGET_NEED_LDST_LABELS
589     QSIMPLEQ_HEAD(, TCGLabelQemuLdst) ldst_labels;
590 #endif
591 #ifdef TCG_TARGET_NEED_POOL_LABELS
592     struct TCGLabelPoolData *pool_labels;
593 #endif
594 
595     TCGLabel *exitreq_label;
596 
597 #ifdef CONFIG_PLUGIN
598     /*
599      * We keep one plugin_tb struct per TCGContext. Note that on every TB
600      * translation we clear but do not free its contents; this way we
601      * avoid a lot of malloc/free churn, since after a few TB's it's
602      * unlikely that we'll need to allocate either more instructions or more
603      * space for instructions (for variable-instruction-length ISAs).
604      */
605     struct qemu_plugin_tb *plugin_tb;
606 
607     /* descriptor of the instruction being translated */
608     struct qemu_plugin_insn *plugin_insn;
609 
610     /* list to quickly access the injected ops */
611     QSIMPLEQ_HEAD(, TCGOp) plugin_ops;
612 #endif
613 
614     GHashTable *const_table[TCG_TYPE_COUNT];
615     TCGTempSet free_temps[TCG_TYPE_COUNT * 2];
616     TCGTemp temps[TCG_MAX_TEMPS]; /* globals first, temps after */
617 
618     QTAILQ_HEAD(, TCGOp) ops, free_ops;
619     QSIMPLEQ_HEAD(, TCGLabel) labels;
620 
621     /* Tells which temporary holds a given register.
622        It does not take into account fixed registers */
623     TCGTemp *reg_to_temp[TCG_TARGET_NB_REGS];
624 
625     uint16_t gen_insn_end_off[TCG_MAX_INSNS];
626     target_ulong gen_insn_data[TCG_MAX_INSNS][TARGET_INSN_START_WORDS];
627 
628     /* Exit to translator on overflow. */
629     sigjmp_buf jmp_trans;
630 };
631 
632 static inline bool temp_readonly(TCGTemp *ts)
633 {
634     return ts->kind >= TEMP_FIXED;
635 }
636 
637 extern __thread TCGContext *tcg_ctx;
638 extern const void *tcg_code_gen_epilogue;
639 extern uintptr_t tcg_splitwx_diff;
640 extern TCGv_env cpu_env;
641 
642 bool in_code_gen_buffer(const void *p);
643 
644 #ifdef CONFIG_DEBUG_TCG
645 const void *tcg_splitwx_to_rx(void *rw);
646 void *tcg_splitwx_to_rw(const void *rx);
647 #else
648 static inline const void *tcg_splitwx_to_rx(void *rw)
649 {
650     return rw ? rw + tcg_splitwx_diff : NULL;
651 }
652 
653 static inline void *tcg_splitwx_to_rw(const void *rx)
654 {
655     return rx ? (void *)rx - tcg_splitwx_diff : NULL;
656 }
657 #endif
658 
659 static inline size_t temp_idx(TCGTemp *ts)
660 {
661     ptrdiff_t n = ts - tcg_ctx->temps;
662     tcg_debug_assert(n >= 0 && n < tcg_ctx->nb_temps);
663     return n;
664 }
665 
666 static inline TCGArg temp_arg(TCGTemp *ts)
667 {
668     return (uintptr_t)ts;
669 }
670 
671 static inline TCGTemp *arg_temp(TCGArg a)
672 {
673     return (TCGTemp *)(uintptr_t)a;
674 }
675 
676 /* Using the offset of a temporary, relative to TCGContext, rather than
677    its index means that we don't use 0.  That leaves offset 0 free for
678    a NULL representation without having to leave index 0 unused.  */
679 static inline TCGTemp *tcgv_i32_temp(TCGv_i32 v)
680 {
681     uintptr_t o = (uintptr_t)v;
682     TCGTemp *t = (void *)tcg_ctx + o;
683     tcg_debug_assert(offsetof(TCGContext, temps[temp_idx(t)]) == o);
684     return t;
685 }
686 
687 static inline TCGTemp *tcgv_i64_temp(TCGv_i64 v)
688 {
689     return tcgv_i32_temp((TCGv_i32)v);
690 }
691 
692 static inline TCGTemp *tcgv_ptr_temp(TCGv_ptr v)
693 {
694     return tcgv_i32_temp((TCGv_i32)v);
695 }
696 
697 static inline TCGTemp *tcgv_vec_temp(TCGv_vec v)
698 {
699     return tcgv_i32_temp((TCGv_i32)v);
700 }
701 
702 static inline TCGArg tcgv_i32_arg(TCGv_i32 v)
703 {
704     return temp_arg(tcgv_i32_temp(v));
705 }
706 
707 static inline TCGArg tcgv_i64_arg(TCGv_i64 v)
708 {
709     return temp_arg(tcgv_i64_temp(v));
710 }
711 
712 static inline TCGArg tcgv_ptr_arg(TCGv_ptr v)
713 {
714     return temp_arg(tcgv_ptr_temp(v));
715 }
716 
717 static inline TCGArg tcgv_vec_arg(TCGv_vec v)
718 {
719     return temp_arg(tcgv_vec_temp(v));
720 }
721 
722 static inline TCGv_i32 temp_tcgv_i32(TCGTemp *t)
723 {
724     (void)temp_idx(t); /* trigger embedded assert */
725     return (TCGv_i32)((void *)t - (void *)tcg_ctx);
726 }
727 
728 static inline TCGv_i64 temp_tcgv_i64(TCGTemp *t)
729 {
730     return (TCGv_i64)temp_tcgv_i32(t);
731 }
732 
733 static inline TCGv_ptr temp_tcgv_ptr(TCGTemp *t)
734 {
735     return (TCGv_ptr)temp_tcgv_i32(t);
736 }
737 
738 static inline TCGv_vec temp_tcgv_vec(TCGTemp *t)
739 {
740     return (TCGv_vec)temp_tcgv_i32(t);
741 }
742 
743 #if TCG_TARGET_REG_BITS == 32
744 static inline TCGv_i32 TCGV_LOW(TCGv_i64 t)
745 {
746     return temp_tcgv_i32(tcgv_i64_temp(t));
747 }
748 
749 static inline TCGv_i32 TCGV_HIGH(TCGv_i64 t)
750 {
751     return temp_tcgv_i32(tcgv_i64_temp(t) + 1);
752 }
753 #endif
754 
755 static inline TCGArg tcg_get_insn_param(TCGOp *op, int arg)
756 {
757     return op->args[arg];
758 }
759 
760 static inline void tcg_set_insn_param(TCGOp *op, int arg, TCGArg v)
761 {
762     op->args[arg] = v;
763 }
764 
765 static inline target_ulong tcg_get_insn_start_param(TCGOp *op, int arg)
766 {
767 #if TARGET_LONG_BITS <= TCG_TARGET_REG_BITS
768     return tcg_get_insn_param(op, arg);
769 #else
770     return tcg_get_insn_param(op, arg * 2) |
771            ((uint64_t)tcg_get_insn_param(op, arg * 2 + 1) << 32);
772 #endif
773 }
774 
775 static inline void tcg_set_insn_start_param(TCGOp *op, int arg, target_ulong v)
776 {
777 #if TARGET_LONG_BITS <= TCG_TARGET_REG_BITS
778     tcg_set_insn_param(op, arg, v);
779 #else
780     tcg_set_insn_param(op, arg * 2, v);
781     tcg_set_insn_param(op, arg * 2 + 1, v >> 32);
782 #endif
783 }
784 
785 /* The last op that was emitted.  */
786 static inline TCGOp *tcg_last_op(void)
787 {
788     return QTAILQ_LAST(&tcg_ctx->ops);
789 }
790 
791 /* Test for whether to terminate the TB for using too many opcodes.  */
792 static inline bool tcg_op_buf_full(void)
793 {
794     /* This is not a hard limit, it merely stops translation when
795      * we have produced "enough" opcodes.  We want to limit TB size
796      * such that a RISC host can reasonably use a 16-bit signed
797      * branch within the TB.  We also need to be mindful of the
798      * 16-bit unsigned offsets, TranslationBlock.jmp_reset_offset[]
799      * and TCGContext.gen_insn_end_off[].
800      */
801     return tcg_ctx->nb_ops >= 4000;
802 }
803 
804 /* pool based memory allocation */
805 
806 /* user-mode: mmap_lock must be held for tcg_malloc_internal. */
807 void *tcg_malloc_internal(TCGContext *s, int size);
808 void tcg_pool_reset(TCGContext *s);
809 TranslationBlock *tcg_tb_alloc(TCGContext *s);
810 
811 void tb_destroy(TranslationBlock *tb);
812 void tcg_region_reset_all(void);
813 
814 size_t tcg_code_size(void);
815 size_t tcg_code_capacity(void);
816 
817 void tcg_tb_insert(TranslationBlock *tb);
818 void tcg_tb_remove(TranslationBlock *tb);
819 size_t tcg_tb_phys_invalidate_count(void);
820 TranslationBlock *tcg_tb_lookup(uintptr_t tc_ptr);
821 void tcg_tb_foreach(GTraverseFunc func, gpointer user_data);
822 size_t tcg_nb_tbs(void);
823 
824 /* user-mode: Called with mmap_lock held.  */
825 static inline void *tcg_malloc(int size)
826 {
827     TCGContext *s = tcg_ctx;
828     uint8_t *ptr, *ptr_end;
829 
830     /* ??? This is a weak placeholder for minimum malloc alignment.  */
831     size = QEMU_ALIGN_UP(size, 8);
832 
833     ptr = s->pool_cur;
834     ptr_end = ptr + size;
835     if (unlikely(ptr_end > s->pool_end)) {
836         return tcg_malloc_internal(tcg_ctx, size);
837     } else {
838         s->pool_cur = ptr_end;
839         return ptr;
840     }
841 }
842 
843 void tcg_init(size_t tb_size, int splitwx, unsigned max_cpus);
844 void tcg_register_thread(void);
845 void tcg_prologue_init(TCGContext *s);
846 void tcg_func_start(TCGContext *s);
847 
848 int tcg_gen_code(TCGContext *s, TranslationBlock *tb);
849 
850 void tcg_set_frame(TCGContext *s, TCGReg reg, intptr_t start, intptr_t size);
851 
852 TCGTemp *tcg_global_mem_new_internal(TCGType, TCGv_ptr,
853                                      intptr_t, const char *);
854 TCGTemp *tcg_temp_new_internal(TCGType, bool);
855 void tcg_temp_free_internal(TCGTemp *);
856 TCGv_vec tcg_temp_new_vec(TCGType type);
857 TCGv_vec tcg_temp_new_vec_matching(TCGv_vec match);
858 
859 static inline void tcg_temp_free_i32(TCGv_i32 arg)
860 {
861     tcg_temp_free_internal(tcgv_i32_temp(arg));
862 }
863 
864 static inline void tcg_temp_free_i64(TCGv_i64 arg)
865 {
866     tcg_temp_free_internal(tcgv_i64_temp(arg));
867 }
868 
869 static inline void tcg_temp_free_ptr(TCGv_ptr arg)
870 {
871     tcg_temp_free_internal(tcgv_ptr_temp(arg));
872 }
873 
874 static inline void tcg_temp_free_vec(TCGv_vec arg)
875 {
876     tcg_temp_free_internal(tcgv_vec_temp(arg));
877 }
878 
879 static inline TCGv_i32 tcg_global_mem_new_i32(TCGv_ptr reg, intptr_t offset,
880                                               const char *name)
881 {
882     TCGTemp *t = tcg_global_mem_new_internal(TCG_TYPE_I32, reg, offset, name);
883     return temp_tcgv_i32(t);
884 }
885 
886 static inline TCGv_i32 tcg_temp_new_i32(void)
887 {
888     TCGTemp *t = tcg_temp_new_internal(TCG_TYPE_I32, false);
889     return temp_tcgv_i32(t);
890 }
891 
892 static inline TCGv_i32 tcg_temp_local_new_i32(void)
893 {
894     TCGTemp *t = tcg_temp_new_internal(TCG_TYPE_I32, true);
895     return temp_tcgv_i32(t);
896 }
897 
898 static inline TCGv_i64 tcg_global_mem_new_i64(TCGv_ptr reg, intptr_t offset,
899                                               const char *name)
900 {
901     TCGTemp *t = tcg_global_mem_new_internal(TCG_TYPE_I64, reg, offset, name);
902     return temp_tcgv_i64(t);
903 }
904 
905 static inline TCGv_i64 tcg_temp_new_i64(void)
906 {
907     TCGTemp *t = tcg_temp_new_internal(TCG_TYPE_I64, false);
908     return temp_tcgv_i64(t);
909 }
910 
911 static inline TCGv_i64 tcg_temp_local_new_i64(void)
912 {
913     TCGTemp *t = tcg_temp_new_internal(TCG_TYPE_I64, true);
914     return temp_tcgv_i64(t);
915 }
916 
917 static inline TCGv_ptr tcg_global_mem_new_ptr(TCGv_ptr reg, intptr_t offset,
918                                               const char *name)
919 {
920     TCGTemp *t = tcg_global_mem_new_internal(TCG_TYPE_PTR, reg, offset, name);
921     return temp_tcgv_ptr(t);
922 }
923 
924 static inline TCGv_ptr tcg_temp_new_ptr(void)
925 {
926     TCGTemp *t = tcg_temp_new_internal(TCG_TYPE_PTR, false);
927     return temp_tcgv_ptr(t);
928 }
929 
930 static inline TCGv_ptr tcg_temp_local_new_ptr(void)
931 {
932     TCGTemp *t = tcg_temp_new_internal(TCG_TYPE_PTR, true);
933     return temp_tcgv_ptr(t);
934 }
935 
936 #if defined(CONFIG_DEBUG_TCG)
937 /* If you call tcg_clear_temp_count() at the start of a section of
938  * code which is not supposed to leak any TCG temporaries, then
939  * calling tcg_check_temp_count() at the end of the section will
940  * return 1 if the section did in fact leak a temporary.
941  */
942 void tcg_clear_temp_count(void);
943 int tcg_check_temp_count(void);
944 #else
945 #define tcg_clear_temp_count() do { } while (0)
946 #define tcg_check_temp_count() 0
947 #endif
948 
949 int64_t tcg_cpu_exec_time(void);
950 void tcg_dump_info(void);
951 void tcg_dump_op_count(void);
952 
953 #define TCG_CT_CONST  1 /* any constant of register size */
954 
955 typedef struct TCGArgConstraint {
956     unsigned ct : 16;
957     unsigned alias_index : 4;
958     unsigned sort_index : 4;
959     bool oalias : 1;
960     bool ialias : 1;
961     bool newreg : 1;
962     TCGRegSet regs;
963 } TCGArgConstraint;
964 
965 #define TCG_MAX_OP_ARGS 16
966 
967 /* Bits for TCGOpDef->flags, 8 bits available, all used.  */
968 enum {
969     /* Instruction exits the translation block.  */
970     TCG_OPF_BB_EXIT      = 0x01,
971     /* Instruction defines the end of a basic block.  */
972     TCG_OPF_BB_END       = 0x02,
973     /* Instruction clobbers call registers and potentially update globals.  */
974     TCG_OPF_CALL_CLOBBER = 0x04,
975     /* Instruction has side effects: it cannot be removed if its outputs
976        are not used, and might trigger exceptions.  */
977     TCG_OPF_SIDE_EFFECTS = 0x08,
978     /* Instruction operands are 64-bits (otherwise 32-bits).  */
979     TCG_OPF_64BIT        = 0x10,
980     /* Instruction is optional and not implemented by the host, or insn
981        is generic and should not be implemened by the host.  */
982     TCG_OPF_NOT_PRESENT  = 0x20,
983     /* Instruction operands are vectors.  */
984     TCG_OPF_VECTOR       = 0x40,
985     /* Instruction is a conditional branch. */
986     TCG_OPF_COND_BRANCH  = 0x80
987 };
988 
989 typedef struct TCGOpDef {
990     const char *name;
991     uint8_t nb_oargs, nb_iargs, nb_cargs, nb_args;
992     uint8_t flags;
993     TCGArgConstraint *args_ct;
994 } TCGOpDef;
995 
996 extern TCGOpDef tcg_op_defs[];
997 extern const size_t tcg_op_defs_max;
998 
999 typedef struct TCGTargetOpDef {
1000     TCGOpcode op;
1001     const char *args_ct_str[TCG_MAX_OP_ARGS];
1002 } TCGTargetOpDef;
1003 
1004 #define tcg_abort() \
1005 do {\
1006     fprintf(stderr, "%s:%d: tcg fatal error\n", __FILE__, __LINE__);\
1007     abort();\
1008 } while (0)
1009 
1010 bool tcg_op_supported(TCGOpcode op);
1011 
1012 void tcg_gen_callN(void *func, TCGTemp *ret, int nargs, TCGTemp **args);
1013 
1014 TCGOp *tcg_emit_op(TCGOpcode opc);
1015 void tcg_op_remove(TCGContext *s, TCGOp *op);
1016 TCGOp *tcg_op_insert_before(TCGContext *s, TCGOp *op, TCGOpcode opc);
1017 TCGOp *tcg_op_insert_after(TCGContext *s, TCGOp *op, TCGOpcode opc);
1018 
1019 /**
1020  * tcg_remove_ops_after:
1021  * @op: target operation
1022  *
1023  * Discard any opcodes emitted since @op.  Expected usage is to save
1024  * a starting point with tcg_last_op(), speculatively emit opcodes,
1025  * then decide whether or not to keep those opcodes after the fact.
1026  */
1027 void tcg_remove_ops_after(TCGOp *op);
1028 
1029 void tcg_optimize(TCGContext *s);
1030 
1031 /* Allocate a new temporary and initialize it with a constant. */
1032 TCGv_i32 tcg_const_i32(int32_t val);
1033 TCGv_i64 tcg_const_i64(int64_t val);
1034 TCGv_i32 tcg_const_local_i32(int32_t val);
1035 TCGv_i64 tcg_const_local_i64(int64_t val);
1036 TCGv_vec tcg_const_zeros_vec(TCGType);
1037 TCGv_vec tcg_const_ones_vec(TCGType);
1038 TCGv_vec tcg_const_zeros_vec_matching(TCGv_vec);
1039 TCGv_vec tcg_const_ones_vec_matching(TCGv_vec);
1040 
1041 /*
1042  * Locate or create a read-only temporary that is a constant.
1043  * This kind of temporary need not be freed, but for convenience
1044  * will be silently ignored by tcg_temp_free_*.
1045  */
1046 TCGTemp *tcg_constant_internal(TCGType type, int64_t val);
1047 
1048 static inline TCGv_i32 tcg_constant_i32(int32_t val)
1049 {
1050     return temp_tcgv_i32(tcg_constant_internal(TCG_TYPE_I32, val));
1051 }
1052 
1053 static inline TCGv_i64 tcg_constant_i64(int64_t val)
1054 {
1055     return temp_tcgv_i64(tcg_constant_internal(TCG_TYPE_I64, val));
1056 }
1057 
1058 TCGv_vec tcg_constant_vec(TCGType type, unsigned vece, int64_t val);
1059 TCGv_vec tcg_constant_vec_matching(TCGv_vec match, unsigned vece, int64_t val);
1060 
1061 #if UINTPTR_MAX == UINT32_MAX
1062 # define tcg_const_ptr(x)        ((TCGv_ptr)tcg_const_i32((intptr_t)(x)))
1063 # define tcg_const_local_ptr(x)  ((TCGv_ptr)tcg_const_local_i32((intptr_t)(x)))
1064 #else
1065 # define tcg_const_ptr(x)        ((TCGv_ptr)tcg_const_i64((intptr_t)(x)))
1066 # define tcg_const_local_ptr(x)  ((TCGv_ptr)tcg_const_local_i64((intptr_t)(x)))
1067 #endif
1068 
1069 TCGLabel *gen_new_label(void);
1070 
1071 /**
1072  * label_arg
1073  * @l: label
1074  *
1075  * Encode a label for storage in the TCG opcode stream.
1076  */
1077 
1078 static inline TCGArg label_arg(TCGLabel *l)
1079 {
1080     return (uintptr_t)l;
1081 }
1082 
1083 /**
1084  * arg_label
1085  * @i: value
1086  *
1087  * The opposite of label_arg.  Retrieve a label from the
1088  * encoding of the TCG opcode stream.
1089  */
1090 
1091 static inline TCGLabel *arg_label(TCGArg i)
1092 {
1093     return (TCGLabel *)(uintptr_t)i;
1094 }
1095 
1096 /**
1097  * tcg_ptr_byte_diff
1098  * @a, @b: addresses to be differenced
1099  *
1100  * There are many places within the TCG backends where we need a byte
1101  * difference between two pointers.  While this can be accomplished
1102  * with local casting, it's easy to get wrong -- especially if one is
1103  * concerned with the signedness of the result.
1104  *
1105  * This version relies on GCC's void pointer arithmetic to get the
1106  * correct result.
1107  */
1108 
1109 static inline ptrdiff_t tcg_ptr_byte_diff(const void *a, const void *b)
1110 {
1111     return a - b;
1112 }
1113 
1114 /**
1115  * tcg_pcrel_diff
1116  * @s: the tcg context
1117  * @target: address of the target
1118  *
1119  * Produce a pc-relative difference, from the current code_ptr
1120  * to the destination address.
1121  */
1122 
1123 static inline ptrdiff_t tcg_pcrel_diff(TCGContext *s, const void *target)
1124 {
1125     return tcg_ptr_byte_diff(target, tcg_splitwx_to_rx(s->code_ptr));
1126 }
1127 
1128 /**
1129  * tcg_tbrel_diff
1130  * @s: the tcg context
1131  * @target: address of the target
1132  *
1133  * Produce a difference, from the beginning of the current TB code
1134  * to the destination address.
1135  */
1136 static inline ptrdiff_t tcg_tbrel_diff(TCGContext *s, const void *target)
1137 {
1138     return tcg_ptr_byte_diff(target, tcg_splitwx_to_rx(s->code_buf));
1139 }
1140 
1141 /**
1142  * tcg_current_code_size
1143  * @s: the tcg context
1144  *
1145  * Compute the current code size within the translation block.
1146  * This is used to fill in qemu's data structures for goto_tb.
1147  */
1148 
1149 static inline size_t tcg_current_code_size(TCGContext *s)
1150 {
1151     return tcg_ptr_byte_diff(s->code_ptr, s->code_buf);
1152 }
1153 
1154 /* Combine the MemOp and mmu_idx parameters into a single value.  */
1155 typedef uint32_t TCGMemOpIdx;
1156 
1157 /**
1158  * make_memop_idx
1159  * @op: memory operation
1160  * @idx: mmu index
1161  *
1162  * Encode these values into a single parameter.
1163  */
1164 static inline TCGMemOpIdx make_memop_idx(MemOp op, unsigned idx)
1165 {
1166     tcg_debug_assert(idx <= 15);
1167     return (op << 4) | idx;
1168 }
1169 
1170 /**
1171  * get_memop
1172  * @oi: combined op/idx parameter
1173  *
1174  * Extract the memory operation from the combined value.
1175  */
1176 static inline MemOp get_memop(TCGMemOpIdx oi)
1177 {
1178     return oi >> 4;
1179 }
1180 
1181 /**
1182  * get_mmuidx
1183  * @oi: combined op/idx parameter
1184  *
1185  * Extract the mmu index from the combined value.
1186  */
1187 static inline unsigned get_mmuidx(TCGMemOpIdx oi)
1188 {
1189     return oi & 15;
1190 }
1191 
1192 /**
1193  * tcg_qemu_tb_exec:
1194  * @env: pointer to CPUArchState for the CPU
1195  * @tb_ptr: address of generated code for the TB to execute
1196  *
1197  * Start executing code from a given translation block.
1198  * Where translation blocks have been linked, execution
1199  * may proceed from the given TB into successive ones.
1200  * Control eventually returns only when some action is needed
1201  * from the top-level loop: either control must pass to a TB
1202  * which has not yet been directly linked, or an asynchronous
1203  * event such as an interrupt needs handling.
1204  *
1205  * Return: The return value is the value passed to the corresponding
1206  * tcg_gen_exit_tb() at translation time of the last TB attempted to execute.
1207  * The value is either zero or a 4-byte aligned pointer to that TB combined
1208  * with additional information in its two least significant bits. The
1209  * additional information is encoded as follows:
1210  *  0, 1: the link between this TB and the next is via the specified
1211  *        TB index (0 or 1). That is, we left the TB via (the equivalent
1212  *        of) "goto_tb <index>". The main loop uses this to determine
1213  *        how to link the TB just executed to the next.
1214  *  2:    we are using instruction counting code generation, and we
1215  *        did not start executing this TB because the instruction counter
1216  *        would hit zero midway through it. In this case the pointer
1217  *        returned is the TB we were about to execute, and the caller must
1218  *        arrange to execute the remaining count of instructions.
1219  *  3:    we stopped because the CPU's exit_request flag was set
1220  *        (usually meaning that there is an interrupt that needs to be
1221  *        handled). The pointer returned is the TB we were about to execute
1222  *        when we noticed the pending exit request.
1223  *
1224  * If the bottom two bits indicate an exit-via-index then the CPU
1225  * state is correctly synchronised and ready for execution of the next
1226  * TB (and in particular the guest PC is the address to execute next).
1227  * Otherwise, we gave up on execution of this TB before it started, and
1228  * the caller must fix up the CPU state by calling the CPU's
1229  * synchronize_from_tb() method with the TB pointer we return (falling
1230  * back to calling the CPU's set_pc method with tb->pb if no
1231  * synchronize_from_tb() method exists).
1232  *
1233  * Note that TCG targets may use a different definition of tcg_qemu_tb_exec
1234  * to this default (which just calls the prologue.code emitted by
1235  * tcg_target_qemu_prologue()).
1236  */
1237 #define TB_EXIT_MASK      3
1238 #define TB_EXIT_IDX0      0
1239 #define TB_EXIT_IDX1      1
1240 #define TB_EXIT_IDXMAX    1
1241 #define TB_EXIT_REQUESTED 3
1242 
1243 #ifdef CONFIG_TCG_INTERPRETER
1244 uintptr_t tcg_qemu_tb_exec(CPUArchState *env, const void *tb_ptr);
1245 #else
1246 typedef uintptr_t tcg_prologue_fn(CPUArchState *env, const void *tb_ptr);
1247 extern tcg_prologue_fn *tcg_qemu_tb_exec;
1248 #endif
1249 
1250 void tcg_register_jit(const void *buf, size_t buf_size);
1251 
1252 #if TCG_TARGET_MAYBE_vec
1253 /* Return zero if the tuple (opc, type, vece) is unsupportable;
1254    return > 0 if it is directly supportable;
1255    return < 0 if we must call tcg_expand_vec_op.  */
1256 int tcg_can_emit_vec_op(TCGOpcode, TCGType, unsigned);
1257 #else
1258 static inline int tcg_can_emit_vec_op(TCGOpcode o, TCGType t, unsigned ve)
1259 {
1260     return 0;
1261 }
1262 #endif
1263 
1264 /* Expand the tuple (opc, type, vece) on the given arguments.  */
1265 void tcg_expand_vec_op(TCGOpcode, TCGType, unsigned, TCGArg, ...);
1266 
1267 /* Replicate a constant C accoring to the log2 of the element size.  */
1268 uint64_t dup_const(unsigned vece, uint64_t c);
1269 
1270 #define dup_const(VECE, C)                                         \
1271     (__builtin_constant_p(VECE)                                    \
1272      ? (  (VECE) == MO_8  ? 0x0101010101010101ull * (uint8_t)(C)   \
1273         : (VECE) == MO_16 ? 0x0001000100010001ull * (uint16_t)(C)  \
1274         : (VECE) == MO_32 ? 0x0000000100000001ull * (uint32_t)(C)  \
1275         : (VECE) == MO_64 ? (uint64_t)(C)                          \
1276         : (qemu_build_not_reached_always(), 0))                    \
1277      : dup_const(VECE, C))
1278 
1279 /*
1280  * Memory helpers that will be used by TCG generated code.
1281  */
1282 #ifdef CONFIG_SOFTMMU
1283 /* Value zero-extended to tcg register size.  */
1284 tcg_target_ulong helper_ret_ldub_mmu(CPUArchState *env, target_ulong addr,
1285                                      TCGMemOpIdx oi, uintptr_t retaddr);
1286 tcg_target_ulong helper_le_lduw_mmu(CPUArchState *env, target_ulong addr,
1287                                     TCGMemOpIdx oi, uintptr_t retaddr);
1288 tcg_target_ulong helper_le_ldul_mmu(CPUArchState *env, target_ulong addr,
1289                                     TCGMemOpIdx oi, uintptr_t retaddr);
1290 uint64_t helper_le_ldq_mmu(CPUArchState *env, target_ulong addr,
1291                            TCGMemOpIdx oi, uintptr_t retaddr);
1292 tcg_target_ulong helper_be_lduw_mmu(CPUArchState *env, target_ulong addr,
1293                                     TCGMemOpIdx oi, uintptr_t retaddr);
1294 tcg_target_ulong helper_be_ldul_mmu(CPUArchState *env, target_ulong addr,
1295                                     TCGMemOpIdx oi, uintptr_t retaddr);
1296 uint64_t helper_be_ldq_mmu(CPUArchState *env, target_ulong addr,
1297                            TCGMemOpIdx oi, uintptr_t retaddr);
1298 
1299 /* Value sign-extended to tcg register size.  */
1300 tcg_target_ulong helper_ret_ldsb_mmu(CPUArchState *env, target_ulong addr,
1301                                      TCGMemOpIdx oi, uintptr_t retaddr);
1302 tcg_target_ulong helper_le_ldsw_mmu(CPUArchState *env, target_ulong addr,
1303                                     TCGMemOpIdx oi, uintptr_t retaddr);
1304 tcg_target_ulong helper_le_ldsl_mmu(CPUArchState *env, target_ulong addr,
1305                                     TCGMemOpIdx oi, uintptr_t retaddr);
1306 tcg_target_ulong helper_be_ldsw_mmu(CPUArchState *env, target_ulong addr,
1307                                     TCGMemOpIdx oi, uintptr_t retaddr);
1308 tcg_target_ulong helper_be_ldsl_mmu(CPUArchState *env, target_ulong addr,
1309                                     TCGMemOpIdx oi, uintptr_t retaddr);
1310 
1311 void helper_ret_stb_mmu(CPUArchState *env, target_ulong addr, uint8_t val,
1312                         TCGMemOpIdx oi, uintptr_t retaddr);
1313 void helper_le_stw_mmu(CPUArchState *env, target_ulong addr, uint16_t val,
1314                        TCGMemOpIdx oi, uintptr_t retaddr);
1315 void helper_le_stl_mmu(CPUArchState *env, target_ulong addr, uint32_t val,
1316                        TCGMemOpIdx oi, uintptr_t retaddr);
1317 void helper_le_stq_mmu(CPUArchState *env, target_ulong addr, uint64_t val,
1318                        TCGMemOpIdx oi, uintptr_t retaddr);
1319 void helper_be_stw_mmu(CPUArchState *env, target_ulong addr, uint16_t val,
1320                        TCGMemOpIdx oi, uintptr_t retaddr);
1321 void helper_be_stl_mmu(CPUArchState *env, target_ulong addr, uint32_t val,
1322                        TCGMemOpIdx oi, uintptr_t retaddr);
1323 void helper_be_stq_mmu(CPUArchState *env, target_ulong addr, uint64_t val,
1324                        TCGMemOpIdx oi, uintptr_t retaddr);
1325 
1326 /* Temporary aliases until backends are converted.  */
1327 #ifdef TARGET_WORDS_BIGENDIAN
1328 # define helper_ret_ldsw_mmu  helper_be_ldsw_mmu
1329 # define helper_ret_lduw_mmu  helper_be_lduw_mmu
1330 # define helper_ret_ldsl_mmu  helper_be_ldsl_mmu
1331 # define helper_ret_ldul_mmu  helper_be_ldul_mmu
1332 # define helper_ret_ldl_mmu   helper_be_ldul_mmu
1333 # define helper_ret_ldq_mmu   helper_be_ldq_mmu
1334 # define helper_ret_stw_mmu   helper_be_stw_mmu
1335 # define helper_ret_stl_mmu   helper_be_stl_mmu
1336 # define helper_ret_stq_mmu   helper_be_stq_mmu
1337 #else
1338 # define helper_ret_ldsw_mmu  helper_le_ldsw_mmu
1339 # define helper_ret_lduw_mmu  helper_le_lduw_mmu
1340 # define helper_ret_ldsl_mmu  helper_le_ldsl_mmu
1341 # define helper_ret_ldul_mmu  helper_le_ldul_mmu
1342 # define helper_ret_ldl_mmu   helper_le_ldul_mmu
1343 # define helper_ret_ldq_mmu   helper_le_ldq_mmu
1344 # define helper_ret_stw_mmu   helper_le_stw_mmu
1345 # define helper_ret_stl_mmu   helper_le_stl_mmu
1346 # define helper_ret_stq_mmu   helper_le_stq_mmu
1347 #endif
1348 
1349 uint32_t helper_atomic_cmpxchgb_mmu(CPUArchState *env, target_ulong addr,
1350                                     uint32_t cmpv, uint32_t newv,
1351                                     TCGMemOpIdx oi, uintptr_t retaddr);
1352 uint32_t helper_atomic_cmpxchgw_le_mmu(CPUArchState *env, target_ulong addr,
1353                                        uint32_t cmpv, uint32_t newv,
1354                                        TCGMemOpIdx oi, uintptr_t retaddr);
1355 uint32_t helper_atomic_cmpxchgl_le_mmu(CPUArchState *env, target_ulong addr,
1356                                        uint32_t cmpv, uint32_t newv,
1357                                        TCGMemOpIdx oi, uintptr_t retaddr);
1358 uint64_t helper_atomic_cmpxchgq_le_mmu(CPUArchState *env, target_ulong addr,
1359                                        uint64_t cmpv, uint64_t newv,
1360                                        TCGMemOpIdx oi, uintptr_t retaddr);
1361 uint32_t helper_atomic_cmpxchgw_be_mmu(CPUArchState *env, target_ulong addr,
1362                                        uint32_t cmpv, uint32_t newv,
1363                                        TCGMemOpIdx oi, uintptr_t retaddr);
1364 uint32_t helper_atomic_cmpxchgl_be_mmu(CPUArchState *env, target_ulong addr,
1365                                        uint32_t cmpv, uint32_t newv,
1366                                        TCGMemOpIdx oi, uintptr_t retaddr);
1367 uint64_t helper_atomic_cmpxchgq_be_mmu(CPUArchState *env, target_ulong addr,
1368                                        uint64_t cmpv, uint64_t newv,
1369                                        TCGMemOpIdx oi, uintptr_t retaddr);
1370 
1371 #define GEN_ATOMIC_HELPER(NAME, TYPE, SUFFIX)         \
1372 TYPE helper_atomic_ ## NAME ## SUFFIX ## _mmu         \
1373     (CPUArchState *env, target_ulong addr, TYPE val,  \
1374      TCGMemOpIdx oi, uintptr_t retaddr);
1375 
1376 #ifdef CONFIG_ATOMIC64
1377 #define GEN_ATOMIC_HELPER_ALL(NAME)          \
1378     GEN_ATOMIC_HELPER(NAME, uint32_t, b)     \
1379     GEN_ATOMIC_HELPER(NAME, uint32_t, w_le)  \
1380     GEN_ATOMIC_HELPER(NAME, uint32_t, w_be)  \
1381     GEN_ATOMIC_HELPER(NAME, uint32_t, l_le)  \
1382     GEN_ATOMIC_HELPER(NAME, uint32_t, l_be)  \
1383     GEN_ATOMIC_HELPER(NAME, uint64_t, q_le)  \
1384     GEN_ATOMIC_HELPER(NAME, uint64_t, q_be)
1385 #else
1386 #define GEN_ATOMIC_HELPER_ALL(NAME)          \
1387     GEN_ATOMIC_HELPER(NAME, uint32_t, b)     \
1388     GEN_ATOMIC_HELPER(NAME, uint32_t, w_le)  \
1389     GEN_ATOMIC_HELPER(NAME, uint32_t, w_be)  \
1390     GEN_ATOMIC_HELPER(NAME, uint32_t, l_le)  \
1391     GEN_ATOMIC_HELPER(NAME, uint32_t, l_be)
1392 #endif
1393 
1394 GEN_ATOMIC_HELPER_ALL(fetch_add)
1395 GEN_ATOMIC_HELPER_ALL(fetch_sub)
1396 GEN_ATOMIC_HELPER_ALL(fetch_and)
1397 GEN_ATOMIC_HELPER_ALL(fetch_or)
1398 GEN_ATOMIC_HELPER_ALL(fetch_xor)
1399 GEN_ATOMIC_HELPER_ALL(fetch_smin)
1400 GEN_ATOMIC_HELPER_ALL(fetch_umin)
1401 GEN_ATOMIC_HELPER_ALL(fetch_smax)
1402 GEN_ATOMIC_HELPER_ALL(fetch_umax)
1403 
1404 GEN_ATOMIC_HELPER_ALL(add_fetch)
1405 GEN_ATOMIC_HELPER_ALL(sub_fetch)
1406 GEN_ATOMIC_HELPER_ALL(and_fetch)
1407 GEN_ATOMIC_HELPER_ALL(or_fetch)
1408 GEN_ATOMIC_HELPER_ALL(xor_fetch)
1409 GEN_ATOMIC_HELPER_ALL(smin_fetch)
1410 GEN_ATOMIC_HELPER_ALL(umin_fetch)
1411 GEN_ATOMIC_HELPER_ALL(smax_fetch)
1412 GEN_ATOMIC_HELPER_ALL(umax_fetch)
1413 
1414 GEN_ATOMIC_HELPER_ALL(xchg)
1415 
1416 #undef GEN_ATOMIC_HELPER_ALL
1417 #undef GEN_ATOMIC_HELPER
1418 #endif /* CONFIG_SOFTMMU */
1419 
1420 /*
1421  * These aren't really a "proper" helpers because TCG cannot manage Int128.
1422  * However, use the same format as the others, for use by the backends.
1423  *
1424  * The cmpxchg functions are only defined if HAVE_CMPXCHG128;
1425  * the ld/st functions are only defined if HAVE_ATOMIC128,
1426  * as defined by <qemu/atomic128.h>.
1427  */
1428 Int128 helper_atomic_cmpxchgo_le_mmu(CPUArchState *env, target_ulong addr,
1429                                      Int128 cmpv, Int128 newv,
1430                                      TCGMemOpIdx oi, uintptr_t retaddr);
1431 Int128 helper_atomic_cmpxchgo_be_mmu(CPUArchState *env, target_ulong addr,
1432                                      Int128 cmpv, Int128 newv,
1433                                      TCGMemOpIdx oi, uintptr_t retaddr);
1434 
1435 Int128 helper_atomic_ldo_le_mmu(CPUArchState *env, target_ulong addr,
1436                                 TCGMemOpIdx oi, uintptr_t retaddr);
1437 Int128 helper_atomic_ldo_be_mmu(CPUArchState *env, target_ulong addr,
1438                                 TCGMemOpIdx oi, uintptr_t retaddr);
1439 void helper_atomic_sto_le_mmu(CPUArchState *env, target_ulong addr, Int128 val,
1440                               TCGMemOpIdx oi, uintptr_t retaddr);
1441 void helper_atomic_sto_be_mmu(CPUArchState *env, target_ulong addr, Int128 val,
1442                               TCGMemOpIdx oi, uintptr_t retaddr);
1443 
1444 #ifdef CONFIG_DEBUG_TCG
1445 void tcg_assert_listed_vecop(TCGOpcode);
1446 #else
1447 static inline void tcg_assert_listed_vecop(TCGOpcode op) { }
1448 #endif
1449 
1450 static inline const TCGOpcode *tcg_swap_vecop_list(const TCGOpcode *n)
1451 {
1452 #ifdef CONFIG_DEBUG_TCG
1453     const TCGOpcode *o = tcg_ctx->vecop_list;
1454     tcg_ctx->vecop_list = n;
1455     return o;
1456 #else
1457     return NULL;
1458 #endif
1459 }
1460 
1461 bool tcg_can_emit_vecop_list(const TCGOpcode *, TCGType, unsigned);
1462 
1463 #endif /* TCG_H */
1464