Search
lxdream.org :: lxdream/src/sh4/xltcache.h
lxdream 0.9.1
released Jun 29
Download Now
filename src/sh4/xltcache.h
changeset 410:5f8413358e7f
prev407:d24ab36150c4
next422:61a0598e07ff
author nkeynes
date Sat Sep 29 11:06:40 2007 +0000 (16 years ago)
permissions -rw-r--r--
last change Change extend-block to take a requested size
Terminate blocks on page boundaries for easier invalidation
view annotate diff log raw
     1 /**
     2  * $Id: xltcache.h,v 1.6 2007-09-29 11:06:40 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  * Returns the next block in the new cache list that can be written to by the
    31  * translator.
    32  */
    33 xlat_cache_block_t xlat_start_block(sh4addr_t address);
    35 /**
    36  * Increases the current block size (only valid between calls to xlat_start_block()
    37  * and xlat_commit_block()). 
    38  * @return the new block, which may be different from the old block.
    39  */
    40 xlat_cache_block_t xlat_extend_block( uint32_t newSize );
    42 /**
    43  * Commit the current translation block
    44  * @param addr target address (for the lookup table)
    45  * @param destsize final size of the translation in bytes.
    46  * @param srcsize size of the original data that was translated in bytes
    47  */
    48 void xlat_commit_block( uint32_t destsize, uint32_t srcsize );
    50 /**
    51  * Dump the disassembly of the specified code block to a stream
    52  * (primarily for debugging purposes)
    53  * @param out The stream to write the output to
    54  * @param code a translated block
    55  */
    56 void xlat_disasm_block( FILE *out, void *code );
    59 /**
    60  * Delete (deactivate) the specified block from the cache. Caller is responsible
    61  * for ensuring that there really is a block there.
    62  */
    63 void xlat_delete_block( xlat_cache_block_t block );
    65 /**
    66  * Retrieve the entry point for the translated code corresponding to the given
    67  * SH4 address, or NULL if there is no code for that address.
    68  */
    69 void *xlat_get_code( sh4addr_t address );
    71 /**
    72  * Retrieve the address of the lookup table entry corresponding to the
    73  * given SH4 address.
    74  */
    75 void **xlat_get_lut_entry( sh4addr_t address );
    77 /**
    78  * Retrieve the size of the code block starting at the specified pointer. If the
    79  * pointer is not a valid code block, the return value is undefined.
    80  */
    81 uint32_t xlat_get_block_size( void *ptr );
    83 /**
    84  * Flush the code cache for the page containing the given address
    85  */
    86 void xlat_flush_page( sh4addr_t address );
    88 void xlat_invalidate_word( sh4addr_t address );
    89 void xlat_invalidate_long( sh4addr_t address );
    92 /**
    93  * Invalidate the code cache for a memory region
    94  */
    95 void xlat_invalidate_block( sh4addr_t address, size_t bytes );
    97 /**
    98  * Flush the entire code cache. This isn't as cheap as one might like
    99  */
   100 void xlat_flush_cache();
   102 /**
   103  * Check the internal integrity of the cache
   104  */
   105 void xlat_check_integrity();
.