include/exec/translator.h

4  * Copyright (C) 2016-2017 Lluís Vilanova <vilanova@ac.upc.edu>
7  * See the COPYING file in the top-level directory.
14  * Include this header from a target-specific file, and add a
18  * member in your target-specific DisasContext.
27  * @tb: translation block
29  * @pc: guest virtual program counter address
30  * @host_pc: host physical program counter address
33  * the target-specific DisasContext, and then invoke translator_loop.
43  * @DISAS_TARGET_*: Start of target-specific conditions.
67  * @tb: Translation block for this disassembly.
68  * @pc_first: Address of first guest instruction in this TB.
69  * @pc_next: Address of next guest instruction in this TB (current during
79  * Architecture-agnostic disassembly context.
109  *      Initialize the target-specific portions of DisasContext struct.
120  *      Disassemble one instruction and set db->pc_next for the start
121  *      of the following instruction.  Set db->is_jmp as necessary to
125  *      Emit any opcodes required to exit the TB, based on db->is_jmp.
142  * @tb: Translation block.
144  * @pc: guest virtual program counter address
145  * @host_pc: host physical program counter address
146  * @ops: Target-specific operations.
151  * Translation will stop in the following cases (in order):
152  * - When is_jmp set by #TranslatorOps::breakpoint_check.
153  *   - set to DISAS_TOO_MANY exits after translating one more insn
154  *   - set to any other value than DISAS_NEXT exits immediately.
155  * - When is_jmp set by #TranslatorOps::translate_insn.
156  *   - set to any value other than DISAS_NEXT exits immediately.
157  * - When the TCG operation buffer is full.
158  * - When single-stepping is enabled (system-wide or on the current vCPU).
159  * - When too many instructions have been translated.
179  * If icount is enabled, set cpu->can_do_io, adjust db->is_jmp to
189  * functions and are mandatory for front-ends that have been migrated
191  * to be called from the translation stage and should not be called
193  * the relevant information at translation time.
235  * translator_fake_ld - fake instruction load
242  * re-synthesised for s390x "ex"). It ensures we update other areas of
250  * @dest: address to copy into
251  * @addr: virtual address within TB
255  * All bytes must have been read during translation.
266  * current translation block with translator_st.
273  * Translators can use this to enforce the rule that only single-insn
274  * translation blocks are allowed to cross page boundaries.
278     return ((addr ^ db->pc_first) & TARGET_PAGE_MASK) == 0;  in is_same_page()