2014-10-27 18:21:42 +01:00
|
|
|
/* Interface between GCC C FE and GDB
|
|
|
|
|
2018-01-03 11:03:58 +01:00
|
|
|
Copyright (C) 2014-2018 Free Software Foundation, Inc.
|
2014-10-27 18:21:42 +01:00
|
|
|
|
|
|
|
This file is part of GCC.
|
|
|
|
|
|
|
|
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/>. */
|
|
|
|
|
|
|
|
#ifndef GCC_C_INTERFACE_H
|
|
|
|
#define GCC_C_INTERFACE_H
|
|
|
|
|
|
|
|
#include "gcc-interface.h"
|
|
|
|
|
|
|
|
/* This header defines the interface to the GCC API. It must be both
|
|
|
|
valid C and valid C++, because it is included by both programs. */
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
extern "C" {
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/* Forward declaration. */
|
|
|
|
|
|
|
|
struct gcc_c_context;
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Definitions and declarations for the C front end.
|
|
|
|
*/
|
|
|
|
|
|
|
|
/* Defined versions of the C front-end API. */
|
|
|
|
|
|
|
|
enum gcc_c_api_version
|
|
|
|
{
|
Introduce C++ support in libcc1
Extend libcc1's with an API for C++ support.
Extend libcc1's C API to distinguish between integral types with the
same width, as in C++. Likewise for float types.
Export small bits of functionality from the C++ front-end for use in
libcc1. Add support for the C++ front-end to look up names and
addresses using a libcc1-registered binding oracle. Add support for
global friends.
for gcc/cp/ChangeLog
Introduce C++ support in libcc1.
* cp-tree.h (struct lang_identifier): Add oracle_looked_up.
(ansi_opname): Rename to...
(cp_operator_id): ... this. Adjust all callers.
(ansi_assopname): Rename to...
(cp_assignment_operator_id): ... this. Adjust all callers.
(cp_literal_operator_id): Declare.
(set_global_friend): Declare.
(is_global_friend): Declare.
(enum cp_oracle_request): New type.
(cp_binding_oracle_function): New type.
(cp_binding_oracle): Declare.
(cp_finish_injected_record_type): Declare.
* friend.c (global_friend): New var.
(set_global_friend): New fn.
(is_global_friend): New fn.
(is_friend): Call is_global_friend.
* name-lookup.c (cp_binding_oracle): New var.
(query_oracle): New fn.
(qualified_lookup_using_namespace): Call query_oracle.
(lookup_name_real_1): Likewise.
* parser.c (cp_literal_operator_id): Drop static.
* search.c (friend_accessible_p): Call is_global_friend.
* semantics.c (is_this_parameter): Accept a variable if the
binding oracle is enabled.
for include/ChangeLog
Introduce C++ support in libcc1.
* gcc-c-fe.def (int_type_v0): Rename from...
(int_type): ... this. Introduce new version.
(float_type_v0): Rename from...
(float_type): ... this. Introduce new version.
(char_type): New.
* gcc-c-interface.h (gcc_c_api_version): Add GCC_C_FE_VERSION_1.
(gcc_type_array): Move...
* gcc-interface.h: ... here.
* gcc-cp-fe.def: New.
* gcc-cp-interface.h: New.
for libcc1/ChangeLog
Introduce C++ support.
* Makefile.am (AM_CPPFLAGS): Move some -I flags to...
(CPPFLAGS_FOR_C_FAMILY, CPPFLAGS_FOR_C, CPPFLAGS_FOR_CXX): ...
new macros.
(plugin_LTLIBRARIES): Add libcp1plugin.la.
(BUILT_SOURCES, MOSTLYCLEANFILES): Add...
(cp-compiler-name.h): ... this. New.
(c-compiler-name.h): Rename all over from...
(compiler-name.h): ... this. Create it atomically.
(marshall_c_source, marshall_cxx_source): New macros.
(libcc1plugin_la_SOURCES): Rename plugin.cc to libcc1plugin.cc.
Add marshall_c_source expansion.
(libcc1plugin.lo_CPPFLAGS): New macro.
(libcp1plugin_la_LDFLAGS): Likewise.
(libcp1plugin_la_SOURCES): Likewise.
(libcp1plugin.lo_CPPFLAGS): Likewise.
(libcp1plugin_la_LIBADD): Likewise.
(libcp1plugin_la_DEPENDENCIES): Likewise.
(libcp1plugin_la_LINK): Likewise.
(libcc1_la_SOURCES): Added marshall_c_source and
marshall_cxx_source expansions.
* Makefile.in: Rebuild.
* compiler-name.h: Rename all over to...
* c-compiler-name.h: ... this. Define C_COMPILER_NAME instead
of COMPILER_NAME.
* plugin.cc: Rename all over to...
* libcc1plugin.cc: ... this. Include marshall-c.hh.
(address_rewriter): Drop cleaning up of VLA sizes.
(plugin_build_decl): Mark decls as external.
(plugin_tagbind): Propagate name to all variants.
(build_anonymous_node): New.
(plugin_build_record_type): Use it instead of make_node.
(plugin_build_union_type): Likewise.
(plugin_build_enum_type): Likewise.
(plugin_finish_record_or_union): Update all type variants.
(safe_lookup_builtin_type): New.
(plugin_int_check): Factor out of, and add checks to, ...
(plugin_int_type): ... this. Rename to...
(plugin_int_type_v0): ... this.
(plugin_int_type): New interface, new implementation.
(plugin_char_type): New.
(plugin_float_type_v0): Rename from...
(plugin_float_type): ... this. New interface, new implementation.
(plugin_init): Bump handshake version.
* libcc1.cc: Include marshall-c.hh. Drop gcc-interface.h.
(call_binding_oracle): Rename to...
(c_call_binding_oracle): ... this, into anonymous namespace.
(call_symbol_address): Rename to...
(c_call_symbol_address): ... this, likewise.
(GCC_METHOD#): Move methods into cc1plugin::c:: namespace.
(libcc1::compiler::find): Refer to C_COMPILER_NAME.
(fork_exec): Bump to GCC_C_FE_VERSION_1.
(libcc1_compile): Prefix callbacks with c_.
(gcc_c_fe_context): Accept GCC_C_FE_VERSION_1.
* libcc1.sym: Export gcc_cp_fe_context.
* libcp1.cc: New, mostly copied and adjusted from libcc1.cc.
* libcp1plugin.cc: New, initially copied from libcc1plugin.cc.
* libcp1plugin.sym: New.
* marshall-c.hh: New. Move C-specific types from...
* marshall.cc: ... this.
(cc1_plugin::marshall_array_start): New.
(cc1_plugin::marshall_array_elmts): New.
(cc1_plugin::marshall for gcc_type_array): Use the above.
(cc1_plugin::unmarshall_array_start): New.
(cc1_plugin::unmarshall_array_elmts): New.
(cc1_plugin::unmarshall for gcc_type_array): Use the above.
* marshall.hh: Declare the new array building blocks.
Drop C-specific unmarshall declarations.
* marshall-cp.hh: New.
* names.cc (GCC_METHOD#): Add LANG:: to method names.
(LANG): Define while including gcc-c-fe.def and gcc-cp-fe.def.
* names.hh: Include gcc-c-fe.def and gcc-cp-fe.def in the
corresponding namespaces.
* rpc.hh: Don't include marshall.hh.
[GCC_CP_INTERFACE_H] (argument_wrapper): Specialize for
gcc_vbase_array, gcc_cp_template_args, gcc_cp_function_args.
From-SVN: r245051
2017-01-31 02:02:03 +01:00
|
|
|
GCC_C_FE_VERSION_0 = 0,
|
|
|
|
|
|
|
|
/* Added char_type. Added new version of int_type and float_type,
|
|
|
|
deprecated int_type_v0 and float_type_v0. */
|
|
|
|
GCC_C_FE_VERSION_1 = 1
|
2014-10-27 18:21:42 +01:00
|
|
|
};
|
|
|
|
|
|
|
|
/* Qualifiers. */
|
|
|
|
|
|
|
|
enum gcc_qualifiers
|
|
|
|
{
|
|
|
|
GCC_QUALIFIER_CONST = 1,
|
|
|
|
GCC_QUALIFIER_VOLATILE = 2,
|
|
|
|
GCC_QUALIFIER_RESTRICT = 4
|
|
|
|
};
|
|
|
|
|
|
|
|
/* This enumerates the kinds of decls that GDB can create. */
|
|
|
|
|
|
|
|
enum gcc_c_symbol_kind
|
|
|
|
{
|
|
|
|
/* A function. */
|
|
|
|
|
|
|
|
GCC_C_SYMBOL_FUNCTION,
|
|
|
|
|
|
|
|
/* A variable. */
|
|
|
|
|
|
|
|
GCC_C_SYMBOL_VARIABLE,
|
|
|
|
|
|
|
|
/* A typedef. */
|
|
|
|
|
|
|
|
GCC_C_SYMBOL_TYPEDEF,
|
|
|
|
|
|
|
|
/* A label. */
|
|
|
|
|
|
|
|
GCC_C_SYMBOL_LABEL
|
|
|
|
};
|
|
|
|
|
|
|
|
/* This enumerates the types of symbols that GCC might request from
|
|
|
|
GDB. */
|
|
|
|
|
|
|
|
enum gcc_c_oracle_request
|
|
|
|
{
|
|
|
|
/* An ordinary symbol -- a variable, function, typedef, or enum
|
|
|
|
constant. */
|
|
|
|
|
|
|
|
GCC_C_ORACLE_SYMBOL,
|
|
|
|
|
|
|
|
/* A struct, union, or enum tag. */
|
|
|
|
|
|
|
|
GCC_C_ORACLE_TAG,
|
|
|
|
|
|
|
|
/* A label. */
|
|
|
|
|
|
|
|
GCC_C_ORACLE_LABEL
|
|
|
|
};
|
|
|
|
|
|
|
|
/* The type of the function called by GCC to ask GDB for a symbol's
|
|
|
|
definition. DATUM is an arbitrary value supplied when the oracle
|
|
|
|
function is registered. CONTEXT is the GCC context in which the
|
|
|
|
request is being made. REQUEST specifies what sort of symbol is
|
|
|
|
being requested, and IDENTIFIER is the name of the symbol. */
|
|
|
|
|
|
|
|
typedef void gcc_c_oracle_function (void *datum,
|
|
|
|
struct gcc_c_context *context,
|
|
|
|
enum gcc_c_oracle_request request,
|
|
|
|
const char *identifier);
|
|
|
|
|
|
|
|
/* The type of the function called by GCC to ask GDB for a symbol's
|
|
|
|
address. This should return 0 if the address is not known. */
|
|
|
|
|
|
|
|
typedef gcc_address gcc_c_symbol_address_function (void *datum,
|
|
|
|
struct gcc_c_context *ctxt,
|
|
|
|
const char *identifier);
|
|
|
|
|
|
|
|
/* The vtable used by the C front end. */
|
|
|
|
|
|
|
|
struct gcc_c_fe_vtable
|
|
|
|
{
|
|
|
|
/* The version of the C interface. The value is one of the
|
|
|
|
gcc_c_api_version constants. */
|
|
|
|
|
|
|
|
unsigned int c_version;
|
|
|
|
|
|
|
|
/* Set the callbacks for this context.
|
|
|
|
|
|
|
|
The binding oracle is called whenever the C parser needs to look
|
|
|
|
up a symbol. This gives the caller a chance to lazily
|
|
|
|
instantiate symbols using other parts of the gcc_c_fe_interface
|
|
|
|
API.
|
|
|
|
|
|
|
|
The address oracle is called whenever the C parser needs to look
|
|
|
|
up a symbol. This is only called for symbols not provided by the
|
|
|
|
symbol oracle -- that is, just built-in functions where GCC
|
|
|
|
provides the declaration.
|
|
|
|
|
|
|
|
DATUM is an arbitrary piece of data that is passed back verbatim
|
Introduce C++ support in libcc1
Extend libcc1's with an API for C++ support.
Extend libcc1's C API to distinguish between integral types with the
same width, as in C++. Likewise for float types.
Export small bits of functionality from the C++ front-end for use in
libcc1. Add support for the C++ front-end to look up names and
addresses using a libcc1-registered binding oracle. Add support for
global friends.
for gcc/cp/ChangeLog
Introduce C++ support in libcc1.
* cp-tree.h (struct lang_identifier): Add oracle_looked_up.
(ansi_opname): Rename to...
(cp_operator_id): ... this. Adjust all callers.
(ansi_assopname): Rename to...
(cp_assignment_operator_id): ... this. Adjust all callers.
(cp_literal_operator_id): Declare.
(set_global_friend): Declare.
(is_global_friend): Declare.
(enum cp_oracle_request): New type.
(cp_binding_oracle_function): New type.
(cp_binding_oracle): Declare.
(cp_finish_injected_record_type): Declare.
* friend.c (global_friend): New var.
(set_global_friend): New fn.
(is_global_friend): New fn.
(is_friend): Call is_global_friend.
* name-lookup.c (cp_binding_oracle): New var.
(query_oracle): New fn.
(qualified_lookup_using_namespace): Call query_oracle.
(lookup_name_real_1): Likewise.
* parser.c (cp_literal_operator_id): Drop static.
* search.c (friend_accessible_p): Call is_global_friend.
* semantics.c (is_this_parameter): Accept a variable if the
binding oracle is enabled.
for include/ChangeLog
Introduce C++ support in libcc1.
* gcc-c-fe.def (int_type_v0): Rename from...
(int_type): ... this. Introduce new version.
(float_type_v0): Rename from...
(float_type): ... this. Introduce new version.
(char_type): New.
* gcc-c-interface.h (gcc_c_api_version): Add GCC_C_FE_VERSION_1.
(gcc_type_array): Move...
* gcc-interface.h: ... here.
* gcc-cp-fe.def: New.
* gcc-cp-interface.h: New.
for libcc1/ChangeLog
Introduce C++ support.
* Makefile.am (AM_CPPFLAGS): Move some -I flags to...
(CPPFLAGS_FOR_C_FAMILY, CPPFLAGS_FOR_C, CPPFLAGS_FOR_CXX): ...
new macros.
(plugin_LTLIBRARIES): Add libcp1plugin.la.
(BUILT_SOURCES, MOSTLYCLEANFILES): Add...
(cp-compiler-name.h): ... this. New.
(c-compiler-name.h): Rename all over from...
(compiler-name.h): ... this. Create it atomically.
(marshall_c_source, marshall_cxx_source): New macros.
(libcc1plugin_la_SOURCES): Rename plugin.cc to libcc1plugin.cc.
Add marshall_c_source expansion.
(libcc1plugin.lo_CPPFLAGS): New macro.
(libcp1plugin_la_LDFLAGS): Likewise.
(libcp1plugin_la_SOURCES): Likewise.
(libcp1plugin.lo_CPPFLAGS): Likewise.
(libcp1plugin_la_LIBADD): Likewise.
(libcp1plugin_la_DEPENDENCIES): Likewise.
(libcp1plugin_la_LINK): Likewise.
(libcc1_la_SOURCES): Added marshall_c_source and
marshall_cxx_source expansions.
* Makefile.in: Rebuild.
* compiler-name.h: Rename all over to...
* c-compiler-name.h: ... this. Define C_COMPILER_NAME instead
of COMPILER_NAME.
* plugin.cc: Rename all over to...
* libcc1plugin.cc: ... this. Include marshall-c.hh.
(address_rewriter): Drop cleaning up of VLA sizes.
(plugin_build_decl): Mark decls as external.
(plugin_tagbind): Propagate name to all variants.
(build_anonymous_node): New.
(plugin_build_record_type): Use it instead of make_node.
(plugin_build_union_type): Likewise.
(plugin_build_enum_type): Likewise.
(plugin_finish_record_or_union): Update all type variants.
(safe_lookup_builtin_type): New.
(plugin_int_check): Factor out of, and add checks to, ...
(plugin_int_type): ... this. Rename to...
(plugin_int_type_v0): ... this.
(plugin_int_type): New interface, new implementation.
(plugin_char_type): New.
(plugin_float_type_v0): Rename from...
(plugin_float_type): ... this. New interface, new implementation.
(plugin_init): Bump handshake version.
* libcc1.cc: Include marshall-c.hh. Drop gcc-interface.h.
(call_binding_oracle): Rename to...
(c_call_binding_oracle): ... this, into anonymous namespace.
(call_symbol_address): Rename to...
(c_call_symbol_address): ... this, likewise.
(GCC_METHOD#): Move methods into cc1plugin::c:: namespace.
(libcc1::compiler::find): Refer to C_COMPILER_NAME.
(fork_exec): Bump to GCC_C_FE_VERSION_1.
(libcc1_compile): Prefix callbacks with c_.
(gcc_c_fe_context): Accept GCC_C_FE_VERSION_1.
* libcc1.sym: Export gcc_cp_fe_context.
* libcp1.cc: New, mostly copied and adjusted from libcc1.cc.
* libcp1plugin.cc: New, initially copied from libcc1plugin.cc.
* libcp1plugin.sym: New.
* marshall-c.hh: New. Move C-specific types from...
* marshall.cc: ... this.
(cc1_plugin::marshall_array_start): New.
(cc1_plugin::marshall_array_elmts): New.
(cc1_plugin::marshall for gcc_type_array): Use the above.
(cc1_plugin::unmarshall_array_start): New.
(cc1_plugin::unmarshall_array_elmts): New.
(cc1_plugin::unmarshall for gcc_type_array): Use the above.
* marshall.hh: Declare the new array building blocks.
Drop C-specific unmarshall declarations.
* marshall-cp.hh: New.
* names.cc (GCC_METHOD#): Add LANG:: to method names.
(LANG): Define while including gcc-c-fe.def and gcc-cp-fe.def.
* names.hh: Include gcc-c-fe.def and gcc-cp-fe.def in the
corresponding namespaces.
* rpc.hh: Don't include marshall.hh.
[GCC_CP_INTERFACE_H] (argument_wrapper): Specialize for
gcc_vbase_array, gcc_cp_template_args, gcc_cp_function_args.
From-SVN: r245051
2017-01-31 02:02:03 +01:00
|
|
|
to the callbacks in requests. */
|
2014-10-27 18:21:42 +01:00
|
|
|
|
|
|
|
void (*set_callbacks) (struct gcc_c_context *self,
|
|
|
|
gcc_c_oracle_function *binding_oracle,
|
|
|
|
gcc_c_symbol_address_function *address_oracle,
|
|
|
|
void *datum);
|
|
|
|
|
|
|
|
#define GCC_METHOD0(R, N) \
|
|
|
|
R (*N) (struct gcc_c_context *);
|
|
|
|
#define GCC_METHOD1(R, N, A) \
|
|
|
|
R (*N) (struct gcc_c_context *, A);
|
|
|
|
#define GCC_METHOD2(R, N, A, B) \
|
|
|
|
R (*N) (struct gcc_c_context *, A, B);
|
|
|
|
#define GCC_METHOD3(R, N, A, B, C) \
|
|
|
|
R (*N) (struct gcc_c_context *, A, B, C);
|
|
|
|
#define GCC_METHOD4(R, N, A, B, C, D) \
|
|
|
|
R (*N) (struct gcc_c_context *, A, B, C, D);
|
|
|
|
#define GCC_METHOD5(R, N, A, B, C, D, E) \
|
|
|
|
R (*N) (struct gcc_c_context *, A, B, C, D, E);
|
|
|
|
#define GCC_METHOD7(R, N, A, B, C, D, E, F, G) \
|
|
|
|
R (*N) (struct gcc_c_context *, A, B, C, D, E, F, G);
|
|
|
|
|
|
|
|
#include "gcc-c-fe.def"
|
|
|
|
|
|
|
|
#undef GCC_METHOD0
|
|
|
|
#undef GCC_METHOD1
|
|
|
|
#undef GCC_METHOD2
|
|
|
|
#undef GCC_METHOD3
|
|
|
|
#undef GCC_METHOD4
|
|
|
|
#undef GCC_METHOD5
|
|
|
|
#undef GCC_METHOD7
|
|
|
|
|
|
|
|
};
|
|
|
|
|
|
|
|
/* The C front end object. */
|
|
|
|
|
|
|
|
struct gcc_c_context
|
|
|
|
{
|
|
|
|
/* Base class. */
|
|
|
|
|
|
|
|
struct gcc_base_context base;
|
|
|
|
|
|
|
|
/* Our vtable. This is a separate field because this is simpler
|
|
|
|
than implementing a vtable inheritance scheme in C. */
|
|
|
|
|
|
|
|
const struct gcc_c_fe_vtable *c_ops;
|
|
|
|
};
|
|
|
|
|
|
|
|
/* The name of the .so that the compiler builds. We dlopen this
|
|
|
|
later. */
|
|
|
|
|
|
|
|
#define GCC_C_FE_LIBCC libcc1.so
|
|
|
|
|
|
|
|
/* The compiler exports a single initialization function. This macro
|
|
|
|
holds its name as a symbol. */
|
|
|
|
|
|
|
|
#define GCC_C_FE_CONTEXT gcc_c_fe_context
|
|
|
|
|
|
|
|
/* The type of the initialization function. The caller passes in the
|
|
|
|
desired base version and desired C-specific version. If the
|
|
|
|
request can be satisfied, a compatible gcc_context object will be
|
|
|
|
returned. Otherwise, the function returns NULL. */
|
|
|
|
|
|
|
|
typedef struct gcc_c_context *gcc_c_fe_context_function
|
|
|
|
(enum gcc_base_api_version,
|
|
|
|
enum gcc_c_api_version);
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#endif /* GCC_C_INTERFACE_H */
|