xref: /openbmc/qemu/include/tcg/tcg.h (revision e6203636)
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 "exec/memop.h"
29 #include "exec/memopidx.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-reg-bits.h"
35 #include "tcg-target.h"
36 #include "tcg/tcg-cond.h"
37 #include "tcg/debug-assert.h"
38 
39 /* XXX: make safe guess about sizes */
40 #define MAX_OP_PER_INSTR 266
41 
42 #define MAX_CALL_IARGS  7
43 
44 #define CPU_TEMP_BUF_NLONGS 128
45 #define TCG_STATIC_FRAME_SIZE  (CPU_TEMP_BUF_NLONGS * sizeof(long))
46 
47 #if TCG_TARGET_REG_BITS == 32
48 typedef int32_t tcg_target_long;
49 typedef uint32_t tcg_target_ulong;
50 #define TCG_PRIlx PRIx32
51 #define TCG_PRIld PRId32
52 #elif TCG_TARGET_REG_BITS == 64
53 typedef int64_t tcg_target_long;
54 typedef uint64_t tcg_target_ulong;
55 #define TCG_PRIlx PRIx64
56 #define TCG_PRIld PRId64
57 #else
58 #error unsupported
59 #endif
60 
61 #if TCG_TARGET_NB_REGS <= 32
62 typedef uint32_t TCGRegSet;
63 #elif TCG_TARGET_NB_REGS <= 64
64 typedef uint64_t TCGRegSet;
65 #else
66 #error unsupported
67 #endif
68 
69 #if TCG_TARGET_REG_BITS == 32
70 /* Turn some undef macros into false macros.  */
71 #define TCG_TARGET_HAS_extr_i64_i32     0
72 #define TCG_TARGET_HAS_div_i64          0
73 #define TCG_TARGET_HAS_rem_i64          0
74 #define TCG_TARGET_HAS_div2_i64         0
75 #define TCG_TARGET_HAS_rot_i64          0
76 #define TCG_TARGET_HAS_ext8s_i64        0
77 #define TCG_TARGET_HAS_ext16s_i64       0
78 #define TCG_TARGET_HAS_ext32s_i64       0
79 #define TCG_TARGET_HAS_ext8u_i64        0
80 #define TCG_TARGET_HAS_ext16u_i64       0
81 #define TCG_TARGET_HAS_ext32u_i64       0
82 #define TCG_TARGET_HAS_bswap16_i64      0
83 #define TCG_TARGET_HAS_bswap32_i64      0
84 #define TCG_TARGET_HAS_bswap64_i64      0
85 #define TCG_TARGET_HAS_not_i64          0
86 #define TCG_TARGET_HAS_andc_i64         0
87 #define TCG_TARGET_HAS_orc_i64          0
88 #define TCG_TARGET_HAS_eqv_i64          0
89 #define TCG_TARGET_HAS_nand_i64         0
90 #define TCG_TARGET_HAS_nor_i64          0
91 #define TCG_TARGET_HAS_clz_i64          0
92 #define TCG_TARGET_HAS_ctz_i64          0
93 #define TCG_TARGET_HAS_ctpop_i64        0
94 #define TCG_TARGET_HAS_deposit_i64      0
95 #define TCG_TARGET_HAS_extract_i64      0
96 #define TCG_TARGET_HAS_sextract_i64     0
97 #define TCG_TARGET_HAS_extract2_i64     0
98 #define TCG_TARGET_HAS_negsetcond_i64   0
99 #define TCG_TARGET_HAS_add2_i64         0
100 #define TCG_TARGET_HAS_sub2_i64         0
101 #define TCG_TARGET_HAS_mulu2_i64        0
102 #define TCG_TARGET_HAS_muls2_i64        0
103 #define TCG_TARGET_HAS_muluh_i64        0
104 #define TCG_TARGET_HAS_mulsh_i64        0
105 /* Turn some undef macros into true macros.  */
106 #define TCG_TARGET_HAS_add2_i32         1
107 #define TCG_TARGET_HAS_sub2_i32         1
108 #endif
109 
110 #ifndef TCG_TARGET_deposit_i32_valid
111 #define TCG_TARGET_deposit_i32_valid(ofs, len) 1
112 #endif
113 #ifndef TCG_TARGET_deposit_i64_valid
114 #define TCG_TARGET_deposit_i64_valid(ofs, len) 1
115 #endif
116 #ifndef TCG_TARGET_extract_i32_valid
117 #define TCG_TARGET_extract_i32_valid(ofs, len) 1
118 #endif
119 #ifndef TCG_TARGET_extract_i64_valid
120 #define TCG_TARGET_extract_i64_valid(ofs, len) 1
121 #endif
122 
123 /* Only one of DIV or DIV2 should be defined.  */
124 #if defined(TCG_TARGET_HAS_div_i32)
125 #define TCG_TARGET_HAS_div2_i32         0
126 #elif defined(TCG_TARGET_HAS_div2_i32)
127 #define TCG_TARGET_HAS_div_i32          0
128 #define TCG_TARGET_HAS_rem_i32          0
129 #endif
130 #if defined(TCG_TARGET_HAS_div_i64)
131 #define TCG_TARGET_HAS_div2_i64         0
132 #elif defined(TCG_TARGET_HAS_div2_i64)
133 #define TCG_TARGET_HAS_div_i64          0
134 #define TCG_TARGET_HAS_rem_i64          0
135 #endif
136 
137 #if !defined(TCG_TARGET_HAS_v64) \
138     && !defined(TCG_TARGET_HAS_v128) \
139     && !defined(TCG_TARGET_HAS_v256)
140 #define TCG_TARGET_MAYBE_vec            0
141 #define TCG_TARGET_HAS_abs_vec          0
142 #define TCG_TARGET_HAS_neg_vec          0
143 #define TCG_TARGET_HAS_not_vec          0
144 #define TCG_TARGET_HAS_andc_vec         0
145 #define TCG_TARGET_HAS_orc_vec          0
146 #define TCG_TARGET_HAS_nand_vec         0
147 #define TCG_TARGET_HAS_nor_vec          0
148 #define TCG_TARGET_HAS_eqv_vec          0
149 #define TCG_TARGET_HAS_roti_vec         0
150 #define TCG_TARGET_HAS_rots_vec         0
151 #define TCG_TARGET_HAS_rotv_vec         0
152 #define TCG_TARGET_HAS_shi_vec          0
153 #define TCG_TARGET_HAS_shs_vec          0
154 #define TCG_TARGET_HAS_shv_vec          0
155 #define TCG_TARGET_HAS_mul_vec          0
156 #define TCG_TARGET_HAS_sat_vec          0
157 #define TCG_TARGET_HAS_minmax_vec       0
158 #define TCG_TARGET_HAS_bitsel_vec       0
159 #define TCG_TARGET_HAS_cmpsel_vec       0
160 #else
161 #define TCG_TARGET_MAYBE_vec            1
162 #endif
163 #ifndef TCG_TARGET_HAS_v64
164 #define TCG_TARGET_HAS_v64              0
165 #endif
166 #ifndef TCG_TARGET_HAS_v128
167 #define TCG_TARGET_HAS_v128             0
168 #endif
169 #ifndef TCG_TARGET_HAS_v256
170 #define TCG_TARGET_HAS_v256             0
171 #endif
172 
173 typedef enum TCGOpcode {
174 #define DEF(name, oargs, iargs, cargs, flags) INDEX_op_ ## name,
175 #include "tcg/tcg-opc.h"
176 #undef DEF
177     NB_OPS,
178 } TCGOpcode;
179 
180 #define tcg_regset_set_reg(d, r)   ((d) |= (TCGRegSet)1 << (r))
181 #define tcg_regset_reset_reg(d, r) ((d) &= ~((TCGRegSet)1 << (r)))
182 #define tcg_regset_test_reg(d, r)  (((d) >> (r)) & 1)
183 
184 #ifndef TCG_TARGET_INSN_UNIT_SIZE
185 # error "Missing TCG_TARGET_INSN_UNIT_SIZE"
186 #elif TCG_TARGET_INSN_UNIT_SIZE == 1
187 typedef uint8_t tcg_insn_unit;
188 #elif TCG_TARGET_INSN_UNIT_SIZE == 2
189 typedef uint16_t tcg_insn_unit;
190 #elif TCG_TARGET_INSN_UNIT_SIZE == 4
191 typedef uint32_t tcg_insn_unit;
192 #elif TCG_TARGET_INSN_UNIT_SIZE == 8
193 typedef uint64_t tcg_insn_unit;
194 #else
195 /* The port better have done this.  */
196 #endif
197 
198 typedef struct TCGRelocation TCGRelocation;
199 struct TCGRelocation {
200     QSIMPLEQ_ENTRY(TCGRelocation) next;
201     tcg_insn_unit *ptr;
202     intptr_t addend;
203     int type;
204 };
205 
206 typedef struct TCGOp TCGOp;
207 typedef struct TCGLabelUse TCGLabelUse;
208 struct TCGLabelUse {
209     QSIMPLEQ_ENTRY(TCGLabelUse) next;
210     TCGOp *op;
211 };
212 
213 typedef struct TCGLabel TCGLabel;
214 struct TCGLabel {
215     bool present;
216     bool has_value;
217     uint16_t id;
218     union {
219         uintptr_t value;
220         const tcg_insn_unit *value_ptr;
221     } u;
222     QSIMPLEQ_HEAD(, TCGLabelUse) branches;
223     QSIMPLEQ_HEAD(, TCGRelocation) relocs;
224     QSIMPLEQ_ENTRY(TCGLabel) next;
225 };
226 
227 typedef struct TCGPool {
228     struct TCGPool *next;
229     int size;
230     uint8_t data[] __attribute__ ((aligned));
231 } TCGPool;
232 
233 #define TCG_POOL_CHUNK_SIZE 32768
234 
235 #define TCG_MAX_TEMPS 512
236 #define TCG_MAX_INSNS 512
237 
238 /* when the size of the arguments of a called function is smaller than
239    this value, they are statically allocated in the TB stack frame */
240 #define TCG_STATIC_CALL_ARGS_SIZE 128
241 
242 typedef enum TCGType {
243     TCG_TYPE_I32,
244     TCG_TYPE_I64,
245     TCG_TYPE_I128,
246 
247     TCG_TYPE_V64,
248     TCG_TYPE_V128,
249     TCG_TYPE_V256,
250 
251     /* Number of different types (integer not enum) */
252 #define TCG_TYPE_COUNT  (TCG_TYPE_V256 + 1)
253 
254     /* An alias for the size of the host register.  */
255 #if TCG_TARGET_REG_BITS == 32
256     TCG_TYPE_REG = TCG_TYPE_I32,
257 #else
258     TCG_TYPE_REG = TCG_TYPE_I64,
259 #endif
260 
261     /* An alias for the size of the native pointer.  */
262 #if UINTPTR_MAX == UINT32_MAX
263     TCG_TYPE_PTR = TCG_TYPE_I32,
264 #else
265     TCG_TYPE_PTR = TCG_TYPE_I64,
266 #endif
267 } TCGType;
268 
269 /**
270  * tcg_type_size
271  * @t: type
272  *
273  * Return the size of the type in bytes.
274  */
275 static inline int tcg_type_size(TCGType t)
276 {
277     unsigned i = t;
278     if (i >= TCG_TYPE_V64) {
279         tcg_debug_assert(i < TCG_TYPE_COUNT);
280         i -= TCG_TYPE_V64 - 1;
281     }
282     return 4 << i;
283 }
284 
285 /**
286  * get_alignment_bits
287  * @memop: MemOp value
288  *
289  * Extract the alignment size from the memop.
290  */
291 static inline unsigned get_alignment_bits(MemOp memop)
292 {
293     unsigned a = memop & MO_AMASK;
294 
295     if (a == MO_UNALN) {
296         /* No alignment required.  */
297         a = 0;
298     } else if (a == MO_ALIGN) {
299         /* A natural alignment requirement.  */
300         a = memop & MO_SIZE;
301     } else {
302         /* A specific alignment requirement.  */
303         a = a >> MO_ASHIFT;
304     }
305     return a;
306 }
307 
308 typedef tcg_target_ulong TCGArg;
309 
310 /* Define type and accessor macros for TCG variables.
311 
312    TCG variables are the inputs and outputs of TCG ops, as described
313    in tcg/README. Target CPU front-end code uses these types to deal
314    with TCG variables as it emits TCG code via the tcg_gen_* functions.
315    They come in several flavours:
316     * TCGv_i32  : 32 bit integer type
317     * TCGv_i64  : 64 bit integer type
318     * TCGv_i128 : 128 bit integer type
319     * TCGv_ptr  : a host pointer type
320     * TCGv_vec  : a host vector type; the exact size is not exposed
321                   to the CPU front-end code.
322     * TCGv      : an integer type the same size as target_ulong
323                   (an alias for either TCGv_i32 or TCGv_i64)
324    The compiler's type checking will complain if you mix them
325    up and pass the wrong sized TCGv to a function.
326 
327    Users of tcg_gen_* don't need to know about any of the internal
328    details of these, and should treat them as opaque types.
329    You won't be able to look inside them in a debugger either.
330 
331    Internal implementation details follow:
332 
333    Note that there is no definition of the structs TCGv_i32_d etc anywhere.
334    This is deliberate, because the values we store in variables of type
335    TCGv_i32 are not really pointers-to-structures. They're just small
336    integers, but keeping them in pointer types like this means that the
337    compiler will complain if you accidentally pass a TCGv_i32 to a
338    function which takes a TCGv_i64, and so on. Only the internals of
339    TCG need to care about the actual contents of the types.  */
340 
341 typedef struct TCGv_i32_d *TCGv_i32;
342 typedef struct TCGv_i64_d *TCGv_i64;
343 typedef struct TCGv_i128_d *TCGv_i128;
344 typedef struct TCGv_ptr_d *TCGv_ptr;
345 typedef struct TCGv_vec_d *TCGv_vec;
346 typedef TCGv_ptr TCGv_env;
347 
348 /* call flags */
349 /* Helper does not read globals (either directly or through an exception). It
350    implies TCG_CALL_NO_WRITE_GLOBALS. */
351 #define TCG_CALL_NO_READ_GLOBALS    0x0001
352 /* Helper does not write globals */
353 #define TCG_CALL_NO_WRITE_GLOBALS   0x0002
354 /* Helper can be safely suppressed if the return value is not used. */
355 #define TCG_CALL_NO_SIDE_EFFECTS    0x0004
356 /* Helper is G_NORETURN.  */
357 #define TCG_CALL_NO_RETURN          0x0008
358 /* Helper is part of Plugins.  */
359 #define TCG_CALL_PLUGIN             0x0010
360 
361 /* convenience version of most used call flags */
362 #define TCG_CALL_NO_RWG         TCG_CALL_NO_READ_GLOBALS
363 #define TCG_CALL_NO_WG          TCG_CALL_NO_WRITE_GLOBALS
364 #define TCG_CALL_NO_SE          TCG_CALL_NO_SIDE_EFFECTS
365 #define TCG_CALL_NO_RWG_SE      (TCG_CALL_NO_RWG | TCG_CALL_NO_SE)
366 #define TCG_CALL_NO_WG_SE       (TCG_CALL_NO_WG | TCG_CALL_NO_SE)
367 
368 /*
369  * Flags for the bswap opcodes.
370  * If IZ, the input is zero-extended, otherwise unknown.
371  * If OZ or OS, the output is zero- or sign-extended respectively,
372  * otherwise the high bits are undefined.
373  */
374 enum {
375     TCG_BSWAP_IZ = 1,
376     TCG_BSWAP_OZ = 2,
377     TCG_BSWAP_OS = 4,
378 };
379 
380 typedef enum TCGTempVal {
381     TEMP_VAL_DEAD,
382     TEMP_VAL_REG,
383     TEMP_VAL_MEM,
384     TEMP_VAL_CONST,
385 } TCGTempVal;
386 
387 typedef enum TCGTempKind {
388     /*
389      * Temp is dead at the end of the extended basic block (EBB),
390      * the single-entry multiple-exit region that falls through
391      * conditional branches.
392      */
393     TEMP_EBB,
394     /* Temp is live across the entire translation block, but dead at end. */
395     TEMP_TB,
396     /* Temp is live across the entire translation block, and between them. */
397     TEMP_GLOBAL,
398     /* Temp is in a fixed register. */
399     TEMP_FIXED,
400     /* Temp is a fixed constant. */
401     TEMP_CONST,
402 } TCGTempKind;
403 
404 typedef struct TCGTemp {
405     TCGReg reg:8;
406     TCGTempVal val_type:8;
407     TCGType base_type:8;
408     TCGType type:8;
409     TCGTempKind kind:3;
410     unsigned int indirect_reg:1;
411     unsigned int indirect_base:1;
412     unsigned int mem_coherent:1;
413     unsigned int mem_allocated:1;
414     unsigned int temp_allocated:1;
415     unsigned int temp_subindex:2;
416 
417     int64_t val;
418     struct TCGTemp *mem_base;
419     intptr_t mem_offset;
420     const char *name;
421 
422     /* Pass-specific information that can be stored for a temporary.
423        One word worth of integer data, and one pointer to data
424        allocated separately.  */
425     uintptr_t state;
426     void *state_ptr;
427 } TCGTemp;
428 
429 typedef struct TCGContext TCGContext;
430 
431 typedef struct TCGTempSet {
432     unsigned long l[BITS_TO_LONGS(TCG_MAX_TEMPS)];
433 } TCGTempSet;
434 
435 /*
436  * With 1 128-bit output, a 32-bit host requires 4 output parameters,
437  * which leaves a maximum of 28 other slots.  Which is enough for 7
438  * 128-bit operands.
439  */
440 #define DEAD_ARG  (1 << 4)
441 #define SYNC_ARG  (1 << 0)
442 typedef uint32_t TCGLifeData;
443 
444 struct TCGOp {
445     TCGOpcode opc   : 8;
446     unsigned nargs  : 8;
447 
448     /* Parameters for this opcode.  See below.  */
449     unsigned param1 : 8;
450     unsigned param2 : 8;
451 
452     /* Lifetime data of the operands.  */
453     TCGLifeData life;
454 
455     /* Next and previous opcodes.  */
456     QTAILQ_ENTRY(TCGOp) link;
457 
458     /* Register preferences for the output(s).  */
459     TCGRegSet output_pref[2];
460 
461     /* Arguments for the opcode.  */
462     TCGArg args[];
463 };
464 
465 #define TCGOP_CALLI(X)    (X)->param1
466 #define TCGOP_CALLO(X)    (X)->param2
467 
468 #define TCGOP_VECL(X)     (X)->param1
469 #define TCGOP_VECE(X)     (X)->param2
470 
471 /* Make sure operands fit in the bitfields above.  */
472 QEMU_BUILD_BUG_ON(NB_OPS > (1 << 8));
473 
474 static inline TCGRegSet output_pref(const TCGOp *op, unsigned i)
475 {
476     return i < ARRAY_SIZE(op->output_pref) ? op->output_pref[i] : 0;
477 }
478 
479 struct TCGContext {
480     uint8_t *pool_cur, *pool_end;
481     TCGPool *pool_first, *pool_current, *pool_first_large;
482     int nb_labels;
483     int nb_globals;
484     int nb_temps;
485     int nb_indirects;
486     int nb_ops;
487     TCGType addr_type;            /* TCG_TYPE_I32 or TCG_TYPE_I64 */
488 
489     int page_mask;
490     uint8_t page_bits;
491     uint8_t tlb_dyn_max_bits;
492     uint8_t insn_start_words;
493     TCGBar guest_mo;
494 
495     TCGRegSet reserved_regs;
496     intptr_t current_frame_offset;
497     intptr_t frame_start;
498     intptr_t frame_end;
499     TCGTemp *frame_temp;
500 
501     TranslationBlock *gen_tb;     /* tb for which code is being generated */
502     tcg_insn_unit *code_buf;      /* pointer for start of tb */
503     tcg_insn_unit *code_ptr;      /* pointer for running end of tb */
504 
505 #ifdef CONFIG_DEBUG_TCG
506     int goto_tb_issue_mask;
507     const TCGOpcode *vecop_list;
508 #endif
509 
510     /* Code generation.  Note that we specifically do not use tcg_insn_unit
511        here, because there's too much arithmetic throughout that relies
512        on addition and subtraction working on bytes.  Rely on the GCC
513        extension that allows arithmetic on void*.  */
514     void *code_gen_buffer;
515     size_t code_gen_buffer_size;
516     void *code_gen_ptr;
517     void *data_gen_ptr;
518 
519     /* Threshold to flush the translated code buffer.  */
520     void *code_gen_highwater;
521 
522     /* Track which vCPU triggers events */
523     CPUState *cpu;                      /* *_trans */
524 
525     /* These structures are private to tcg-target.c.inc.  */
526 #ifdef TCG_TARGET_NEED_LDST_LABELS
527     QSIMPLEQ_HEAD(, TCGLabelQemuLdst) ldst_labels;
528 #endif
529 #ifdef TCG_TARGET_NEED_POOL_LABELS
530     struct TCGLabelPoolData *pool_labels;
531 #endif
532 
533     TCGLabel *exitreq_label;
534 
535 #ifdef CONFIG_PLUGIN
536     /*
537      * We keep one plugin_tb struct per TCGContext. Note that on every TB
538      * translation we clear but do not free its contents; this way we
539      * avoid a lot of malloc/free churn, since after a few TB's it's
540      * unlikely that we'll need to allocate either more instructions or more
541      * space for instructions (for variable-instruction-length ISAs).
542      */
543     struct qemu_plugin_tb *plugin_tb;
544 
545     /* descriptor of the instruction being translated */
546     struct qemu_plugin_insn *plugin_insn;
547 #endif
548 
549     GHashTable *const_table[TCG_TYPE_COUNT];
550     TCGTempSet free_temps[TCG_TYPE_COUNT];
551     TCGTemp temps[TCG_MAX_TEMPS]; /* globals first, temps after */
552 
553     QTAILQ_HEAD(, TCGOp) ops, free_ops;
554     QSIMPLEQ_HEAD(, TCGLabel) labels;
555 
556     /*
557      * When clear, new ops are added to the tail of @ops.
558      * When set, new ops are added in front of @emit_before_op.
559      */
560     TCGOp *emit_before_op;
561 
562     /* Tells which temporary holds a given register.
563        It does not take into account fixed registers */
564     TCGTemp *reg_to_temp[TCG_TARGET_NB_REGS];
565 
566     uint16_t gen_insn_end_off[TCG_MAX_INSNS];
567     uint64_t *gen_insn_data;
568 
569     /* Exit to translator on overflow. */
570     sigjmp_buf jmp_trans;
571 };
572 
573 static inline bool temp_readonly(TCGTemp *ts)
574 {
575     return ts->kind >= TEMP_FIXED;
576 }
577 
578 #ifdef CONFIG_USER_ONLY
579 extern bool tcg_use_softmmu;
580 #else
581 #define tcg_use_softmmu  true
582 #endif
583 
584 extern __thread TCGContext *tcg_ctx;
585 extern const void *tcg_code_gen_epilogue;
586 extern uintptr_t tcg_splitwx_diff;
587 extern TCGv_env tcg_env;
588 
589 bool in_code_gen_buffer(const void *p);
590 
591 #ifdef CONFIG_DEBUG_TCG
592 const void *tcg_splitwx_to_rx(void *rw);
593 void *tcg_splitwx_to_rw(const void *rx);
594 #else
595 static inline const void *tcg_splitwx_to_rx(void *rw)
596 {
597     return rw ? rw + tcg_splitwx_diff : NULL;
598 }
599 
600 static inline void *tcg_splitwx_to_rw(const void *rx)
601 {
602     return rx ? (void *)rx - tcg_splitwx_diff : NULL;
603 }
604 #endif
605 
606 static inline TCGArg temp_arg(TCGTemp *ts)
607 {
608     return (uintptr_t)ts;
609 }
610 
611 static inline TCGTemp *arg_temp(TCGArg a)
612 {
613     return (TCGTemp *)(uintptr_t)a;
614 }
615 
616 #ifdef CONFIG_DEBUG_TCG
617 size_t temp_idx(TCGTemp *ts);
618 TCGTemp *tcgv_i32_temp(TCGv_i32 v);
619 #else
620 static inline size_t temp_idx(TCGTemp *ts)
621 {
622     return ts - tcg_ctx->temps;
623 }
624 
625 /*
626  * Using the offset of a temporary, relative to TCGContext, rather than
627  * its index means that we don't use 0.  That leaves offset 0 free for
628  * a NULL representation without having to leave index 0 unused.
629  */
630 static inline TCGTemp *tcgv_i32_temp(TCGv_i32 v)
631 {
632     return (void *)tcg_ctx + (uintptr_t)v;
633 }
634 #endif
635 
636 static inline TCGTemp *tcgv_i64_temp(TCGv_i64 v)
637 {
638     return tcgv_i32_temp((TCGv_i32)v);
639 }
640 
641 static inline TCGTemp *tcgv_i128_temp(TCGv_i128 v)
642 {
643     return tcgv_i32_temp((TCGv_i32)v);
644 }
645 
646 static inline TCGTemp *tcgv_ptr_temp(TCGv_ptr v)
647 {
648     return tcgv_i32_temp((TCGv_i32)v);
649 }
650 
651 static inline TCGTemp *tcgv_vec_temp(TCGv_vec v)
652 {
653     return tcgv_i32_temp((TCGv_i32)v);
654 }
655 
656 static inline TCGArg tcgv_i32_arg(TCGv_i32 v)
657 {
658     return temp_arg(tcgv_i32_temp(v));
659 }
660 
661 static inline TCGArg tcgv_i64_arg(TCGv_i64 v)
662 {
663     return temp_arg(tcgv_i64_temp(v));
664 }
665 
666 static inline TCGArg tcgv_i128_arg(TCGv_i128 v)
667 {
668     return temp_arg(tcgv_i128_temp(v));
669 }
670 
671 static inline TCGArg tcgv_ptr_arg(TCGv_ptr v)
672 {
673     return temp_arg(tcgv_ptr_temp(v));
674 }
675 
676 static inline TCGArg tcgv_vec_arg(TCGv_vec v)
677 {
678     return temp_arg(tcgv_vec_temp(v));
679 }
680 
681 static inline TCGv_i32 temp_tcgv_i32(TCGTemp *t)
682 {
683     (void)temp_idx(t); /* trigger embedded assert */
684     return (TCGv_i32)((void *)t - (void *)tcg_ctx);
685 }
686 
687 static inline TCGv_i64 temp_tcgv_i64(TCGTemp *t)
688 {
689     return (TCGv_i64)temp_tcgv_i32(t);
690 }
691 
692 static inline TCGv_i128 temp_tcgv_i128(TCGTemp *t)
693 {
694     return (TCGv_i128)temp_tcgv_i32(t);
695 }
696 
697 static inline TCGv_ptr temp_tcgv_ptr(TCGTemp *t)
698 {
699     return (TCGv_ptr)temp_tcgv_i32(t);
700 }
701 
702 static inline TCGv_vec temp_tcgv_vec(TCGTemp *t)
703 {
704     return (TCGv_vec)temp_tcgv_i32(t);
705 }
706 
707 static inline TCGArg tcg_get_insn_param(TCGOp *op, int arg)
708 {
709     return op->args[arg];
710 }
711 
712 static inline void tcg_set_insn_param(TCGOp *op, int arg, TCGArg v)
713 {
714     op->args[arg] = v;
715 }
716 
717 static inline uint64_t tcg_get_insn_start_param(TCGOp *op, int arg)
718 {
719     if (TCG_TARGET_REG_BITS == 64) {
720         return tcg_get_insn_param(op, arg);
721     } else {
722         return deposit64(tcg_get_insn_param(op, arg * 2), 32, 32,
723                          tcg_get_insn_param(op, arg * 2 + 1));
724     }
725 }
726 
727 static inline void tcg_set_insn_start_param(TCGOp *op, int arg, uint64_t v)
728 {
729     if (TCG_TARGET_REG_BITS == 64) {
730         tcg_set_insn_param(op, arg, v);
731     } else {
732         tcg_set_insn_param(op, arg * 2, v);
733         tcg_set_insn_param(op, arg * 2 + 1, v >> 32);
734     }
735 }
736 
737 /* The last op that was emitted.  */
738 static inline TCGOp *tcg_last_op(void)
739 {
740     return QTAILQ_LAST(&tcg_ctx->ops);
741 }
742 
743 /* Test for whether to terminate the TB for using too many opcodes.  */
744 static inline bool tcg_op_buf_full(void)
745 {
746     /* This is not a hard limit, it merely stops translation when
747      * we have produced "enough" opcodes.  We want to limit TB size
748      * such that a RISC host can reasonably use a 16-bit signed
749      * branch within the TB.  We also need to be mindful of the
750      * 16-bit unsigned offsets, TranslationBlock.jmp_reset_offset[]
751      * and TCGContext.gen_insn_end_off[].
752      */
753     return tcg_ctx->nb_ops >= 4000;
754 }
755 
756 /* pool based memory allocation */
757 
758 /* user-mode: mmap_lock must be held for tcg_malloc_internal. */
759 void *tcg_malloc_internal(TCGContext *s, int size);
760 void tcg_pool_reset(TCGContext *s);
761 TranslationBlock *tcg_tb_alloc(TCGContext *s);
762 
763 void tcg_region_reset_all(void);
764 
765 size_t tcg_code_size(void);
766 size_t tcg_code_capacity(void);
767 
768 void tcg_tb_insert(TranslationBlock *tb);
769 void tcg_tb_remove(TranslationBlock *tb);
770 TranslationBlock *tcg_tb_lookup(uintptr_t tc_ptr);
771 void tcg_tb_foreach(GTraverseFunc func, gpointer user_data);
772 size_t tcg_nb_tbs(void);
773 
774 /* user-mode: Called with mmap_lock held.  */
775 static inline void *tcg_malloc(int size)
776 {
777     TCGContext *s = tcg_ctx;
778     uint8_t *ptr, *ptr_end;
779 
780     /* ??? This is a weak placeholder for minimum malloc alignment.  */
781     size = QEMU_ALIGN_UP(size, 8);
782 
783     ptr = s->pool_cur;
784     ptr_end = ptr + size;
785     if (unlikely(ptr_end > s->pool_end)) {
786         return tcg_malloc_internal(tcg_ctx, size);
787     } else {
788         s->pool_cur = ptr_end;
789         return ptr;
790     }
791 }
792 
793 void tcg_func_start(TCGContext *s);
794 
795 int tcg_gen_code(TCGContext *s, TranslationBlock *tb, uint64_t pc_start);
796 
797 void tb_target_set_jmp_target(const TranslationBlock *, int,
798                               uintptr_t, uintptr_t);
799 
800 void tcg_set_frame(TCGContext *s, TCGReg reg, intptr_t start, intptr_t size);
801 
802 #define TCG_CT_CONST  1 /* any constant of register size */
803 
804 typedef struct TCGArgConstraint {
805     unsigned ct : 16;
806     unsigned alias_index : 4;
807     unsigned sort_index : 4;
808     unsigned pair_index : 4;
809     unsigned pair : 2;  /* 0: none, 1: first, 2: second, 3: second alias */
810     bool oalias : 1;
811     bool ialias : 1;
812     bool newreg : 1;
813     TCGRegSet regs;
814 } TCGArgConstraint;
815 
816 #define TCG_MAX_OP_ARGS 16
817 
818 /* Bits for TCGOpDef->flags, 8 bits available, all used.  */
819 enum {
820     /* Instruction exits the translation block.  */
821     TCG_OPF_BB_EXIT      = 0x01,
822     /* Instruction defines the end of a basic block.  */
823     TCG_OPF_BB_END       = 0x02,
824     /* Instruction clobbers call registers and potentially update globals.  */
825     TCG_OPF_CALL_CLOBBER = 0x04,
826     /* Instruction has side effects: it cannot be removed if its outputs
827        are not used, and might trigger exceptions.  */
828     TCG_OPF_SIDE_EFFECTS = 0x08,
829     /* Instruction operands are 64-bits (otherwise 32-bits).  */
830     TCG_OPF_64BIT        = 0x10,
831     /* Instruction is optional and not implemented by the host, or insn
832        is generic and should not be implemented by the host.  */
833     TCG_OPF_NOT_PRESENT  = 0x20,
834     /* Instruction operands are vectors.  */
835     TCG_OPF_VECTOR       = 0x40,
836     /* Instruction is a conditional branch. */
837     TCG_OPF_COND_BRANCH  = 0x80
838 };
839 
840 typedef struct TCGOpDef {
841     const char *name;
842     uint8_t nb_oargs, nb_iargs, nb_cargs, nb_args;
843     uint8_t flags;
844     TCGArgConstraint *args_ct;
845 } TCGOpDef;
846 
847 extern TCGOpDef tcg_op_defs[];
848 extern const size_t tcg_op_defs_max;
849 
850 typedef struct TCGTargetOpDef {
851     TCGOpcode op;
852     const char *args_ct_str[TCG_MAX_OP_ARGS];
853 } TCGTargetOpDef;
854 
855 bool tcg_op_supported(TCGOpcode op);
856 
857 void tcg_gen_call0(TCGHelperInfo *, TCGTemp *ret);
858 void tcg_gen_call1(TCGHelperInfo *, TCGTemp *ret, TCGTemp *);
859 void tcg_gen_call2(TCGHelperInfo *, TCGTemp *ret, TCGTemp *, TCGTemp *);
860 void tcg_gen_call3(TCGHelperInfo *, TCGTemp *ret, TCGTemp *,
861                    TCGTemp *, TCGTemp *);
862 void tcg_gen_call4(TCGHelperInfo *, TCGTemp *ret, TCGTemp *, TCGTemp *,
863                    TCGTemp *, TCGTemp *);
864 void tcg_gen_call5(TCGHelperInfo *, TCGTemp *ret, TCGTemp *, TCGTemp *,
865                    TCGTemp *, TCGTemp *, TCGTemp *);
866 void tcg_gen_call6(TCGHelperInfo *, TCGTemp *ret, TCGTemp *, TCGTemp *,
867                    TCGTemp *, TCGTemp *, TCGTemp *, TCGTemp *);
868 void tcg_gen_call7(TCGHelperInfo *, TCGTemp *ret, TCGTemp *, TCGTemp *,
869                    TCGTemp *, TCGTemp *, TCGTemp *, TCGTemp *, TCGTemp *);
870 
871 TCGOp *tcg_emit_op(TCGOpcode opc, unsigned nargs);
872 void tcg_op_remove(TCGContext *s, TCGOp *op);
873 TCGOp *tcg_op_insert_before(TCGContext *s, TCGOp *op,
874                             TCGOpcode opc, unsigned nargs);
875 TCGOp *tcg_op_insert_after(TCGContext *s, TCGOp *op,
876                            TCGOpcode opc, unsigned nargs);
877 
878 /**
879  * tcg_remove_ops_after:
880  * @op: target operation
881  *
882  * Discard any opcodes emitted since @op.  Expected usage is to save
883  * a starting point with tcg_last_op(), speculatively emit opcodes,
884  * then decide whether or not to keep those opcodes after the fact.
885  */
886 void tcg_remove_ops_after(TCGOp *op);
887 
888 void tcg_optimize(TCGContext *s);
889 
890 TCGLabel *gen_new_label(void);
891 
892 /**
893  * label_arg
894  * @l: label
895  *
896  * Encode a label for storage in the TCG opcode stream.
897  */
898 
899 static inline TCGArg label_arg(TCGLabel *l)
900 {
901     return (uintptr_t)l;
902 }
903 
904 /**
905  * arg_label
906  * @i: value
907  *
908  * The opposite of label_arg.  Retrieve a label from the
909  * encoding of the TCG opcode stream.
910  */
911 
912 static inline TCGLabel *arg_label(TCGArg i)
913 {
914     return (TCGLabel *)(uintptr_t)i;
915 }
916 
917 /**
918  * tcg_ptr_byte_diff
919  * @a, @b: addresses to be differenced
920  *
921  * There are many places within the TCG backends where we need a byte
922  * difference between two pointers.  While this can be accomplished
923  * with local casting, it's easy to get wrong -- especially if one is
924  * concerned with the signedness of the result.
925  *
926  * This version relies on GCC's void pointer arithmetic to get the
927  * correct result.
928  */
929 
930 static inline ptrdiff_t tcg_ptr_byte_diff(const void *a, const void *b)
931 {
932     return a - b;
933 }
934 
935 /**
936  * tcg_pcrel_diff
937  * @s: the tcg context
938  * @target: address of the target
939  *
940  * Produce a pc-relative difference, from the current code_ptr
941  * to the destination address.
942  */
943 
944 static inline ptrdiff_t tcg_pcrel_diff(TCGContext *s, const void *target)
945 {
946     return tcg_ptr_byte_diff(target, tcg_splitwx_to_rx(s->code_ptr));
947 }
948 
949 /**
950  * tcg_tbrel_diff
951  * @s: the tcg context
952  * @target: address of the target
953  *
954  * Produce a difference, from the beginning of the current TB code
955  * to the destination address.
956  */
957 static inline ptrdiff_t tcg_tbrel_diff(TCGContext *s, const void *target)
958 {
959     return tcg_ptr_byte_diff(target, tcg_splitwx_to_rx(s->code_buf));
960 }
961 
962 /**
963  * tcg_current_code_size
964  * @s: the tcg context
965  *
966  * Compute the current code size within the translation block.
967  * This is used to fill in qemu's data structures for goto_tb.
968  */
969 
970 static inline size_t tcg_current_code_size(TCGContext *s)
971 {
972     return tcg_ptr_byte_diff(s->code_ptr, s->code_buf);
973 }
974 
975 /**
976  * tcg_qemu_tb_exec:
977  * @env: pointer to CPUArchState for the CPU
978  * @tb_ptr: address of generated code for the TB to execute
979  *
980  * Start executing code from a given translation block.
981  * Where translation blocks have been linked, execution
982  * may proceed from the given TB into successive ones.
983  * Control eventually returns only when some action is needed
984  * from the top-level loop: either control must pass to a TB
985  * which has not yet been directly linked, or an asynchronous
986  * event such as an interrupt needs handling.
987  *
988  * Return: The return value is the value passed to the corresponding
989  * tcg_gen_exit_tb() at translation time of the last TB attempted to execute.
990  * The value is either zero or a 4-byte aligned pointer to that TB combined
991  * with additional information in its two least significant bits. The
992  * additional information is encoded as follows:
993  *  0, 1: the link between this TB and the next is via the specified
994  *        TB index (0 or 1). That is, we left the TB via (the equivalent
995  *        of) "goto_tb <index>". The main loop uses this to determine
996  *        how to link the TB just executed to the next.
997  *  2:    we are using instruction counting code generation, and we
998  *        did not start executing this TB because the instruction counter
999  *        would hit zero midway through it. In this case the pointer
1000  *        returned is the TB we were about to execute, and the caller must
1001  *        arrange to execute the remaining count of instructions.
1002  *  3:    we stopped because the CPU's exit_request flag was set
1003  *        (usually meaning that there is an interrupt that needs to be
1004  *        handled). The pointer returned is the TB we were about to execute
1005  *        when we noticed the pending exit request.
1006  *
1007  * If the bottom two bits indicate an exit-via-index then the CPU
1008  * state is correctly synchronised and ready for execution of the next
1009  * TB (and in particular the guest PC is the address to execute next).
1010  * Otherwise, we gave up on execution of this TB before it started, and
1011  * the caller must fix up the CPU state by calling the CPU's
1012  * synchronize_from_tb() method with the TB pointer we return (falling
1013  * back to calling the CPU's set_pc method with tb->pb if no
1014  * synchronize_from_tb() method exists).
1015  *
1016  * Note that TCG targets may use a different definition of tcg_qemu_tb_exec
1017  * to this default (which just calls the prologue.code emitted by
1018  * tcg_target_qemu_prologue()).
1019  */
1020 #define TB_EXIT_MASK      3
1021 #define TB_EXIT_IDX0      0
1022 #define TB_EXIT_IDX1      1
1023 #define TB_EXIT_IDXMAX    1
1024 #define TB_EXIT_REQUESTED 3
1025 
1026 #ifdef CONFIG_TCG_INTERPRETER
1027 uintptr_t tcg_qemu_tb_exec(CPUArchState *env, const void *tb_ptr);
1028 #else
1029 typedef uintptr_t tcg_prologue_fn(CPUArchState *env, const void *tb_ptr);
1030 extern tcg_prologue_fn *tcg_qemu_tb_exec;
1031 #endif
1032 
1033 void tcg_register_jit(const void *buf, size_t buf_size);
1034 
1035 #if TCG_TARGET_MAYBE_vec
1036 /* Return zero if the tuple (opc, type, vece) is unsupportable;
1037    return > 0 if it is directly supportable;
1038    return < 0 if we must call tcg_expand_vec_op.  */
1039 int tcg_can_emit_vec_op(TCGOpcode, TCGType, unsigned);
1040 #else
1041 static inline int tcg_can_emit_vec_op(TCGOpcode o, TCGType t, unsigned ve)
1042 {
1043     return 0;
1044 }
1045 #endif
1046 
1047 /* Expand the tuple (opc, type, vece) on the given arguments.  */
1048 void tcg_expand_vec_op(TCGOpcode, TCGType, unsigned, TCGArg, ...);
1049 
1050 /* Replicate a constant C according to the log2 of the element size.  */
1051 uint64_t dup_const(unsigned vece, uint64_t c);
1052 
1053 #define dup_const(VECE, C)                                         \
1054     (__builtin_constant_p(VECE)                                    \
1055      ? (  (VECE) == MO_8  ? 0x0101010101010101ull * (uint8_t)(C)   \
1056         : (VECE) == MO_16 ? 0x0001000100010001ull * (uint16_t)(C)  \
1057         : (VECE) == MO_32 ? 0x0000000100000001ull * (uint32_t)(C)  \
1058         : (VECE) == MO_64 ? (uint64_t)(C)                          \
1059         : (qemu_build_not_reached_always(), 0))                    \
1060      : dup_const(VECE, C))
1061 
1062 static inline const TCGOpcode *tcg_swap_vecop_list(const TCGOpcode *n)
1063 {
1064 #ifdef CONFIG_DEBUG_TCG
1065     const TCGOpcode *o = tcg_ctx->vecop_list;
1066     tcg_ctx->vecop_list = n;
1067     return o;
1068 #else
1069     return NULL;
1070 #endif
1071 }
1072 
1073 bool tcg_can_emit_vecop_list(const TCGOpcode *, TCGType, unsigned);
1074 
1075 #endif /* TCG_H */
1076