OpenCores
URL https://opencores.org/ocsvn/openrisc/openrisc/trunk

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [gnu-old/] [gdb-6.8/] [gdb/] [or1k-tdep.c] - Rev 853

Go to most recent revision | Compare with Previous | Blame | View Log

/* Target-dependent code for the or1k architecture, for GDB, the GNU Debugger.
 
   Copyright 1988-2008, Free Software Foundation, Inc.
   Copyright (C) 2008, 2010 Embecosm Limited
 
   Contributed by Alessandro Forin(af@cs.cmu.edu at CMU
   and by Per Bothner(bothner@cs.wisc.edu) at U.Wisconsin.
   Contributor Jeremy Bennett <jeremy.bennett@embecosm.com>
 
   This file is part of GDB.
 
   This program is free software; you can redistribute it and/or modify it
   under the terms of the GNU General Public License as published by the Free
   Software Foundation; either version 3 of the License, or (at your option)
   any later version.
 
   This program is distributed in the hope that it will be useful, but WITHOUT
   ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
   FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
   more details.
 
   You should have received a copy of the GNU General Public License along
   with this program.  If not, see <http://www.gnu.org/licenses/>.  */
 
/*-----------------------------------------------------------------------------
   This version for the OpenRISC 1000 architecture is a rewrite by Jeremy
   Bennett of the old GDB 5.3 interface to make use of gdbarch for GDB 6.8.
 
   The code tries to follow the GDB coding style.
 
   Commenting is Doxygen compatible.
 
   Much has been stripped out in the interests of getting a basic working
   system. This is described as the OpenRISC 1000 target architecture, so
   should work with 16, 32 and 64 bit versions of that architecture and should
   work whether or not they have floating point and/or vector registers.
 
   There was never a capability to run simulator commands (no remote target
   implemented the required function), so that has been removed.
 
   The info trace command has been removed. The meaning of this is not clear -
   it relies on a value in register 255 of the debug group, which is
   undocumented.
 
   All the hardware trace has been removed for the time being. The new debug
   interface does not support hardware trace, so there is no plan to reinstate
   this functionality.
 
   Support for multiple contexts (which was rudimentary, and not working) has
   been removed. */
/*---------------------------------------------------------------------------*/
 
#include "demangle.h"
#include "defs.h"
#include "gdb_string.h"
#include "frame.h"
#include "inferior.h"
#include "symtab.h"
#include "value.h"
#include "gdbcmd.h"
#include "language.h"
#include "gdbcore.h"
#include "symfile.h"
#include "objfiles.h"
#include "gdbtypes.h"
#include "target.h"
#include "regcache.h"
 
#include "opcode/or32.h"
#include "or1k-tdep.h"
 
#include "safe-ctype.h"
#include "block.h"
#include "reggroups.h"
#include "arch-utils.h"
#include "frame.h"
#include "frame-unwind.h"
#include "frame-base.h"
#include "dwarf2-frame.h"
#include "trad-frame.h"
 
#include <inttypes.h>
 
 

 
/* Support functions for the architecture definition */
 
 
/*----------------------------------------------------------------------------*/
/*!Get an instruction from a frame
 
   This reads from memory, but if the instruction has been substituted by a
   software breakpoint, returns the instruction that has been replaced, NOT
   the break point instruction
 
   Depending on whether this has a frame available we use a frame based memory
   access or independent memory access. Underneath they are both the same, but
   annoyingly save_frame_unwind_memory inverts the status returned!
 
   @param[in] next_frame  Information about the next frame.
   @param[in] addr        Address from which to get the instruction
 
   @return  The instruction */
/*---------------------------------------------------------------------------*/
 
static unsigned long int
or1k_fetch_instruction (struct frame_info *next_frame,
			CORE_ADDR          addr) 
{
  char  buf[OR1K_INSTLEN];
  int   status;
 
  struct frame_info *this_frame = get_prev_frame (next_frame);
 
  if (NULL == this_frame)
    {
      status = read_memory_nobpt (addr, buf, OR1K_INSTLEN);
    }
  else
    {
      status = !(safe_frame_unwind_memory (this_frame, addr, buf,
					   OR1K_INSTLEN));
    }
 
  if (0 != status)
    {
      memory_error (status, addr);
    }
 
  return  (unsigned long int)(extract_unsigned_integer (buf, OR1K_INSTLEN));
 
}	/* or1k_fetch_instruction() */
 
 
/*----------------------------------------------------------------------------*/
/*!Store an instruction in a frame
 
   This writes to memory. Unlike its counterpart to fetch the instruction it
   does nothing about breakpoints
 
   Depending on whether this has a frame available we use a frame based memory
   access or independent memory access.
 
   @param[in] next_frame  Information about the next frame. Here for
                          compatibility with the fetch function, but ignored.
   @param[in] addr        Address to which to put the instruction
   @param[in] insn        The instruction to be written */
/*---------------------------------------------------------------------------*/
 
static void
or1k_store_instruction (struct frame_info *next_frame,
			CORE_ADDR          addr,
			unsigned long int  insn) 
{
  write_memory_unsigned_integer( addr, sizeof( insn ), insn );
 
}	/* or1k_store_instruction() */
 
 
/*---------------------------------------------------------------------------*/
/*!Generic function to read bits from an instruction
 
   printf style. Basic syntax
 
      or1k_analyse_inst (inst, format, &arg1, &arg2 ...)
 
   Format string can contain the following characters:
 
   - SPACE:  Ignored, just for layout
   - 0:      Match with a zero bit
   - 1:      Match with a one bit
   - %<n>b:  Match <n> bits to the next argument (n decimal)
 
   If the arg corresponding to a bit field is non-null, the value will be
   assigned to that argument (using NULL allows fields to be skipped).
 
   Any bad string will cause a fatal error. These are constant strings, so
   should be correct.
 
   The bit field must be 32 bits long. A failure here will cause a fatal error
   for the same reason.
 
   @note The format string is presented MS field to LS field, left to
         right. This means that it is read lowest numbered char first.
 
   @note Some of the arg fields may be populated, even if recognition
         ultimately fails.
 
   @param[in]  inst    The instruction to analyse
   @param[in]  format  The format string
   @param[out] ...     Argument fields
 
   @return  1 (TRUE) if the instruction matches, 0 (FALSE) otherwise.        */
/*---------------------------------------------------------------------------*/
static int
or1k_analyse_inst (uint32_t    inst,
		   const char *format,
		   ...)
{
  /* Break out each field in turn, validating as we go. */
  va_list     ap;
 
  int         i;
  int         iptr = 0;			/* Instruction pointer */
 
  va_start (ap, format);
 
  for (i = 0; 0 != format[i];)
    {
      const char *start_ptr;
      char       *end_ptr;
 
      uint32_t    bits;			/* Bit substring of interest */
      uint32_t    width;		/* Substring width */
      uint32_t   *arg_ptr;
 
      switch (format[i])
	{
	case ' ': i++; break;	/* Formatting: ignored */
 
	case '0': case '1':	/* Constant bit field */
	  bits = (inst >> (OR1K_INSTBITLEN - iptr - 1)) & 0x1;
 
	  if ((format[i] - '0') != bits)
	    {
	      return  0;
	    }
 
	  iptr++;
	  i++;
	  break;
 
	case '%':		/* Bit field */
	  i++;
	  start_ptr = &(format[i]);
	  width     = strtoul (start_ptr, &end_ptr, 10);
 
	  /* Check we got something, and if so skip on */
	  if (start_ptr == end_ptr)
	    {
	      fatal ("bitstring \"%s\" at offset %d has no length field.\n",
		     format, i);
	    }
 
	  i += end_ptr - start_ptr;
 
	  /* Look for and skip the terminating 'b'. If it's not there, we
	     still give a fatal error, because these are fixed strings that
	     just should not be wrong. */
	  if ('b' != format[i++])
	    {
	      fatal ("bitstring \"%s\" at offset %d has no terminating 'b'.\n",
		     format, i);
	    }
 
	  /* Break out the field. There is a special case with a bit width of
	     32. */
	  if (32 == width)
	    {
	      bits = inst;
	    }
	  else
	    {
	      bits = (inst >> (OR1K_INSTBITLEN - iptr - width)) & ((1 << width) - 1);
	    }
 
	  arg_ptr   = va_arg (ap, uint32_t *);
	  *arg_ptr  = bits;
	  iptr     += width;
	  break;
 
	default:
	  fatal ("invalid character in bitstring \"%s\" at offset %d.\n",
		 format, i);
	  break;
	}
    }
 
  /* Is the length OK? */
  gdb_assert (OR1K_INSTBITLEN == iptr);
 
  return  1;				/* We succeeded */
 
}	/* or1k_analyse_inst () */
 
 
/*---------------------------------------------------------------------------*/
/*!Analyse a l.addi instruction
 
   General form is:
 
     l.addi  rD,rA,I
 
   Makes use of the generic analysis function (@see or1k_analyse_inst ()).
 
   @param[in]  inst      The instruction to analyse.
   @param[out] rd_ptr    Pointer to the rD value.
   @param[out] ra_ptr    Pointer to the rA value.
   @param[out] simm_ptr  Pointer to the signed immediate value.
 
   @return  1 (TRUE) if the instruction matches, 0 (FALSE) otherwise.        */
/*---------------------------------------------------------------------------*/
static int
or1k_analyse_l_addi (uint32_t      inst,
		     unsigned int *rd_ptr,
		     unsigned int *ra_ptr,
		     int          *simm_ptr)
{
  /* Instruction fields */
  uint32_t  rd, ra, i;
 
  if (or1k_analyse_inst (inst, "10 0111 %5b %5b %16b", &rd, &ra, &i))
    {
      /* Found it. Construct the result fields */
      *rd_ptr   = (unsigned int) rd;
      *ra_ptr   = (unsigned int) ra;
      *simm_ptr = (int) (((i & 0x8000) == 0x8000) ? 0xffff0000 | i : i);
 
      return  1;		/* Success */
    }
  else
    {
      return  0;		/* Failure */
    }
}	/* or1k_analyse_l_addi () */
 
 
/*---------------------------------------------------------------------------*/
/*!Analyse a l.sw instruction
 
   General form is:
 
     l.sw  I(rA),rB
 
   Makes use of the generic analysis function (@see or1k_analyse_inst ()).
 
   @param[in]  inst      The instruction to analyse.
   @param[out] simm_ptr  Pointer to the signed immediate value.
   @param[out] ra_ptr    Pointer to the rA value.
   @param[out] rb_ptr    Pointer to the rB value.
 
   @return  1 (TRUE) if the instruction matches, 0 (FALSE) otherwise.        */
