home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-dist / gdb-4.16-base.tgz / gdb-4.16-base.tar / fsf / gdb / sim / ppc / std-config.h < prev    next >
Encoding:
C/C++ Source or Header  |  1995-12-19  |  16.8 KB  |  601 lines
  1. /*  This file is part of the program psim.
  2.  
  3.     Copyright (C) 1994-1995, Andrew Cagney <cagney@highland.com.au>
  4.  
  5.     This program is free software; you can redistribute it and/or modify
  6.     it under the terms of the GNU General Public License as published by
  7.     the Free Software Foundation; either version 2 of the License, or
  8.     (at your option) any later version.
  9.  
  10.     This program is distributed in the hope that it will be useful,
  11.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  12.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13.     GNU General Public License for more details.
  14.  
  15.     You should have received a copy of the GNU General Public License
  16.     along with this program; if not, write to the Free Software
  17.     Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  18.  
  19.     */
  20.  
  21.  
  22. #ifndef _PSIM_CONFIG_H_
  23. #define _PSIM_CONFIG_H_
  24.  
  25.  
  26. /* endianness of the host/target:
  27.  
  28.    If the build process is aware (at compile time) of the endianness
  29.    of the host/target it is able to eliminate slower generic endian
  30.    handling code.
  31.  
  32.    Possible values are 0 (unknown), LITTLE_ENDIAN, BIG_ENDIAN */
  33.  
  34. #ifndef WITH_HOST_BYTE_ORDER
  35. #define WITH_HOST_BYTE_ORDER        0 /*unknown*/
  36. #endif
  37.  
  38. #ifndef WITH_TARGET_BYTE_ORDER
  39. #define WITH_TARGET_BYTE_ORDER        0 /*unknown*/
  40. #endif
  41.  
  42. extern int current_host_byte_order;
  43. #define CURRENT_HOST_BYTE_ORDER (WITH_HOST_BYTE_ORDER \
  44.                  ? WITH_HOST_BYTE_ORDER \
  45.                  : current_host_byte_order)
  46. extern int current_target_byte_order;
  47. #define CURRENT_TARGET_BYTE_ORDER (WITH_TARGET_BYTE_ORDER \
  48.                    ? WITH_TARGET_BYTE_ORDER \
  49.                    : current_target_byte_order)
  50.  
  51.  
  52. /* PowerPC XOR endian.
  53.  
  54.    In addition to the above, the simulator can support the PowerPC's
  55.    horrible XOR endian mode.  This feature makes it possible to
  56.    control the endian mode of a processor using the MSR. */
  57.  
  58. #ifndef WITH_XOR_ENDIAN
  59. #define WITH_XOR_ENDIAN        8
  60. #endif
  61.  
  62.  
  63. /* Intel host BSWAP support:
  64.  
  65.    Whether to use bswap on the 486 and pentiums rather than the 386
  66.    sequence that uses xchgb/rorl/xchgb */
  67. #ifndef WITH_BSWAP
  68. #define    WITH_BSWAP 0
  69. #endif
  70.  
  71.  
  72. /* SMP support:
  73.  
  74.    Sets a limit on the number of processors that can be simulated.  If
  75.    WITH_SMP is set to zero (0), the simulator is restricted to
  76.    suporting only on processor (and as a consequence leaves the SMP
  77.    code out of the build process).
  78.  
  79.    The actual number of processors is taken from the device
  80.    /options/smp@<nr-cpu> */
  81.  
  82. #ifndef WITH_SMP
  83. #define WITH_SMP                        5
  84. #endif
  85. #if WITH_SMP
  86. #define MAX_NR_PROCESSORS        WITH_SMP
  87. #else
  88. #define MAX_NR_PROCESSORS        1
  89. #endif
  90.  
  91.  
  92. /* Word size of host/target:
  93.  
  94.    Set these according to your host and target requirements.  At this
  95.    point in time, I've only compiled (not run) for a 64bit and never
  96.    built for a 64bit host.  This will always remain a compile time
  97.    option */
  98.  
  99. #ifndef WITH_TARGET_WORD_BITSIZE
  100. #define WITH_TARGET_WORD_BITSIZE        32 /* compiled only */
  101. #endif
  102.  
  103. #ifndef WITH_HOST_WORD_BITSIZE
  104. #define WITH_HOST_WORD_BITSIZE        32 /* 64bit ready? */
  105. #endif
  106.  
  107.  
  108. /* Program environment:
  109.  
  110.    Three environments are available - UEA (user), VEA (virtual) and
  111.    OEA (perating).  The former two are environment that users would
  112.    expect to see (VEA includes things like coherency and the time
  113.    base) while OEA is what an operating system expects to see.  By
  114.    setting these to specific values, the build process is able to
  115.    eliminate non relevent environment code
  116.  
  117.    CURRENT_ENVIRONMENT specifies which of vea or oea is required for
  118.    the current runtime. */
  119.  
  120. #define USER_ENVIRONMENT        1
  121. #define VIRTUAL_ENVIRONMENT        2
  122. #define OPERATING_ENVIRONMENT        3
  123.  
  124. #ifndef WITH_ENVIRONMENT
  125. #define WITH_ENVIRONMENT        0
  126. #endif
  127.  
  128. extern int current_environment;
  129. #define CURRENT_ENVIRONMENT (WITH_ENVIRONMENT \
  130.                  ? WITH_ENVIRONMENT \
  131.                  : current_environment)
  132.  
  133.  
  134. /* Optional VEA/OEA code: 
  135.  
  136.    The below, required for the OEA model may also be included in the
  137.    VEA model however, as far as I can tell only make things
  138.    slower... */
  139.  
  140.  
  141. /* Events.  Devices modeling real H/W need to be able to efficiently
  142.    schedule things to do at known times in the future.  The event
  143.    queue implements this.  Unfortunatly this adds the need to check
  144.    for any events once each full instruction cycle. */
  145.  
  146. #define WITH_EVENTS                     (WITH_ENVIRONMENT != USER_ENVIRONMENT)
  147.  
  148.  
  149. /* Time base:
  150.  
  151.    The PowerPC architecture includes the addition of both a time base
  152.    register and a decrement timer.  Like events adds to the overhead
  153.    of of some instruction cycles. */
  154.  
  155. #ifndef WITH_TIME_BASE
  156. #define WITH_TIME_BASE            (WITH_ENVIRONMENT != USER_ENVIRONMENT)
  157. #endif
  158.  
  159.  
  160. /* Callback/Default Memory.
  161.  
  162.    Core includes a builtin memory type (raw_memory) that is
  163.    implemented using an array.  raw_memory does not require any
  164.    additional functions etc.
  165.  
  166.    Callback memory is where the core calls a core device for the data
  167.    it requires.
  168.  
  169.    Default memory is an extenstion of this where for addresses that do
  170.    not map into either a callback or core memory range a default map
  171.    can be used.
  172.  
  173.    The OEA model uses callback memory for devices and default memory
  174.    for buses.
  175.  
  176.    The VEA model uses callback memory to capture `page faults'.
  177.  
  178.    While it may be possible to eliminate callback/default memory (and
  179.    hence also eliminate an additional test per memory fetch) it
  180.    probably is not worth the effort.
  181.  
  182.    BTW, while raw_memory could have been implemented as a callback,
  183.    profiling has shown that there is a biger win (at least for the
  184.    x86) in eliminating a function call for the most common
  185.    (raw_memory) case. */
  186.  
  187. #define WITH_CALLBACK_MEMORY        1
  188.  
  189.  
  190. /* Alignment:
  191.  
  192.    The PowerPC may or may not handle miss aligned transfers.  An
  193.    implementation normally handles miss aligned transfers in big
  194.    endian mode but generates an exception in little endian mode.
  195.  
  196.    This model.  Instead allows both little and big endian modes to
  197.    either take exceptions or handle miss aligned transfers.
  198.  
  199.    If 0 is specified then for big-endian mode miss alligned accesses
  200.    are permitted (NONSTRICT_ALIGNMENT) while in little-endian mode the
  201.    processor will fault on them (STRICT_ALIGNMENT). */
  202.  
  203. #define NONSTRICT_ALIGNMENT            1
  204. #define STRICT_ALIGNMENT               2
  205.  
  206. #ifndef WITH_ALIGNMENT
  207. #define WITH_ALIGNMENT             0
  208. #endif
  209.  
  210. extern int current_alignment;
  211. #define CURRENT_ALIGNMENT (WITH_ALIGNMENT \
  212.                ? WITH_ALIGNMENT \
  213.                : current_alignment)
  214.  
  215.  
  216. /* Floating point suport:
  217.  
  218.    Still under development. */
  219.  
  220. #define SOFT_FLOATING_POINT        1
  221. #define HARD_FLOATING_POINT        2
  222.  
  223. #ifndef WITH_FLOATING_POINT
  224. #define WITH_FLOATING_POINT        HARD_FLOATING_POINT
  225. #endif
  226. extern int current_floating_point;
  227. #define CURRENT_FLOATING_POINT (WITH_FLOATING_POINT \
  228.                 ? WITH_FLOATING_POINT \
  229.                 : current_floating_point)
  230.  
  231.  
  232. /* Debugging:
  233.  
  234.    Control the inclusion of debugging code. */
  235.  
  236. /* Include the tracing code.  Disabling this eliminates all tracing
  237.    code */
  238.  
  239. #ifndef WITH_TRACE
  240. #define WITH_TRACE                      1
  241. #endif
  242.  
  243. /* include code that checks assertions scattered through out the
  244.    program */
  245.  
  246. #ifndef WITH_ASSERT
  247. #define WITH_ASSERT            1
  248. #endif
  249.  
  250. /* Whether to check instructions for reserved bits being set */
  251.  
  252. #ifndef WITH_RESERVED_BITS
  253. #define WITH_RESERVED_BITS        1
  254. #endif
  255.  
  256. /* include monitoring code */
  257.  
  258. #define MONITOR_INSTRUCTION_ISSUE    1
  259. #define MONITOR_LOAD_STORE_UNIT        2
  260. #ifndef WITH_MON
  261. #define WITH_MON            (MONITOR_LOAD_STORE_UNIT \
  262.                      | MONITOR_INSTRUCTION_ISSUE)
  263. #endif
  264.  
  265. /* Current CPU model (models are in the generated models.h include file)  */
  266. #ifndef WITH_MODEL
  267. #define WITH_MODEL            0
  268. #endif
  269.  
  270. #define CURRENT_MODEL (WITH_MODEL    \
  271.                ? WITH_MODEL    \
  272.                : current_model)
  273.  
  274. #ifndef WITH_DEFAULT_MODEL
  275. #define WITH_DEFAULT_MODEL        DEFAULT_MODEL
  276. #endif
  277.  
  278. #define MODEL_ISSUE_IGNORE        (-1)
  279. #define MODEL_ISSUE_PROCESS        1
  280.  
  281. #ifndef WITH_MODEL_ISSUE
  282. #define WITH_MODEL_ISSUE        0
  283. #endif
  284.  
  285. extern int current_model_issue;
  286. #define CURRENT_MODEL_ISSUE (WITH_MODEL_ISSUE    \
  287.                  ? WITH_MODEL_ISSUE    \
  288.                  : current_model_issue)
  289.  
  290. /* INLINE CODE SELECTION:
  291.  
  292.    GCC -O3 attempts to inline any function or procedure in scope.  The
  293.    options below facilitate fine grained control over what is and what
  294.    isn't made inline.  For instance it can control things down to a
  295.    specific modules static routines.  Doing this allows the compiler
  296.    to both eliminate the overhead of function calls and (as a
  297.    consequence) also eliminate further dead code.
  298.  
  299.    On a CISC (x86) I've found that I can achieve an order of magintude
  300.    speed improvement (x3-x5).  In the case of RISC (sparc) while the
  301.    performance gain isn't as great it is still significant.
  302.  
  303.    Each module is controled by the macro <module>_INLINE which can
  304.    have the values described below
  305.  
  306.        0  Do not inline any thing for the given module
  307.  
  308.    The following additional values are `bit fields' and can be
  309.    combined.
  310.  
  311.       1  Include the C file for the module into the file being compiled
  312.          but do not make the functions within the module inline.
  313.  
  314.      While of no apparent benefit, this makes it possible for the
  315.      included module, when compiled to inline its calls to what
  316.      would otherwize be external functions.
  317.  
  318.       2  Make external functions within the module `inline'.  Thus if
  319.          the module is included into a file being compiled, calls to
  320.      its funtions can be eliminated. 2 implies 1.
  321.  
  322.       4  Make internal (static) functions within the module `inline'.
  323.  
  324.    In addition to this, modules have been put into two categories.
  325.  
  326.          Simple modules - eg sim-endian.h bits.h
  327.  
  328.      Because these modules are small and simple and do not have
  329.      any complex interpendencies they are configured, if
  330.      <module>_INLINE is so enabled, to inline themselves in all
  331.      modules that include those files.
  332.  
  333.      For the default build, this is a real win as all byte
  334.      conversion and bit manipulation functions are inlined.
  335.  
  336.      Complex modules - the rest
  337.  
  338.      These are all handled using the files inline.h and inline.c.
  339.      psim.c includes the above which in turn include any remaining
  340.      code.
  341.  
  342.    IMPLEMENTATION:
  343.  
  344.    The inline ability is enabled by prefixing every data / function
  345.    declaration and definition with one of the following:
  346.  
  347.  
  348.        INLINE_<module>
  349.  
  350.        Prefix to any global function that is a candidate for being
  351.        inline.
  352.  
  353.        values - `', `static', `static INLINE'
  354.  
  355.  
  356.        EXTERN_<module>
  357.       
  358.        Prefix to any global data structures for the module.  Global
  359.        functions that are not to be inlined shall also be prefixed
  360.        with this.
  361.  
  362.        values - `', `static', `static'
  363.  
  364.  
  365.        STATIC_INLINE_<module>
  366.  
  367.        Prefix to any local (static) function that is a candidate for
  368.        being made inline.
  369.  
  370.        values - `static', `static INLINE'
  371.  
  372.  
  373.        static
  374.  
  375.        Prefix all local data structures.  Local functions that are not
  376.        to be inlined shall also be prefixed with this.
  377.  
  378.        values - `static', `static'
  379.  
  380.        nb: will not work for modules that are being inlined for every
  381.        use (white lie).
  382.  
  383.  
  384.        extern
  385.        #ifndef _INLINE_C_
  386.        #endif
  387.        
  388.        Prefix to any declaration of a global object (function or
  389.        variable) that should not be inlined and should have only one
  390.        definition.  The #ifndef wrapper goes around the definition
  391.        propper to ensure that only one copy is generated.
  392.  
  393.        nb: this will not work when a module is being inlined for every
  394.        use.
  395.  
  396.  
  397.        STATIC_<module>
  398.  
  399.        Replaced by either `static' or `EXTERN_MODULE'.
  400.  
  401.  
  402.    REALITY CHECK:
  403.  
  404.    This is not for the faint hearted.  I've seen GCC get up to 200mb
  405.    trying to compile what this can create.
  406.  
  407.    Some of the modules do not yet implement the WITH_INLINE_STATIC
  408.    option.  Instead they use the macro STATIC_INLINE to control their
  409.    local function.
  410.  
  411.    Because of the way that GCC parses __attribute__(), the macro's
  412.    need to be adjacent to the functioin name rather then at the start
  413.    of the line vis:
  414.  
  415.        int STATIC_INLINE_MODULE f(void);
  416.     void INLINE_MODULE *g(void);
  417.  
  418.    */
  419.  
  420. #define REVEAL_MODULE            1
  421. #define INLINE_MODULE            2
  422. #define INCLUDE_MODULE            (INLINE_MODULE | REVEAL_MODULE)
  423. #define INLINE_LOCALS            4
  424. #define ALL_INLINE            7
  425.  
  426. /* Your compilers inline reserved word */
  427.  
  428. #ifndef INLINE
  429. #if defined(__GNUC__) && defined(__OPTIMIZE__)
  430. #define INLINE __inline__
  431. #else
  432. #define INLINE /*inline*/
  433. #endif
  434. #endif
  435.  
  436. /* Your compilers pass parameters in registers reserved word */
  437.  
  438. #if !defined REGPARM
  439. #if (defined(i386) || defined(i486) || defined(i586) || defined(__i386__) || defined(__i486__) || defined(__i586__)) && WITH_REGPARM
  440. #define REGPARM __attribute__((__regparm__(WITH_REGPARM)))
  441. #else
  442. #define REGPARM
  443. #endif
  444. #endif
  445.  
  446.  
  447.  
  448. /* Default prefix for static functions */
  449.  
  450. #ifndef STATIC_INLINE
  451. #define STATIC_INLINE static INLINE
  452. #endif
  453.  
  454. /* Default macro to simplify control several of key the inlines */
  455.  
  456. #ifndef DEFAULT_INLINE
  457. #define    DEFAULT_INLINE            INLINE_LOCALS
  458. #endif
  459.  
  460. /* Code that converts between hosts and target byte order.  Used on
  461.    every memory access (instruction and data).  See sim-endian.h for
  462.    additional byte swapping configuration information.  This module
  463.    can inline for all callers */
  464.  
  465. #ifndef SIM_ENDIAN_INLINE
  466. #define SIM_ENDIAN_INLINE        (DEFAULT_INLINE ? ALL_INLINE : 0)
  467. #endif
  468.  
  469. /* Low level bit manipulation routines. This module can inline for all
  470.    callers */
  471.  
  472. #ifndef BITS_INLINE
  473. #define BITS_INLINE            (DEFAULT_INLINE ? ALL_INLINE : 0)
  474. #endif
  475.  
  476. /* Code that gives access to various CPU internals such as registers.
  477.    Used every time an instruction is executed */
  478.  
  479. #ifndef CPU_INLINE
  480. #define CPU_INLINE            (DEFAULT_INLINE ? ALL_INLINE : 0)
  481. #endif
  482.  
  483. /* Code that translates between an effective and real address.  Used
  484.    by every load or store. */
  485.  
  486. #ifndef VM_INLINE
  487. #define VM_INLINE            DEFAULT_INLINE
  488. #endif
  489.  
  490. /* Code that loads/stores data to/from the memory data structure.
  491.    Used by every load or store */
  492.  
  493. #ifndef CORE_INLINE
  494. #define CORE_INLINE            DEFAULT_INLINE
  495. #endif
  496.  
  497. /* Code to check for and process any events scheduled in the future.
  498.    Called once per instruction cycle */
  499.  
  500. #ifndef EVENTS_INLINE
  501. #define EVENTS_INLINE            (DEFAULT_INLINE ? ALL_INLINE : 0)
  502. #endif
  503.  
  504. /* Code monotoring the processors performance.  It counts events on
  505.    every instruction cycle */
  506.  
  507. #ifndef MON_INLINE
  508. #define MON_INLINE            (DEFAULT_INLINE ? ALL_INLINE : 0)
  509. #endif
  510.  
  511. /* Code called on the rare occasions that an interrupt occures. */
  512.  
  513. #ifndef INTERRUPTS_INLINE
  514. #define INTERRUPTS_INLINE        DEFAULT_INLINE
  515. #endif
  516.  
  517. /* Code called on the rare occasion that either gdb or the device tree
  518.    need to manipulate a register within a processor */
  519.  
  520. #ifndef REGISTERS_INLINE
  521. #define REGISTERS_INLINE        DEFAULT_INLINE
  522. #endif
  523.  
  524. /* Code called on the rare occasion that a processor is manipulating
  525.    real hardware instead of RAM.
  526.  
  527.    Also, most of the functions in devices.c are always called through
  528.    a jump table.
  529.  
  530.    There seems to be some problem with making either device_tree or
  531.    devices inline.  It reports the message: device_tree_find_node()
  532.    not a leaf */
  533.  
  534. #ifndef DEVICE_INLINE
  535. #define DEVICE_INLINE            DEFAULT_INLINE
  536. #endif
  537.  
  538. /* Code called whenever information on a Special Purpose Register is
  539.    required.  Called by the mflr/mtlr pseudo instructions */
  540.  
  541. #ifndef SPREG_INLINE
  542. #define SPREG_INLINE            DEFAULT_INLINE
  543. #endif
  544.  
  545. /* Functions modeling the semantics of each instruction.  Two cases to
  546.    consider, firstly of idecode is implemented with a switch then this
  547.    allows the idecode function to inline each semantic function
  548.    (avoiding a call).  The second case is when idecode is using a
  549.    table, even then while the semantic functions can't be inlined,
  550.    setting it to one still enables each semantic function to inline
  551.    anything they call (if that code is marked for being inlined).
  552.  
  553.    WARNING: you need lots (like 200mb of swap) of swap.  Setting this
  554.    to 1 is useful when using a table as it enables the sematic code to
  555.    inline all of their called functions */
  556.  
  557. #ifndef SEMANTICS_INLINE
  558. #define SEMANTICS_INLINE        DEFAULT_INLINE
  559. #endif
  560.  
  561. /* Code to decode an instruction. Normally called on every instruction
  562.    cycle */
  563.  
  564. #ifndef IDECODE_INLINE
  565. #define IDECODE_INLINE            DEFAULT_INLINE
  566. #endif
  567.  
  568. /* Model specific code used in simulating functional units.  Note, it actaully
  569.    pays NOT to inline the PowerPC model functions (at least on the x86).  This
  570.    is because if it is inlined, each PowerPC instruction gets a separate copy
  571.    of the code, which is not friendly to the cache.  */
  572.  
  573. #ifndef MODEL_INLINE
  574. #define    MODEL_INLINE            (DEFAULT_INLINE & ~INLINE_MODULE)
  575. #endif
  576.  
  577. /* Code to print out what options we were compiled with.  Because this
  578.    is called at process startup, it doesn't have to be inlined, but
  579.    if it isn't brought in and the model routines are inline, the model
  580.    routines will be pulled in twice.  */
  581.  
  582. #ifndef OPTIONS_INLINE
  583. #define OPTIONS_INLINE            DEFAULT_INLINE
  584. #endif
  585.  
  586. /* The main body of code */
  587.  
  588. #ifndef PSIM_INLINE
  589. #define    PSIM_INLINE            DEFAULT_INLINE
  590. #endif
  591.  
  592.  
  593. /* Code to emulate os or rom compatibility.  Called on the rare
  594.    occasion that the OS or ROM code is being emulated. */
  595.  
  596. #ifndef OS_EMUL_INLINE
  597. #define OS_EMUL_INLINE            0
  598. #endif
  599.  
  600. #endif /* _PSIM_CONFIG_H */
  601.