lxdream.org :: lxdream/src/sh4/xltcache.h r422:61a0598e07ff

tree revision 500:848e66eee418

view

     1 /**

     2  * $Id: xltcache.h,v 1.7 2007-10-06 09:03:24 nkeynes Exp $

     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 typedef struct xlat_cache_block {

    23     int active;  /* 0 = deleted, 1 = normal. 2 = accessed (temp-space only) */

    24     uint32_t size;

    25     void **lut_entry; /* For deletion */

    26     unsigned char code[0];

    27 } *xlat_cache_block_t;

    29 /**

    30  * Initialize the translation cache

    31  */

    32 void xlat_cache_init(void);

    34 /**

    35  * Returns the next block in the new cache list that can be written to by the

    36  * translator.

    37  */

    38 xlat_cache_block_t xlat_start_block(sh4addr_t address);

    40 /**

    41  * Increases the current block size (only valid between calls to xlat_start_block()

    42  * and xlat_commit_block()).

    43  * @return the new block, which may be different from the old block.

    44  */

    45 xlat_cache_block_t xlat_extend_block( uint32_t newSize );

    47 /**

    48  * Commit the current translation block

    49  * @param addr target address (for the lookup table)

    50  * @param destsize final size of the translation in bytes.

    51  * @param srcsize size of the original data that was translated in bytes

    52  */

    53 void xlat_commit_block( uint32_t destsize, uint32_t srcsize );

    55 /**

    56  * Dump the disassembly of the specified code block to a stream

    57  * (primarily for debugging purposes)

    58  * @param out The stream to write the output to

    59  * @param code a translated block

    60  */

    61 void xlat_disasm_block( FILE *out, void *code );

    64 /**

    65  * Delete (deactivate) the specified block from the cache. Caller is responsible

    66  * for ensuring that there really is a block there.

    67  */

    68 void xlat_delete_block( xlat_cache_block_t block );

    70 /**

    71  * Retrieve the entry point for the translated code corresponding to the given

    72  * SH4 address, or NULL if there is no code for that address.

    73  */

    74 void *xlat_get_code( sh4addr_t address );

    76 /**

    77  * Retrieve the address of the lookup table entry corresponding to the

    78  * given SH4 address.

    79  */

    80 void **xlat_get_lut_entry( sh4addr_t address );

    82 /**

    83  * Retrieve the size of the code block starting at the specified pointer. If the

    84  * pointer is not a valid code block, the return value is undefined.

    85  */

    86 uint32_t xlat_get_block_size( void *ptr );

    88 /**

    89  * Flush the code cache for the page containing the given address

    90  */

    91 void xlat_flush_page( sh4addr_t address );

    93 void xlat_invalidate_word( sh4addr_t address );

    94 void xlat_invalidate_long( sh4addr_t address );

    97 /**

    98  * Invalidate the code cache for a memory region

    99  */

   100 void xlat_invalidate_block( sh4addr_t address, size_t bytes );

   102 /**

   103  * Flush the entire code cache. This isn't as cheap as one might like

   104  */

   105 void xlat_flush_cache();

   107 /**

   108  * Check the internal integrity of the cache

   109  */

   110 void xlat_check_integrity();