/*---------------------------------------------------------------------------*/
static int
or1k_analyse_l_sw (uint32_t      inst,
		   int          *simm_ptr,
		   unsigned int *ra_ptr,
		   unsigned int *rb_ptr)
{
  /* Instruction fields */
  uint32_t  ihi, ilo, ra, rb;
 
  if (or1k_analyse_inst (inst, "11 0101 %5b %5b %5b %11b", &ihi, &ra, &rb,
			 &ilo))
 
    {
      /* Found it. Construct the result fields */
      *simm_ptr  = (int) ((ihi << 11) | ilo);
      *simm_ptr |= ((ihi & 0x10) == 0x10) ? 0xffff0000 : 0;
 
      *ra_ptr    = (unsigned int) ra;
      *rb_ptr    = (unsigned int) rb;
 
      return  1;		/* Success */
    }
  else
    {
      return  0;		/* Failure */
    }
}	/* or1k_analyse_l_sw () */
 
 

 
/* Functions defining the architecture */
 
 
/*----------------------------------------------------------------------------*/
/*!Determine the return convention used for a given type
 
   Optionally, fetch or set the return value via "readbuf" or "writebuf"
   respectively using "regcache" for the register values.
 
   The OpenRISC 1000 returns scalar values via R11 and (for 64 bit values on
   32 bit architectures) R12. Structs and unions are returned by reference,
   with the address in R11
 
   Throughout use read_memory(), not target_read_memory(), since the address
   may be invalid and we want an error reported (read_memory() is
   target_read_memory() with error reporting).
 
   @todo This implementation is labelled OR1K, but in fact is just for the 32
         bit version, OR32. This should be made explicit
 
   @param[in]  gdbarch   The GDB architecture being used
   @param[in]  type      The type of the entity to be returned
   @param[in]  regcache  The register cache
   @param[in]  readbuf   Buffer into which the return value should be written
   @param[out] writebuf  Buffer from which the return value should be written
 
   @return  The type of return value */
/*---------------------------------------------------------------------------*/
 
static enum return_value_convention
or1k_return_value (struct gdbarch  *gdbarch,
		   struct type     *type,
		   struct regcache *regcache,
		   gdb_byte        *readbuf,
		   const gdb_byte  *writebuf) 
{
  enum type_code  rv_type = TYPE_CODE (type);
  unsigned int    rv_size = TYPE_LENGTH (type);
  ULONGEST        tmp;
 
  /* Deal with struct/union and large scalars first. Large (> 4 byte) scalars
     are returned via a pointer (despite what is says in the architecture
     document). Result pointed to by R11 */
 
  if((TYPE_CODE_STRUCT == rv_type) ||
     (TYPE_CODE_UNION  == rv_type) ||
     (rv_size          >  4))
    {
      if (readbuf)
	{
	  regcache_cooked_read_unsigned (regcache, OR1K_RV_REGNUM, &tmp);
	  read_memory (tmp, readbuf, rv_size);
	}
      if (writebuf)
	{
	  regcache_cooked_read_unsigned (regcache, OR1K_RV_REGNUM, &tmp);
	  write_memory (tmp, writebuf, rv_size);
	}
 
      return RETURN_VALUE_ABI_RETURNS_ADDRESS;
    }
 
  /* 1-4 byte scalars are returned in R11 */
 
  if (readbuf)
    {
      regcache_cooked_read_unsigned (regcache, OR1K_RV_REGNUM, &tmp);
      store_unsigned_integer (readbuf, rv_size, tmp);
    }
  if (writebuf)
    {
      gdb_byte buf[4];
      memset (buf, 0, sizeof (buf));	/* Pad with zeros if < 4 bytes */
 
      if (BFD_ENDIAN_BIG == gdbarch_byte_order (gdbarch))
	{
	  memcpy (buf + sizeof (buf) - rv_size, writebuf, rv_size);
	}
      else
	{
	  memcpy (buf,                          writebuf, rv_size);
	}
 
      regcache_cooked_write (regcache, OR1K_RV_REGNUM, buf);
    }
 
  return RETURN_VALUE_REGISTER_CONVENTION;
 
}	/* or1k_return_value() */
 
 
/*----------------------------------------------------------------------------*/
/*!Determine the instruction to use for a breakpoint.
 
   Given the address at which to insert a breakpoint (bp_addr), what will
   that breakpoint be?
 
   For or1k, we have a breakpoint instruction. Since all or1k instructions
   are 32 bits, this is all we need, regardless of address.
 
   @param[in]  gdbarch  The GDB architecture being used
   @param[in]  bp_addr  The breakpoint address in question
   @param[out] bp_size  The size of instruction selected
 
   @return  The chosen breakpoint instruction */
/*---------------------------------------------------------------------------*/
 
static const gdb_byte *
or1k_breakpoint_from_pc (struct gdbarch *gdbarch,
			 CORE_ADDR      *bp_addr,
			 int            *bp_size) 
{ 
  static const gdb_byte breakpoint[] = OR1K_BRK_INSTR_STRUCT;
 
  *bp_size = OR1K_INSTLEN;
  return breakpoint;
 
}	/* or1k_breakpoint_from_pc() */
 
 
/*----------------------------------------------------------------------------*/
/*!Determine if we are executing a delay slot
 
   Looks at the instruction at the previous instruction to see if it was one
   with a delay slot. But it also has to be the address prior to NPC, because
   we may have just taken an exception.
 
   @param[in] gdbarch     The GDB architecture being used
   @param[in] this_frame  Information about THIS frame
 
   @return  1 (true) if this instruction is executing a delay slot, 0 (false)
   otherwise. */
/*--------------------------------------------------------------------------*/
 
static int
or1k_single_step_through_delay( struct gdbarch    *gdbarch,
				struct frame_info *this_frame )
{
  struct regcache   *regcache = get_current_regcache ();
  ULONGEST           val;
  CORE_ADDR          ppc;
  CORE_ADDR          npc;
  int                index;
 
  /* Get and the previous and current instruction addresses. If they are not
     adjacent, we cannot be in a delay slot. */
  regcache_cooked_read_unsigned (regcache, OR1K_PPC_REGNUM, &val);
  ppc        = (CORE_ADDR) val;
  regcache_cooked_read_unsigned (regcache, OR1K_NPC_REGNUM, &val);
  npc        = (CORE_ADDR) val;
 
  if (0x4 != (npc - ppc))
    {
      return  0;
    }
 
  /* Decode the previous instruction to see if it was a branch or a jump, and
     hence we are in a delay slot. */
  index = insn_decode (or1k_fetch_instruction (this_frame, ppc));
  return  or32_opcodes[index].flags & OR32_IF_DELAY;
 
}	/* or1k_single_step_through_delay() */
 
 
/*----------------------------------------------------------------------------*/
/*!Read a pseudo register
 
   Since we have no pseudo registers this is a null function for now.
 
   @todo The floating point and vector registers ought to be done as
         pseudo-registers.
 
   @param[in]  gdbarch   The GDB architecture to consider
   @param[in]  regcache  The cached register values as an array
   @param[in]  regnum    The register to read
   @param[out] buf       A buffer to put the result in */
/*---------------------------------------------------------------------------*/
 
static void
or1k_pseudo_register_read (struct gdbarch  *gdbarch,
			   struct regcache *regcache,
			   int              regnum,
			   gdb_byte        *buf) 
{
  return;
 
}	/* or1k_pseudo_register_read() */
 
 
/*----------------------------------------------------------------------------*/
/*!Write a pseudo register
 
   Since we have no pseudo registers this is a null function for now.
 
   @todo The floating point and vector registers ought to be done as
         pseudo-registers.
 
   @param[in] gdbarch   The GDB architecture to consider
   @param[in] regcache  The cached register values as an array
   @param[in] regnum    The register to read
   @param[in] buf       A buffer with the value to write */
/*---------------------------------------------------------------------------*/
 
static void
or1k_pseudo_register_write (struct gdbarch  *gdbarch,
			    struct regcache *regcache,
			    int              regnum,
			    const gdb_byte  *buf) 
{
  return;
 
}	/* or1k_pseudo_register_write() */
 
 
/*----------------------------------------------------------------------------*/
/*!Return the register name for the OpenRISC 1000 architecture
 
   This version converted to ANSI C, made static and incorporates the static
   table of register names (this is the only place it is referenced).
 
   @todo The floating point and vector registers ought to be done as
         pseudo-registers.
 
   @param[in] gdbarch  The GDB architecture being used
   @param[in] regnum    The register number
 
   @return  The textual name of the register */
/*---------------------------------------------------------------------------*/
 
static const char *
or1k_register_name (struct gdbarch *gdbarch,
		    int             regnum) 
{
  static char *or1k_gdb_reg_names[OR1K_TOTAL_NUM_REGS] =
    {
      /* general purpose registers */
      "gpr0",  "gpr1",  "gpr2",  "gpr3",  "gpr4",  "gpr5",  "gpr6",  "gpr7",
      "gpr8",  "gpr9",  "gpr10", "gpr11", "gpr12", "gpr13", "gpr14", "gpr15",
      "gpr16", "gpr17", "gpr18", "gpr19", "gpr20", "gpr21", "gpr22", "gpr23",
      "gpr24", "gpr25", "gpr26", "gpr27", "gpr28", "gpr29", "gpr30", "gpr31",
 
      /* previous program counter, next program counter and status register */
      "ppc",   "npc",   "sr"
 
      /* Floating point and vector registers may appear as pseudo registers in
	 the future. */
    };
 
  return or1k_gdb_reg_names[regnum];
 
}	/* or1k_register_name() */
 
 
/*----------------------------------------------------------------------------*/
/*!Identify the type of a register
 
   @todo I don't fully understand exactly what this does, but I think this
         makes sense!
 
   @param[in] arch     The GDB architecture to consider
   @param[in] regnum   The register to identify
 
   @return  The type of the register */
/*---------------------------------------------------------------------------*/
 
static struct type *
or1k_register_type (struct gdbarch *arch,
		    int             regnum) 
{
  static struct type *void_func_ptr = NULL;
  static struct type *void_ptr      = NULL;
 
  /* Set up the static pointers once, the first time*/
  if (NULL == void_func_ptr)
    {
      void_ptr = lookup_pointer_type (builtin_type_void);
      void_func_ptr =
	lookup_pointer_type (lookup_function_type (builtin_type_void));
    }
 
  if((regnum >= 0) && (regnum < OR1K_TOTAL_NUM_REGS))
    {
      switch (regnum)
	{
	case OR1K_PPC_REGNUM:
	case OR1K_NPC_REGNUM:
	  return void_func_ptr;		/* Pointer to code */
 
	case OR1K_SP_REGNUM:
	case OR1K_FP_REGNUM:
	  return void_ptr;			/* Pointer to data */
 
	default:
	  return builtin_type_int32;	/* Data */
	}
    }
 
  internal_error (__FILE__, __LINE__,
		  _("or1k_register_type: illegal register number %d"), regnum);
 
}	/* or1k_register_type() */
 
 
/*----------------------------------------------------------------------------*/
/*!Handle the "info register" command
 
   Print the identified register, unless it is -1, in which case print all
   the registers. If all is 1 means all registers, otherwise only the core
   GPRs.
 
   @todo At present all registers are printed with the default method. Should
         there be something special for FP registers?
 
   @param[in] gdbarch  The GDB architecture being used
   @param[in] file     File handle for use with any custom I/O
   @param[in] frame    Frame info for use with custom output
   @param[in] regnum   Register of interest, or -1 if all registers
   @param[in] all      1 if all means all, 0 if all means just GPRs
 
   @return  The aligned stack frame address */
/*---------------------------------------------------------------------------*/
 
