gdb/dwarf2cfi.h

   1 /* Stack unwinding code based on dwarf2 frame info for GDB, the GNU debugger.
   2    Copyright 2001
   3    Free Software Foundation, Inc.
   4
   5    This file is part of GDB.
   6
   7    This program is free software; you can redistribute it and/or modify
   8    it under the terms of the GNU General Public License as published by
   9    the Free Software Foundation; either version 2 of the License, or
  10    (at your option) any later version.
  11
  12    This program is distributed in the hope that it will be useful,
  13    but WITHOUT ANY WARRANTY; without even the implied warranty of
  14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15    GNU General Public License for more details.
  16
  17    You should have received a copy of the GNU General Public License
  18    along with this program; if not, write to the Free Software
  19    Foundation, Inc., 59 Temple Place - Suite 330,
  20    Boston, MA 02111-1307, USA.  */
  21
  22 #ifndef DWARF2CFI_H
  23 #define DWARF2CFI_H
  24
  25 struct frame_info;
  26
  27 struct context_reg
  28 {
  29   union
  30   {
  31     unsigned int reg;
  32     long offset;
  33     CORE_ADDR addr;
  34   }
  35   loc;
  36   enum
  37   {
  38     REG_CTX_UNSAVED,
  39     REG_CTX_SAVED_OFFSET,
  40     REG_CTX_SAVED_REG,
  41     REG_CTX_SAVED_ADDR,
  42     REG_CTX_VALUE,
  43   }
  44   how;
  45 };
  46
  47 /* This is the register and unwind state for a particular frame.  */
  48 struct context
  49 {
  50   struct context_reg *reg;
  51
  52   CORE_ADDR cfa;
  53   CORE_ADDR ra;
  54   void *lsda;
  55   int args_size;
  56 };
  57
  58 /* Return the frame address.  */
  59 CORE_ADDR cfi_read_fp ();
  60
  61 /* Store the frame address.  */
  62 void cfi_write_fp (CORE_ADDR val);
  63
  64 /* Restore the machine to the state it had before the current frame
  65    was created.  */
  66 void cfi_pop_frame (struct frame_info *);
  67
  68 /* Determine the address of the calling function's frame.  */
  69 CORE_ADDR cfi_frame_chain (struct frame_info *fi);
  70
  71 /* Sets the pc of the frame.  */
  72 CORE_ADDR cfi_init_frame_pc (int fromleaf, struct frame_info *fi);
  73
  74 /* Initialize unwind context informations of the frame.  */
  75 void cfi_init_extra_frame_info (int fromleaf, struct frame_info *fi);
  76
  77 /* Obtain return address of the frame.  */
  78 CORE_ADDR cfi_get_ra (struct frame_info *fi);
  79
  80 /* Find register number REGNUM relative to FRAME and put its
  81    (raw) contents in *RAW_BUFFER.  Set *OPTIMIZED if the variable
  82    was optimized out (and thus can't be fetched).  If the variable
  83    was fetched from memory, set *ADDRP to where it was fetched from,
  84    otherwise it was fetched from a register.
  85
  86    The argument RAW_BUFFER must point to aligned memory.  */
  87 void cfi_get_saved_register (char *raw_buffer,
  88                              int *optimized,
  89                              CORE_ADDR *addrp,
  90                              struct frame_info *frame,
  91                              int regnum, enum lval_type *lval);
  92
  93 /*  Return the register that the function uses for a frame pointer,
  94     plus any necessary offset to be applied to the register before
  95     any frame pointer offsets.  */
  96 void cfi_virtual_frame_pointer (CORE_ADDR pc, int *frame_regnum,
  97                                 LONGEST * frame_offset);
  98
  99 struct context *context_alloc ();
 100 void context_cpy (struct context *dst, struct context *src);
 101 struct frame_state *frame_state_alloc ();
 102 #endif