X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=gdb%2Fextension.h;h=581afc282dc71a0193c31215aa2933d95589d38c;hb=34dafe9f39e61de970c36ed636daa58e1caa386c;hp=04f90490ebb16993064620b91af643f311a6271b;hpb=e2882c85786571175a0b0bfc3bcd2f14620b1ea3;p=external%2Fbinutils.git diff --git a/gdb/extension.h b/gdb/extension.h index 04f9049..581afc2 100644 --- a/gdb/extension.h +++ b/gdb/extension.h @@ -1,6 +1,6 @@ /* Interface between gdb and its extension languages. - Copyright (C) 2014-2018 Free Software Foundation, Inc. + Copyright (C) 2014-2019 Free Software Foundation, Inc. This file is part of GDB. @@ -21,7 +21,8 @@ #define EXTENSION_H #include "mi/mi-cmds.h" /* For PRINT_NO_VALUES, etc. */ -#include "common/vec.h" +#include "gdbsupport/vec.h" +#include "gdbsupport/array-view.h" struct breakpoint; struct command_line; @@ -76,32 +77,36 @@ enum ext_lang_bt_status succeeded. */ EXT_LANG_BT_OK = 1, - /* Return when the frame filter process is complete, and all - operations have succeeded. */ - EXT_LANG_BT_COMPLETED = 2, - /* Return when the frame filter process is complete, but there were no filter registered and enabled to process. */ - EXT_LANG_BT_NO_FILTERS = 3 + EXT_LANG_BT_NO_FILTERS = 2 }; /* Flags to pass to apply_extlang_frame_filter. */ -enum frame_filter_flags +enum frame_filter_flag { /* Set this flag if frame level is to be printed. */ - PRINT_LEVEL = 1, + PRINT_LEVEL = 1 << 0, /* Set this flag if frame information is to be printed. */ - PRINT_FRAME_INFO = 2, + PRINT_FRAME_INFO = 1 << 1, /* Set this flag if frame arguments are to be printed. */ - PRINT_ARGS = 4, + PRINT_ARGS = 1 << 2, /* Set this flag if frame locals are to be printed. */ - PRINT_LOCALS = 8, + PRINT_LOCALS = 1 << 3, + + /* Set this flag if a "More frames" message is to be printed. */ + PRINT_MORE_FRAMES = 1 << 4, + + /* Set this flag if elided frames should not be printed. */ + PRINT_HIDE = 1 << 5, }; +DEF_ENUM_FLAGS_TYPE (enum frame_filter_flag, frame_filter_flags); + /* A choice of the different frame argument printing strategies that can occur in different cases of frame filter instantiation. */ @@ -120,7 +125,10 @@ enum ext_lang_frame_args CLI_SCALAR_VALUES, /* Print all values for arguments when invoked from the CLI. */ - CLI_ALL_VALUES + CLI_ALL_VALUES, + + /* Only indicate the presence of arguments when invoked from the CLI. */ + CLI_PRESENCE }; /* The possible results of @@ -142,30 +150,84 @@ enum ext_lang_bp_stop struct ext_lang_type_printers { + ext_lang_type_printers (); + ~ext_lang_type_printers (); + + DISABLE_COPY_AND_ASSIGN (ext_lang_type_printers); + /* Type-printers from Python. */ - void *py_type_printers; + void *py_type_printers = nullptr; +}; + +/* The return code for some API calls. */ + +enum ext_lang_rc +{ + /* The operation completed successfully. */ + EXT_LANG_RC_OK, + + /* The operation was not performed (e.g., no pretty-printer). */ + EXT_LANG_RC_NOP, + + /* There was an error (e.g., Python error while printing a value). + When an error occurs no further extension languages are tried. + This is to preserve existing behaviour, and because it's convenient + for Python developers. + Note: This is different than encountering a memory error trying to read + a value for pretty-printing. Here we're referring to, e.g., programming + errors that trigger an exception in the extension language. */ + EXT_LANG_RC_ERROR }; /* A type which holds its extension language specific xmethod worker data. */ struct xmethod_worker { - /* The language the xmethod worker is implemented in. */ - const struct extension_language_defn *extlang; + xmethod_worker (const extension_language_defn *extlang) + : m_extlang (extlang) + {} + + virtual ~xmethod_worker () = default; + + /* Invoke the xmethod encapsulated in this worker and return the result. + The method is invoked on OBJ with arguments in the ARGS array. */ + + virtual value *invoke (value *obj, gdb::array_view args) = 0; + + /* Return the arg types of the xmethod encapsulated in this worker. + The type of the 'this' object is returned as the first element of + the vector. */ + + std::vector get_arg_types (); - /* The extension language specific data for this xmethod worker. */ - void *data; + /* Return the type of the result of the xmethod encapsulated in this worker. + OBJECT and ARGS are the same as for invoke. */ - /* The TYPE_CODE_XMETHOD value corresponding to this worker. - Always use value_of_xmethod to access it. */ - struct value *value; + type *get_result_type (value *object, gdb::array_view args); + +private: + + /* Return the types of the arguments the method takes. The types + are returned in TYPE_ARGS, one per argument. */ + + virtual enum ext_lang_rc do_get_arg_types + (std::vector *type_args) = 0; + + /* Fetch the type of the result of the method implemented by this + worker. OBJECT and ARGS are the same as for the invoked method. + The result type is stored in *RESULT_TYPE. */ + + virtual enum ext_lang_rc do_get_result_type + (struct value *obj, gdb::array_view args, + struct type **result_type_ptr) = 0; + + /* The language the xmethod worker is implemented in. */ + + const extension_language_defn *m_extlang; }; -typedef struct xmethod_worker *xmethod_worker_ptr; -DEF_VEC_P (xmethod_worker_ptr); -typedef VEC (xmethod_worker_ptr) xmethod_worker_vec; +typedef std::unique_ptr xmethod_worker_up; - /* The interface for gdb's own extension(/scripting) language. */ extern const struct extension_language_defn extension_language_gdb; @@ -217,13 +279,9 @@ extern void eval_ext_lang_from_control_command (struct command_line *cmd); extern void auto_load_ext_lang_scripts_for_objfile (struct objfile *); -extern struct ext_lang_type_printers *start_ext_lang_type_printers (void); - extern char *apply_ext_lang_type_printers (struct ext_lang_type_printers *, struct type *); -extern void free_ext_lang_type_printers (struct ext_lang_type_printers *); - extern int apply_ext_lang_val_pretty_printer (struct type *type, LONGEST embedded_offset, CORE_ADDR address, @@ -232,7 +290,8 @@ extern int apply_ext_lang_val_pretty_printer const struct language_defn *language); extern enum ext_lang_bt_status apply_ext_lang_frame_filter - (struct frame_info *frame, int flags, enum ext_lang_frame_args args_type, + (struct frame_info *frame, frame_filter_flags flags, + enum ext_lang_frame_args args_type, struct ui_out *out, int frame_low, int frame_high); extern void preserve_ext_lang_values (struct objfile *, htab_t copied_types); @@ -242,26 +301,13 @@ extern const struct extension_language_defn *get_breakpoint_cond_ext_lang extern int breakpoint_ext_lang_cond_says_stop (struct breakpoint *); -extern struct value *invoke_xmethod (struct xmethod_worker *, - struct value *, - struct value **, int nargs); - -extern struct xmethod_worker *clone_xmethod_worker (struct xmethod_worker *); - -extern struct xmethod_worker *new_xmethod_worker - (const struct extension_language_defn *extlang, void *data); - -extern void free_xmethod_worker (struct xmethod_worker *); - -extern void free_xmethod_worker_vec (void *vec); - -extern xmethod_worker_vec *get_matching_xmethod_workers - (struct type *, const char *); - -extern struct type **get_xmethod_arg_types (struct xmethod_worker *, int *); +/* If a method with name METHOD_NAME is to be invoked on an object of type + TYPE, then all extension languages are searched for implementations of + methods with name METHOD_NAME. All matches found are appended to the WORKERS + vector. */ -extern struct type *get_xmethod_result_type (struct xmethod_worker *, - struct value *object, - struct value **args, int nargs); +extern void get_matching_xmethod_workers + (struct type *type, const char *method_name, + std::vector *workers); #endif /* EXTENSION_H */