static void
or1k_registers_info (struct gdbarch    *gdbarch,
		     struct ui_file    *file,
		     struct frame_info *frame,
		     int                regnum,
		     int                all) 
{
  if (-1 == regnum)
    {
      /* Do all (valid) registers */
      unsigned int  lim = all ? OR1K_NUM_REGS : OR1K_MAX_GPR_REGS;
 
      for (regnum = 0; regnum < lim; regnum++) {
	if ('\0' != *(or1k_register_name (gdbarch, regnum)))
	  {
	    or1k_registers_info (gdbarch, file, frame, regnum, all);
	  }
      }
    }
  else
    {
      /* Do one specified register - if it is part of this architecture */
      if ('\0' == *(or1k_register_name (gdbarch, regnum)))
	{
	  error ("Not a valid register for the current processor type");
	}
      else
	{
	  default_print_registers_info (gdbarch, file, frame, regnum, all);
	}
    }
}	/* or1k_registers_info() */
 
 
/*----------------------------------------------------------------------------*/
/*!Identify if a register belongs to a specified group
 
   Return true if the specified register is a member of the specified
   register group.
 
   These are the groups of registers that can be displayed via "info reg".
 
   @todo The Vector and Floating Point registers ought to be displayed as
         pseudo-registers.
 
   @param[in] gdbarch  The GDB architecture to consider
   @param[in] regnum   The register to consider
   @param[in] group    The group to consider
 
   @return  True (1) if regnum is a member of group */
/*---------------------------------------------------------------------------*/
 
static int
or1k_register_reggroup_p (struct gdbarch  *gdbarch,
			  int              regnum,
			  struct reggroup *group) 
{
  struct gdbarch_tdep *tdep = gdbarch_tdep (gdbarch);
 
  /* All register group */
  if (group == all_reggroup)
    {
      return ((regnum >= 0) &&
	      (regnum < OR1K_TOTAL_NUM_REGS) &&
	      (or1k_register_name (gdbarch, regnum)[0] != '\0'));
    }
 
  /* For now everything except the PC */
  if (group == general_reggroup)
    {
      return ((regnum >= OR1K_ZERO_REGNUM) &&
	      (regnum <  tdep->num_gpr_regs) &&
	      (regnum != OR1K_PPC_REGNUM) &&
	      (regnum != OR1K_NPC_REGNUM));
    }
 
  if (group == float_reggroup)
    {
      return 0;			/* No float regs.  */
    }
 
  if (group == vector_reggroup)
    {
      return 0;			/* No vector regs.  */
    }
 
  /* For any that are not handled above.  */
  return default_register_reggroup_p (gdbarch, regnum, group);
 
}	/* or1k_register_reggroup_p() */
 
 
/*----------------------------------------------------------------------------*/
/*!Skip a function prolog
 
   If the input address, PC, is in a function prologue, return the address of
   the end of the prologue, otherwise return the input  address.
 
   @see For details of the stack frame, see the function
   or1k_frame_unwind_cache().
 
   This function reuses the helper functions from or1k_frame_unwind_cache() to
   locate the various parts of the prolog, any or all of which may be missing.
 
   @param[in] gdbarch  The GDB architecture being used
   @param[in] pc       Current program counter
 
   @return  The address of the end of the prolog if the PC is in a function
            prologue, otherwise the input  address.                           */
/*----------------------------------------------------------------------------*/
 
static CORE_ADDR
or1k_skip_prologue (struct gdbarch *gdbarch,
		    CORE_ADDR       pc) 
{
  CORE_ADDR     addr;
  uint32_t      inst;
 
  unsigned int  ra, rb, rd;		/* For instruction analysis */
  int           simm;
 
  int           frame_size = 0;
 
  /* Try using SAL first if we have symbolic information available. */
  if (find_pc_partial_function (pc, NULL, NULL, NULL))
    {
      CORE_ADDR  prologue_end = skip_prologue_using_sal( pc );
 
      return  (prologue_end > pc) ? prologue_end : pc;
    }
 
  /* Look to see if we can find any of the standard prologue sequence. All
     quite difficult, since any or all of it may be missing. So this is just a
     best guess! */
  addr = pc;				/* Where we have got to */
  inst = or1k_fetch_instruction (NULL, addr);
 
  /* Look for the new stack pointer being set up. */
  if (or1k_analyse_l_addi (inst, &rd, &ra, &simm) &&
      (OR1K_SP_REGNUM == rd) && (OR1K_SP_REGNUM == ra) &&
      (simm < 0) && (0 == (simm % 4)))
    {
      frame_size  = -simm;
      addr       += OR1K_INSTLEN;
      inst        = or1k_fetch_instruction (NULL, addr);
    }
 
  /* Look for the frame pointer being manipulated. */
  if (or1k_analyse_l_sw (inst, &simm, &ra, &rb) &&
      (OR1K_SP_REGNUM == ra) && (OR1K_FP_REGNUM == rb) &&
      (simm >= 0) && (0 == (simm % 4)))
    {
      addr += OR1K_INSTLEN;
      inst  = or1k_fetch_instruction (NULL, addr);
 
      gdb_assert (or1k_analyse_l_addi (inst, &rd, &ra, &simm) &&
		  (OR1K_FP_REGNUM == rd) && (OR1K_SP_REGNUM == ra) &&
		  (simm == frame_size));
 
      addr += OR1K_INSTLEN;
      inst  = or1k_fetch_instruction (NULL, addr);
    }
 
  /* Look for the link register being saved */
  if (or1k_analyse_l_sw (inst, &simm, &ra, &rb) &&
      (OR1K_SP_REGNUM == ra) && (OR1K_LR_REGNUM == rb) &&
      (simm >= 0) && (0 == (simm % 4)))
    {
      addr += OR1K_INSTLEN;
      inst  = or1k_fetch_instruction (NULL, addr);
    }
 
  /* Look for callee-saved register being saved. The register must be one
     of the 10 callee saved registers (r10, r12, r14, r16, r18, r20, r22,
     r24, r26, r28, r30).*/
  while (1)
    {
      if (or1k_analyse_l_sw (inst, &simm, &ra, &rb) &&
	  (OR1K_SP_REGNUM == ra) && (rb >= OR1K_FIRST_SAVED_REGNUM) &&
	  (0 == rb % 2) && (simm >= 0) && (0 == (simm % 4)))
	{
	  addr += OR1K_INSTLEN;
	  inst  = or1k_fetch_instruction (NULL, addr);
	}
      else
	{
	  /* Nothing else to look for. We have found the end of the prologue. */
	  return  addr;
	}
    }
}	/* or1k_skip_prologue() */
 
 
/*----------------------------------------------------------------------------*/
/*!Align the stack frame
 
   OpenRISC 1000 uses a falling stack frame, so this aligns down to the
   nearest 8 bytes. Useful when we'be building a dummy frame.
 
   @param[in] gdbarch  The GDB architecture being used
   @param[in] sp       Current stack pointer
 
   @return  The aligned stack frame address */
/*---------------------------------------------------------------------------*/
 
static CORE_ADDR
or1k_frame_align (struct gdbarch *gdbarch,
		  CORE_ADDR       sp) 
{
  return align_down (sp, OR1K_STACK_ALIGN);
 
}	/* or1k_frame_align() */
 
 
/*----------------------------------------------------------------------------*/
/*!Unwind the program counter from a stack frame
 
   This just uses the built in frame unwinder
 
   @param[in] gdbarch     The GDB architecture being used
   @param[in] next_frame  Frame info for the NEXT frame
 
   @return  The program counter for THIS frame */
/*---------------------------------------------------------------------------*/
 
static CORE_ADDR
or1k_unwind_pc (struct gdbarch    *gdbarch,
		struct frame_info *next_frame) 
{
  CORE_ADDR pc = frame_unwind_register_unsigned (next_frame, OR1K_NPC_REGNUM);
 
  return pc;
 
}	/* or1k_unwind_pc() */
 
 
/*----------------------------------------------------------------------------*/
/*!Unwind the stack pointer from a stack frame
 
   This just uses the built in frame unwinder
 
   @param[in] gdbarch     The GDB architecture being used
   @param[in] next_frame  Frame info for the NEXT frame
 
   @return  The stack pointer for THIS frame */
/*---------------------------------------------------------------------------*/
 
static CORE_ADDR
or1k_unwind_sp (struct gdbarch    *gdbarch,
		struct frame_info *next_frame) 
{
  CORE_ADDR sp = frame_unwind_register_unsigned (next_frame, OR1K_SP_REGNUM);
 
  return sp;
 
}	/* or1k_unwind_sp() */
 
 
/*----------------------------------------------------------------------------*/
/*!Create a dummy stack frame
 
   The arguments are placed in registers and/or pushed on the stack as per the
   OR1K ABI.
 
   @param[in] gdbarch        The architecture to use
   @param[in] function       Pointer to the function that will be called
   @param[in] regcache       The register cache to use
   @param[in] bp_addr        Breakpoint address
   @param[in] nargs          Number of ags to push
   @param[in] args           The arguments
   @param[in] sp             The stack pointer
   @param[in] struct_return  True (1) if this returns a structure
   @param[in] struct_addr    Address for returning structures
 
   @return  The updated stack pointer */
/*---------------------------------------------------------------------------*/
 
