#!/bin/sh -u

# Architecture commands for GDB, the GNU debugger.

#

# Copyright (C) 1998-2018 Free Software Foundation, Inc.

#

# 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/>.

# Make certain that the script is not running in an internationalized

# environment.

LANG=C ; export LANG

LC_ALL=C ; export LC_ALL

compare_new ()

{

    file=$1

    if test ! -r ${file}

    then

	echo "${file} missing? cp new-${file} ${file}" 1>&2

    elif diff -u ${file} new-${file}

    then

	echo "${file} unchanged" 1>&2

    else

	echo "${file} has changed? cp new-${file} ${file}" 1>&2

    fi

}

# Format of the input table

read="class returntype function formal actual staticdefault predefault postdefault invalid_p print garbage_at_eol"

do_read ()

{

    comment=""

    class=""

    # On some SH's, 'read' trims leading and trailing whitespace by

    # default (e.g., bash), while on others (e.g., dash), it doesn't.

    # Set IFS to empty to disable the trimming everywhere.

    while IFS='' read line

    do

	if test "${line}" = ""

	then

	    continue

	elif test "${line}" = "#" -a "${comment}" = ""

	then

	    continue

	elif expr "${line}" : "#" > /dev/null

	then

	    comment="${comment}

${line}"

	else

	    # The semantics of IFS varies between different SH's.  Some

	    # treat ``;;' as three fields while some treat it as just two.

	    # Work around this by eliminating ``;;'' ....

	    line="`echo "${line}" | sed -e 's/;;/; ;/g' -e 's/;;/; ;/g'`"

	    OFS="${IFS}" ; IFS="[;]"

	    eval read ${read} <

${line}

EOF

	    IFS="${OFS}"

	    if test -n "${garbage_at_eol}"

	    then

		echo "Garbage at end-of-line in ${line}" 1>&2

		kill $$

		exit 1

	    fi

	    # .... and then going back through each field and strip out those

	    # that ended up with just that space character.

	    for r in ${read}

	    do

		if eval test \"\${${r}}\" = \"\ \"

		then

		    eval ${r}=""

		fi

	    done

	    case "${class}" in

		m ) staticdefault="${predefault}" ;;

		M ) staticdefault="0" ;;

		* ) test "${staticdefault}" || staticdefault=0 ;;

	    esac

	    case "${class}" in

	    F | V | M )

		case "${invalid_p}" in

		"" )

		    if test -n "${predefault}"

		    then

			#invalid_p="gdbarch->${function} == ${predefault}"

			predicate="gdbarch->${function} != ${predefault}"

		    elif class_is_variable_p

		    then

			predicate="gdbarch->${function} != 0"

		    elif class_is_function_p

		    then

			predicate="gdbarch->${function} != NULL"

		    fi

		    ;;

		* )

		    echo "Predicate function ${function} with invalid_p." 1>&2

		    kill $$

		    exit 1

		    ;;

		esac

	    esac

	    # PREDEFAULT is a valid fallback definition of MEMBER when

	    # multi-arch is not enabled.  This ensures that the

	    # default value, when multi-arch is the same as the

	    # default value when not multi-arch.  POSTDEFAULT is

	    # always a valid definition of MEMBER as this again

	    # ensures consistency.

	    if [ -n "${postdefault}" ]

	    then

		fallbackdefault="${postdefault}"

	    elif [ -n "${predefault}" ]

	    then

		fallbackdefault="${predefault}"

	    else

		fallbackdefault="0"

	    fi

	    #NOT YET: See gdbarch.log for basic verification of

	    # database

	    break

	fi

    done

    if [ -n "${class}" ]

    then

	true

    else

	false

    fi

}

fallback_default_p ()

{

    [ -n "${postdefault}" -a "x${invalid_p}" != "x0" ] \

	|| [ -n "${predefault}" -a "x${invalid_p}" = "x0" ]

}

class_is_variable_p ()

{

    case "${class}" in

	*v* | *V* ) true ;;

	* ) false ;;

    esac

}

class_is_function_p ()

{

    case "${class}" in

	*f* | *F* | *m* | *M* ) true ;;

	* ) false ;;

    esac

}

class_is_multiarch_p ()

{

    case "${class}" in

	*m* | *M* ) true ;;

	* ) false ;;

    esac

}

class_is_predicate_p ()

{

    case "${class}" in

	*F* | *V* | *M* ) true ;;

	* ) false ;;

    esac

}

class_is_info_p ()

{

    case "${class}" in

	*i* ) true ;;

	* ) false ;;

    esac

}

# dump out/verify the doco

for field in ${read}

