/* Scheme interface to architecture. Copyright (C) 2014-2021 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 . */ /* See README file in this directory for implementation notes, coding conventions, et.al. */ #include "defs.h" #include "charset.h" #include "gdbarch.h" #include "arch-utils.h" #include "guile-internal.h" /* The smob. */ struct arch_smob { /* This always appears first. */ gdb_smob base; struct gdbarch *gdbarch; }; static const char arch_smob_name[] = "gdb:arch"; /* The tag Guile knows the arch smob by. */ static scm_t_bits arch_smob_tag; static struct gdbarch_data *arch_object_data = NULL; static int arscm_is_arch (SCM); /* Administrivia for arch smobs. */ /* The smob "print" function for . */ static int arscm_print_arch_smob (SCM self, SCM port, scm_print_state *pstate) { arch_smob *a_smob = (arch_smob *) SCM_SMOB_DATA (self); struct gdbarch *gdbarch = a_smob->gdbarch; gdbscm_printf (port, "#<%s", arch_smob_name); gdbscm_printf (port, " %s", gdbarch_bfd_arch_info (gdbarch)->printable_name); scm_puts (">", port); scm_remember_upto_here_1 (self); /* Non-zero means success. */ return 1; } /* Low level routine to create a object for GDBARCH. */ static SCM arscm_make_arch_smob (struct gdbarch *gdbarch) { arch_smob *a_smob = (arch_smob *) scm_gc_malloc (sizeof (arch_smob), arch_smob_name); SCM a_scm; a_smob->gdbarch = gdbarch; a_scm = scm_new_smob (arch_smob_tag, (scm_t_bits) a_smob); gdbscm_init_gsmob (&a_smob->base); return a_scm; } /* Return the gdbarch field of A_SMOB. */ struct gdbarch * arscm_get_gdbarch (arch_smob *a_smob) { return a_smob->gdbarch; } /* Return non-zero if SCM is an architecture smob. */ static int arscm_is_arch (SCM scm) { return SCM_SMOB_PREDICATE (arch_smob_tag, scm); } /* (arch? object) -> boolean */ static SCM gdbscm_arch_p (SCM scm) { return scm_from_bool (arscm_is_arch (scm)); } /* Associates an arch_object with GDBARCH as gdbarch_data via the gdbarch post init registration mechanism (gdbarch_data_register_post_init). */ static void * arscm_object_data_init (struct gdbarch *gdbarch) { SCM arch_scm = arscm_make_arch_smob (gdbarch); /* This object lasts the duration of the GDB session, so there is no call to scm_gc_unprotect_object for it. */ scm_gc_protect_object (arch_scm); return (void *) arch_scm; } /* Return the object corresponding to GDBARCH. The object is cached in GDBARCH so this is simple. */ SCM arscm_scm_from_arch (struct gdbarch *gdbarch) { SCM a_scm = (SCM) gdbarch_data (gdbarch, arch_object_data); return a_scm; } /* Return the smob in SELF. Throws an exception if SELF is not a object. */ static SCM arscm_get_arch_arg_unsafe (SCM self, int arg_pos, const char *func_name) { SCM_ASSERT_TYPE (arscm_is_arch (self), self, arg_pos, func_name, arch_smob_name); return self; } /* Return a pointer to the arch smob of SELF. Throws an exception if SELF is not a object. */ arch_smob * arscm_get_arch_smob_arg_unsafe (SCM self, int arg_pos, const char *func_name) { SCM a_scm = arscm_get_arch_arg_unsafe (self, arg_pos, func_name); arch_smob *a_smob = (arch_smob *) SCM_SMOB_DATA (a_scm); return a_smob; } /* Arch methods. */ /* (current-arch) -> Return the architecture of the currently selected stack frame, if there is one, or the current target if there isn't. */ static SCM gdbscm_current_arch (void) { return arscm_scm_from_arch (get_current_arch ()); } /* (arch-name ) -> string Return the name of the architecture as a string value. */ static SCM gdbscm_arch_name (SCM self) { arch_smob *a_smob = arscm_get_arch_smob_arg_unsafe (self, SCM_ARG1, FUNC_NAME); struct gdbarch *gdbarch = a_smob->gdbarch; const char *name; name = (gdbarch_bfd_arch_info (gdbarch))->printable_name; return gdbscm_scm_from_c_string (name); } /* (arch-charset ) -> string */ static SCM gdbscm_arch_charset (SCM self) { arch_smob *a_smob =arscm_get_arch_smob_arg_unsafe (self, SCM_ARG1, FUNC_NAME); struct gdbarch *gdbarch = a_smob->gdbarch; return gdbscm_scm_from_c_string (target_charset (gdbarch)); } /* (arch-wide-charset ) -> string */ static SCM gdbscm_arch_wide_charset (SCM self) { arch_smob *a_smob = arscm_get_arch_smob_arg_unsafe (self, SCM_ARG1, FUNC_NAME); struct gdbarch *gdbarch = a_smob->gdbarch; return gdbscm_scm_from_c_string (target_wide_charset (gdbarch)); } /* Builtin types. The order the types are defined here follows the order in struct builtin_type. */ /* Helper routine to return a builtin type for object SELF. OFFSET is offsetof (builtin_type, the_type). Throws an exception if SELF is not a object. */ static const struct builtin_type * gdbscm_arch_builtin_type (SCM self, const char *func_name) { arch_smob *a_smob = arscm_get_arch_smob_arg_unsafe (self, SCM_ARG1, func_name); struct gdbarch *gdbarch = a_smob->gdbarch; return builtin_type (gdbarch); } /* (arch-void-type ) -> */ static SCM gdbscm_arch_void_type (SCM self) { struct type *type = gdbscm_arch_builtin_type (self, FUNC_NAME)->builtin_void; return tyscm_scm_from_type (type); } /* (arch-char-type ) -> */ static SCM gdbscm_arch_char_type (SCM self) { struct type *type = gdbscm_arch_builtin_type (self, FUNC_NAME)->builtin_char; return tyscm_scm_from_type (type); } /* (arch-short-type ) -> */ static SCM gdbscm_arch_short_type (SCM self) { struct type *type = gdbscm_arch_builtin_type (self, FUNC_NAME)->builtin_short; return tyscm_scm_from_type (type); } /* (arch-int-type ) -> */ static SCM gdbscm_arch_int_type (SCM self) { struct type *type = gdbscm_arch_builtin_type (self, FUNC_NAME)->builtin_int; return tyscm_scm_from_type (type); } /* (arch-long-type ) -> */ static SCM gdbscm_arch_long_type (SCM self) { struct type *type = gdbscm_arch_builtin_type (self, FUNC_NAME)->builtin_long; return tyscm_scm_from_type (type); } /* (arch-schar-type ) -> */ static SCM gdbscm_arch_schar_type (SCM self) { struct type *type = gdbscm_arch_builtin_type (self, FUNC_NAME)->builtin_signed_char; return tyscm_scm_from_type (type); } /* (arch-uchar-type ) -> */ static SCM gdbscm_arch_uchar_type (SCM self) { struct type *type = gdbscm_arch_builtin_type (self, FUNC_NAME)->builtin_unsigned_char; return tyscm_scm_from_type (type); } /* (arch-ushort-type ) -> */ static SCM gdbscm_arch_ushort_type (SCM self) { struct type *type = gdbscm_arch_builtin_type (self, FUNC_NAME)->builtin_unsigned_short; return tyscm_scm_from_type (type); } /* (arch-uint-type ) -> */ static SCM gdbscm_arch_uint_type (SCM self) { struct type *type = gdbscm_arch_builtin_type (self, FUNC_NAME)->builtin_unsigned_int; return tyscm_scm_from_type (type); } /* (arch-ulong-type ) -> */ static SCM gdbscm_arch_ulong_type (SCM self) { struct type *type = gdbscm_arch_builtin_type (self, FUNC_NAME)->builtin_unsigned_long; return tyscm_scm_from_type (type); } /* (arch-float-type ) -> */ static SCM gdbscm_arch_float_type (SCM self) { struct type *type = gdbscm_arch_builtin_type (self, FUNC_NAME)->builtin_float; return tyscm_scm_from_type (type); } /* (arch-double-type ) -> */ static SCM gdbscm_arch_double_type (SCM self) { struct type *type = gdbscm_arch_builtin_type (self, FUNC_NAME)->builtin_double; return tyscm_scm_from_type (type); } /* (arch-longdouble-type ) -> */ static SCM gdbscm_arch_longdouble_type (SCM self) { struct type *type = gdbscm_arch_builtin_type (self, FUNC_NAME)->builtin_long_double; return tyscm_scm_from_type (type); } /* (arch-bool-type ) -> */ static SCM gdbscm_arch_bool_type (SCM self) { struct type *type = gdbscm_arch_builtin_type (self, FUNC_NAME)->builtin_bool; return tyscm_scm_from_type (type); } /* (arch-longlong-type ) -> */ static SCM gdbscm_arch_longlong_type (SCM self) { struct type *type = gdbscm_arch_builtin_type (self, FUNC_NAME)->builtin_long_long; return tyscm_scm_from_type (type); } /* (arch-ulonglong-type ) -> */ static SCM gdbscm_arch_ulonglong_type (SCM self) { struct type *type = gdbscm_arch_builtin_type (self, FUNC_NAME)->builtin_unsigned_long_long; return tyscm_scm_from_type (type); } /* (arch-int8-type ) -> */ static SCM gdbscm_arch_int8_type (SCM self) { struct type *type = gdbscm_arch_builtin_type (self, FUNC_NAME)->builtin_int8; return tyscm_scm_from_type (type); } /* (arch-uint8-type ) -> */ static SCM gdbscm_arch_uint8_type (SCM self) { struct type *type = gdbscm_arch_builtin_type (self, FUNC_NAME)->builtin_uint8; return tyscm_scm_from_type (type); } /* (arch-int16-type ) -> */ static SCM gdbscm_arch_int16_type (SCM self) { struct type *type = gdbscm_arch_builtin_type (self, FUNC_NAME)->builtin_int16; return tyscm_scm_from_type (type); } /* (arch-uint16-type ) -> */ static SCM gdbscm_arch_uint16_type (SCM self) { struct type *type = gdbscm_arch_builtin_type (self, FUNC_NAME)->builtin_uint16; return tyscm_scm_from_type (type); } /* (arch-int32-type ) -> */ static SCM gdbscm_arch_int32_type (SCM self) { struct type *type = gdbscm_arch_builtin_type (self, FUNC_NAME)->builtin_int32; return tyscm_scm_from_type (type); } /* (arch-uint32-type ) -> */ static SCM gdbscm_arch_uint32_type (SCM self) { struct type *type = gdbscm_arch_builtin_type (self, FUNC_NAME)->builtin_uint32; return tyscm_scm_from_type (type); } /* (arch-int64-type ) -> */ static SCM gdbscm_arch_int64_type (SCM self) { struct type *type = gdbscm_arch_builtin_type (self, FUNC_NAME)->builtin_int64; return tyscm_scm_from_type (type); } /* (arch-uint64-type ) -> */ static SCM gdbscm_arch_uint64_type (SCM self) { struct type *type = gdbscm_arch_builtin_type (self, FUNC_NAME)->builtin_uint64; return tyscm_scm_from_type (type); } /* Initialize the Scheme architecture support. */ static const scheme_function arch_functions[] = { { "arch?", 1, 0, 0, as_a_scm_t_subr (gdbscm_arch_p), "\ Return #t if the object is a object." }, { "current-arch", 0, 0, 0, as_a_scm_t_subr (gdbscm_current_arch), "\ Return the object representing the architecture of the\n\ currently selected stack frame, if there is one, or the architecture of the\n\ current target if there isn't.\n\ \n\ Arguments: none" }, { "arch-name", 1, 0, 0, as_a_scm_t_subr (gdbscm_arch_name), "\ Return the name of the architecture." }, { "arch-charset", 1, 0, 0, as_a_scm_t_subr (gdbscm_arch_charset), "\ Return name of target character set as a string." }, { "arch-wide-charset", 1, 0, 0, as_a_scm_t_subr (gdbscm_arch_wide_charset), "\ Return name of target wide character set as a string." }, { "arch-void-type", 1, 0, 0, as_a_scm_t_subr (gdbscm_arch_void_type), "\ Return the object for the \"void\" type\n\ of the architecture." }, { "arch-char-type", 1, 0, 0, as_a_scm_t_subr (gdbscm_arch_char_type), "\ Return the object for the \"char\" type\n\ of the architecture." }, { "arch-short-type", 1, 0, 0, as_a_scm_t_subr (gdbscm_arch_short_type), "\ Return the object for the \"short\" type\n\ of the architecture." }, { "arch-int-type", 1, 0, 0, as_a_scm_t_subr (gdbscm_arch_int_type), "\ Return the object for the \"int\" type\n\ of the architecture." }, { "arch-long-type", 1, 0, 0, as_a_scm_t_subr (gdbscm_arch_long_type), "\ Return the object for the \"long\" type\n\ of the architecture." }, { "arch-schar-type", 1, 0, 0, as_a_scm_t_subr (gdbscm_arch_schar_type), "\ Return the object for the \"signed char\" type\n\ of the architecture." }, { "arch-uchar-type", 1, 0, 0, as_a_scm_t_subr (gdbscm_arch_uchar_type), "\ Return the object for the \"unsigned char\" type\n\ of the architecture." }, { "arch-ushort-type", 1, 0, 0, as_a_scm_t_subr (gdbscm_arch_ushort_type), "\ Return the object for the \"unsigned short\" type\n\ of the architecture." }, { "arch-uint-type", 1, 0, 0, as_a_scm_t_subr (gdbscm_arch_uint_type), "\ Return the object for the \"unsigned int\" type\n\ of the architecture." }, { "arch-ulong-type", 1, 0, 0, as_a_scm_t_subr (gdbscm_arch_ulong_type), "\ Return the object for the \"unsigned long\" type\n\ of the architecture." }, { "arch-float-type", 1, 0, 0, as_a_scm_t_subr (gdbscm_arch_float_type), "\ Return the object for the \"float\" type\n\ of the architecture." }, { "arch-double-type", 1, 0, 0, as_a_scm_t_subr (gdbscm_arch_double_type), "\ Return the object for the \"double\" type\n\ of the architecture." }, { "arch-longdouble-type", 1, 0, 0, as_a_scm_t_subr (gdbscm_arch_longdouble_type), "\ Return the object for the \"long double\" type\n\ of the architecture." }, { "arch-bool-type", 1, 0, 0, as_a_scm_t_subr (gdbscm_arch_bool_type), "\ Return the object for the \"bool\" type\n\ of the architecture." }, { "arch-longlong-type", 1, 0, 0, as_a_scm_t_subr (gdbscm_arch_longlong_type), "\ Return the object for the \"long long\" type\n\ of the architecture." }, { "arch-ulonglong-type", 1, 0, 0, as_a_scm_t_subr (gdbscm_arch_ulonglong_type), "\ Return the object for the \"unsigned long long\" type\n\ of the architecture." }, { "arch-int8-type", 1, 0, 0, as_a_scm_t_subr (gdbscm_arch_int8_type), "\ Return the object for the \"int8\" type\n\ of the architecture." }, { "arch-uint8-type", 1, 0, 0, as_a_scm_t_subr (gdbscm_arch_uint8_type), "\ Return the object for the \"uint8\" type\n\ of the architecture." }, { "arch-int16-type", 1, 0, 0, as_a_scm_t_subr (gdbscm_arch_int16_type), "\ Return the object for the \"int16\" type\n\ of the architecture." }, { "arch-uint16-type", 1, 0, 0, as_a_scm_t_subr (gdbscm_arch_uint16_type), "\ Return the object for the \"uint16\" type\n\ of the architecture." }, { "arch-int32-type", 1, 0, 0, as_a_scm_t_subr (gdbscm_arch_int32_type), "\ Return the object for the \"int32\" type\n\ of the architecture." }, { "arch-uint32-type", 1, 0, 0, as_a_scm_t_subr (gdbscm_arch_uint32_type), "\ Return the object for the \"uint32\" type\n\ of the architecture." }, { "arch-int64-type", 1, 0, 0, as_a_scm_t_subr (gdbscm_arch_int64_type), "\ Return the object for the \"int64\" type\n\ of the architecture." }, { "arch-uint64-type", 1, 0, 0, as_a_scm_t_subr (gdbscm_arch_uint64_type), "\ Return the object for the \"uint64\" type\n\ of the architecture." }, END_FUNCTIONS }; void gdbscm_initialize_arches (void) { arch_smob_tag = gdbscm_make_smob_type (arch_smob_name, sizeof (arch_smob)); scm_set_smob_print (arch_smob_tag, arscm_print_arch_smob); gdbscm_define_functions (arch_functions, 1); } void _initialize_scm_arch (); void _initialize_scm_arch () { arch_object_data = gdbarch_data_register_post_init (arscm_object_data_init); }