static CORE_ADDR
or1k_push_dummy_call (struct gdbarch  *gdbarch,
		      struct value    *function,
		      struct regcache *regcache,
		      CORE_ADDR        bp_addr,
		      int              nargs,
		      struct value   **args,
		      CORE_ADDR        sp,
		      int              struct_return,
		      CORE_ADDR        struct_addr) 
{
  int           argreg;
  int           argnum;
  int           first_stack_arg;
  int           stack_offset = 0;
 
  unsigned int  bpa = (gdbarch_tdep (gdbarch))->bytes_per_address;
  unsigned int  bpw = (gdbarch_tdep (gdbarch))->bytes_per_word;
 
  /* Return address */
  regcache_cooked_write_unsigned (regcache, OR1K_LR_REGNUM, bp_addr);
 
  /* Register for the next argument */
  argreg = OR1K_FIRST_ARG_REGNUM;
 
  /* Location for a returned structure. This is passed as a silent first
     argument. */
 
  if (struct_return)
    {
      regcache_cooked_write_unsigned (regcache, OR1K_FIRST_ARG_REGNUM, 
				      struct_addr);
      argreg++;
    }
 
  /* Put as many args as possible in registers */
  for (argnum = 0; argnum < nargs; argnum++)
    {
      char           *val;
      char            valbuf[sizeof (ULONGEST) ];
 
      struct value   *arg      = args[argnum];
      struct type    *arg_type = check_typedef (value_type (arg));
      int             len      = arg_type->length;
      enum type_code  typecode = arg_type->main_type->code;
 
      /* The EABI passes structures that do not fit in a register by
	 reference. In all other cases, pass the structure by value.  */
      if((len > bpw) &&
	 ((TYPE_CODE_STRUCT == typecode) || (TYPE_CODE_UNION == typecode)))
	{
 
	  store_unsigned_integer (valbuf, bpa, value_offset (arg));
	  len      = bpa;
	  val      = valbuf;
	}
      else
	{
	  val = (char *)value_contents (arg);
	}   
 
      if((len > bpw) && (argreg <= (OR1K_LAST_ARG_REGNUM - 1)))
	{
 
	  /* Big scalars use two registers, must be pair aligned. This code
	     breaks if we can have quad-word scalars (e.g. long double). */
	  ULONGEST regval = extract_unsigned_integer (val, len);
 
	  gdb_assert (len <= (bpw * 2));
 
	  argreg = 1 == (argreg & 1) ? argreg + 1 : argreg;
	  regcache_cooked_write_unsigned (regcache, argreg, regval >> bpw);
	  regcache_cooked_write_unsigned (regcache, argreg + 1,
					  regval && ((ULONGEST)(1 << bpw) - 1));
	  argreg += 2;
	}
      else if (argreg <= OR1K_LAST_ARG_REGNUM)
	{
	  regcache_cooked_write_unsigned (regcache, argreg,
					  extract_unsigned_integer (val, len));
	  argreg++;
	}
      else
	{
	  /* Run out of regs */
	  break;
	}
    }
 
  first_stack_arg = argnum;
 
  /* If we get here with argnum < nargs, then arguments remain to be placed on
     the stack. This is tricky, since they must be pushed in reverse order and
     the stack in the end must be aligned. The only solution is to do it in
     two stages, the first to compute the stack size, the second to save the
     args. */
 
  for (argnum = first_stack_arg; argnum < nargs; argnum++)
    {
      struct value   *arg      = args[argnum];
      struct type    *arg_type = check_typedef (value_type (arg));
      int             len      = arg_type->length;
      enum type_code  typecode = arg_type->main_type->code;
 
      if((len > bpw) &&
	 ((TYPE_CODE_STRUCT == typecode) || (TYPE_CODE_UNION == typecode)))
	{
	  /* Large structures are passed as addresses */
	  sp -= bpa;
	}
      else
	{
	/* Big scalars use more than one word. Code here allows for future
	 quad-word entities (e.g. long double) */
	  sp -= ((len + bpw - 1) / bpw) * bpw;
	}
    }
 
  sp           = gdbarch_frame_align (gdbarch, sp);
  stack_offset = 0;
 
  /* Push the remaining args on the stack */
  for (argnum = first_stack_arg; argnum < nargs; argnum++)
    {
      char           *val;
      char            valbuf[sizeof (ULONGEST) ];
 
      struct value   *arg      = args[argnum];
      struct type    *arg_type = check_typedef (value_type (arg));
      int             len      = arg_type->length;
      enum type_code  typecode = arg_type->main_type->code;
 
      /* The EABI passes structures that do not fit in a register by
	 reference. In all other cases, pass the structure by value.  */
      if((len > bpw) &&
	 ((TYPE_CODE_STRUCT == typecode) || (TYPE_CODE_UNION == typecode)))
	{
 
	  store_unsigned_integer (valbuf, bpa, value_offset (arg));
	  len      = bpa;
	  val      = valbuf;
	}
      else
	{
	  val = (char *)value_contents (arg);
	}   
 
      gdb_assert (len <= (bpw * 2));
 
      write_memory (sp + stack_offset, val, len);
      stack_offset += ((len + bpw - 1) / bpw) * bpw;
    }
 
  /* Save the updated stack pointer */
  regcache_cooked_write_unsigned (regcache, OR1K_SP_REGNUM, sp);
 
  return sp;
 
}	/* or1k_push_dummy_call() */
 
 
/*----------------------------------------------------------------------------*/
/*!Unwind a dummy stack frame
 
   Tear down a dummy frame created by or1k_push_dummy_call(). This data has to
   be constructed manually from the data in our hand. The frame_id info in
   next_frame is not complete, and a call to unwind it will just recurse to us
   (we think).
 
   The stack pointer and program counter can be unwound. From the program
   counter, the start of the function can be determined.
 
   @param[in] gdbarch     The architecture to use
   @param[in] next_frame  Information about the next frame
 
   @return  Frame ID of the preceding frame */
/*---------------------------------------------------------------------------*/
 
static struct frame_id
or1k_unwind_dummy_id (struct gdbarch    *gdbarch,
		      struct frame_info *next_frame) 
{
  CORE_ADDR  this_sp = gdbarch_unwind_sp (gdbarch, next_frame);
  CORE_ADDR  this_pc = gdbarch_unwind_pc (gdbarch, next_frame);
 
  CORE_ADDR  start_addr;
  CORE_ADDR  end_addr;
 
  /* Try using SAL to find the true function start. Otherwise the PC will
     have to be a proxy for the start of the function. */
  if (find_pc_partial_function (this_pc, NULL, &start_addr, &end_addr))
    {
      return  frame_id_build (this_sp, start_addr);
    }
  else
    {
      return  frame_id_build (this_sp, this_pc);
    }
 
}	/* or1k_unwind_dummy_id() */
 
 

 
 
/* Support functions for frame handling */
 
 
/*----------------------------------------------------------------------------*/
/*!Initialize a prologue (unwind) cache
 
   Build up the information (saved registers etc) for the given frame if it
   does not already exist.
 
   STACK FORMAT
   ============
 
   The OR1K has a falling stack frame and a simple prolog. The Stack pointer
   is R1 and the frame pointer R2. The frame base is therefore the address
   held in R2 and the stack pointer (R1) is the frame base of the NEXT frame.
 
   @verbatim
   l.addi  r1,r1,-frame_size	# SP now points to end of new stack frame
   @endverbatim
 
   The stack pointer may not be set up in a frameless function (e.g. a simple
   leaf function).
 
   @verbatim
   l.sw    fp_loc(r1),r2        # old FP saved in new stack frame
   l.addi  r2,r1,frame_size     # FP now points to base of new stack frame
   @endverbatim
 
   The frame pointer is not necessarily saved right at the end of the stack
   frame - OR1K saves enough space for any args to called functions right at
   the end (this is a difference from the Architecture Manual).
 
   @verbatim
   l.sw    lr_loc(r1),r9        # Link (return) address
   @endverbatim
 
   The link register is usally saved at fp_loc - 4. It may not be saved at all
   in a leaf function.
 
   @verbatim
   l.sw    reg_loc(r1),ry       # Save any callee saved regs
   @endverbatim
 
   The offsets x for the callee saved registers generally (always?) rise in
   increments of 4, starting at fp_loc + 4. If the frame pointer is omitted
   (an option to GCC), then it may not be saved at all. There may be no callee
   saved registers.
 
   So in summary none of this may be present. However what is present seems
   always to follow this fixed order, and occur before any substantive code
   (it is possible for GCC to have more flexible scheduling of the prologue,
   but this does not seem to occur for OR1K).
 
   ANALYSIS
   ========
 
   This prolog is used, even for -O3 with GCC.
 
   All this analysis must allow for the possibility that the PC is in the
   middle of the prologue. Data should only be set up insofar as it has been
   computed.
 
   A suite of "helper" routines are used, allowing reuse for
   or1k_skip_prologue().
 
   Reportedly, this is only valid for frames less than 0x7fff in size.
 
   @param[in]     next_frame           The NEXT frame (i.e. inner from here,
                                       the one THIS frame called)
   @param[in,out] this_prologue_cache  The prologue cache. If not supplied, we
                                       build it.
 
   @return  The prolog cache (duplicates the return through the argument) */
/*---------------------------------------------------------------------------*/
 
static struct trad_frame_cache *
or1k_frame_unwind_cache (struct frame_info  *next_frame,
			 void              **this_prologue_cache) 
{
  struct gdbarch          *gdbarch;
  struct trad_frame_cache *info;
 
  CORE_ADDR                this_pc;
  CORE_ADDR                this_sp;
  int                      frame_size = 0;
 
  CORE_ADDR                start_addr;
  CORE_ADDR                end_addr;
 
  /* Nothing to do if we already have this info */
  if (NULL != *this_prologue_cache)
    {
      return *this_prologue_cache;
    }
 
  /* Get a new prologue cache and populate it with default values */
  info                 = trad_frame_cache_zalloc (next_frame);
  *this_prologue_cache = info;
 
  /* Find the start address of THIS function (which is a NORMAL frame, even if
     the NEXT frame is the sentinel frame) and the end of its prologue.  */
  start_addr = frame_func_unwind (next_frame, NORMAL_FRAME);
 
  /* Return early if GDB couldn't find the function.  */
  if (start_addr == 0)
    {
      return  info;
    }
 
  /* Unwind key registers for THIS frame. */
  gdbarch = get_frame_arch (next_frame);
  this_pc = or1k_unwind_pc (gdbarch, next_frame);
  this_sp = or1k_unwind_sp (gdbarch, next_frame);
 
  /* The frame base of THIS frame is its stack pointer. This is the same
     whether we are frameless or not. */
  trad_frame_set_this_base (info, this_sp);
 
  /* The default is to find the PC of the PREVIOUS frame in the link register
     of this frame. This may be changed if we find the link register was saved
     on the stack. */
  trad_frame_set_reg_realreg (info, OR1K_NPC_REGNUM, OR1K_LR_REGNUM);
 
  /* We should only examine code that is in the prologue and which has been
     executed. This is all code up to (but not including) end_addr or the PC,
     whichever is first. */
  end_addr = or1k_skip_prologue (gdbarch, start_addr);
  end_addr = (this_pc > end_addr) ? end_addr : this_pc;
 
  /* All the following analysis only occurs if we are in the prologue and have
     executed the code. Check we have a sane prologue size, and if zero we
     are frameless and can give up here. */
  if (end_addr < start_addr)
    {
      fatal ("end addr 0x%08x is less than start addr 0x%08x\n",
	     (unsigned int) end_addr, (unsigned int) start_addr);
    }
 
  if (end_addr == start_addr)
    {
      frame_size = 0;
    }
  else
    {
      /* have a frame. Look for the various components */
      CORE_ADDR  addr = start_addr;	/* Where we have got to */
      uint32_t   inst = or1k_fetch_instruction (next_frame, addr);
 
      unsigned int  ra, rb, rd;		/* For instruction analysis */
      int           simm;
 
      /* Look for the new stack pointer being set up. */
      if (or1k_analyse_l_addi (inst, &rd, &ra, &simm) &&
	  (OR1K_SP_REGNUM == rd) && (OR1K_SP_REGNUM == ra) &&
	  (simm < 0) && (0 == (simm % 4)))
	{
	  frame_size  = -simm;
	  addr       += OR1K_INSTLEN;
	  inst        = or1k_fetch_instruction (next_frame, addr);
 
	  /* The stack pointer of the PREVIOUS frame is frame_size greater
	     than the stack pointer of THIS frame. */
	  trad_frame_set_reg_value (info, OR1K_SP_REGNUM,
				    this_sp + frame_size);
	}
 
      /* Look for the frame pointer being manipulated. */
      if ((addr < end_addr) &&
	  or1k_analyse_l_sw (inst, &simm, &ra, &rb) &&
	  (OR1K_SP_REGNUM == ra) && (OR1K_FP_REGNUM == rb) &&
	  (simm >= 0) && (0 == (simm % 4)))
	{
	  addr += OR1K_INSTLEN;
	  inst  = or1k_fetch_instruction (next_frame, addr);
 
	  /* At this stage, we can find the frame pointer of the PREVIOUS
	     frame on the stack of the current frame. */
	  trad_frame_set_reg_addr (info, OR1K_FP_REGNUM, this_sp + simm);
 
	  /* Look for the new frame pointer being set up */
	  if (addr < end_addr)
	    {
	      gdb_assert (or1k_analyse_l_addi (inst, &rd, &ra, &simm) &&
			  (OR1K_FP_REGNUM == rd) && (OR1K_SP_REGNUM == ra) &&
			  (simm == frame_size));
 
	      addr += OR1K_INSTLEN;
	      inst  = or1k_fetch_instruction (next_frame, addr);
 
	      /* If we have got this far, the stack pointer of the PREVIOUS
		 frame is the frame pointer of THIS frame. */
	      trad_frame_set_reg_realreg (info, OR1K_SP_REGNUM, OR1K_FP_REGNUM);
	    }
	}
 
      /* Look for the link register being saved */
      if ((addr < end_addr) &&
	  or1k_analyse_l_sw (inst, &simm, &ra, &rb) &&
	  (OR1K_SP_REGNUM == ra) && (OR1K_LR_REGNUM == rb) &&
	  (simm >= 0) && (0 == (simm % 4)))
	{
	  addr += OR1K_INSTLEN;
	  inst  = or1k_fetch_instruction (next_frame, addr);
 
	  /* If the link register is saved in the THIS frame, it holds the
	     value of the PC in the PREVIOUS frame. This overwrites the
	     previous information about finding the PC in the link
	     register. */
	  trad_frame_set_reg_addr (info, OR1K_NPC_REGNUM, this_sp + simm);
	}
 
      /* Look for callee-saved register being save. The register must be one
	 of the 10 callee saved registers (r10, r12, r14, r16, r18, r20, r22,
	 r24, r26, r28, r30).*/
      while (addr < end_addr)
	{
	  if (or1k_analyse_l_sw (inst, &simm, &ra, &rb) &&
	      (OR1K_SP_REGNUM == ra) && (rb >= OR1K_FIRST_SAVED_REGNUM) &&
	      (0 == rb % 2) && (simm >= 0) && (0 == (simm % 4)))
	    {
	      addr += OR1K_INSTLEN;
	      inst  = or1k_fetch_instruction (next_frame, addr);
 
	      /* The register in the PREVIOUS frame can be found at this
		 location in THIS frame */
	      trad_frame_set_reg_addr (info, rb, this_sp + simm);
	    }
	  else
	    {
	      break;			/* Not a register save instruction */
	    }
	}
    }
 
  /* Build the frame ID */
  trad_frame_set_id (info, frame_id_build (this_sp, start_addr));
 
  return info;
 
}	/* or1k_frame_unwind_cache() */
 
 
/*----------------------------------------------------------------------------*/
/*!Find the frame ID of this frame
 
   Given a GDB frame (called by THIS frame), determine the address of oru
   frame and from this create a new GDB frame struct. The info required is
   obtained from the prologue cache for THIS frame.
 
   @param[in] next_frame            The NEXT frame (i.e. inner from here, the
                                    one THIS frame called)
   @param[in]  this_prologue_cache  Any cached prologue for THIS function.
   @param[out] this_id              Frame ID of our own frame.
 
   @return  Frame ID for THIS frame */