do

  case ${field} in

    class ) : ;;

	# # -> line disable

	# f -> function

	#   hiding a function

	# F -> function + predicate

	#   hiding a function + predicate to test function validity

	# v -> variable

	#   hiding a variable

	# V -> variable + predicate

	#   hiding a variable + predicate to test variables validity

	# i -> set from info

	#   hiding something from the ``struct info'' object

	# m -> multi-arch function

	#   hiding a multi-arch function (parameterised with the architecture)

        # M -> multi-arch function + predicate

	#   hiding a multi-arch function + predicate to test function validity

    returntype ) : ;;

	# For functions, the return type; for variables, the data type

    function ) : ;;

	# For functions, the member function name; for variables, the

	# variable name.  Member function names are always prefixed with

	# ``gdbarch_'' for name-space purity.

    formal ) : ;;

	# The formal argument list.  It is assumed that the formal

	# argument list includes the actual name of each list element.

	# A function with no arguments shall have ``void'' as the

	# formal argument list.

    actual ) : ;;

	# The list of actual arguments.  The arguments specified shall

	# match the FORMAL list given above.  Functions with out

	# arguments leave this blank.

    staticdefault ) : ;;

	# To help with the GDB startup a static gdbarch object is

	# created.  STATICDEFAULT is the value to insert into that

	# static gdbarch object.  Since this a static object only

	# simple expressions can be used.

	# If STATICDEFAULT is empty, zero is used.

    predefault ) : ;;

	# An initial value to assign to MEMBER of the freshly

	# malloc()ed gdbarch object.  After initialization, the

	# freshly malloc()ed object is passed to the target

	# architecture code for further updates.

	# If PREDEFAULT is empty, zero is used.

	# A non-empty PREDEFAULT, an empty POSTDEFAULT and a zero

	# INVALID_P are specified, PREDEFAULT will be used as the

	# default for the non- multi-arch target.

	# A zero PREDEFAULT function will force the fallback to call

	# internal_error().

	# Variable declarations can refer to ``gdbarch'' which will

	# contain the current architecture.  Care should be taken.

    postdefault ) : ;;

	# A value to assign to MEMBER of the new gdbarch object should

	# the target architecture code fail to change the PREDEFAULT

	# value.

	# If POSTDEFAULT is empty, no post update is performed.

	# If both INVALID_P and POSTDEFAULT are non-empty then

	# INVALID_P will be used to determine if MEMBER should be

	# changed to POSTDEFAULT.

	# If a non-empty POSTDEFAULT and a zero INVALID_P are

	# specified, POSTDEFAULT will be used as the default for the

	# non- multi-arch target (regardless of the value of

	# PREDEFAULT).

	# You cannot specify both a zero INVALID_P and a POSTDEFAULT.

	# Variable declarations can refer to ``gdbarch'' which

	# will contain the current architecture.  Care should be

	# taken.

    invalid_p ) : ;;

	# A predicate equation that validates MEMBER.  Non-zero is

	# returned if the code creating the new architecture failed to

	# initialize MEMBER or the initialized the member is invalid.

	# If POSTDEFAULT is non-empty then MEMBER will be updated to

	# that value.  If POSTDEFAULT is empty then internal_error()

	# is called.

	# If INVALID_P is empty, a check that MEMBER is no longer

	# equal to PREDEFAULT is used.

	# The expression ``0'' disables the INVALID_P check making

	# PREDEFAULT a legitimate value.

	# See also PREDEFAULT and POSTDEFAULT.

    print ) : ;;

	# An optional expression that convers MEMBER to a value

	# suitable for formatting using %s.

	# If PRINT is empty, core_addr_to_string_nz (for CORE_ADDR)

	# or plongest (anything else) is used.

    garbage_at_eol ) : ;;

	# Catches stray fields.

    *)

	echo "Bad field ${field}"

	exit 1;;

  esac

done

function_list ()

