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