/*---------------------------------------------------------------------------*/
 
static void
or1k_frame_this_id (struct frame_info  *next_frame,
		    void              **this_prologue_cache,
		    struct frame_id    *this_id) 
{
  struct trad_frame_cache *info =
    or1k_frame_unwind_cache (next_frame, this_prologue_cache);
 
  trad_frame_get_id (info, this_id);
 
}	/* or1k_frame_this_id() */
 
 
/*----------------------------------------------------------------------------*/
/*!Get a register from THIS frame
 
   Given a pointer to the NEXT frame, return the details of a register in the
   PREVIOUS frame.
 
   @param[in] next_frame            The NEXT frame (i.e. inner from here, the
                                    one THIS frame called)
   @param[in]  this_prologue_cache  Any cached prologue associated with THIS
                                    frame, which may therefore tell us about
                                    registers in the PREVIOUS frame.
   @param[in]  regnum               The register of interest in the PREVIOUS
                                    frame
   @param[out] optimizedp           True (1) if the register has been
                                    optimized out.
   @param[out] lvalp                What sort of l-value (if any) does the
                                    register represent
   @param[out] addrp                Address in THIS frame where the register's
                                    value may be found (-1 if not available)
   @param[out] realregp             Register in this frame where the
                                    register's value may be found (-1 if not
                                    available)
   @param[out] bufferp              If non-NULL, buffer where the value held
   in the register may be put */
/*--------------------------------------------------------------------------*/
 
static void
or1k_frame_prev_register (struct frame_info  *next_frame,
			  void              **this_prologue_cache,
			  int                 regnum,
			  int                *optimizedp,
			  enum lval_type     *lvalp,
			  CORE_ADDR          *addrp,
			  int                *realregp,
			  gdb_byte           *bufferp) 
{
  struct trad_frame_cache *info =
    or1k_frame_unwind_cache (next_frame, this_prologue_cache);
 
  trad_frame_get_register (info, next_frame, regnum, optimizedp, lvalp, addrp,
			   realregp, bufferp);
 
}	/* or1k_frame_prev_register() */
 
 
/*----------------------------------------------------------------------------*/
/*!Return the base address of the frame
 
   The commenting in the GDB source code could mean our stack pointer or our
   frame pointer, since we have a falling stack, but index within the frame
   using negative offsets from the FP.
 
   This seems to be the function used to determine the value of $fp, but the
   value required seems to be the stack pointer, so we return that, even if
   the value of $fp will be wrong.
 
   @param[in] next_frame            The NEXT frame (i.e. inner from here, the
                                    one THIS frame called)
   @param[in]  this_prologue_cache  Any cached prologue for THIS function.
 
   @return  The frame base address */
/*---------------------------------------------------------------------------*/
 
static CORE_ADDR
or1k_frame_base_address (struct frame_info  *next_frame,
			 void              **this_prologue_cache) 
{
  return  frame_unwind_register_unsigned (next_frame, OR1K_SP_REGNUM);
 
}	/* or1k_frame_base_address() */
 
 
/*----------------------------------------------------------------------------*/
/*!The OpenRISC 1000 registered frame sniffer
 
   This function just identifies our family of frame sniffing functions.
 
   @param[in] next_frame  The "next" (i.e. inner, newer from here, the one
                          THIS frame called) frame.
 
			  @return  A pointer to a struct identifying the sniffing functions */
/*---------------------------------------------------------------------------*/
 
static const struct frame_unwind *
or1k_frame_sniffer (struct frame_info *next_frame)
{
  static const struct frame_unwind or1k_frame_unwind = {
    .type          = NORMAL_FRAME,
    .this_id       = or1k_frame_this_id,
    .prev_register = or1k_frame_prev_register,
    .unwind_data   = NULL,
    .sniffer       = NULL,
    .prev_pc       = NULL,
    .dealloc_cache = NULL
  };
 
  return  &or1k_frame_unwind;
 
}	/* or1k_frame_sniffer() */
 
 
/*----------------------------------------------------------------------------*/
/*!Architecture initialization for OpenRISC 1000
 
   Looks for a candidate architecture in the list of architectures supplied
   using the info supplied. If none match, create a new architecture.
 
   @param[in] info    Information about the target architecture
   @param[in] arches  The list of currently know architectures
 
   @return  A structure describing the target architecture */
/*---------------------------------------------------------------------------*/
 
static struct gdbarch *
or1k_gdbarch_init (struct gdbarch_info  info,
		   struct gdbarch_list *arches) 
{
  static struct frame_base     or1k_frame_base;
  struct        gdbarch       *gdbarch;
  struct        gdbarch_tdep  *tdep;
  const struct  bfd_arch_info *binfo;
 
  /* Find a candidate among the list of pre-declared architectures.  */
  arches = gdbarch_list_lookup_by_info (arches, &info);
  if (NULL != arches)
    {
      return arches->gdbarch;
    }
 
  /* None found, create a new architecture from the information
     provided. Can't initialize all the target dependencies until we actually
     know which target we are talking to, but put in some defaults for now. */
 
  binfo                   = info.bfd_arch_info;
  tdep                    = xmalloc (sizeof *tdep);
  tdep->num_matchpoints   = OR1K_MAX_MATCHPOINTS;
  tdep->num_gpr_regs      = OR1K_MAX_GPR_REGS;
  tdep->bytes_per_word    = binfo->bits_per_word    / binfo->bits_per_byte;
  tdep->bytes_per_address = binfo->bits_per_address / binfo->bits_per_byte;
  gdbarch                 = gdbarch_alloc (&info, tdep);
 
  /* Target data types.  */
  set_gdbarch_short_bit             (gdbarch, 16);
  set_gdbarch_int_bit               (gdbarch, 32);
  set_gdbarch_long_bit              (gdbarch, 32);
  set_gdbarch_long_long_bit         (gdbarch, 64);
  set_gdbarch_float_bit             (gdbarch, 32);
  set_gdbarch_float_format          (gdbarch, floatformats_ieee_single);
  set_gdbarch_double_bit            (gdbarch, 64);
  set_gdbarch_double_format         (gdbarch, floatformats_ieee_double);
  set_gdbarch_long_double_bit       (gdbarch, 64);
  set_gdbarch_long_double_format    (gdbarch, floatformats_ieee_double);
  set_gdbarch_ptr_bit               (gdbarch, binfo->bits_per_address);
  set_gdbarch_addr_bit              (gdbarch, binfo->bits_per_address);
  set_gdbarch_char_signed           (gdbarch, 1);
 
  /* Information about the target architecture */
  set_gdbarch_return_value          (gdbarch, or1k_return_value);
  set_gdbarch_breakpoint_from_pc    (gdbarch, or1k_breakpoint_from_pc);
  set_gdbarch_single_step_through_delay
                                    (gdbarch, or1k_single_step_through_delay);
  set_gdbarch_have_nonsteppable_watchpoint
                                    (gdbarch, 1);
  switch (gdbarch_byte_order (gdbarch))
    {
    case BFD_ENDIAN_BIG:
      set_gdbarch_print_insn        (gdbarch, print_insn_big_or32);
      break;
 
    case BFD_ENDIAN_LITTLE:
      set_gdbarch_print_insn        (gdbarch, print_insn_little_or32);
      break;
 
    case BFD_ENDIAN_UNKNOWN:
      error ("or1k_gdbarch_init: Unknown endianism");
      break;
    }
 
  /* Register architecture */
  set_gdbarch_pseudo_register_read  (gdbarch, or1k_pseudo_register_read);
  set_gdbarch_pseudo_register_write (gdbarch, or1k_pseudo_register_write);
  set_gdbarch_num_regs              (gdbarch, OR1K_NUM_REGS);
  set_gdbarch_num_pseudo_regs       (gdbarch, OR1K_NUM_PSEUDO_REGS);
  set_gdbarch_sp_regnum             (gdbarch, OR1K_SP_REGNUM);
  set_gdbarch_pc_regnum             (gdbarch, OR1K_NPC_REGNUM);
  set_gdbarch_ps_regnum             (gdbarch, OR1K_SR_REGNUM);
  set_gdbarch_deprecated_fp_regnum  (gdbarch, OR1K_FP_REGNUM);
 
  /* Functions to supply register information */
  set_gdbarch_register_name         (gdbarch, or1k_register_name);
  set_gdbarch_register_type         (gdbarch, or1k_register_type);
  set_gdbarch_print_registers_info  (gdbarch, or1k_registers_info);
  set_gdbarch_register_reggroup_p   (gdbarch, or1k_register_reggroup_p);
 