{

  # See below (DOCO) for description of each field

  cat <

i;const struct bfd_arch_info *;bfd_arch_info;;;&bfd_default_arch_struct;;;;gdbarch_bfd_arch_info (gdbarch)->printable_name

#

i;enum bfd_endian;byte_order;;;BFD_ENDIAN_BIG

i;enum bfd_endian;byte_order_for_code;;;BFD_ENDIAN_BIG

#

i;enum gdb_osabi;osabi;;;GDB_OSABI_UNKNOWN

#

i;const struct target_desc *;target_desc;;;;;;;host_address_to_string (gdbarch->target_desc)

# The bit byte-order has to do just with numbering of bits in debugging symbols

# and such.  Conceptually, it's quite separate from byte/word byte order.

v;int;bits_big_endian;;;1;(gdbarch->byte_order == BFD_ENDIAN_BIG);;0

# Number of bits in a short or unsigned short for the target machine.

v;int;short_bit;;;8 * sizeof (short);2*TARGET_CHAR_BIT;;0

# Number of bits in an int or unsigned int for the target machine.

v;int;int_bit;;;8 * sizeof (int);4*TARGET_CHAR_BIT;;0

# Number of bits in a long or unsigned long for the target machine.

v;int;long_bit;;;8 * sizeof (long);4*TARGET_CHAR_BIT;;0

# Number of bits in a long long or unsigned long long for the target

# machine.

v;int;long_long_bit;;;8 * sizeof (LONGEST);2*gdbarch->long_bit;;0

# The ABI default bit-size and format for "half", "float", "double", and

# "long double".  These bit/format pairs should eventually be combined

# into a single object.  For the moment, just initialize them as a pair.

# Each format describes both the big and little endian layouts (if

# useful).

v;int;half_bit;;;16;2*TARGET_CHAR_BIT;;0

v;const struct floatformat **;half_format;;;;;floatformats_ieee_half;;pformat (gdbarch->half_format)

v;int;float_bit;;;8 * sizeof (float);4*TARGET_CHAR_BIT;;0

v;const struct floatformat **;float_format;;;;;floatformats_ieee_single;;pformat (gdbarch->float_format)

v;int;double_bit;;;8 * sizeof (double);8*TARGET_CHAR_BIT;;0

v;const struct floatformat **;double_format;;;;;floatformats_ieee_double;;pformat (gdbarch->double_format)

v;int;long_double_bit;;;8 * sizeof (long double);8*TARGET_CHAR_BIT;;0

v;const struct floatformat **;long_double_format;;;;;floatformats_ieee_double;;pformat (gdbarch->long_double_format)

# The ABI default bit-size for "wchar_t".  wchar_t is a built-in type

# starting with C++11.

v;int;wchar_bit;;;8 * sizeof (wchar_t);4*TARGET_CHAR_BIT;;0

# One if \`wchar_t' is signed, zero if unsigned.

v;int;wchar_signed;;;1;-1;1

# Returns the floating-point format to be used for values of length LENGTH.

# NAME, if non-NULL, is the type name, which may be used to distinguish

# different target formats of the same length.

m;const struct floatformat **;floatformat_for_type;const char *name, LONGEST length;name, length;0;default_floatformat_for_type;;0

# For most targets, a pointer on the target and its representation as an

# address in GDB have the same size and "look the same".  For such a

# target, you need only set gdbarch_ptr_bit and gdbarch_addr_bit

# / addr_bit will be set from it.

#

# If gdbarch_ptr_bit and gdbarch_addr_bit are different, you'll probably

# also need to set gdbarch_dwarf2_addr_size, gdbarch_pointer_to_address and

# gdbarch_address_to_pointer as well.

#

# ptr_bit is the size of a pointer on the target

v;int;ptr_bit;;;8 * sizeof (void*);gdbarch->int_bit;;0

# addr_bit is the size of a target address as represented in gdb

v;int;addr_bit;;;8 * sizeof (void*);0;gdbarch_ptr_bit (gdbarch);

#

# dwarf2_addr_size is the target address size as used in the Dwarf debug

# info.  For .debug_frame FDEs, this is supposed to be the target address

# size from the associated CU header, and which is equivalent to the

# DWARF2_ADDR_SIZE as defined by the target specific GCC back-end.

# Unfortunately there is no good way to determine this value.  Therefore

# dwarf2_addr_size simply defaults to the target pointer size.

#

# dwarf2_addr_size is not used for .eh_frame FDEs, which are generally

# defined using the target's pointer size so far.

#

# Note that dwarf2_addr_size only needs to be redefined by a target if the

# GCC back-end defines a DWARF2_ADDR_SIZE other than the target pointer size,

# and if Dwarf versions < 4 need to be supported.

v;int;dwarf2_addr_size;;;sizeof (void*);0;gdbarch_ptr_bit (gdbarch) / TARGET_CHAR_BIT;

#

# One if \`char' acts like \`signed char', zero if \`unsigned char'.

v;int;char_signed;;;1;-1;1

#

F;CORE_ADDR;read_pc;readable_regcache *regcache;regcache

F;void;write_pc;struct regcache *regcache, CORE_ADDR val;regcache, val

# Function for getting target's idea of a frame pointer.  FIXME: GDB's

# whole scheme for dealing with "frames" and "frame pointers" needs a

# serious shakedown.

m;void;virtual_frame_pointer;CORE_ADDR pc, int *frame_regnum, LONGEST *frame_offset;pc, frame_regnum, frame_offset;0;legacy_virtual_frame_pointer;;0

#

M;enum register_status;pseudo_register_read;readable_regcache *regcache, int cookednum, gdb_byte *buf;regcache, cookednum, buf

# Read a register into a new struct value.  If the register is wholly

# or partly unavailable, this should call mark_value_bytes_unavailable

# as appropriate.  If this is defined, then pseudo_register_read will

# never be called.

M;struct value *;pseudo_register_read_value;readable_regcache *regcache, int cookednum;regcache, cookednum

M;void;pseudo_register_write;struct regcache *regcache, int cookednum, const gdb_byte *buf;regcache, cookednum, buf

#

v;int;num_regs;;;0;-1

# This macro gives the number of pseudo-registers that live in the

# register namespace but do not get fetched or stored on the target.

# These pseudo-registers may be aliases for other registers,

# combinations of other registers, or they may be computed by GDB.

v;int;num_pseudo_regs;;;0;0;;0

# Assemble agent expression bytecode to collect pseudo-register REG.

# Return -1 if something goes wrong, 0 otherwise.

M;int;ax_pseudo_register_collect;struct agent_expr *ax, int reg;ax, reg

# Assemble agent expression bytecode to push the value of pseudo-register

# REG on the interpreter stack.

# Return -1 if something goes wrong, 0 otherwise.

M;int;ax_pseudo_register_push_stack;struct agent_expr *ax, int reg;ax, reg

# Some targets/architectures can do extra processing/display of

# segmentation faults.  E.g., Intel MPX boundary faults.

# Call the architecture dependent function to handle the fault.

# UIOUT is the output stream where the handler will place information.

M;void;handle_segmentation_fault;struct ui_out *uiout;uiout

# GDB's standard (or well known) register numbers.  These can map onto

# a real register or a pseudo (computed) register or not be defined at

# all (-1).

# gdbarch_sp_regnum will hopefully be replaced by UNWIND_SP.

v;int;sp_regnum;;;-1;-1;;0

v;int;pc_regnum;;;-1;-1;;0

v;int;ps_regnum;;;-1;-1;;0

v;int;fp0_regnum;;;0;-1;;0

# Convert stab register number (from \`r\' declaration) to a gdb REGNUM.

m;int;stab_reg_to_regnum;int stab_regnr;stab_regnr;;no_op_reg_to_regnum;;0

# Provide a default mapping from a ecoff register number to a gdb REGNUM.

m;int;ecoff_reg_to_regnum;int ecoff_regnr;ecoff_regnr;;no_op_reg_to_regnum;;0

# Convert from an sdb register number to an internal gdb register number.

m;int;sdb_reg_to_regnum;int sdb_regnr;sdb_regnr;;no_op_reg_to_regnum;;0

# Provide a default mapping from a DWARF2 register number to a gdb REGNUM.

# Return -1 for bad REGNUM.  Note: Several targets get this wrong.

m;int;dwarf2_reg_to_regnum;int dwarf2_regnr;dwarf2_regnr;;no_op_reg_to_regnum;;0

m;const char *;register_name;int regnr;regnr;;0

# Return the type of a register specified by the architecture.  Only

# the register cache should call this function directly; others should

# use "register_type".

M;struct type *;register_type;int reg_nr;reg_nr

M;struct frame_id;dummy_id;struct frame_info *this_frame;this_frame

# Implement DUMMY_ID and PUSH_DUMMY_CALL, then delete

# deprecated_fp_regnum.

v;int;deprecated_fp_regnum;;;-1;-1;;0

M;CORE_ADDR;push_dummy_call;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;function, regcache, bp_addr, nargs, args, sp, struct_return, struct_addr

v;int;call_dummy_location;;;;AT_ENTRY_POINT;;0

M;CORE_ADDR;push_dummy_code;CORE_ADDR sp, CORE_ADDR funaddr, struct value **args, int nargs, struct type *value_type, CORE_ADDR *real_pc, CORE_ADDR *bp_addr, struct regcache *regcache;sp, funaddr, args, nargs, value_type, real_pc, bp_addr, regcache

# Return true if the code of FRAME is writable.

m;int;code_of_frame_writable;struct frame_info *frame;frame;;default_code_of_frame_writable;;0

m;void;print_registers_info;struct ui_file *file, struct frame_info *frame, int regnum, int all;file, frame, regnum, all;;default_print_registers_info;;0

m;void;print_float_info;struct ui_file *file, struct frame_info *frame, const char *args;file, frame, args;;default_print_float_info;;0

M;void;print_vector_info;struct ui_file *file, struct frame_info *frame, const char *args;file, frame, args

# MAP a GDB RAW register number onto a simulator register number.  See

# also include/...-sim.h.

m;int;register_sim_regno;int reg_nr;reg_nr;;legacy_register_sim_regno;;0

m;int;cannot_fetch_register;int regnum;regnum;;cannot_register_not;;0

m;int;cannot_store_register;int regnum;regnum;;cannot_register_not;;0

# Determine the address where a longjmp will land and save this address

# in PC.  Return nonzero on success.

#

# FRAME corresponds to the longjmp frame.

F;int;get_longjmp_target;struct frame_info *frame, CORE_ADDR *pc;frame, pc

#

v;int;believe_pcc_promotion;;;;;;;

#

m;int;convert_register_p;int regnum, struct type *type;regnum, type;0;generic_convert_register_p;;0

f;int;register_to_value;struct frame_info *frame, int regnum, struct type *type, gdb_byte *buf, int *optimizedp, int *unavailablep;frame, regnum, type, buf, optimizedp, unavailablep;0

f;void;value_to_register;struct frame_info *frame, int regnum, struct type *type, const gdb_byte *buf;frame, regnum, type, buf;0

# Construct a value representing the contents of register REGNUM in

# frame FRAME_ID, interpreted as type TYPE.  The routine needs to

# allocate and return a struct value with all value attributes

# (but not the value contents) filled in.

m;struct value *;value_from_register;struct type *type, int regnum, struct frame_id frame_id;type, regnum, frame_id;;default_value_from_register;;0

#

m;CORE_ADDR;pointer_to_address;struct type *type, const gdb_byte *buf;type, buf;;unsigned_pointer_to_address;;0

m;void;address_to_pointer;struct type *type, gdb_byte *buf, CORE_ADDR addr;type, buf, addr;;unsigned_address_to_pointer;;0

M;CORE_ADDR;integer_to_address;struct type *type, const gdb_byte *buf;type, buf

# Return the return-value convention that will be used by FUNCTION

# to return a value of type VALTYPE.  FUNCTION may be NULL in which

# case the return convention is computed based only on VALTYPE.

#

# If READBUF is not NULL, extract the return value and save it in this buffer.

#

# If WRITEBUF is not NULL, it contains a return value which will be

# stored into the appropriate register.  This can be used when we want

# to force the value returned by a function (see the "return" command

# for instance).

M;enum return_value_convention;return_value;struct value *function, struct type *valtype, struct regcache *regcache, gdb_byte *readbuf, const gdb_byte *writebuf;function, valtype, regcache, readbuf, writebuf

# Return true if the return value of function is stored in the first hidden

# parameter.  In theory, this feature should be language-dependent, specified

# by language and its ABI, such as C++.  Unfortunately, compiler may

# implement it to a target-dependent feature.  So that we need such hook here

# to be aware of this in GDB.

m;int;return_in_first_hidden_param_p;struct type *type;type;;default_return_in_first_hidden_param_p;;0

m;CORE_ADDR;skip_prologue;CORE_ADDR ip;ip;0;0

M;CORE_ADDR;skip_main_prologue;CORE_ADDR ip;ip

# On some platforms, a single function may provide multiple entry points,

# e.g. one that is used for function-pointer calls and a different one

# that is used for direct function calls.

# In order to ensure that breakpoints set on the function will trigger

# no matter via which entry point the function is entered, a platform

# may provide the skip_entrypoint callback.  It is called with IP set

# to the main entry point of a function (as determined by the symbol table),

# and should return the address of the innermost entry point, where the

# actual breakpoint needs to be set.  Note that skip_entrypoint is used

# by GDB common code even when debugging optimized code, where skip_prologue

# is not used.

M;CORE_ADDR;skip_entrypoint;CORE_ADDR ip;ip

f;int;inner_than;CORE_ADDR lhs, CORE_ADDR rhs;lhs, rhs;0;0

m;const gdb_byte *;breakpoint_from_pc;CORE_ADDR *pcptr, int *lenptr;pcptr, lenptr;0;default_breakpoint_from_pc;;0

# Return the breakpoint kind for this target based on *PCPTR.

m;int;breakpoint_kind_from_pc;CORE_ADDR *pcptr;pcptr;;0;

# Return the software breakpoint from KIND.  KIND can have target

# specific meaning like the Z0 kind parameter.

# SIZE is set to the software breakpoint's length in memory.

m;const gdb_byte *;sw_breakpoint_from_kind;int kind, int *size;kind, size;;NULL;;0

# Return the breakpoint kind for this target based on the current

# processor state (e.g. the current instruction mode on ARM) and the

# *PCPTR.  In default, it is gdbarch->breakpoint_kind_from_pc.

m;int;breakpoint_kind_from_current_state;struct regcache *regcache, CORE_ADDR *pcptr;regcache, pcptr;0;default_breakpoint_kind_from_current_state;;0

M;CORE_ADDR;adjust_breakpoint_address;CORE_ADDR bpaddr;bpaddr

m;int;memory_insert_breakpoint;struct bp_target_info *bp_tgt;bp_tgt;0;default_memory_insert_breakpoint;;0

m;int;memory_remove_breakpoint;struct bp_target_info *bp_tgt;bp_tgt;0;default_memory_remove_breakpoint;;0

v;CORE_ADDR;decr_pc_after_break;;;0;;;0

# A function can be addressed by either it's "pointer" (possibly a

# descriptor address) or "entry point" (first executable instruction).

# The method "convert_from_func_ptr_addr" converting the former to the

# latter.  gdbarch_deprecated_function_start_offset is being used to implement

# a simplified subset of that functionality - the function's address

# corresponds to the "function pointer" and the function's start

# corresponds to the "function entry point" - and hence is redundant.

v;CORE_ADDR;deprecated_function_start_offset;;;0;;;0

# Return the remote protocol register number associated with this

# register.  Normally the identity mapping.

m;int;remote_register_number;int regno;regno;;default_remote_register_number;;0

# Fetch the target specific address used to represent a load module.

F;CORE_ADDR;fetch_tls_load_module_address;struct objfile *objfile;objfile

#

v;CORE_ADDR;frame_args_skip;;;0;;;0

M;CORE_ADDR;unwind_pc;struct frame_info *next_frame;next_frame

M;CORE_ADDR;unwind_sp;struct frame_info *next_frame;next_frame

# DEPRECATED_FRAME_LOCALS_ADDRESS as been replaced by the per-frame

# frame-base.  Enable frame-base before frame-unwind.

F;int;frame_num_args;struct frame_info *frame;frame

#

M;CORE_ADDR;frame_align;CORE_ADDR address;address

m;int;stabs_argument_has_addr;struct type *type;type;;default_stabs_argument_has_addr;;0

v;int;frame_red_zone_size

#

m;CORE_ADDR;convert_from_func_ptr_addr;CORE_ADDR addr, struct target_ops *targ;addr, targ;;convert_from_func_ptr_addr_identity;;0

# On some machines there are bits in addresses which are not really

# part of the address, but are used by the kernel, the hardware, etc.

# for special purposes.  gdbarch_addr_bits_remove takes out any such bits so

# we get a "real" address such as one would find in a symbol table.

# This is used only for addresses of instructions, and even then I'm

# not sure it's used in all contexts.  It exists to deal with there

# being a few stray bits in the PC which would mislead us, not as some

# sort of generic thing to handle alignment or segmentation (it's

# possible it should be in TARGET_READ_PC instead).

m;CORE_ADDR;addr_bits_remove;CORE_ADDR addr;addr;;core_addr_identity;;0

# On some machines, not all bits of an address word are significant.

# For example, on AArch64, the top bits of an address known as the "tag"

# are ignored by the kernel, the hardware, etc. and can be regarded as

# additional data associated with the address.

v;int;significant_addr_bit;;;;;;0

# FIXME/cagney/2001-01-18: This should be split in two.  A target method that

# indicates if the target needs software single step.  An ISA method to

# implement it.

#

# FIXME/cagney/2001-01-18: The logic is backwards.  It should be asking if the

# target can single step.  If not, then implement single step using breakpoints.

#

# Return a vector of addresses on which the software single step

# breakpoints should be inserted.  NULL means software single step is

# not used.

# Multiple breakpoints may be inserted for some instructions such as

# conditional branch.  However, each implementation must always evaluate

# the condition and only put the breakpoint at the branch destination if

# the condition is true, so that we ensure forward progress when stepping

# past a conditional branch to self.

F;std::vector<CORE_ADDR>;software_single_step;struct regcache *regcache;regcache

# Return non-zero if the processor is executing a delay slot and a

# further single-step is needed before the instruction finishes.

M;int;single_step_through_delay;struct frame_info *frame;frame

# FIXME: cagney/2003-08-28: Need to find a better way of selecting the

# disassembler.  Perhaps objdump can handle it?

f;int;print_insn;bfd_vma vma, struct disassemble_info *info;vma, info;;default_print_insn;;0

f;CORE_ADDR;skip_trampoline_code;struct frame_info *frame, CORE_ADDR pc;frame, pc;;generic_skip_trampoline_code;;0

# If in_solib_dynsym_resolve_code() returns true, and SKIP_SOLIB_RESOLVER

# evaluates non-zero, this is the address where the debugger will place

# a step-resume breakpoint to get us past the dynamic linker.

m;CORE_ADDR;skip_solib_resolver;CORE_ADDR pc;pc;;generic_skip_solib_resolver;;0

# Some systems also have trampoline code for returning from shared libs.

m;int;in_solib_return_trampoline;CORE_ADDR pc, const char *name;pc, name;;generic_in_solib_return_trampoline;;0

# Return true if PC lies inside an indirect branch thunk.

m;bool;in_indirect_branch_thunk;CORE_ADDR pc;pc;;default_in_indirect_branch_thunk;;0

# A target might have problems with watchpoints as soon as the stack

# frame of the current function has been destroyed.  This mostly happens

# as the first action in a function's epilogue.  stack_frame_destroyed_p()

# is defined to return a non-zero value if either the given addr is one

# instruction after the stack destroying instruction up to the trailing

# return instruction or if we can figure out that the stack frame has

# already been invalidated regardless of the value of addr.  Targets

# which don't suffer from that problem could just let this functionality

# untouched.

m;int;stack_frame_destroyed_p;CORE_ADDR addr;addr;0;generic_stack_frame_destroyed_p;;0

# Process an ELF symbol in the minimal symbol table in a backend-specific

# way.  Normally this hook is supposed to do nothing, however if required,

# then this hook can be used to apply tranformations to symbols that are

# considered special in some way.  For example the MIPS backend uses it

# to interpret \`st_other' information to mark compressed code symbols so

# that they can be treated in the appropriate manner in the processing of

# the main symbol table and DWARF-2 records.

F;void;elf_make_msymbol_special;asymbol *sym, struct minimal_symbol *msym;sym, msym

f;void;coff_make_msymbol_special;int val, struct minimal_symbol *msym;val, msym;;default_coff_make_msymbol_special;;0

# Process a symbol in the main symbol table in a backend-specific way.

# Normally this hook is supposed to do nothing, however if required,

# then this hook can be used to apply tranformations to symbols that

# are considered special in some way.  This is currently used by the

# MIPS backend to make sure compressed code symbols have the ISA bit

# set.  This in turn is needed for symbol values seen in GDB to match

# the values used at the runtime by the program itself, for function

# and label references.

f;void;make_symbol_special;struct symbol *sym, struct objfile *objfile;sym, objfile;;default_make_symbol_special;;0

# Adjust the address retrieved from a DWARF-2 record other than a line

# entry in a backend-specific way.  Normally this hook is supposed to

# return the address passed unchanged, however if that is incorrect for

# any reason, then this hook can be used to fix the address up in the

# required manner.  This is currently used by the MIPS backend to make

# sure addresses in FDE, range records, etc. referring to compressed

# code have the ISA bit set, matching line information and the symbol

# table.

f;CORE_ADDR;adjust_dwarf2_addr;CORE_ADDR pc;pc;;default_adjust_dwarf2_addr;;0

# Adjust the address updated by a line entry in a backend-specific way.

# Normally this hook is supposed to return the address passed unchanged,

# however in the case of inconsistencies in these records, this hook can

# be used to fix them up in the required manner.  This is currently used

# by the MIPS backend to make sure all line addresses in compressed code

# are presented with the ISA bit set, which is not always the case.  This

# in turn ensures breakpoint addresses are correctly matched against the

# stop PC.

f;CORE_ADDR;adjust_dwarf2_line;CORE_ADDR addr, int rel;addr, rel;;default_adjust_dwarf2_line;;0

v;int;cannot_step_breakpoint;;;0;0;;0

v;int;have_nonsteppable_watchpoint;;;0;0;;0

F;int;address_class_type_flags;int byte_size, int dwarf2_addr_class;byte_size, dwarf2_addr_class

M;const char *;address_class_type_flags_to_name;int type_flags;type_flags

# Execute vendor-specific DWARF Call Frame Instruction.  OP is the instruction.

# FS are passed from the generic execute_cfa_program function.

m;bool;execute_dwarf_cfa_vendor_op;gdb_byte op, struct dwarf2_frame_state *fs;op, fs;;default_execute_dwarf_cfa_vendor_op;;0

# Return the appropriate type_flags for the supplied address class.

# This function should return 1 if the address class was recognized and

# type_flags was set, zero otherwise.

M;int;address_class_name_to_type_flags;const char *name, int *type_flags_ptr;name, type_flags_ptr

# Is a register in a group

m;int;register_reggroup_p;int regnum, struct reggroup *reggroup;regnum, reggroup;;default_register_reggroup_p;;0

# Fetch the pointer to the ith function argument.

F;CORE_ADDR;fetch_pointer_argument;struct frame_info *frame, int argi, struct type *type;frame, argi, type

# Iterate over all supported register notes in a core file.  For each

# supported register note section, the iterator must call CB and pass

# CB_DATA unchanged.  If REGCACHE is not NULL, the iterator can limit

# the supported register note sections based on the current register

# values.  Otherwise it should enumerate all supported register note

# sections.

M;void;iterate_over_regset_sections;iterate_over_regset_sections_cb *cb, void *cb_data, const struct regcache *regcache;cb, cb_data, regcache

# Create core file notes

M;char *;make_corefile_notes;bfd *obfd, int *note_size;obfd, note_size

# Find core file memory regions

M;int;find_memory_regions;find_memory_region_ftype func, void *data;func, data

# Read offset OFFSET of TARGET_OBJECT_LIBRARIES formatted shared libraries list from

# core file into buffer READBUF with length LEN.  Return the number of bytes read

# (zero indicates failure).

# failed, otherwise, return the red length of READBUF.

M;ULONGEST;core_xfer_shared_libraries;gdb_byte *readbuf, ULONGEST offset, ULONGEST len;readbuf, offset, len

# Read offset OFFSET of TARGET_OBJECT_LIBRARIES_AIX formatted shared

# libraries list from core file into buffer READBUF with length LEN.

# Return the number of bytes read (zero indicates failure).

M;ULONGEST;core_xfer_shared_libraries_aix;gdb_byte *readbuf, ULONGEST offset, ULONGEST len;readbuf, offset, len

# How the core target converts a PTID from a core file to a string.

M;const char *;core_pid_to_str;ptid_t ptid;ptid

# How the core target extracts the name of a thread from a core file.

M;const char *;core_thread_name;struct thread_info *thr;thr

# Read offset OFFSET of TARGET_OBJECT_SIGNAL_INFO signal information

# from core file into buffer READBUF with length LEN.  Return the number

# of bytes read (zero indicates EOF, a negative value indicates failure).

M;LONGEST;core_xfer_siginfo;gdb_byte *readbuf, ULONGEST offset, ULONGEST len; readbuf, offset, len

# BFD target to use when generating a core file.

V;const char *;gcore_bfd_target;;;0;0;;;pstring (gdbarch->gcore_bfd_target)

# If the elements of C++ vtables are in-place function descriptors rather

# than normal function pointers (which may point to code or a descriptor),

# set this to one.

v;int;vtable_function_descriptors;;;0;0;;0

# Set if the least significant bit of the delta is used instead of the least

# significant bit of the pfn for pointers to virtual member functions.

v;int;vbit_in_delta;;;0;0;;0

# Advance PC to next instruction in order to skip a permanent breakpoint.

f;void;skip_permanent_breakpoint;struct regcache *regcache;regcache;default_skip_permanent_breakpoint;default_skip_permanent_breakpoint;;0

# The maximum length of an instruction on this architecture in bytes.

V;ULONGEST;max_insn_length;;;0;0

# Copy the instruction at FROM to TO, and make any adjustments

# necessary to single-step it at that address.

#

# REGS holds the state the thread's registers will have before

# executing the copied instruction; the PC in REGS will refer to FROM,

# not the copy at TO.  The caller should update it to point at TO later.

#

# Return a pointer to data of the architecture's choice to be passed

# to gdbarch_displaced_step_fixup.  Or, return NULL to indicate that

# the instruction's effects have been completely simulated, with the

# resulting state written back to REGS.

#

# For a general explanation of displaced stepping and how GDB uses it,

# see the comments in infrun.c.

#

# The TO area is only guaranteed to have space for

# gdbarch_max_insn_length (arch) bytes, so this function must not

# write more bytes than that to that area.

#

# If you do not provide this function, GDB assumes that the

# architecture does not support displaced stepping.

#

# If the instruction cannot execute out of line, return NULL.  The

# core falls back to stepping past the instruction in-line instead in

# that case.

M;struct displaced_step_closure *;displaced_step_copy_insn;CORE_ADDR from, CORE_ADDR to, struct regcache *regs;from, to, regs

# Return true if GDB should use hardware single-stepping to execute

# the displaced instruction identified by CLOSURE.  If false,

# GDB will simply restart execution at the displaced instruction

# location, and it is up to the target to ensure GDB will receive

# control again (e.g. by placing a software breakpoint instruction

# into the displaced instruction buffer).

#

# The default implementation returns false on all targets that

# provide a gdbarch_software_single_step routine, and true otherwise.

m;int;displaced_step_hw_singlestep;struct displaced_step_closure *closure;closure;;default_displaced_step_hw_singlestep;;0

# Fix up the state resulting from successfully single-stepping a

# displaced instruction, to give the result we would have gotten from

# stepping the instruction in its original location.

#

# REGS is the register state resulting from single-stepping the

# displaced instruction.

#

# CLOSURE is the result from the matching call to

# gdbarch_displaced_step_copy_insn.

#

# If you provide gdbarch_displaced_step_copy_insn.but not this

# function, then GDB assumes that no fixup is needed after

# single-stepping the instruction.

#

# For a general explanation of displaced stepping and how GDB uses it,

# see the comments in infrun.c.

M;void;displaced_step_fixup;struct displaced_step_closure *closure, CORE_ADDR from, CORE_ADDR to, struct regcache *regs;closure, from, to, regs;;NULL

# Return the address of an appropriate place to put displaced

# instructions while we step over them.  There need only be one such

# place, since we're only stepping one thread over a breakpoint at a

# time.

#

# For a general explanation of displaced stepping and how GDB uses it,

# see the comments in infrun.c.

m;CORE_ADDR;displaced_step_location;void;;;NULL;;(! gdbarch->displaced_step_location) != (! gdbarch->displaced_step_copy_insn)

# Relocate an instruction to execute at a different address.  OLDLOC

# is the address in the inferior memory where the instruction to

# relocate is currently at.  On input, TO points to the destination

# where we want the instruction to be copied (and possibly adjusted)

# to.  On output, it points to one past the end of the resulting

# instruction(s).  The effect of executing the instruction at TO shall

# be the same as if executing it at FROM.  For example, call

# instructions that implicitly push the return address on the stack

# should be adjusted to return to the instruction after OLDLOC;

# relative branches, and other PC-relative instructions need the

# offset adjusted; etc.

M;void;relocate_instruction;CORE_ADDR *to, CORE_ADDR from;to, from;;NULL

# Refresh overlay mapped state for section OSECT.

F;void;overlay_update;struct obj_section *osect;osect

M;const struct target_desc *;core_read_description;struct target_ops *target, bfd *abfd;target, abfd

# Handle special encoding of static variables in stabs debug info.

F;const char *;static_transform_name;const char *name;name

# Set if the address in N_SO or N_FUN stabs may be zero.

v;int;sofun_address_maybe_missing;;;0;0;;0

# Parse the instruction at ADDR storing in the record execution log

# the registers REGCACHE and memory ranges that will be affected when

# the instruction executes, along with their current values.

# Return -1 if something goes wrong, 0 otherwise.

M;int;process_record;struct regcache *regcache, CORE_ADDR addr;regcache, addr

# Save process state after a signal.

# Return -1 if something goes wrong, 0 otherwise.

M;int;process_record_signal;struct regcache *regcache, enum gdb_signal signal;regcache, signal

# Signal translation: translate inferior's signal (target's) number

# into GDB's representation.  The implementation of this method must

# be host independent.  IOW, don't rely on symbols of the NAT_FILE