lxdream 0.9.1| filename | src/sh4/xltcache.h |
| changeset | 901:32c5cf5e206f |
| prev | 809:8bdbf4d95da4 |
| next | 905:4c17ebd9ef5e |
| author | nkeynes |
| date | Sun Oct 26 02:28:29 2008 +0000 (15 years ago) |
| permissions | -rw-r--r-- |
| last change | Move the precision/size tests to translation-time rather than execution-time, and flush/retranslate on a mismatch. Shaves a few percent off the core runtime |
| view | annotate | diff | log | raw |
1 /**
2 * $Id$
3 *
4 * Translation cache support (architecture independent)
5 *
6 * Copyright (c) 2005 Nathan Keynes.
7 *
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
12 *
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
17 */
19 #include "dream.h"
20 #include "mem.h"
22 #ifndef lxdream_xltcache_H
23 #define lxdream_xltcache_H 1
25 /**
26 * For now, recovery is purely a matter of mapping native pc => sh4 pc,
27 * and updating sh4r.pc & sh4r.slice_cycles accordingly. In future more
28 * detailed recovery may be required if the translator optimizes more
29 * agressively.
30 *
31 * The recovery table contains (at least) one entry per abortable instruction,
32 *
33 */
34 typedef struct xlat_recovery_record {
35 uint32_t xlat_offset; // native (translated) pc
36 uint32_t sh4_icount; // instruction number of the corresponding SH4 instruction
37 // (0 = first instruction, 1 = second instruction, ... )
38 } *xlat_recovery_record_t;
40 struct xlat_cache_block {
41 int active; /* 0 = deleted, 1 = normal. 2 = accessed (temp-space only) */
42 uint32_t size;
43 void **lut_entry; /* For deletion */
44 uint32_t fpscr_mask, fpscr; /* fpscr condition check */
45 uint32_t recover_table_offset; // Offset from code[0] of the recovery table;
46 uint32_t recover_table_size;
47 unsigned char code[0];
48 } __attribute__((packed));
50 typedef struct xlat_cache_block *xlat_cache_block_t;
52 #define XLAT_BLOCK_FOR_CODE(code) (((xlat_cache_block_t)code)-1)
54 #define XLAT_BLOCK_FPSCR_MASK(code) (XLAT_BLOCK_FOR_CODE(code)->fpscr_mask)
55 #define XLAT_BLOCK_FPSCR(code) (XLAT_BLOCK_FOR_CODE(code)->fpscr_mask)
57 /**
58 * Initialize the translation cache
59 */
60 void xlat_cache_init(void);
62 /**
63 * Returns the next block in the new cache list that can be written to by the
64 * translator.
65 */
66 xlat_cache_block_t xlat_start_block(sh4addr_t address);
68 /**
69 * Increases the current block size (only valid between calls to xlat_start_block()
70 * and xlat_commit_block()).
71 * @return the new block, which may be different from the old block.
72 */
73 xlat_cache_block_t xlat_extend_block( uint32_t newSize );
75 /**
76 * Commit the current translation block
77 * @param addr target address (for the lookup table)
78 * @param destsize final size of the translation in bytes.
79 * @param srcsize size of the original data that was translated in bytes
80 */
81 void xlat_commit_block( uint32_t destsize, uint32_t srcsize );
83 /**
84 * Dump the disassembly of the specified code block to a stream
85 * (primarily for debugging purposes)
86 * @param out The stream to write the output to
87 * @param code a translated block
88 */
89 void xlat_disasm_block( FILE *out, void *code );
92 /**
93 * Delete (deactivate) the specified block from the cache. Caller is responsible
94 * for ensuring that there really is a block there.
95 */
96 void xlat_delete_block( xlat_cache_block_t block );
98 /**
99 * Retrieve the entry point for the translated code corresponding to the given
100 * SH4 address, or NULL if there is no code for that address.
101 */
102 void *xlat_get_code( sh4addr_t address );
104 /**
105 * Retrieve the post-instruction recovery record corresponding to the given
106 * native address, or NULL if there is no recovery code for the address.
107 * @param code The code block containing the recovery table.
108 * @param native_pc A pointer that must be within the currently executing
109 * @param with_terminal If false, return NULL instead of the final block record.
110 * return the first record before or equal to the given pc.
111 * translation block.
112 */
113 struct xlat_recovery_record *xlat_get_post_recovery( void *code, void *native_pc, gboolean with_terminal );
115 /**
116 * Retrieve the pre-instruction recovery record corresponding to the given
117 * native address, or NULL if there is no recovery code for the address.
118 * @param code The code block containing the recovery table.
119 * @param native_pc A pointer that must be within the currently executing
120 * @param with_terminal If false, return NULL instead of the final block record.
121 * return the first record before or equal to the given pc.
122 * translation block.
123 */
124 struct xlat_recovery_record *xlat_get_pre_recovery( void *code, void *native_pc );
127 /**
128 * Retrieve the entry point for the translated code corresponding to the given
129 * SH4 virtual address, or NULL if there is no code for the address.
130 * If the virtual address cannot be resolved, this method will raise a TLB miss
131 * exception, and return NULL.
132 */
133 void *xlat_get_code_by_vma( sh4vma_t address );
135 /**
136 * Retrieve the address of the lookup table entry corresponding to the
137 * given SH4 address.
138 */
139 void **xlat_get_lut_entry( sh4addr_t address );
141 /**
142 * Retrieve the current host address of the running translated code block.
143 * @return the host PC, or null if there is no currently executing translated
144 * block (or the stack is corrupted)
145 * Note: this method is implemented in host-specific asm.
146 */
147 void *xlat_get_native_pc();
149 /**
150 * Retrieve the size of the block starting at the specified pointer. If the
151 * pointer is not a valid code block, the return value is undefined.
152 */
153 uint32_t xlat_get_block_size( void *ptr );
155 /**
156 * Retrieve the size of the code in the block starting at the specified
157 * pointer. Effectively this is xlat_get_block_size() minus the size of
158 * the recovery table. If the pointer is not a valid code block, the
159 * return value is undefined.
160 */
161 uint32_t xlat_get_code_size( void *ptr );
163 /**
164 * Flush the code cache for the page containing the given address
165 */
166 void xlat_flush_page( sh4addr_t address );
168 void xlat_invalidate_word( sh4addr_t address );
169 void xlat_invalidate_long( sh4addr_t address );
172 /**
173 * Invalidate the code cache for a memory region
174 */
175 void xlat_invalidate_block( sh4addr_t address, size_t bytes );
177 /**
178 * Flush the entire code cache. This isn't as cheap as one might like
179 */
180 void xlat_flush_cache();
182 /**
183 * Check the internal integrity of the cache
184 */
185 void xlat_check_integrity();
187 #endif /* lxdream_xltcache_H */
.