  /* Functions to analyse frames */
  set_gdbarch_skip_prologue         (gdbarch, or1k_skip_prologue);
  set_gdbarch_inner_than            (gdbarch, core_addr_lessthan);
  set_gdbarch_frame_align           (gdbarch, or1k_frame_align);
  set_gdbarch_frame_red_zone_size   (gdbarch, OR1K_FRAME_RED_ZONE_SIZE);
 
  /* Functions to access frame data */
  set_gdbarch_unwind_pc             (gdbarch, or1k_unwind_pc);
  set_gdbarch_unwind_sp             (gdbarch, or1k_unwind_sp);
 
  /* Functions handling dummy frames */
  set_gdbarch_push_dummy_call       (gdbarch, or1k_push_dummy_call);
  set_gdbarch_unwind_dummy_id       (gdbarch, or1k_unwind_dummy_id);
 
  /* High level frame base sniffer */
  or1k_frame_base.unwind      = or1k_frame_sniffer (NULL);
  or1k_frame_base.this_base   = or1k_frame_base_address;
  or1k_frame_base.this_locals = or1k_frame_base_address;
  or1k_frame_base.this_args   = or1k_frame_base_address;
  frame_base_set_default            (gdbarch, &or1k_frame_base);
 
  /* Low level frame sniffers */
  frame_unwind_append_sniffer       (gdbarch, dwarf2_frame_sniffer);
  frame_unwind_append_sniffer       (gdbarch, or1k_frame_sniffer);
 
 
  return gdbarch;
 
}	/* or1k_gdbarch_init() */
 
 
/*----------------------------------------------------------------------------*/
/*!Dump the target specific data for this architecture
 
   @param[in] gdbarch  The architecture of interest
   @param[in] file     Where to dump the data */
/*---------------------------------------------------------------------------*/
 
static void
or1k_dump_tdep (struct gdbarch *gdbarch,
		struct ui_file *file) 
{
  struct gdbarch_tdep *tdep = gdbarch_tdep (gdbarch);
 
  if (NULL == tdep)
    {
      return;			/* Nothing to report */
    }
 
  fprintf_unfiltered (file, "or1k_dump_tdep: %d matchpoints available\n",
		      tdep->num_matchpoints);
  fprintf_unfiltered (file, "or1k_dump_tdep: %d general purpose registers\n",
		      tdep->num_gpr_regs);
  fprintf_unfiltered (file, "or1k_dump_tdep: %d bytes per word\n",
		      tdep->bytes_per_word);
  fprintf_unfiltered (file, "or1k_dump_tdep: %d bytes per address\n",
		      tdep->bytes_per_address);
 
}	/* or1k_dump_tdep() */
 
 

/* Functions to add extra commands to GDB */
 
 
/*----------------------------------------------------------------------------*/
/*!Returns a special purpose register group name
 
   @param[in]  group  The SPR group number
 
   @return  The SPR name (pointer to the name argument) */
/*---------------------------------------------------------------------------*/
 
static const char *
or1k_spr_group_name (int  group) 
{
  static const char *or1k_group_names[OR1K_NUM_SPGS] =
    {
      "SYS",
      "DMMU",
      "IMMU",
      "DCACHE",
      "ICACHE",
      "MAC",
      "DEBUG",
      "PERF",
      "POWER",
      "PIC",
      "TIMER",
      "FPU"
    };
 
  if ((0 <= group) && (group < OR1K_NUM_SPGS))
    {
      return or1k_group_names[group];
    }
  else
    {
      return "";
    }
}	/* or1k_spr_group_name() */
 
 
/*----------------------------------------------------------------------------*/
/*!Returns a special purpose register name
 
   @param[in]  group  The SPR group
   @param[in]  index  The index within the SPR group
   @param[out] name   Array to put the name in
 
   @return  The SPR name (pointer to the name argument) */
/*---------------------------------------------------------------------------*/
 
static char *
or1k_spr_register_name (int   group,
			int   index,
			char *name) 
{
  char di;
 
  switch (group)
    {
 
    case OR1K_SPG_SYS:
      /* 1:1 names */
      switch (index)
	{
	case OR1K_SPG_SYS_VR:       sprintf (name, "VR"      ); return  name;
	case OR1K_SPG_SYS_UPR:      sprintf (name, "UPR"     ); return  name;
	case OR1K_SPG_SYS_CPUCFGR:  sprintf (name, "CPUCFGR" ); return  name;
	case OR1K_SPG_SYS_DMMUCFGR: sprintf (name, "DMMUCFGR"); return  name;
	case OR1K_SPG_SYS_IMMUCFGR: sprintf (name, "IMMUCFGR"); return  name;
	case OR1K_SPG_SYS_DCCFGR:   sprintf (name, "DCCFGR"  ); return  name;
	case OR1K_SPG_SYS_ICCFGR:   sprintf (name, "ICCFGR"  ); return  name;
	case OR1K_SPG_SYS_DCFGR:    sprintf (name, "DCFGR"   ); return  name;
	case OR1K_SPG_SYS_PCCFGR:   sprintf (name, "PCCFGR"  ); return  name;
	case OR1K_SPG_SYS_NPC:      sprintf (name, "NPC"     ); return  name;
	case OR1K_SPG_SYS_SR:       sprintf (name, "SR"      ); return  name;
	case OR1K_SPG_SYS_PPC:      sprintf (name, "PPC"     ); return  name;
	case OR1K_SPG_SYS_FPCSR:    sprintf (name, "FPCSR"   ); return  name;
	}
 
      /* Exception PC regs */
      if((OR1K_SPG_SYS_EPCR <= index) &&
	 (index             <= OR1K_SPG_SYS_EPCR_END))
	{
	  sprintf (name, "EPCR%d", index - OR1K_SPG_SYS_EPCR);
	  return  name;
	}
 
      /* Exception EA regs */
      if((OR1K_SPG_SYS_EEAR <= index) &&
	 (index             <= OR1K_SPG_SYS_EEAR_END))
	{
	  sprintf (name, "EEAR%d", index - OR1K_SPG_SYS_EEAR);
	  return  name;
	}
 
      /* Exception SR regs */
      if((OR1K_SPG_SYS_ESR <= index) &&
	 (index            <= OR1K_SPG_SYS_ESR_END))
	{
	  sprintf (name, "ESR%d", index - OR1K_SPG_SYS_ESR);
	  return  name;
	}
 
      /* GPRs */
      if((OR1K_SPG_SYS_GPR <= index) &&
	 (index            <= OR1K_SPG_SYS_GPR_END))
	{
	  sprintf (name, "GPR%d", index - OR1K_SPG_SYS_GPR);
	  return  name;
	}
 
      break;
 
    case OR1K_SPG_DMMU:
    case OR1K_SPG_IMMU:
      /* MMU registers. Use DMMU constants throughout, but these are identical
	 to the corresponding IMMU constants */
      di = OR1K_SPG_DMMU == group ? 'D' : 'I';
 
      /* 1:1 names */
      switch (index)
	{
	case OR1K_SPG_DMMU_DMMUCR:
	  sprintf (name, "%cMMUCR",  di); return  name;
	case OR1K_SPG_DMMU_DMMUPR:
	  sprintf (name, "%cMMUPR",  di); return  name;
	case OR1K_SPG_DMMU_DTLBEIR:
	  sprintf (name, "%cTLBEIR", di); return  name;
	}
 
      /* ATB Match registers */
      if((OR1K_SPG_DMMU_DATBMR <= index) &&
	 (index                <= OR1K_SPG_DMMU_DATBMR_END))
	{
	  sprintf (name, "%cATBMR%d", di, index - OR1K_SPG_DMMU_DATBMR);
	  return  name;
	}
 
      /* ATB Translate registers */
      if((OR1K_SPG_DMMU_DATBTR <= index) &&
	 (index                <= OR1K_SPG_DMMU_DATBTR_END))
	{
	  sprintf (name, "%cATBTR%d", di, index - OR1K_SPG_DMMU_DATBTR);
	  return  name;
	}
 
      /* TLB Way 1 Match registers */
      if((OR1K_SPG_DMMU_DTLBW1MR <= index) &&
	 (index                <= OR1K_SPG_DMMU_DTLBW1MR_END))
	{
	  sprintf (name, "%cTLBW1MR%d", di, index - OR1K_SPG_DMMU_DTLBW1MR);
	  return  name;
	}
 
      /* TLB Way 1 Translate registers */
      if((OR1K_SPG_DMMU_DTLBW1TR <= index) &&
	 (index                <= OR1K_SPG_DMMU_DTLBW1TR_END))
	{
	  sprintf (name, "%cTLBW1TR%d", di, index - OR1K_SPG_DMMU_DTLBW1TR);
	  return  name;
	}
 
      /* TLB Way 2 Match registers */
      if((OR1K_SPG_DMMU_DTLBW2MR <= index) &&
	 (index                <= OR1K_SPG_DMMU_DTLBW2MR_END))
	{
	  sprintf (name, "%cTLBW2MR%d", di, index - OR1K_SPG_DMMU_DTLBW2MR);
	  return  name;
	}
 
      /* TLB Way 2 Translate registers */
      if((OR1K_SPG_DMMU_DTLBW2TR <= index) &&
	 (index                <= OR1K_SPG_DMMU_DTLBW2TR_END))
	{
	  sprintf (name, "%cTLBW2TR%d", di, index - OR1K_SPG_DMMU_DTLBW2TR);
	  return  name;
	}
 
      /* TLB Way 3 Match registers */
      if((OR1K_SPG_DMMU_DTLBW3MR <= index) &&
	 (index                <= OR1K_SPG_DMMU_DTLBW3MR_END))
	{
	  sprintf (name, "%cTLBW3MR%d", di, index - OR1K_SPG_DMMU_DTLBW3MR);
	  return  name;
	}
 
      /* TLB Way 3 Translate registers */
      if((OR1K_SPG_DMMU_DTLBW3TR <= index) &&
	 (index                <= OR1K_SPG_DMMU_DTLBW3TR_END))
	{
	  sprintf (name, "%cTLBW3TR%d", di, index - OR1K_SPG_DMMU_DTLBW3TR);
	  return  name;
	}
 
      break;
 
    case OR1K_SPG_DC:
      /* Data cache registers. These do not have an exact correspondence with
	 their instruction cache counterparts, so must be done separately. */
 
      /* 1:1 names */
      switch (index)
	{
	case OR1K_SPG_DC_DCCR:  sprintf (name, "DCCR" ); return  name;
	case OR1K_SPG_DC_DCBPR: sprintf (name, "DCBPR"); return  name;
	case OR1K_SPG_DC_DCBFR: sprintf (name, "DCBFR"); return  name;
	case OR1K_SPG_DC_DCBIR: sprintf (name, "DCBIR"); return  name;
	case OR1K_SPG_DC_DCBWR: sprintf (name, "DCBWR"); return  name;
	case OR1K_SPG_DC_DCBLR: sprintf (name, "DCBLR"); return  name;
	}
 
      break;
 
    case OR1K_SPG_IC:
      /* Instruction cache registers */
 
      /* 1:1 names */
      switch (index)
	{
	case OR1K_SPG_IC_ICCR:  sprintf (name, "ICCR" ); return  name;
	case OR1K_SPG_IC_ICBPR: sprintf (name, "ICBPR"); return  name;
	case OR1K_SPG_IC_ICBIR: sprintf (name, "ICBIR"); return  name;
	case OR1K_SPG_IC_ICBLR: sprintf (name, "ICBLR"); return  name;
	}
 
      break;
 
    case OR1K_SPG_MAC:
      /* MAC registers */
 
      /* 1:1 names */
      switch (index)
	{
	case OR1K_SPG_MAC_MACLO: sprintf (name, "MACLO"); return  name;
	case OR1K_SPG_MAC_MACHI: sprintf (name, "MACHI"); return  name;
	}
 
      break;
 
    case OR1K_SPG_DEBUG:
      /* Debug registers */
 
      /* Debug Value registers */
      if((OR1K_SPG_DEBUG_DVR <= index) &&
	 (index                <= OR1K_SPG_DEBUG_DVR_END))
	{
	  sprintf (name, "DVR%d", index - OR1K_SPG_DEBUG_DVR);
	  return  name;
	}
 
      /* Debug Control registers */
      if((OR1K_SPG_DEBUG_DCR <= index) &&
	 (index                <= OR1K_SPG_DEBUG_DCR_END))
	{
	  sprintf (name, "DCR%d", index - OR1K_SPG_DEBUG_DCR);
	  return  name;
	}
 
      /* 1:1 names */
      switch (index)
	{
	case OR1K_SPG_DEBUG_DMR1:  sprintf (name, "DMR1" ); return  name;
	case OR1K_SPG_DEBUG_DMR2:  sprintf (name, "DMR2" ); return  name;
	case OR1K_SPG_DEBUG_DCWR0: sprintf (name, "DCWR0"); return  name;
	case OR1K_SPG_DEBUG_DCWR1: sprintf (name, "DCWR1"); return  name;
	case OR1K_SPG_DEBUG_DSR:   sprintf (name, "DSR"  ); return  name;
	case OR1K_SPG_DEBUG_DRR:   sprintf (name, "DRR"  ); return  name;
	}
 
      break;
 
    case OR1K_SPG_PC:
      /* Performance Counter registers */
 
      /* Performance Counters Count registers */
      if((OR1K_SPG_PC_PCCR <= index) &&
	 (index                <= OR1K_SPG_PC_PCCR_END))
	{
	  sprintf (name, "PCCR%d", index - OR1K_SPG_PC_PCCR);
	  return  name;
	}
 
      /* Performance Counters Mode registers */
      if((OR1K_SPG_PC_PCMR <= index) &&
	 (index                <= OR1K_SPG_PC_PCMR_END))
	{
	  sprintf (name, "PCMR%d", index - OR1K_SPG_PC_PCMR);
	  return  name;
	}
 
      break;
 
    case OR1K_SPG_PM:
      /* Power Management registers */
 
      /* 1:1 names */
      switch (index)
	{
	case OR1K_SPG_PM_PMR:  sprintf (name, "PMR"); return  name;
	}
 
      break;
 
    case OR1K_SPG_PIC:
      /* Programmable Interrupt Controller registers */
 
      /* 1:1 names */
      switch (index)
	{
	case OR1K_SPG_PIC_PICMR:  sprintf (name, "PICMR"); return  name;
	case OR1K_SPG_PIC_PICSR:  sprintf (name, "PICSR"); return  name;
	}
 
      break;
 
    case OR1K_SPG_TT:
      /* Tick Timer registers */
 
      /* 1:1 names */
      switch (index)
	{
	case OR1K_SPG_TT_TTMR:  sprintf (name, "TTMR"); return  name;
	case OR1K_SPG_TT_TTCR:  sprintf (name, "TTCR"); return  name;
	}
 
      break;
 
    case OR1K_SPG_FPU:
 
      break;
    }
 
  /* Not a recognized register */
  strcpy (name, "");
  return  name;
 
}	/* or1k_spr_register_name() */
 
 
/*----------------------------------------------------------------------------*/
/*!Get SPR group number from a name
 
   @param[in] group_name  SPR register group
 
   @return  The index, or negative if no match. */
/*----------------------------------------------------------------------------*/
 
static int
or1k_groupnum_from_name (char *group_name) 
{
  int  group;
 
  for (group = 0; group < OR1K_NUM_SPGS; group++)
    {
      if (0 == strcasecmp (group_name, or1k_spr_group_name (group)))
	{
	  return group;
	}
    }
 
  return -1;
 
}	/* or1k_groupnum_from_name() */
 
 
/*----------------------------------------------------------------------------*/
/*!Get register index in special purpose register group from name
 
   The name may either be SPR<group_num>_<index> or a known unique name. In
   either case the group number must match the supplied group number.
 
   @param[in] group  SPR register group
   @param[in] name   Register name
 
   @return  The index, or negative if no match. */
/*----------------------------------------------------------------------------*/
 
static int
or1k_regnum_from_name (int   group,
		       char *name) 
{
  /* Last valid register in each group. */
  static const int  or1k_spr_group_last[OR1K_NUM_SPGS] =
    {
      OR1K_SPG_SYS_LAST,
      OR1K_SPG_DMMU_LAST,
      OR1K_SPG_IMMU_LAST,
      OR1K_SPG_DC_LAST,
      OR1K_SPG_IC_LAST,
      OR1K_SPG_MAC_LAST,
      OR1K_SPG_DEBUG_LAST,
      OR1K_SPG_PC_LAST,
      OR1K_SPG_PM_LAST,
      OR1K_SPG_PIC_LAST,
      OR1K_SPG_TT_LAST,
      OR1K_SPG_FPU_LAST
    };
 
  int  i;
  char  spr_name[32];
 
  if (0 == strcasecmp (name, "SPR"))
    {
      char *ptr_c;      
 
      /* Skip SPR */
      name += 3;
 
      /* Get group number */
      i = (int) strtoul (name, &ptr_c, 10);
      if (*ptr_c != '_' || i != group)
	{
	  return -1;
	}
 
      /* Get index */
      ptr_c++;
      i = (int) strtoul (name, &ptr_c, 10);
      if (*ptr_c)
	{
	  return -1;
	}
      else
	{
	  return  i;
	}
    }
 
  /* Look for a "known" name in this group */
  for (i = 0; i <= or1k_spr_group_last[group]; i++)
    {
      char *s = or1k_spr_register_name (group, i, spr_name);
 
      if (0 == strcasecmp (name, s))
	{
	  return i;
	}
    }
 
  /* Failure */
  return -1;
 
}	/* or1k_regnum_from_name() */
 
 
/*----------------------------------------------------------------------------*/
/*!Get the next token from a string
 
   I can't believe there isn't a library argument for this, but strtok is
   deprecated.
 
   Take a string and find the start of the next token and its length. A token
   is anything containing non-blank characters.
 
   @param[in]  str  The string to look at (may be NULL).
   @param[out] tok  Pointer to the start of the token within str. May be NULL
                    if this result is not wanted (e.g. just the length is
		    wanted. If no token is found will be the NULL char at the
		    end of the string, if the original str was NULL, this will
		    be NULL.
 
		    @return  The length of the token found */
/*----------------------------------------------------------------------------*/
 
static int
or1k_tokenize (char  *str,
	       char **tok) 
{
  char *ptr;
  int   len;
 
  /* Deal with NULL argument */
  if (NULL == str)
    {
      if (NULL != tok)
	{
	  *tok = NULL;
	}
      return 0;
    }
 
  /* Find the start */
  for (ptr = str; ISBLANK (*ptr) ; ptr++)
    {
      continue;
    }
 
  /* Return the start pointer if requested */
  if (NULL != tok)
    {
      *tok = ptr;
    }
 
  /* Find the end and put in EOS */
  for (len = 0;  ('\0' != ptr[len]) && (!ISBLANK (ptr[len])); len++)
    {
      continue;
    }
 
  return len;
 
}	/* or1k_tokenize() */
 
 
/*----------------------------------------------------------------------------*/
/*!Parses args for spr commands
 
   Determines the special purpose register (SPR) name and puts result into
   group and index
 
   Syntax is:
 
   @verbatim
   <spr_args>    -> <group_ref> | <reg_name>
   <group_ref>   -> <group_id> <index>
   <group_id>    -> <group_num> | <group_name>
   @endverbatim
 
   Where the indices/names have to be valid.
 
   So to parse, we look for 1 or 2 args. If 1 it must be a unique register
   name. If 2, the first must be a group number or name and the second an
   index within that group.
 
   Also responsible for providing diagnostics if the arguments do not match.
 
   Rewritten for GDB 6.8 to use the new UI calls and remove assorted
   bugs. Syntax also slightly restricted to be more comprehensible.
 
   @param[in]  arg_str  The argument string
   @param[out] group    The group this SPR belongs in, or -1 to indicate
                        failure
   @param[out] index    Index of the register within the group, or -1 to
                        indicate the whole group
   @param[in]  is_set   1 (true) if we are called from the "spr" command (so
                        there is an extra arg) rather than the "info spr"
                        command. Needed to distinguish between the case where
                        info is sought from a register specified as group and
                        index and setting a uniquely identified register to a
                        value.
 
			@return  A pointer to any remaining args */
/*---------------------------------------------------------------------------*/
 
static char *
or1k_parse_spr_params (char *arg_str,
		       int  *group,
		       int  *index,
		       int   is_set) 
{
  struct {
    char              *str;
    int                len;
    unsigned long int  val;
    int                is_num;
  } arg[3] = {
    {
      .str    = NULL,
      .len    = 0,
      .val    = 0,
      .is_num = 0,
    },
   {
      .str    = NULL,
      .len    = 0,
      .val    = 0,
      .is_num = 0,
    },
   {
      .str    = NULL,
      .len    = 0,
      .val    = 0,
      .is_num = 0,
    }
  };
 
  int   num_args;
  char *trailer  = arg_str;
  char *tmp_str;
  int   i;
 
  char  spr_name[32];
 
  /* Break out the arguments. Note that the strings are NOT null terminated
     (we don't want to change arg_str), so we must rely on len. The stroul
     call will still work, since there is always a non-digit char (possibly EOS)
     after the last digit. */
  if (NULL == arg_str)
    {
      num_args = 0;
    }
  else
    {
      for (num_args = 0; num_args < 3; num_args++)
	{
	  arg[num_args].len = or1k_tokenize (trailer, &(arg[num_args].str));
	  trailer           = arg[num_args].str + arg[num_args].len;
 
	  if (0 == arg[num_args].len)
	    {
	      break;
	    }
	}
    }
 
  /* Patch nulls into the arg strings and see about values. Couldn't do this
     earlier, since we needed the next char clean to check later args. This
     means advancing trailer, UNLESS it was already at EOS */
 
  if((NULL != arg_str) && ('\0' != *trailer))
    {
      trailer++;
    }
 
  for (i = 0; i < num_args; i++)
    {
      (arg[i].str)[arg[i].len] = '\0';
      errno                    = 0;
      arg[i].val               = strtoul (arg[i].str, &tmp_str, 0);
      arg[i].is_num            = (0 == errno) && ('\0' == *tmp_str);
    }
 
  /* Deal with the case where we are setting a register, so the final argument
     should be disregarded (it is the trailer). Do this anyway if we get a
     third argument */
  if ((is_set & (num_args > 0)) || (num_args > 2))
    {
      trailer = arg[num_args - 1].str;
      num_args--;
    }
 
  /* Deal with different numbers of args */
 
  switch (num_args)
    {
 
    case 0:
      ui_out_message (uiout, 0,
		      "Usage: <command> <register>      |\n"
		      "       <command> <group>         |\n"
		      "       <command> <group> <index>\n"
		      "Valid groups are:\n");
      for (i = 0; i < OR1K_NUM_SPGS; i++)
	{
	  ui_out_field_string (uiout, NULL, or1k_spr_group_name  (i));
	  ui_out_spaces (uiout, 1);
	  ui_out_wrap_hint (uiout, NULL);
	}
      ui_out_field_string (uiout, NULL, "\n");
 
      *index = -1;
      return  trailer;
 
    case 1:
      /* See if it is a numeric group */
      if (arg[0].is_num)
	{
	  if (arg[0].val < OR1K_NUM_SPGS)
	    {
	      *group = arg[0].val;
	      *index = -1;
	      return trailer;
	    }
	  else
	    {
	      ui_out_message (uiout, 0,
			      "Group index should be in the range 0 - %d\n",
			      OR1K_NUM_SPGS);
	      *group = -1;
	      *index = -1;
	      return trailer;
	    }
	}	
 
      /* Is is it a group name? */
      *group = or1k_groupnum_from_name (arg[0].str);
      if (*group >= 0)
	{
	  *index = -1;
	  return trailer;
	}
 
      /* See if it is a valid register name in any group */
      for (*group = 0; *group < OR1K_NUM_SPGS; (*group)++)
	{
	  *index = or1k_regnum_from_name (*group, arg[0].str);
 
	  if (*index >= 0)
	    {
	      return  trailer;
	    }
	}
 
      /* Couldn't find it - print out a rude message */
      ui_out_message (uiout, 0,
		      "Group or register name not recognized.\n"
		      "Valid groups are:\n");
      for (i = 0; i < OR1K_NUM_SPGS; i++)
	{
	  ui_out_field_string (uiout, NULL, or1k_spr_group_name (i));
	  ui_out_spaces (uiout, 1);
	  ui_out_wrap_hint (uiout, NULL);
	}
      ui_out_field_string (uiout, NULL, "\n");
 
      *group = -1;
      *index = -1;
      return  trailer;
 
    case 2:
      /* See if first arg is a numeric group */
      if (arg[0].is_num)
	{
	  if (arg[0].val < OR1K_NUM_SPGS)
	    {
	      *group = arg[0].val;
	      *index = -1;
	    }
	  else
	    {
	      ui_out_message (uiout, 0,
			      "Group index should be in the range 0 - %d\n",
			      OR1K_NUM_SPGS - 1);
	      *group = -1;
	      *index = -1;
	      return trailer;
	    }
	}	
      else
	{
	  /* Is is it a group name? */
	  *group = or1k_groupnum_from_name (arg[0].str);
	  if (*group >= 0)
	    {
	      *index = -1;
	    }
	  else
	    {
	      ui_out_message (uiout, 0,
			      "Group name not recognized.\n"
			      "Valid groups are:\n");
	      for (i = 0; i < OR1K_NUM_SPGS; i++)
		{
		  ui_out_field_string (uiout, NULL, or1k_spr_group_name (i));
		  ui_out_spaces (uiout, 1);
		  ui_out_wrap_hint (uiout, NULL);
		}
	      ui_out_field_string (uiout, NULL, "\n");
 
	      *group = -1;
	      *index = -1;
	      return  trailer;
	    }
	}
 
      /* Is second arg an index or name? */
      if (arg[1].is_num)
	{
	  if (arg[1].val < OR1K_SPG_SIZE)
	    {
	      /* Check this really is a register */
	      if (0 != strlen (or1k_spr_register_name (*group, arg[1].val,
						       spr_name)))
		{
		  *index = arg[1].val;
		  return trailer;
		}
	      else
		{
		  ui_out_message (uiout, 0,
				  "No valid register at that index in group\n");
		  *group = -1;
		  *index = -1;
		  return  trailer;
		}
	    }
	  else
	    {
	      ui_out_message (uiout, 0,
			      "Register index should be in the range 0 - %d\n",
			      OR1K_SPG_SIZE - 1);
	      *group = -1;
	      *index = -1;
	      return  trailer;
	    }
	}
 
      /* Must be a name */
      *index = or1k_regnum_from_name (*group, arg[1].str);
 
      if (*index >= 0)
	{
	  return trailer;
	}
 
      /* Couldn't find it - print out a rude message */
      ui_out_message (uiout, 0, "Register name not recognized in group.\n");
      *group = -1;
      *index = -1;
      return  trailer;
 
    default:
      /* Anything else is an error */
      ui_out_message (uiout, 0, "Unable to parse arguments\n");
      *group = -1;
      *index = -1;
      return  trailer;
    }
}	/* or1k_parse_spr_params() */
 
 
/*---------------------------------------------------------------------------*/
/*!Read a special purpose register from the target
 
   This has to be done using the target remote command "readspr"
 
   @param[in] regnum  The register to read
 
   @return  The value read */
/*---------------------------------------------------------------------------*/
 
static ULONGEST
or1k_read_spr (unsigned int  regnum) 
{
  struct ui_file    *uibuf = mem_fileopen ();
  char               cmd[sizeof ("readspr ffff")];
  unsigned long int  data;
  char              *res;
  long int           len;
 
  /* Create the command string and pass it to target remote command function */
  sprintf (cmd, "readspr %4x", regnum);
  target_rcmd (cmd, uibuf);
 
  /* Get the output for the UI file as a string */
  res = ui_file_xstrdup (uibuf, &len);
  sscanf (res, "%lx", &data);
 
  /* Tidy up */
  xfree (res);
  ui_file_delete (uibuf);
 
  return  (ULONGEST)data;
 
}	/* or1k_read_spr() */
 
 
/*---------------------------------------------------------------------------*/
/*!Write a special purpose register on the target
 
   This has to be done using the target remote command "writespr"
 
   Since the SPRs may map to GPR's or the other GDB register (PPC, NPC, SR),
   any register cache is flushed.
 
   @param[in] regnum  The register to write
   @param[in] data  The value to write */
/*---------------------------------------------------------------------------*/
 
static void
or1k_write_spr (unsigned int  regnum,
		ULONGEST      data) 
{
  struct ui_file    *uibuf = mem_fileopen ();
  char               cmd[sizeof ("writespr ffff ffffffff")];
  char              *res;
  long int           len;
 
  /* Create the command string and pass it to target remote command function */
  sprintf (cmd, "writespr %4x %8llx", regnum, (long long unsigned int)data);
  target_rcmd (cmd, uibuf);
 
  /* Flush the register cache */
  registers_changed ();
 
  /* We ignore the result - Rcmd can put out its own error messages. Just
     tidy up */
  ui_file_delete (uibuf);
 
}	/* or1k_write_spr() */
 
 
/*----------------------------------------------------------------------------*/
/*!Show the value of a special purpose register or group
 
   This is a custom extension to the GDB info command.
 
   @param[in] args
   @param[in] from_tty  True (1) if GDB is running from a TTY, false (0)
   otherwise. */
/*---------------------------------------------------------------------------*/
 
static void
or1k_info_spr_command (char *args,
		       int   from_tty) 
{
  int  group;
  int  index;
 
  char  spr_name[32];
 
  or1k_parse_spr_params (args, &group, &index, 0);
 
  if (group < 0)
    {
      return;			/* Couldn't parse the args */
    }
 
  if (index >= 0)
    {
      ULONGEST  value = or1k_read_spr (OR1K_SPR (group, index));
 
      ui_out_field_fmt (uiout, NULL, "%s.%s = SPR%i_%i = %llu (0x%llx)\n",
			or1k_spr_group_name (group), 
			or1k_spr_register_name (group, index, spr_name), group,
			index, (long long unsigned int)value, (long long unsigned int)value);
    }
  else
    {
      /* Print all valid registers in the group */
      for (index = 0; index < OR1K_SPG_SIZE; index++)
	{
	  if (0 != strlen (or1k_spr_register_name (group, index, spr_name)))
	    {
	      ULONGEST  value = or1k_read_spr (OR1K_SPR (group, index));
 
	      ui_out_field_fmt (uiout, NULL,
				"%s.%s = SPR%i_%i = %llu (0x%llx)\n",
				or1k_spr_group_name (group),
				or1k_spr_register_name (group, index, spr_name),
				group, index, (long long unsigned int)value, (long long unsigned int)value);
	    }
	}
    }
}	/* or1k_info_spr_command() */
 
 
/*----------------------------------------------------------------------------*/
/*!Set a special purpose register
 
   This is a custom command added to GDB.
 
   @param[in] args
   @param[in] from_tty  True (1) if GDB is running from a TTY, false (0)
   otherwise. */
/*---------------------------------------------------------------------------*/
 
static void
or1k_spr_command (char *args,
		  int   from_tty) 
{
  int   group;
  int   index;
  char *tmp_str;
  char *nargs = or1k_parse_spr_params (args, &group, &index, 1);
 
  ULONGEST  old_val;
  ULONGEST  new_val;
 
  char  spr_name[32];
 
  /* Do we have a valid register spec? */
  if (index < 0)
    {
      return;		/* Parser will have printed the error message */
    }
 
  /* Do we have a value to set? */
 
  errno = 0;
  new_val = (ULONGEST)strtoul (nargs, &tmp_str, 0);
 
  if((0 != errno) || ('\0' != *tmp_str))
    {
      ui_out_message (uiout, 0, "Invalid value - register not changed\n");
      return;
    }
 
  old_val = or1k_read_spr (OR1K_SPR (group, index));
 
  or1k_write_spr (OR1K_SPR (group, index) , new_val);
 
  ui_out_field_fmt (uiout, NULL,
		    "%s.%s (SPR%i_%i) set to %llu (0x%llx), "
		    "was: %llu (0x%llx)\n",
		    or1k_spr_group_name (group),
		    or1k_spr_register_name (group, index, spr_name) , group,
		    index, (long long unsigned int)new_val, (long long unsigned int)new_val, (long long unsigned int)old_val, (long long unsigned int)old_val);
 
}	/* or1k_spr_command() */
 
 
/*----------------------------------------------------------------------------*/
/*!Main entry point for target architecture initialization
 
   In this version initializes the architecture via
   registers_gdbarch_init(). Add a command to set and show special purpose
   registers. */
/*---------------------------------------------------------------------------*/
 
void
_initialize_or1k_tdep (void) 
{
  /* Register this architecture. We should do this for or16 and or64 when
     they have their BFD defined. */
  gdbarch_register (bfd_arch_or32, or1k_gdbarch_init, or1k_dump_tdep);
 
  /* Initialize the automata for the assembler */
  build_automata();
 
  /* Commands to show and set special purpose registers */
  add_info ("spr", or1k_info_spr_command,
	    "Show the value of a special purpose register");
  add_com ("spr", class_support, or1k_spr_command,
	   "Set a special purpose register");
 
}	/* _initialize_or1k_tdep() */
 

Go to most recent revision | Compare with Previous | Blame | View Log

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.